Phiên bản 8.0

API Đồ thị

Ngày phát hành 04/08/2020 | Ngày hết hạn 01/11/2022 | Bài viết trên blog

Mã truy cập

Điểm cuối đã ngừng hoạt động

Đã ngừng hoạt động trong phiên bản 8.0 trở lên. Sẽ ngừng hoạt động trên tất cả phiên bản kể từ ngày 02/11/2020.

• GET /token_deprecation_check

Album

Điểm cuối đã được khôi phục

Áp dụng cho tất cả phiên bản.

• GET /{album-id}/likes

Cấu hình ứng dụng

Loại ứng dụng

Sự thay đổi này áp dụng cho tất cả các phiên bản.

Đối với các ứng dụng mới tạo, bạn hiện có thể chọn Loại ứng dụng: Kinh doanh, Chơi game hoặc Không có. Điều này giúp đơn giản hóa giao diện Xét duyệt ứng dụng nhờ việc gỡ bỏ các Tính năng và Quyền không phù hợp dựa trên loại ứng dụng đã chọn. Ngoài ra, các ứng dụng thuộc loại Ứng dụng kinh doanh sử dụng cơ chế ủy quyền mới (thay vì các chế độ) và có quyền truy cập vào Tính năng mới. Hãy xem mục Ứng dụng kinh doanh trong nhật ký thay đổi để biết chi tiết.

Ứng dụng kinh doanh

Các ứng dụng thuộc loại Ứng dụng kinh doanh sử dụng một cơ chế ủy quyền mới có tên là Cấp độ truy cập. Cấp độ truy cập thay cho chức năng của Chế độ phát triển và Chế độ chính thức (đã bị gỡ đối với Ứng dụng kinh doanh), nhờ đó quy trình Xét duyệt ứng dụng trở nên đơn giản và trực quan hơn. Ngoài ra, chúng tôi đã phát hành tính năng mới có tên Quyền truy cập vào trang cá nhân của người dùng trong tài sản doanh nghiệp để Ứng dụng kinh doanh có thể đọc một số ít các trường thông tin công khai của Người dùng. Các thay đổi này được mô tả chi tiết hơn ở bên dưới.

Cấp độ truy cập

Áp dụng cho tất cả phiên bản.

Cấp độ truy cập là cơ chế ủy quyền mới của API Đồ thị dành cho Ứng dụng kinh doanh. Cơ chế này được áp dụng cho từng Quyền và Tính năng cụ thể. Quyền truy cập tiêu chuẩn chỉ cho phép truy cập vào dữ liệu thuộc sở hữu của người dùng có Vai trò trên ứng dụng hoặc Vai trò trong Doanh nghiệp đã xác nhận ứng dụng. Quyền truy cập nâng cao cho phép truy cập vào dữ liệu thuộc sở hữu của bất kỳ người dùng ứng dụng nào, nhưng yêu cầu phải Xét duyệt ứng dụng. Ứng dụng kinh doanh sẽ tự động được cấp Quyền truy cập tiêu chuẩn để mọi Quyền và Tính năng đều được cung cấp cho Loại ứng dụng kinh doanh.

Gỡ Chế độ phát triển và Chế độ chính thức

Áp dụng cho tất cả phiên bản.

Chúng tôi đã gỡ Chế độ phát triển và Chế độ chính thức đối với các ứng dụng thuộc loại Ứng dụng kinh doanh. Chúng tôi thay thế các chế độ này bằng Cấp độ truy cập để tăng tính linh hoạt mà vẫn duy trì chức năng tương tự. Vì Ứng dụng kinh doanh có Cấp độ truy cập tiêu chuẩn cho mọi Quyền và tính năng có sẵn, nên người dùng có Vai trò trên ứng dụng hoặc Vai trò trong Doanh nghiệp đã xác nhận ứng dụng có thể cấp Quyền có sẵn cho ứng dụng bất cứ lúc nào. Nhờ vậy, ứng dụng không cần phải trải qua quy trình Xét duyệt ứng dụng hoặc không phải chuyển đổi giữa các chế độ trong quá trình phát triển.

