第 8.0 版

圖形 API

發佈日期：2020 年 8 月 4 日 | 有效期限：2022 年 11 月 1 日 | 部落格文章

存取權杖

已停用的端點

在 8.0 以上版本中已停用。將於 2020 年 11 月 2 日在所有版本中停用。

• GET /token_deprecation_check

相簿

已恢復的端點

適用於所有版本。

• GET /{album-id}/likes

應用程式設定

應用程式類型

這項變更適用於所有版本。

新建立的應用程式現可選擇應用程式類型：企業、遊戲或無。如此可根據所選類型移除不當的權限和功能，進而簡化應用程式審查介面。此外，歸類為企業應用程式的應用程式會使用新的授權機制而不再使用模式，並擁有存取新功能的權限。如需詳細資料，請參閱企業應用程式變更紀錄項目。

商業應用程式

歸類為企業應用程式的應用程式會使用新的授權機制，名為存取層級。存取層級取代開發模式和上線模式所提供的功能，系統已在企業應用程式中移除此兩種模式，讓應用程式審查程序更簡單且更直覺化。此外，我們也已發佈企業資產用戶個人檔案存取權限新功能，可讓企業應用程式讀取一小組公開的用戶欄位。以下詳細說明這些變更。

存取權限層級

適用於所有版本。

存取層級是企業應用程式專用的全新圖形 API 授權機制，適用於個別的權限和功能。標準存取僅允許存取擁有該應用程式且具應用程式角色或企業角色之用戶所擁有的資料。進階存取允許存取任何應用程式用戶所擁有的資料，但需要應用程式審查。企業應用程式會針對適用於其類型的所有權限和功能的標準存取進行自動授予。

開發和上線模式移除

適用於所有版本。

系統已移除歸類為企業應用程式之應用程式的開發模式和上線模式。此兩種模式已由存取層級（可提供相同功能且更具多功能性）所取代，因為企業應用程式可對所有可用權限和功能進行標準存取，任何擁有該應用程式且具應用程式角色或企業角色的用戶，皆可隨時授予該應用程式任何可用權限。如此可免除應用程式審查或開發過程中在模式之間切換的必要性。

企業資產用戶個人檔案存取權限新功能

適用於所有版本。

只要用戶已與擁有該應用程式之企業所擁有的資產進行互動，企業資產用戶個人檔案存取權限新功能即可讓該企業應用程式讀取一小組公開的用戶欄位。如需可讀取用戶欄位的清單，請參閱企業資產用戶個人檔案存取權限參考資料。

留言

已恢復的端點

適用於所有版本。

• GET /{comment-id}/likes

裝置

已停用的端點

在 8.0 以上版本中已停用。將於 2020 年 11 月 2 日在所有版本中停用。

• POST /device/share

社團

已停用的端點

在 8.0 以上版本中已停用。

• GET /{group-id}/posts

在 8.0 以上版本中已停用。將於 2020 年 11 月 2 日在所有版本中停用。

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

Instagram

新的 Instagram oEmbed 端點

適用於所有版本。

我們已推出新的 GET /instagram_oembed 端點，其提供的功能與 Instagram 舊版 oEmbed 端點所提供的相同，該舊版端點將於 2020 年 10 月 24 日停用。新端點需要存取權杖，因此您需要 Facebook 開發人員帳號和已註冊的應用程式才能加以存取。如需使用方式指示和其他詳細資訊，請參閱 Instagram oEmbed 文件。

生活要事

已停用的端點

在 8.0 以上版本中已停用。

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

連結

已停用的端點

在 8.0 以上版本中已停用。

• GET /{link-id}/reactions

直播視訊

已停用的端點

在 8.0 以上版本中已停用。

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

請使用 GET /{live-video-id}/reactions 端點取得直播視訊上的讚。

save_vod 參數

適用於 8.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 開放平台

已停用的端點

在 8.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 個人檔案關係連線

適用於 8.0 以上版本。

系統已停用 POST /{page-id}/messenger_profile 的巢狀常駐功能表類型。

新功能：Messenger for Shops

適用於 8.0 以上版本。

可在 Messenger for Shops 上支援傳送和接收產品，包括可用於在訊息中傳送產品的產品範本、Facebook 商店產品詳細資訊頁面中包含產品範本和訊息的訊息 Webhooks，以及包含產品的訊息 echo Webhooks。

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

原生優惠

已停用的端點

在 8.0 以上版本中已停用。

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

開放社交關係圖

已停用的端點

在 8.0 以上版本中已停用。將於 2020 年 11 月 2 日在所有版本中停用。

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

粉絲專頁

已停用的端點

在 8.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

粉絲專頁貼文

已在所有版本中停用。

粉絲專頁貼文留言編號格式，{page-id}_{post_id}_{comment-id} 已停用，請改用 {pagepost-id}_{comment-id} 格式。

相片

已停用的端點

已在所有版本中停用。

