버전 8.0

그래프 API

2020년 8월 4일에 출시됨 | 이용 가능 기한: 2022년 11월 1일 | 블로그 게시물

액세스 토큰

사용 중단된 엔드포인트

v8.0 이상에서 사용 중단됩니다. 2020년 11월 2일에 모든 버전에서 사용 중단됩니다.

• GET /token_deprecation_check

사진첩

복구된 엔드포인트

모든 버전에 적용됩니다.

• GET /{album-id}/likes

앱 구성

앱 유형

이 변경 사항은 모든 버전에 적용됩니다.

새로 생성된 앱은 비즈니스, 게임 또는 없음 중에서 앱 유형을 선택할 수 있습니다. 선택한 유형에 적절하지 않은 권한과 기능이 제거되므로 앱 검수 인터페이스가 간단해집니다. 또한 비즈니스 앱으로 유형이 지정된 앱은 모드 대신 새로운 인증 메커니즘을 사용하며 새로운 기능에 액세스할 수 있습니다. 자세한 내용은 비즈니스 앱 변경 사항 항목을 참조하세요.

비즈니스 앱

비즈니스 앱으로 유형이 지정된 앱은 액세스 레벨이라는 새로운 인증 메커니즘을 사용합니다. 액세스 레벨은 개발 모드와 라이브 모드에서 제공하는 기능을 대체합니다. 해당 기능이 비즈니스 앱에서 제거되었으므로 앱 검수 절차가 더욱 간단하고 직관적으로 바뀌었습니다. 또한 비즈니스 앱이 몇 개의 공개 사용자 필드를 읽을 수 있는 새로운 비즈니스 자산 사용자 프로필 액세스 기능이 출시되었습니다. 이 변경 사항은 아래에 자세한 설명이 나와 있습니다.

액세스 레벨

모든 버전에 적용됩니다.

액세스 레벨은 비즈니스 앱의 새로운 그래프 API 인증 메커니즘으로, 개별적으로 권한과 기능에 적용됩니다. 표준 액세스는 앱이나 앱을 요청한 비즈니스에서 역할이 부여된 사용자가 소유한 데이터에 대한 액세스만 허용합니다. 고급 액세스는 모든 앱 사용자가 소유한 데이터에 대한 액세스를 허용하지만 앱 검수가 필요합니다. 비즈니스 앱은 해당 유형에 제공되는 모든 권한과 기능에 자동으로 표준 액세스 권한이 부여됩니다.

개발 및 라이브 모드 제거

모든 버전에 적용됩니다.

개발 모드와 라이브 모드는 유형이 비즈니스 앱으로 지정된 앱에서 제거되었습니다. 이 두 가지 모드는 동일한 기능을 제공하면서도 더욱 다양한 목적에 활용할 수 있는 액세스 레벨로 대체되었습니다. 비즈니스 앱은 모든 사용 가능한 권한과 기능에 표준 액세스 권한을 부여하므로 앱이나 앱을 요청한 비즈니스에서 역할이 부여된 모든 사용자가 언제든 앱에 사용 가능한 권한을 부여할 수 있습니다. 따라서 앱 검수를 받거나 개발 중에 모드를 전환할 필요가 없습니다.

새로운 비즈니스 자산 사용자 프로필 액세스 기능

모든 버전에 적용됩니다.

새로운 비즈니스 자산 사용자 프로필 액세스 기능을 사용하는 비즈니스 앱은 사용자에 대한 몇 가지 공개 필드를 읽습니다. 단, 사용자가 앱을 요청한 비즈니스가 소유한 자산에 참여했어야 합니다. 읽을 수 있는 사용자 필드 리스트는 비즈니스 자산 사용자 프로필 액세스 참고 자료를 참조하세요.

댓글

복구된 엔드포인트

모든 버전에 적용됩니다.

• GET /{comment-id}/likes

기기

사용 중단된 엔드포인트