Tính năng mới Quyền truy cập vào trang cá nhân của người dùng trong tài sản doanh nghiệp

Áp dụng cho tất cả phiên bản.

Với tính năng mới Quyền truy cập vào trang cá nhân của người dùng trong tài sản doanh nghiệp, Ứng dụng kinh doanh có thể đọc một số ít các Trường thông tin công khai của Người dùng, miễn là Người dùng này đã tương tác với tài sản thuộc quyền sở hữu của Doanh nghiệp đã xác nhận ứng dụng. Hãy xem tài liệu tham khảo về Quyền truy cập vào trang cá nhân của người dùng trong tài sản doanh nghiệp để biết danh sách các Trường thông tin có thể đọc được của người dùng.

Bình luận

Điểm cuối đã được khôi phục

Áp dụng cho tất cả phiên bản.

• GET /{comment-id}/likes

Thiết bị

Điểm cuối đã ngừng hoạt động

Đã ngừng hoạt động trong phiên bản 8.0 trở lên. Sẽ ngừng hoạt động trên tất cả phiên bản kể từ ngày 02/11/2020.

• POST /device/share

Nhóm

Điểm cuối đã ngừng hoạt động

Đã ngừng hoạt động trong phiên bản 8.0 trở lên.

• GET /{group-id}/posts

Đã ngừng hoạt động trong phiên bản 8.0 trở lên. Sẽ ngừng hoạt động trên tất cả phiên bản kể từ ngày 02/11/2020.

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

Instagram

Điểm cuối mới Instagram oEmbed

Áp dụng cho tất cả phiên bản.

Chúng tôi đã ra mắt một điểm cuối mới là GET /instagram_oembed. Điểm cuối này cung cấp chức năng tương tự như điểm cuối oEmbed cũ của Instagram (đã ngừng hoạt động kể từ ngày 24/10/2020). Điểm cuối mới này yêu cầu mã truy cập. Do đó, bạn cần có tài khoản Nhà phát triển trên Facebook và đăng ký ứng dụng để có thể truy cập vào điểm cuối đó. Hãy xem tài liệu về Instagram oEmbed để biết hướng dẫn về cách sử dụng và các thông tin chi tiết khác.

Sự kiện trong đời

Điểm cuối đã ngừng hoạt động

Đã ngừng hoạt động trong phiên bản 8.0 trở lên.

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

Liên kết

Điểm cuối đã ngừng hoạt động

Đã ngừng hoạt động trong phiên bản 8.0 trở lên.

• GET /{link-id}/reactions

Video trực tiếp

Điểm cuối đã ngừng hoạt động

Đã ngừng hoạt động trong phiên bản 8.0 trở lên.

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

Sử dụng điểm cuối GET /{live-video-id}/reactions để xem số lượt thích của Video trực tiếp.

Thông số save_vod

Áp dụng cho phiên bản 8.0 trở lên. Sẽ áp dụng cho tất cả phiên bản kể từ ngày 02/11/2020.

Thông số save_vod hiện không còn được dùng cho các cạnh sau:

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

Nền tảng Messenger

Điểm cuối đã ngừng hoạt động

Đã ngừng hoạt động trong phiên bản 8.0 trở lên.

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

Xét duyệt ứng dụng

Áp dụng cho tất cả phiên bản.

Quy trình Xét duyệt ứng dụng cho Messenger đã được chuyển từ phần Sản phẩm > Messenger > Cài đặt sang phần Xét duyệt ứng dụng trong bảng điều khiển ứng dụng. Để yêu cầu các quyền cụ thể cho Messenger (pages_messaging, pages_user_gender, pages_user_locale và pages_user_timezone), hãy truy cập vào phần Xét duyệt ứng dụng > Quyền và tính năng. Hãy xem tài liệu về quy trình Xét duyệt ứng dụng cho Messenger để biết thêm chi tiết.

