버전 3.1

출시 2018년 7월 26일 | 이용 가능 시기 2020년 10월 27일 | 블로그 게시물

일반
Live API
마케팅 API
Messenger 플랫폼
함께 아는 친구 API
페이지 API
Webhooks

일반

이 변경 사항은 v3.1 이상에 적용되며 2018년 10월 24일 이후에는 모든 버전에 적용됩니다.

이제 모든 그래프 API 엔드포인트는 모든 빈 구조를 {}로 반환하고 모든 빈 리스트는 []로 반환합니다.

Live API

이 변경 사항은 v3.1 이상에 적용되며 2018년 10월 24일 이후에는 모든 버전에 적용됩니다.

type 매개변수는 다음 에지에 대해 사용이 중단됩니다. 새로운 source 매개변수로 대체되었습니다.

/event/live_videos
/group/live_videos
/official_events/live_videos
/page/live_videos
/user/live_videos

새로운 source 매개변수는 target와 owner 값 중 하나를 받을 수 있습니다. 노드의 /live_videos 에지를 source=target으로 쿼리하면 해당 노드로 스트리밍된 라이브 동영상이 반환되고 source=owner에 대해 쿼리하면 해당 노드가 스트리밍한 라이브 동영상이 반환됩니다.

이벤트 및 그룹 노드는 target 쿼리만 지원하고 대상 노드를 볼 수 있는 권한이 없으면 target 쿼리가 실패할 수 있습니다.

마케팅 API

출시 2018년 7월 26일 | 이용 가능 시기 2019년 5월 14일 | 블로그 게시물

광고 관리

동작 기반 타게팅 카테고리 - behaviors에서 사용되는 일부 동작 기반 타게팅 옵션을 사용 중단했습니다. 이 카테고리 중 하나로 광고를 생성하려고 하면 The category you selected is no longer available. 오류가 발생합니다. 타게팅에 사용할 수 있는 유효한 카테고리는 타게팅 검색에서 확인하세요.
PAGE_ENGAGEMENT를 optimization_goal로 사용하지 못하도록 사용 중단 - PAGE_ENGAGEMENT를 광고 캠페인의 optimization_goal로 사용하지 못하도록 사용을 중단했습니다. v3.1 이후로 optimization_goal을 PAGE_ENGAGEMENT로 설정하여 캠페인을 만들거나 업데이트하거나 복제할 수 없습니다. v3.1 이전에 만든 기존 광고 캠페인이 있으면 이렇게 설정하더라도 캠페인을 실행할 수 있습니다. 기존 광고 캠페인에서 이 optimization_goal을 사용해 데이터에 대한 인사이트 API 분석 데이터로 PAGE_ENGAGEMENT를 여전히 사용할 수 있습니다.
게시물이 없는 단일 이미지 페이지 좋아요 광고 사용 중단 - v3.1부터 페이지 게시물 없이 단일 이미지 페이지 좋아요 광고를 만들 수 없습니다. 대신 게시물을 포함한 페이지 좋아요 광고를 만들어야 합니다. 크리에이티브, 노출 위치 및 미리 보기, 페이지 좋아요 광고 만들기를 참조하세요.

개발 계층에서 Webhooks를 통해 잠재 고객용 광고 검색 불가 - 개발 모드에서 Webhooks를 통해 앱으로 잠재 고객용 광고 형식으로 수집한 데이터 전송을 중단합니다. 이 변경 사항은 2019년 2월 1일부터 적용됩니다.
- v3.1 업데이트를 받아볼 경우 앱이 프로덕션 및 라이브 모드가 아니라면 업데이트를 전송하지 않습니다.
- v3.1 이후에 새 앱을 만든다면 앱이 프로덕션 및 라이브 모드가 아니라면 업데이트를 전송하지 않습니다.
- 기존 앱이 있으면 2019년 2월 1일까지 라이브 모드로 전환해야 합니다. 그 시점까지는 개발 모드에서 계속 업데이트를 받을 수 있습니다.
마케팅 API 액세스 계층과 앱 모드에 대한 자세한 정보는 마케팅 API 액세스의 새로운 구조와 마케팅 API, 액세스 및 인증을 참조하세요.

광고 인사이트 및 측정