v8.0 이상에서 사용 중단됩니다. 2020년 11월 2일에 모든 버전에서 사용 중단됩니다.

• POST /device/share

그룹

사용 중단된 엔드포인트

v8.0 이상에서 사용 중단됩니다.

• GET /{group-id}/posts

v8.0 이상에서 사용 중단됩니다. 2020년 11월 2일에 모든 버전에서 사용 중단됩니다.

• GET /{group-post-id}/likes

Instagram

새로운 Instagram oEmbed 엔드포인트

모든 버전에 적용됩니다.

새로운 GET /instagram_oembed 엔드포인트가 도입되었습니다. 2020년 10월 24일에 사용 중단될 Instagram의 기존 oEmbed 엔드포인트와 동일한 기능을 제공합니다. 새로운 엔드포인트는 액세스 토큰이 필요합니다. 따라서 Facebook 개발자 계정과 이에 액세스할 수 있는 등록된 앱이 필요합니다. 사용 안내와 자세한 내용은 Instagram oEmbed 문서를 참조하세요.

중요 이벤트

사용 중단된 엔드포인트

v8.0 이상에서 사용 중단됩니다.

• GET /{life-event-id}
• GET /{life-events-id}/photos

링크

사용 중단된 엔드포인트

v8.0 이상에서 사용 중단됩니다.

• GET /{link-id}/reactions

라이브 방송

사용 중단된 엔드포인트

v8.0 이상에서 사용 중단됩니다.

• GET /{live-video-id}/likes

GET /{live-video-id}/reactions 엔드포인트를 사용하여 LiveVideo의 좋아요를 가져옵니다.

save_vod 매개변수

v8.0 이상에 적용됩니다. 2020년 11월 2일에 모든 버전에 적용됩니다.

save_vod 매개변수는 다음 에지에 대해 사용이 중단됩니다.

• POST /{user_id}/live_videos
• POST /{group_id}/live_videos
• POST /{page_id}/live_videos
• POST /{event_id}/live_videos

Messenger 플랫폼

사용 중단된 엔드포인트

v8.0 이상에서 사용 중단됩니다.

• GET /{page-id}/thread_settings
• POST /{page-id}/thread_settings
• DELETE /{page-id}/thread_settings

앱 검수

모든 버전에 적용됩니다.

Messenger의 앱 검수는 앱 대시보드의 제품 > Messenger > 설정에서 앱 검수로 이동되었습니다. Messenger 전용 권한인 pages_messaging, pages_user_gender, pages_user_locale 및 pages_user_timezone을 요청하려면 앱 검수 > 권한 및 기능으로 가세요. 자세한 내용은 Messenger 앱 검수 문서를 참조하세요.

Messenger 프로필 에지

v8.0 이상에 적용됩니다.

중첩된 고정 메뉴 유형이 POST /{page-id}/messenger_profile에서 사용 중단되었습니다.

새로운 기능: Messenger for Shops

v8.0 이상에 적용됩니다.

Messenger for Shops에서 제품의 발송과 수신을 지원합니다. 여기에는 메시지에서 제품을 보낼 수 있는 제품 템플릿, 제품 템플릿을 사용한 메시지와 Facebook Shops 제품 상세 정보 페이지에서 보내는 메시지용 Webhooks, 제품이 포함된 메시지용 echo Webhooks가 포함됩니다.

• GET /{message_id}/access_requests
• POST {page_id}/message
• message_echo Webhook
• messages Webhook

네이티브 쿠폰

사용 중단된 엔드포인트

v8.0 이상에서 사용 중단됩니다.

• GET /{native-offer-id}/nativeofferviews?photos

오픈 그래프

사용 중단된 엔드포인트

v8.0 이상에서 사용 중단됩니다. 2020년 11월 2일에 모든 버전에서 사용 중단됩니다.

• GET /{open-graph-action-id}/comments
• POST /{open-graph-action-id}/comments

페이지

사용 중단된 엔드포인트

v8.0 이상에서 사용 중단됩니다.