Cạnh Trang cá nhân Messenger

Áp dụng cho phiên bản 8.0 trở lên.

Loại menu cố định lồng ghép không còn được dùng cho POST /{page-id}/messenger_profile.

Tính năng mới: Messenger dành cho Cửa hàng

Áp dụng cho phiên bản 8.0 trở lên.

Hỗ trợ gửi và nhận sản phẩm trên Messenger dành cho Cửa hàng. Trong đó có Mẫu sản phẩm có thể dùng để gửi sản phẩm trong tin nhắn, Webhook cho tin nhắn có mẫu sản phẩm và tin nhắn trên Trang chi tiết sản phẩm của Cửa hàng trên Facebook, cũng như Webhook trả về cho các tin nhắn có sản phẩm.

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

Ưu đãi trong quảng cáo tự nhiên

Điểm cuối đã ngừng hoạt động

Đã ngừng hoạt động trong phiên bản 8.0 trở lên.

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

Open Graph

Điểm cuối đã ngừng hoạt động

Đã ngừng hoạt động trong phiên bản 8.0 trở lên. Sẽ ngừng hoạt động trên tất cả phiên bản kể từ ngày 02/11/2020.

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

Trang

Điểm cuối đã ngừng hoạt động

Đã ngừng hoạt động trong phiên bản 8.0 trở lên.

• 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

Bài viết trên Trang

Đã ngừng hoạt động trên tất cả phiên bản.

Định dạng ID bình luận về Bài viết trên Trang ({page-id}_{post_id}_{comment-id}) không còn được dùng nữa. Thay vào đó, hãy sử dụng định dạng {pagepost-id}_{comment-id}.

Ảnh

Điểm cuối đã ngừng hoạt động

Đã ngừng hoạt động trên tất cả phiên bản.

• GET /{photo-id}/sharedposts

Địa điểm

Điểm cuối đã ngừng hoạt động

Đã ngừng hoạt động trong phiên bản 8.0 trở lên.

• GET /{place-information-id} (xem phần Sửa đổi)

Bài viết

Điểm cuối đã ngừng hoạt động

Đã ngừng hoạt động trong phiên bản 8.0 trở lên. Sẽ ngừng hoạt động trên tất cả phiên bản kể từ ngày 02/11/2020.

• GET /{post-id}/likes

Sử dụng điểm cuối GET /post/reactions để xem số lượt thích của bài viết.

Tìm kiếm

Điểm cuối đã ngừng hoạt động

Đã ngừng hoạt động trong phiên bản 8.0 trở lên. Sẽ ngừng hoạt động trên tất cả phiên bản kể từ ngày 02/11/2020.

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

Cài đặt bảo mật

Trường đã ngừng hoạt động

Đã ngừng hoạt động trong phiên bản 8.0 trở lên. Sẽ ngừng hoạt động trên tất cả phiên bản kể từ tháng 11/2020.

• secure_browsing

Plugin xã hội

Điểm cuối Facebook oEmbed

Thay đổi này sẽ áp dụng cho tất cả các phiên bản kể từ ngày 24/10/2020.

Điểm cuối Facebook oEmbed (cho phép ứng dụng lấy HTML nhúng cho các bài viết và video công khai trên Facebook) sẽ ngừng hoạt động kể từ ngày 24/10/2020. Chúng tôi đã ra mắt 3 điểm cuối mới có chức năng tương tự như các điểm cuối cũ được thay thế:

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

Các điểm cuối mới này đòi hỏi phải có Mã truy cập và các yêu cầu phải tuân theo giới hạn tốc độ. Vui lòng tham khảo tài liệu về điểm cuối oEmbed mới để biết chi tiết về cách sử dụng và các thông tin khác.

Người dùng

Điểm cuối đã ngừng hoạt động

Đã ngừng hoạt động trong phiên bản 8.0 trở lên.

• GET /{user-id}/taggable_friends

Trường đã ngừng hoạt động

