版本 8.0

Graph API

發佈日期：2020 年 8 月 4 日 | 停用日期：2022 年 11 月 1 日 | 網誌文章

存取憑證

已停用端點

已在 v8.0 版及以上版本中停用。於 2020 年 11 月 2 日起在所有版本中停用。

• GET /token_deprecation_check

相簿

已恢復端點

適用於所有版本。

• GET /{album-id}/likes

應用程式配置

應用程式類型

此變更適用於所有版本。

新建立的應用程式現可選擇應用程式類型：商業、遊戲或無。如此一來，系統便可根據所選類型移除不當的權限和功能，從而簡化應用程式審查介面。此外，屬於商業類型的應用程式可使用新的授權機制，不再使用模式，並可享用一項新功能。詳情請參閱商業應用程式變更記錄條目。

商業應用程式

此外，屬於商業類型的應用程式可使用一個名為存取權限級別的全新授權機制。存取權限級別會取代開發模式和已發佈模式所提供的功能（企業應用程式已移除此等模式），並可使應用程式審查流程變得更加簡單易用。此外，我們亦推出了全新的商家資產用戶個人檔案存取功能，以便商業應用程式讀取用戶的一小部分公開用戶欄位。下文將會詳細講解這些變更。

存取權限級別

適用於所有版本。

存取權限級別是 Graph API 為商業應用程式而推出的全新授權機制，可用於授予單個權限和功能。標準存取權限只允許存取以下用戶擁有的資料：擁有應用程式角色，或於已認領應用程式的企業中擁有角色的用戶。Advanced Access 可允許存取所有應用程式用戶的資料，但應用程式需要接受應用程式審查。商業應用程式會自動獲授予標準存取權限，可以使用適用於此類型應用程式的所有權限和功能。

移除開發模式和已發佈模式

適用於所有版本。

商業應用程式的開發模式和已發佈模式現已移除。這些模式已由存取權限級別取代；後者能提供同樣的功能，而且功能更全面。由於商業應用程式擁有所有可用權限和功能之標準存取權限，任何擁有應用程式角色的用戶，或在已認領應用程式的企業中擁有角色的用戶均可隨時向應用程式授予任何可用權限。如此一來，當應用程式處於開發模式時，便無需接受應用程式審查或切換模式。

全新的商家資產用戶個人檔案存取功能

適用於所有版本。

有了全新的商家資產用戶個人檔案存取功能，商業應用程式便能讀取用戶的一小部分公開用戶欄位，前提是用戶必須曾與已認領應用程式的企業所擁有的資產互動。請參閱商家資產用戶個人檔案存取功能參考資料，以獲取可讀取用戶欄位的清單。

回應

已恢復端點

適用於所有版本。

• 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 端點經已推出。此端點的功能與 Instagram 的舊版 oEmbed 端點相同，而舊版 oEmbed 端點於 2020 年 10 月 24 日停用。這個新端點需要使用存取憑證，因此您需要有 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 端點來獲取直播視像的讚好數量。

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 商店商品詳情頁面訊息的 Webhooks，以及適用於內含商品之訊息的回應 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

專頁帖子

已在所有版本中停用。

專頁帖子回應編號格式{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 oEmbed 端點於 2020 年 10 月 24 日起停用，此端點可允許應用程式獲取公開 Facebook 帖子或影片的內嵌 HTML。我們推出了 3 個新的端點以取代以下現有端點，這些端點可提供與現有端點相同的功能：

• 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）的無憑證要求需要使用應用程式範圍用戶編號（ASID）。如果您向用戶查詢時未有提供 ASID，則必須在要求中包含應用程式、用戶端或用戶存取憑證。詳情請參閱用戶相片參考資料。

影片問題

已停用端點

已在 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 的廣告都必須最少包含兩項目標設定自訂規則。如果廣告創意使用了 asset_feed_spec，但是其包含的規則少於兩項，您將無法建立廣告。

此變更將會影響版位自訂素材、多語言廣告和族群自訂素材。

族群自訂素材

適用於 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

我們先前在推出 Graph 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 端點現在需要遵循雙重驗證企業管理平台設定。如果擁有目錄的企業要求目前應用程式用戶進行雙重驗證，而該用戶沒有透過雙重驗證來驗證身分，則呼叫此端點的所有應用程式都會收到錯誤。

如果目前應用程式用戶可以透過合作夥伴企業存取目錄，則我們會遵循該合作夥伴的企業管理平台身分驗證要求。系統用戶無需透過雙重驗證來驗證身分。

• 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} 端點尚未被停用。