• DELETE /{page-id}/tabs
• GET /{group-id}/posts
• GET /{page-id}/place_topics
• GET /{page-about-story-id}
• POST /{page-about-story-id}
• POST /{page-id}/page_about_story

페이지 게시물

모든 버전에서 사용 중단됩니다.

페이지 게시물 댓글 ID 형식인 {page-id}_{post_id}_{comment-id}는 사용 중단되었습니다. 대신 {pagepost-id}_{comment-id} 형식을 사용하세요.

사진

사용 중단된 엔드포인트

모든 버전에서 사용 중단됩니다.

• GET /{photo-id}/sharedposts

장소

사용 중단된 엔드포인트

v8.0 이상에서 사용 중단됩니다.

• GET /{place-information-id}(수정 사항 참조)

게시물

사용 중단된 엔드포인트

v8.0 이상에서 사용 중단됩니다. 2020년 11월 2일에 모든 버전에서 사용 중단됩니다.

• GET /{post-id}/likes

게시물의 좋아요를 가져오려면 GET /post/reactions 엔드포인트를 사용하세요.

검색

사용 중단된 엔드포인트

v8.0 이상에서 사용 중단됩니다. 2020년 11월 2일에 모든 버전에서 사용 중단됩니다.

• GET /search?type=place
• GET /search?type=audience_interest

보안 설정

사용 중단된 필드

v8.0 이상에서 사용 중단됩니다. 2020년 11월에 모든 버전에서 사용 중단됩니다.

• secure_browsing

소셜 플러그인

Facebook oEmbed 엔드포인트

이 변경 사항은 2020년 10월 24일 이후에는 모든 버전에 적용됩니다.

앱에서 공개 Facebook 게시물과 동영상의 포함(embed) HTML을 가져올 수 있는 Facebook oEmbed 엔드포인트는 2020년 10월 24일에 사용이 중단됩니다. 새로 도입된 세 가지 엔드포인트는 사용이 중단되는 이전 엔드포인트와 동일한 기능을 제공합니다.

• GET /oembed_page
• GET /oembed_post
• GET /oembed_video

새로운 엔드포인트는 액세스 토큰이 필요하고 요청에는 사용 제한이 적용됩니다. 자세한 사용 방법과 정보는 새로운 oEmbed 엔드포인트 문서를 참조하세요.

사용자

사용 중단된 엔드포인트

v8.0 이상에서 사용 중단됩니다.

• GET /{user-id}/taggable_friends

사용 중단된 필드

v8.0 이상에서 사용 중단됩니다. 2020년 11월에 모든 버전에서 사용 중단됩니다.

• security_settings
• test_group
• viewer_can_send_gift
• is_shared_login

모든 버전에서 사용 중단됩니다.

• can_review_measurement_request
• is_famedeeplinkinguser

재인증

이 변경 사항은 모든 버전에 적용됩니다.

2020년 10월 24일부터 다음의 필드는 90일 이상 사용하지 않으면 데이터 액세스 재인증이 필요합니다.

• is_eligible_promo
• payment_mobile_pricepoint
• payment_pricepoints

사용자 사진

2020년 10월 24일부터 모든 버전에 적용됩니다.

2020년 10월 24일부터 GET /{user-id}/picture 엔드포인트(GET /{user-id}?fields=picture)가 토큰 없이 요청을 보내려면 앱 범위 사용자 ID(ASID)가 필요합니다. ASID 외에 다른 ID로 사용자를 쿼리하려면 요청에 앱, 클라이언트 또는 사용자 액세스 토큰을 포함해야 합니다. 자세한 내용은 사용자 사진 참고 자료를 참조하세요.

동영상 질문

사용 중단된 엔드포인트

v8.0 이상에서 사용 중단됩니다.

• GET /{question-id}
• GET /{question-id}/options
• GET /{question-id}/votes
• GET /{question-option-id}

Workplace

사용 중단된 엔드포인트