Đã ngừng hoạt động trong phiên bản 8.0 trở lên. Sẽ ngừng hoạt động trên tất cả phiên bản kể từ tháng 11/2020.

• security_settings
• test_group
• viewer_can_send_gift
• is_shared_login

Đã ngừng hoạt động trên tất cả phiên bản.

• can_review_measurement_request
• is_famedeeplinkinguser

Ủy quyền lại

Sự thay đổi này áp dụng cho tất cả phiên bản.

Kể từ ngày 24/10/2020, các trường thông tin sau đây phải trải qua quy trình Ủy quyền lại quyền truy cập vào dữ liệu sau 90 ngày không hoạt động:

• is_eligible_promo
• payment_mobile_pricepoint
• payment_pricepoints

Ảnh người dùng

Áp dụng cho tất cả các phiên bản vào ngày 24/10/2020.

Kể từ ngày 24/10/2020, điểm cuối GET /{user-id}/picture (GET /{user-id}?fields=picture) sẽ đòi hỏi các yêu cầu không có mã phải có ID người dùng trong ứng dụng (ASID). Nếu truy vấn Người dùng bằng mã không phải là mã ASID, yêu cầu của bạn phải có Mã truy cập ứng dụng, máy khách hoặc người dùng. Hãy xem tài liệu tham khảo về Ảnh người dùng để biết thông tin chi tiết.

Câu hỏi về video

Điểm cuối đã ngừng hoạt động

Đã ngừng hoạt động trong phiên bản 8.0 trở lên.

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

Workplace

Điểm cuối đã ngừng hoạt động

Đã ngừng hoạt động trong phiên bản 8.0 trở lên. Sẽ ngừng hoạt động trên tất cả phiên bản kể từ ngày 02/11/2020.

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

API Marketing

Ngày phát hành 04/08/2020 | Ngày hết hạn 04/05/2021 | Bài viết trên blog

Tài khoản quảng cáo

Điểm cuối đã ngừng hoạt động

Đã ngừng hoạt động trong phiên bản 8.0 trở lên.

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

Quyền

Áp dụng cho phiên bản 8.0 trở lên. Sẽ áp dụng cho tất cả phiên bản kể từ ngày 02/11/2020.

Ứng dụng cần có quyền truy cập tiểu tiết để truy cập vào các trường thông tin kinh doanh của một Tài khoản quảng cáo. Các quyền nên được cấp cho một Đối tượng kinh doanh cụ thể.

Quy tắc tùy chỉnh tài sản

Xác thực

Áp dụng cho phiên bản 8.0 trở lên.

Mọi quảng cáo sử dụng asset_feed_spec phải chứa ít nhất 2 quy tắc tùy chỉnh mục tiêu. Nếu nội dung của bạn sử dụng asset_feed_specvà bao gồm dưới 2 quy tắc, bạn sẽ không thể tạo quảng cáo đó.

Sự thay đổi này ảnh hưởng đến phương thức Tùy chỉnh tài sản theo vị trí quảng cáo, Quảng cáo bằng nhiều ngôn ngữ và Tùy chỉnh phân khúc tài sản.

Tùy chỉnh phân khúc tài sản

Áp dụng cho phiên bản 8.0 trở lên. Sẽ áp dụng cho tất cả phiên bản kể từ ngày 02/11/2020.

Mọi trường hợp sử dụng không liên quan đến vị trí địa lý đã bị ngừng đối với người dùng phương thức Tùy chỉnh phân khúc tài sản. Với sự thay đổi này, mọi quy tắc nhắm mục tiêu đều phải có thông số tùy chỉnh chứa thông tin về vị trí địa lý. Tuy nhiên, riêng quy tắc mặc định không cần phải bao gồm thông tin về vị trí địa lý.

Đặt giá thầu

Chiến lược giá thầu chi phí mục tiêu

Áp dụng cho phiên bản 8.0 trở lên