인사이트 API의 cost_per_store_visit과 store_visits을 cost_per_store_visit_actions과 store_visit_actions으로 이름을 변경했습니다. 다음에 영향을 미칩니다.
- GET {adaccount-id}/insights,
- GET {campaign-id}/insights,
- GET {adset-id}/insights,
- GET {ad-id}/insights,
- POST {adaccount-id}/insights,
- POST {campaign-id}/insights,
- POST {adset-id}/insights 및
- POST {ad-id}/insights.
새로 이름이 지정된 지표에 대한 정보는 매장 방문수, 측정을 참조하세요. 매장 방문 API와 관련 문서는 제한적으로 제공됩니다. 이용 권한은 Facebook 담당자에게 문의하세요.

비즈니스 관리자 API

v3.1에서는 작업 기반 권한이라는 새로운 개념을 도입하여 현재의 역할 기반 권한을 대체합니다. 비즈니스 관리자 API와 페이지에서 관리하는 광고 계정 액세스에 영향을 미칩니다. 광고 계정과 페이지에 대한 역할 기반 액세스 권한은 아직 사용할 수 있지만 나중에는 사용이 중단됩니다. 다음 역할에 영향을 미치고 광고 계정에 그에 해당하는 작업을 제공합니다.

역할	작업	설명
`ADMIN`	`['MANAGE', 'ADVERTISE', 'ANALYZE']`	광고 캠페인, 보고, 청구 및 광고 계정 권한의 모든 측면을 관리합니다.
`GENERAL_USER`	`['ADVERTISE', 'ANALYZE']`	광고 계정에 연결된 결제 수단을 사용하여 광고를 만들 수 있습니다. 보고서를 실행합니다.
`GENERAL_USER`	`['ANALYZE']`	보고서를 실행합니다.

비즈니스 관리자 API의 다음 역할이 아래와 같은 작업으로 교체됩니다.

역할	작업
`MANAGER`	`['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']`
`CONTENT_CREATOR`	`['CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']`
`MODERATOR`	`['MODERATE', 'ADVERTISE', 'ANALYZE']`
`ADVERTISER`	`['ADVERTISE', 'ANALYZE']`
`INSIGHTS_ANALYST`	`['ANALYZE']`

Facebook 픽셀 관리의 경우, 이는 역할에 영향을 미치고 새 작업이 도입됩니다.

역할	작업
`PIXEL_EDITOR`	`['EDIT', 'ANALYZE']`
`PIXEL_ANALYST`	`['ANALYZE']`

이번 변경 사항에서는 다음 비즈니스 관리 API 필드의 사용을 중단하고 다음과 같이 교체합니다.

영역	사용 중단	새로운 필드
`GET {adaccount-id}/users`	`permissions`, `role`	`tasks`
`POST {adaccount-id}/users`	`role`, `uidRoles`, `emailRoles`	`tasks`
`GET {user-id}/adaccounts`	`permissions`, `role`	`tasks`
`GET {user-id}/assigned_ad_accounts`	`role`, `permitted_role`	`tasks`, `permitted_tasks`
`GET {user-id}/assigned_pages`	`role`, `permitted_role`	`tasks`, `permitted_tasks`
`GET {adaccount-id}/assigned_users`	`role`, `permitted_role`	`tasks`, `permitted_tasks`
`POST {adaccount-id}/assigned_users`	`role`	`tasks`
`GET {page-id}/assigned_users`	`role`, `permitted_role`	`tasks`, `permitted_tasks`
`POST {page-id}/assigned_users`	`role`	`tasks`
`GET {fb-pixel-id}/assigned_users`	`role`, `permitted_role`	`tasks`, `permitted_tasks`
`GET {adaccount-id}/userpermissions`	`role`	`tasks`
`POST {adaccount-id}/userpermissions`	`role`	`tasks`
`GET {page-id}/userpermissions`	`role`	`tasks`
`POST {page-id}/userpermissions`	`role`	`tasks`
`GET {business-id}/client_ad_accounts`	`permitted_role`	`permitted_tasks`
`POST {business-id}/client_ad_accounts`	`permitted_role`	`permitted_tasks`
`GET {business-id}/client_pages`	`permitted_role`	`permitted_tasks`
`POST {business-id}/client_pages`	`permitted_role`	`permitted_tasks`
`GET {business-id}/client_pixels`	`permitted_role`	`permitted_tasks`
`GET {adaccount-id}/agencies`	`permitted_role`	`permitted_tasks`
`POST {adaccount-id}/agencies`	`permitted_role`	`permitted_tasks`
`GET {page-id}/agencies`	`permitted_role`	`permitted_tasks`
`POST {page-id}/agencies`	`permitted_role`	`permitted_tasks`
`GET {business-id}/pending_client_pages`	`permitted_role`	`permitted_tasks`
`GET {business-id}/pending_client_ad_accounts`	`permitted_role`	`permitted_tasks`