v8.0 이상에서 사용 중단됩니다. 2020년 11월 2일에 모든 버전에서 사용 중단됩니다.

• GET /{company-id}/access_requests
• GET /access_requests

마케팅 API

2020년 8월 4일에 출시됨 | 이용 가능 기한: 2021년 5월 4일 | 블로그 게시물

광고 계정

사용 중단된 엔드포인트

v8.0 이상에서 사용 중단됩니다.

• GET /AdReportSchedule
• DELETE act_{ad-account-id}/adsets

권한

v8.0 이상에 적용됩니다. 2020년 11월 2일에 모든 버전에 적용됩니다.

앱이 광고 계정의 비즈니스 필드에 액세스하려면 세분화된 권한이 필요합니다. 권한은 특정 비즈니스 개체에 부여해야 합니다.

소재 맞춤화 규칙

검증

v8.0 이상에 적용됩니다.

asset_feed_spec을 사용하는 모든 광고는 타겟 맞춤화 규칙을 2개 이상 포함해야 합니다. 크리에이티브가 asset_feed_spec을 사용하고 규칙을 2개 미만으로 포함할 경우 해당 광고를 생성할 수 없습니다.

이 변경 사항은 노출 위치 자산 맞춤화, 다언어 광고 및 세그먼트 자산 맞춤화에 적용됩니다.

세그먼트 소재 맞춤화

v8.0 이상에 적용됩니다. 2020년 11월 2일에 모든 버전에 적용됩니다.

위치 정보와 관련이 없는 모든 사용 사례는 세그먼트 소재 맞춤화 사용자에 대해 사용 중단되었습니다. 이번 변경 사항 이후로 모든 타게팅 규칙은 맞춤화 사양 안에 위치 정보를 포함해야 합니다. 기본 규칙에 위치 정보를 포함하지 않아도 되는 예외가 한 가지 있습니다.

입찰

타겟 비용 입찰 전략

v8.0 이상에 적용됩니다.

TARGET_COST 입찰 전략이 사용 중단되었습니다. 비용 관리를 유지하려면 비용 한도 입찰을 사용하는 것이 좋습니다. 모든 사용 가능한 입찰 전략을 참조하세요.

비즈니스 관리자

사용 중단된 엔드포인트

v8.0 이상에서 사용 중단됩니다.

• GET{system-user-id}/updated_by

공유 동의 엔드포인트 재도입

모든 버전에 적용됩니다.

다음 엔드포인트가 다시 도입되었습니다.

• /{business-id}/received_sharing_agreements
• /{business-id}/initiated_sharing_agreements

두 엔드포인트는 그래프 API V6.0이 출시되면서 사용 중단되었습니다.

캔버스

사용 중단된 엔드포인트

• /{canvas-id}/collection_hero_image
• /{canvas-id}/collection_hero_video
• /{canvas-id}/collection_thumbnails

카탈로그 API

권한

v8.0 이상에 적용됩니다. 2021년 1월 31일부터 모든 버전에 적용됩니다.

이제 제품 카탈로그 엔드포인트에 액세스하는 데 ads_management 권한이 필요하지 않습니다. 향후에는 이 엔드포인트를 호출하려면 catalog_management 권한이 필요합니다. 최근 90일 이내에 ads_management를 통해 카탈로그 엔드포인트에 액세스한 개발자는 2020년 8월 14일까지 catalog_management 권한으로 자동 마이그레이션됩니다.

지금부터 2021년 2월 28일까지는 이전 버전의 API를 사용하는 개발자가 ads_management 권한으로 제품 카탈로그 엔드포인트를 호출할 수 있습니다. v8.0을 사용하고 있다면 catalog_management 권한이 있어야 합니다.

2월로 예정된 기한이 지나면 catalog_management 권한이 ads_management와 연결되지 않으므로 사용자가 앱에 catalog_management 권한을 명시적으로 부여해야 합니다.

인증

