Phiên bản 7.0
API Đồ thị
Ngày phát hành 05/05/2020 | Ngày hết hạn 04/08/2022 | Bài viết trên blog
Tiện ích Facebook Business (FBE) phiên bản 2
Sự thay đổi này áp dụng cho tất cả phiên bản.
Tiện ích Facebook Business phiên bản 2 đã có thêm 2 trường mới.
ID tài khoản quảng cáo (
ad_account_id) - Biểu thị ID tài khoản quảng cáo mà người dùng chọn trong FBE. Bạn có thể dùng tài khoản quảng cáo này để quản lý quảng cáo nếu ứng dụng của bạn có quyềnads_management.ID danh mục (
catalog_id) - ID danh mục mà người dùng chọn trong FBE. Người dùng có thể sử dụng ID này để quản lý danh mục sản phẩm của họ.
Tìm kiếm hashtag
Sự thay đổi này áp dụng cho phiên bản 7.0 trở lên.
Từ giờ, bạn có thể yêu cầu trường timestamp của File phương tiện trên Instagram do các truy vấn GET /{ig-hashtag-id}/top_media và GET /{ig-hashtag-id}/recent_mediaTìm kiếm hashtag trả về. Ví dụ: GET /{ig-hashtag-id}/top_media?fields=timestamp.
Messenger
Plugin chat với khách hàng
Sự thay đổi này áp dụng cho phiên bản 7.0 trở lên và sẽ áp dụng cho tất cả phiên bản kể từ ngày 02/11/2020.
Khi bạn bắt đầu cuộc trò chuyện mới hoặc tiếp tục cuộc trò chuyện hiện có thông qua Plugin chat với khách hàng, thông báo webhook messaging_postbacks và messaging_referrals ban đầu sẽ chứa ID user_ref ẩn danh của người dùng thay vì ID trong Trang (PSID) của người dùng đó. Sau khi người dùng gửi tin nhắn, thông báo webhook tiếp theo sẽ chứa PSID của người dùng.
Trang cá nhân Messenger trên Trang
Sự thay đổi này áp dụng cho phiên bản 7.0 trở lên.
Thuộc tính home_url của Trang cá nhân Messenger trên Trang đã ngừng hoạt động đối với tất cả thao tác (GET, POST và DELETE).
Open Graph
Thành phần ngừng hoạt động
Sự thay đổi này áp dụng cho phiên bản 7.0 và sẽ áp dụng cho tất cả phiên bản kể từ ngày 03/08/2020.
POST /{user-id}/{open-graph-action-type-id}
Trang
ID người dùng trong ứng dụng
Các thay đổi này áp dụng cho phiên bản 7.0 trở lên và sẽ áp dụng cho tất cả phiên bản kể từ ngày 05/05/2021.
Kể từ ngày 01/05/2018, API Trang bắt đầu trả về ID người dùng trong Trang (PSID) thay vì ID người dùng trong ứng dụng (ASID) cho tất cả ứng dụng mới. Các ứng dụng được tạo trước ngày này vẫn nhận được ASID trừ khi chọn nhận PSID. Từ giờ, tất cả ứng dụng đều sẽ nhận được PSID từ API Trang.
Với API ID trong Trang, bạn có thể đối ghép ASID với PSID tương đương. API này không còn được dùng trong phiên bản 7.0 trở lên nhưng vẫn có thể dùng với các phiên bản cũ hơn cho đến ngày 05/05/2021.
Thành phần ngừng hoạt động
Các thay đổi này áp dụng cho phiên bản 7.0 trở lên và sẽ áp dụng cho tất cả phiên bản kể từ ngày 03/08/2020.
Dưới đây là những điểm cuối sẽ ngừng hoạt động:
Quyền
Quyền manage_pages đã ngừng hoạt động và được thay thế bằng 4 quyền mới:
Quyền publish_pages đã ngừng hoạt động và được thay thế bằng 2 quyền mới:
Các ứng dụng đã được phê duyệt quyền manage_pages hoặc publish_pages hay cả hai sẽ được chuyển sang quyền mới muộn nhất vào ngày 01/06/2020.
Còn các ứng dụng đã gửi nhưng chưa được xét duyệt quyền manage_pages hoặc publish_pages hay cả hai, quy trình xét duyệt sẽ vẫn diễn ra như bình thường. Sau khi được phê duyệt, các ứng dụng sẽ được chuyển sang quyền mới muộn nhất vào ngày 01/06/2020.
Nếu bạn muốn gửi lại hoặc đăng ký quyền truy cập Trang trước ngày 01/06/2020, hãy chọn quyền bạn thấy trong bảng điều khiển ứng dụng - manage_pages hoặc publish_pages hay cả hai - hoặc chọn quyền mới. Ứng dụng của bạn sẽ tự động được chuyển sang quyền mới muộn nhất vào ngày 01/06/2020, nếu cần.
Sau ngày 01/06/2020, quyền manage_pages và publish_pages sẽ không còn xuất hiện trong lựa chọn Xét duyệt ứng dụng > Quyền và tính năng của Bảng điều khiển ứng dụng nữa.
Quyền manage_pages và publish_pages sẽ hoàn toàn ngừng hoạt động kể từ tháng 05/2022. Bạn phải áp dụng các thay đổi đối với mã trước ngày này.
SDK
Vui lòng truy cập Nhật ký thay đổi iOS SDK và Nhật ký thay đổi Android SDK để tìm hiểu các thay đổi quan trọng sắp tới đối với những SDK này.
Người dùng
Thành phần ngừng hoạt động
Các thay đổi này áp dụng cho phiên bản 7.0 trở lên và sẽ áp dụng cho tất cả phiên bản kể từ ngày 03/08/2020.
Dưới đây là những điểm cuối sẽ ngừng hoạt động:
API Marketing
Ngày phát hành 05/05/2020 | Ngày hết hạn 03/03/2021 | Bài viết trên blog
Chiến dịch quảng cáo
Tối ưu hóa ngân sách chiến dịch
Sự thay đổi này áp dụng cho phiên bản 7.0 trở lên.
Đối với một chiến dịch quảng cáo cụ thể, bạn không thể đặt cả lifetime_budget và spend_cap cùng lúc được nữa. Bạn chỉ có thể chọn lifetime_budget.
Ngân sách trọn đời của chiến dịch được trải đều trong suốt chiến dịch. Khi bạn sử dụng lifetime_budget ở cấp độ chiến dịch, thông tin về giới hạn chi tiêu đã được bao gồm. Vì vậy, không có lý do gì để thêm giới hạn chi tiêu thứ hai.
Bạn vẫn có thể sử dụng spend_cap cho các chiến dịch không dùng tùy chọn Tối ưu hóa ngân sách chiến dịch.
Hạng mục quảng cáo đặc biệt
Sự thay đổi này áp dụng cho phiên bản 7.0 trở lên.
Thông số special_ad_category trên điểm cuối POST /act_<AD_ACCOUNT_ID>/campaigns đã ngừng hoạt động và được thay thế bằng thông số special_ad_categories mới.
Thông số special_ad_categories mới này là bắt buộc và chấp nhận một mảng. Nếu bạn lấy thông số special_ad_category, thông số này sẽ vẫn trả về một chuỗi. Tuy nhiên, bạn nên sử dụng GET /{campaign-id}?fields=special_ad_categories để nhận lại một mảng.
Để biết chi tiết, hãy xem phần Hạng mục quảng cáo đặc biệt.
Tìm hiểu thêm về Hạng mục quảng cáo đặc biệt, Trung tâm trợ giúp quảng cáo.
Thành phần ngừng hoạt động
Sự thay đổi này áp dụng cho phiên bản 7.0 trở lên.
Thông số budget_rebalance_flag đã ngừng hoạt động. Thay vào đó, bạn nên sử dụng tùy chọn Tối ưu hóa ngân sách chiến dịch.
Chiến dịch quảng cáo Atlas
Thành phần ngừng hoạt động
Sự thay đổi này áp dụng cho phiên bản 7.0 trở lên.
GET /{atlas-ad-campaign-id}/cumulative_edited_date
Danh mục sản phẩm
Thành phần ngừng hoạt động
Sự thay đổi này áp dụng cho phiên bản 7.0 trở lên.
Thông số cpas_parent_catalog_settings trên cạnh POST /PRODUCT_CATALOG_ID đã ngừng hoạt động đối với các ứng dụng bên thứ ba.