이번 새 디자인은 페이지 API에도 영향을 미칩니다. 그래프 API 3.1, 페이지 API, 핵심 변경 사항을 참조하세요. 비즈니스 관리자 API 문서는 다음을 참조하세요.

Messenger 플랫폼

2018년 7월 26일 이전에 생성된 앱의 경우 2019년 1월 8일에 변경 사항이 적용됩니다. 2018년 7월 26일 이후에 생성된 앱의 경우 즉시 변경 사항이 적용됩니다.

사용자 프로필 API는 이제 기본적으로 first_name, last_name, profile_pic 필드만 반환합니다. 추가 필드는 앱 대시보드의 Messenger 플랫폼 탭을 통해 제품 검수를 받아야 합니다.

last_ad_referral과 is_payment_enabled 필드는 사용이 중단되고 2018년 10월 30일에 API에서 삭제됩니다.

함께 아는 친구 API

이 변경 사항은 v3.1 이상에 적용되며 2018년 10월 24일 이후에는 모든 버전에 적용됩니다.

함께 아는 친구 API는 2018년 4월 4일에 사용이 중단되었고 다음 엔드포인트는 빈 데이터 세트를 반환하기 시작했습니다. 이 엔드포인트는 이제 완전히 사용이 중단되었고 오류가 반환됩니다.

/user-context/all_mutual_friends
/user-context/mutual_friends
/user-context/three_degree_mutual_friends

페이지 API

권한

다음 변경 사항은 v3.1 이상에 적용되며 2019년 2월 1일 이후에는 모든 버전에 적용됩니다.

pages_manage_cta 권한은 모든 POST 및 DELETE 요청에 대해 앱 검수가 필요합니다. 2018년 7월 26일 전에 생성된 앱은 이 권한을 계속 사용할 수 있지만 2019년 2월 1일 전까지 앱 검수를 위해 앱을 제출해야 pages_manage_cta를 계속 사용할 수 있습니다.

페이지 역할

다음 변경 사항은 v3.1 이상에 적용됩니다.

페이지 역할은 사용 중단이 진행 중이며 페이지 작업으로 대체되는 중입니다. 사용자에게 페이지에 대한 역할을 부여하는 대신 그에 해당하는 작업을 부여해야 합니다.

역할	해당 작업
`Admin`	`ADVERTISE`, `ANALYZE`, `CREATE_CONTENT`, `MANAGE`, `MODERATE`
`Advertiser`	`ADVERTISE`, `ANALYZE`
`Analyst`	`ANALYZE`
`Editor`	`ADVERTISE`, `ANALYZE`, `CREATE_CONTENT`, `MODERATE`
`Moderator`	`ADVERTISE`, `ANALYZE`, `MODERATE`

역할 기반 권한이 완전히 작업 기반 권한으로 대체될 때까지는 /page/roles를 통해 작업을 부여할 경우 역할에 해당하는 작업을 모두 부여하지 않으면 POST 작업이 실패합니다.

이러한 변경 사항을 지원하기 위해 perms와 role 필드의 사용이 중단되고 새로운 tasks 필드로 대체되었습니다. 다음 에지에 영향을 미칩니다.

/me/accounts
/page/roles
/user/accounts

이러한 변경 사항이 마케팅 API와 비즈니스 관리자 API에 어떤 영향을 미치는지 알아보려면 마케팅 API 변경 사항을 참조하세요.

Webhooks

이 변경 사항은 v3.1 이상에 적용되며 2018년 10월 24일 이후에는 모든 버전에 적용됩니다.

다음 사용자 Webhook 필드는 사용이 중단됩니다.

pic_big_with_logo
pic_small_with_logo
pic_square_with_logo
pic_with_logo

다음 사용자 Webhook 필드는 HTTP 대신 HTTPS URL을 사용합니다.

pic
pic_big
pic_small
pic_square
picture

또한 이 필드의 URL이 만료됩니다. 이 변경 사항은 모든 API 버전에 즉시 적용됩니다.