Chiến lược giá thầu TARGET_COST không còn được dùng nữa. Để tiếp tục kiểm soát chi phí, bạn nên sử dụng chiến lược đặt giá thầu giới hạn chi phí. Xem tất cả các chiến lược giá thầu hiện có.

Trình quản lý kinh doanh

Điểm cuối đã ngừng hoạt động

Đã ngừng hoạt động trong phiên bản 8.0 trở lên.

• GET{system-user-id}/updated_by

Các điểm cuối thỏa thuận chia sẻ đã được ra mắt lại

Áp dụng cho tất cả các phiên bản

Chúng tôi đã ra mắt lại các điểm cuối sau đây:

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

Cả 2 điểm cuối này đã ngừng hoạt động trước đó khi API Đồ thị phiên bản 6.0 ra mắt.

Canvas

Điểm cuối đã ngừng hoạt động

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

API Danh mục

Quyền

Áp dụng cho phiên bản 8.0 trở lên. Sẽ áp dụng cho tất cả các phiên bản kể từ ngày 31/01/2021.

Để truy cập vào điểm cuối danh mục sản phẩm, bạn không cần quyền ads_management nữa. Từ giờ trở đi, bạn sẽ cần quyền catalog_management để gọi các điểm cuối đó. Những nhà phát triển có quyền truy cập vào điểm cuối danh mục thông qua ads_management trong 90 ngày qua sẽ tự động được chuyển sang quyền catalog_management muộn nhất vào ngày 14/08/2020.

Từ giờ đến ngày 28/02/2021, các nhà phát triển sử dụng phiên bản trước của API vẫn có thể gọi điểm cuối danh mục sản phẩm bằng quyền ads_management. Nếu đang sử dụng phiên bản 8.0, bạn phải có quyền catalog_management.

Sau hạn chót là tháng 2, quyền catalog_management sẽ không còn được liên kết với ads_management. Vì vậy, người dùng sẽ phải cấp quyền catalog_management một cách rõ ràng cho ứng dụng của bạn.

Xác thực

Áp dụng cho phiên bản 8.0 trở lên. Sẽ áp dụng cho tất cả phiên bản kể từ ngày 02/11/2020.

[CẬP NHẬT] Các điểm cuối API Danh mục sau đây hiện tuân theo chế độ cài đặt xác thực 2 yếu tố dành cho doanh nghiệp. Bất kỳ ứng dụng nào gọi điểm cuối này đều sẽ gặp lỗi nếu Doanh nghiệp sở hữu danh mục yêu cầu người dùng ứng dụng hiện tại và người dùng ứng dụng chưa xác thực 2 yếu tố phải tiến hành xác thực 2 yếu tố.

Khi người dùng ứng dụng hiện tại có quyền truy cập vào danh mục thông qua doanh nghiệp đối tác, chúng tôi sẽ tôn trọng các yêu cầu xác thực từ Trình quản lý kinh doanh của đối tác. Người dùng hệ thống không phải xác thực 2 yếu tố.

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

Báo cáo

Điểm cuối đã ngừng hoạt động

Áp dụng cho phiên bản 8.0 trở lên

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

Nhắm mục tiêu

Điểm cuối đã ngừng hoạt động

Áp dụng cho phiên bản 8.0 trở lên

• GET /search?type=adzipcode

Sửa đổi

• 28/09/2020 - Cập nhật mục xác thực API Danh mục để làm rõ hơn.
• 23/10/2020 - Cập nhật mục API Danh mục:

  • Chúng tôi đã kéo dài thời hạn để những nhà phát triển sử dụng các phiên bản trước của API vẫn có thể gọi điểm cuối danh mục sản phẩm bằng quyền ads_management. Thời hạn mới là ngày 28/02/2021.
  • Chúng tôi đã làm rõ hơn về quy trình xác thực người dùng hệ thống.
• 17/05/2021 - Thay đổi điểm cuối đã ngừng hoạt động từ GET /{place-id} thành GET /{place-information-id}. GET /{place-id} không còn được dùng nữa.