• GET /{photo-id}/sharedposts

地標

已停用的端點

在 8.0 以上版本中已停用。

• GET /{place-information-id}（請參閱修正）

貼文

已停用的端點

在 8.0 以上版本中已停用。將於 2020 年 11 月 2 日在所有版本中停用。

• GET /{post-id}/likes

請使用 GET /post/reactions 端點取得貼文上的讚。

搜尋

已停用的端點

在 8.0 以上版本中已停用。將於 2020 年 11 月 2 日在所有版本中停用。

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

帳號安全設定

已停用的欄位

在 8.0 以上版本中已停用。將於 2020 年 11 月在所有版本中停用。

• secure_browsing

社交外掛程式

Facebook oEmbed 端點

此變更將於 2020 年 10 月 24 日套用至所有版本。

Facebook oEmbed 端點允許應用程式取得公開 Facebook 貼文和影片的內嵌 HTML，將於 2020 年 10 月 24 日停用。我們已推出三個新端點，其提供的功能與即將取代之舊端點所提供的相同：

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

新端點需要存取權杖，且將受到限速。如需使用方式詳細資料和其他資訊，請參閱新 oEmbed 端點文件。

用戶

已停用的端點

在 8.0 以上版本中已停用。

• GET /{user-id}/taggable_friends

已停用的欄位

在 8.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）將需要應用程式範圍用戶編號（ASID）來進行無權杖要求。如果使用非 ASID 查詢用戶，必須在要求中包含應用程式、用戶端或用戶存取權杖。如需詳細資料，請參閱用戶圖片參考資料。

影片問題

已停用的端點

在 8.0 以上版本中已停用。

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

Workplace

已停用的端點

在 8.0 以上版本中已停用。將於 2020 年 11 月 2 日在所有版本中停用。

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

行銷 API

發佈日期：2020 年 8 月 4 日 | 有效期限：2021年 5 月 4 日 | 部落格文章

廣告帳號

已停用的端點

在 8.0 以上版本中已停用。

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

權限

適用於 8.0 以上版本。將於 2020 年 11 月 2 日套用至所有版本。

應用程式需要細項權限來存取廣告帳號的企業欄位。您應將權限授予特定企業物件。

素材客製化規則

驗證

適用於 8.0 以上版本。

所有使用 asset_feed_spec 的廣告必須包含至少兩個目標客製化規則。如果您的廣告創意使用 asset_feed_spec 且包含不到兩個規則，您將無法建立該廣告。

此變更影響（廣告）版位素材客製化、多國語言廣告，以及族群素材客製化。

族群素材客製化

適用於 8.0 以上版本。將於 2020 年 11 月 2 日套用至所有版本。

所有與地理位置不相關的使用案例已針對族群素材客製化用戶停用。在此變更後，所有目標設定規則必須包含其客製化規格中的地理位置資訊。預設規則存在例外狀況，亦即不需要包含地理位置。

出價

目標成本出價策略

適用於 8.0 以上版本

TARGET_COST 出價策略已停用。若要繼續控制成本，建議使用成本上限出價。請查看全部可用的出價策略。

企業管理平台

已停用的端點

在 8.0 以上版本中已停用。

• GET{system-user-id}/updated_by

重新推出的分享協議端點

適用於所有版本

我們已重新推出以下端點：

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

當圖形 API 第 6.0 版推出時，以上兩個端點在先前皆已停用。

全螢幕互動廣告

已停用的端點

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

目錄 API

權限

適用於 8.0 以上版本。將於 2021 年 1 月 31 日套用至所有版本。

您不再需要 ads_management 權限來存取商品目錄端點。今後，您將需要 catalog_management 權限來呼叫這些端點。過去 90 天內曾透過 ads_management 存取目錄端點的開發人員，系統會在 2020 年 8 月 14 日之前自動將其移轉至 catalog_management 權限。

即日起至 2021 年 2 月 28 日，使用舊版 API 的開發人員仍可使用 ads_management 權限呼叫商品目錄端點。如果您使用第 8.0 版，必須擁有 catalog_management 權限。

在 2 月期限之後，catalog_management 權限將不再與 ads_management 產生關聯，因此用戶必須明確授予應用程式 catalog_management 權限。

驗證

適用於 8.0 以上版本。將於 2020 年 11 月 2 日套用至所有版本。

[已更新] 以下目錄 API 端點現在採用雙重驗證企業設定。如果擁有目錄的企業需要現有應用程式用戶的雙重驗證，且該應用程式用戶尚未透過雙因素進行驗證，則呼叫此端點的任何應用程式都將收到錯誤。

當現有應用程式用戶透過合作夥伴企業存取目錄時，我們採用合作夥伴企業管理平台的驗證要求。系統用戶不需透過雙因素進行驗證。

• 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}

分析報告

停用

適用於 8.0 以上版本

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

目標設定

停用

適用於 8.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} 未停用。