v8.0 이상에 적용됩니다. 2020년 11월 2일에 모든 버전에 적용됩니다.

[업데이트] 다음의 카탈로그 API 엔드포인트는 2단계 인증 비즈니스 설정을 준수합니다. 카탈로그를 소유한 비즈니스가 현재 앱 사용자에게 2단계 인증을 요구하고 앱 사용자가 2단계 인증을 통해 인증을 받지 않았을 경우, 이 엔드포인트를 호출하는 앱에 오류가 발생합니다.

현재 앱 사용자가 파트너 비즈니스를 통해 카탈로그에 액세스한다면 Facebook에서는 파트너 비즈니스 관리자의 인증 요구 사항을 준수합니다. 시스템 사용자는 2단계 인증을 통해 인증할 필요가 없습니다.

• POST /{business-id}/owned_product_catalogs
• POST /{destination-id}
• POST /{home-listing-id}
• DELETE /{home-listing-id}
• POST /{hotel-id}
• DELETE /{hotel-id}
• POST /{hotel-id}/hotel_rooms
• POST /{hotel-room-id}
• DELETE /{hotel-room-id}
• POST /{page-id}/product_catalogs
• POST /{product-catalog-id}
• DELETE /{product-catalog-id}
• POST /{product-catalog-id}/agencies
• DELETE /{product-catalog-id}/agencies
• POST /{product-catalog-id}/assigned_users
• DELETE /{product-catalog-id}/assigned_users
• POST /{product-catalog-id}/batch
• POST /{product-catalog-id}/categories
• POST /{product-catalog-id}/destinations
• POST /{product-catalog-id}/external_event_sources
• DELETE /{product-catalog-id}/external_event_sources
• POST /{product-catalog-id}/flights
• POST /{product-catalog-id}/home_listings
• POST /{product-catalog-id}/hotel_rooms_batch
• POST /{product-catalog-id}/hotels
• POST /{product-catalog-id}/items_batch
• /{product-catalog-id}/pricing_variables_batch
• POST /{product-catalog-id}/product_groups
• POST /{product-catalog-id}/product_feeds
• POST /{product-catalog-id}/product_sets
• POST /{product-catalog-id}/products
• POST /{product-catalog-id}/vehicles
• POST /{product-feed-rule-id}
• DELETE /{product-feed-rule-id}
• POST /{product-feed-id}
• DELETE /{product-feed-id}
• POST /{product-feed-id}/rules
• POST /{product-feed-id}/uploads
• POST /{product-feed-id}/upload_schedules
• POST /{product-feed-schedule-id}
• DELETE /{product-feed-schedule-id}
• POST /{product-feed-upload-id}/error_report
• POST /{product-group-id}
• DELETE /{product-group-id}
• POST /{product-group-id}/products
• POST /{product-item-id}
• DELETE /{product-item-id}
• POST /{product-set-id}
• DELETE /{product-set-id}
• POST /{vehicle-id}

보고

사용 중단

v8.0 이상에 적용됩니다.

• GET /{ad-study-id}?fields=split_test_config
• GET /{ad-study-id}?fields=iterative_split_test_config

타게팅

사용 중단

v8.0 이상에 적용됩니다.

• GET /search?type=adzipcode

수정 사항

• 2020년 9월 28일 — 명확성을 높이기 위해 카탈로그 API 인증 항목을 업데이트했습니다.
• 2020년 10월 23일 — 카탈로그 API 항목을 업데이트했습니다.

  • 이전 버전의 API를 사용하는 개발자가 ads_management 권한으로 제품 카탈로그 엔드포인트를 호출할 수 있는 기한을 연장했습니다. 새로운 기한은 2021년 2월 28일입니다.
  • 시스템 사용자 인증에 대한 명확한 설명을 추가했습니다.
• 2021년 5월 17일 — 사용 중단된 엔드포인트를 GET /{place-id}에서 GET /{place-information-id}로 변경했습니다. GET /{place-id}는 사용 중단되지 않았습니다.