Introducing Facebook Graph API v12.0 and Marketing API v12.0

Hôm nay, chúng tôi sẽ ra mắt API Đồ thị phiên bản 12.0 và API Marketing phiên bản 12.0 của Facebook. Dưới đây, chúng tôi đã nêu bật những thay đổi sẽ ảnh hưởng đến cộng đồng nhà phát triển của mình. Những thay đổi này bao gồm thông báo và cập nhật về sản phẩm, lời nhắc từ các đợt ra mắt sản phẩm trước, cũng như thông báo về việc ngừng hoạt động trên quy mô lớn có thể tác động đến quá trình tích hợp ứng dụng của bạn với nền tảng của chúng tôi.

Để xem danh sách đầy đủ tất cả các thay đổi kèm theo thông tin chi tiết, vui lòng truy cập nhật ký thay đổi của chúng tôi.

Thông báo chung và nội dung cập nhật

API Chuyển đổi: Mở rộng phiên bản có thể gọi tối thiểu

Khả năng tương thích ngược của API Đồ thị dành cho các ứng dụng được tạo bằng mã truy cập một lần nhấp Kể từ phiên bản 12.0, mọi phiên bản API Đồ thị có sẵn đều hỗ trợ các mã truy cập mới tạo trong tab cài đặt API Chuyển đổi của Trình quản lý sự kiện (xem các phiên bản được hỗ trợ tại đây).

Lưu ý rằng các lệnh gọi được thực hiện bằng những mã này đến một phiên bản API Đồ thị không dùng nữa sẽ tự động chọn phiên bản có sẵn cũ nhất. Hành vi này chỉ áp dụng cho các điểm cuối API Đồ thị. Các điểm cuối API Marketing, bao gồm cả API Chuyển đổi, không hỗ trợ hành vi tự động nâng cấp và sẽ trả về một ngoại lệ.

API Trang cá nhân của người dùng dành cho tính năng Nhắn tin trên Instagram: Các trường thông tin mới

Chúng tôi đang thực hiện các cải tiến đối với API Trang cá nhân của người dùng dành cho tính năng Nhắn tin trên Instagram. Trước đây, API Trang cá nhân của người dùng dành cho Instagram hỗ trợ 2 trường thông tin: 1) Tên và 2) URL của ảnh đại diện. Để cho phép doanh nghiệp cá nhân hóa tốt hơn và ưu tiên các tin nhắn dựa trên thông tin người dùng công khai, chúng tôi đã cập nhật API này để bao gồm cả những thông tin sau:

1. Số lượng người theo dõi
2. Huy hiệu đã xác minh
3. Doanh nghiệp theo dõi tài khoản của Người dùng [Có/Không]
4. Tài khoản của Người dùng theo dõi tài khoản của Doanh nghiệp [Có/Không]

Vui lòng tham khảo tài liệu dành cho nhà phát triển để biết chi tiết.

Cơ hội mới nhờ tùy chọn nhắm mục tiêu chi tiết

Để giúp các nhà quảng cáo tìm thấy những cơ hội khác mà ban đầu không có, khi nhà quảng cáo sử dụng tùy chọn Nhắm mục tiêu chi tiết và tối ưu hóa cho lượt chuyển đổi, giá trị hoặc sự kiện trong ứng dụng bằng cách sử dụng mục tiêu lượt chuyển đổi, những cơ hội này sẽ tự động có trong tùy chọn Mở rộng nhắm mục tiêu. Để biết thêm thông tin, vui lòng tham khảo Bài viết Mở rộng nhắm mục tiêu chi tiết trong Trung tâm trợ giúp.

API Video: Các trường thông tin mới

Chúng tôi đã thêm 2 trường thông tin mới: views và post_views vào nút [Video]. Vui lòng xem tài liệu dành cho nhà phát triển API Video để tìm hiểu thêm.

Phiên bản không dùng nữa và những thay đổi quan trọng

Thông tin minh bạch về lỗi

Hành vi mặc định của API Đồ thị và API Marketing là trả về lỗi khi ứng dụng yêu cầu trường thông tin hoặc cạnh trên một nút trả về (các) nút liên kết, nhưng thiếu các quyền thích hợp mà nút liên kết đó yêu cầu. Tuy nhiên, một số trường thông tin và cạnh không tuân theo giao thức này mà chỉ bị loại bỏ khỏi phản hồi API nếu ứng dụng gọi thiếu các quyền thích hợp.

Kể từ phiên bản 12.0, các trường thông tin và cạnh này sẽ tuân theo hành vi mặc định. Sự thay đổi này sẽ áp dụng cho tất cả phiên bản từ ngày 13/12/2021.

• Điểm cuối API Đồ thị bị ảnh hưởng
• Điểm cuối API Marketing bị ảnh hưởng

Người dùng hệ thống và vai trò trong ứng dụng

Chúng tôi sẽ ngừng hỗ trợ khả năng cấp cho người dùng hệ thống các vai trò trong ứng dụng trừ khi cả người dùng và ứng dụng đều thuộc cùng một doanh nghiệp. Để ngăn tình trạng gián đoạn ứng dụng và hoạt động kinh doanh, bạn nên xóa những người dùng hệ thống này khỏi ứng dụng của mình và dùng API Business On Behalf Of. Thay đổi quan trọng này sẽ có hiệu lực từ ngày 13/12/2021.

Video trực tiếp đã lên lịch

Chúng tôi sẽ ngừng hỗ trợ thông số planned_start_time trong chức năng Lên lịch của API Live và thay đổi quan trọng này sẽ có hiệu lực từ ngày 13/12/2021. Chúng tôi sẽ thông báo thông số mới vào một ngày trong tương lai.

Nền tảng Messenger: API Cuộc trò chuyện

Chúng tôi sẽ ngừng hỗ trợ trường user_id trong siêu dữ liệu chuỗi trò chuyện của API Cuộc trò chuyện. Tất cả các nhà phát triển sẽ phải chuyển mọi thông tin tham chiếu đến user_id (IGID) sang hoàn toàn sử dụng IGSID làm thông tin nhận dạng chính của chuỗi trò chuyện giữa người dùng và doanh nghiệp.

Thay đổi quan trọng này sẽ có hiệu lực trong các phiên bản API Đồ thị trước từ ngày 13/12/2021. Vui lòng xem tài liệu dành cho nhà phát triển API Cuộc trò chuyện để tìm hiểu thêm.

Nền tảng Messenger: Webhooks Instagram

Chúng tôi đang cập nhật API Messenger dành cho webhook cảm xúc trên Instagram để hỗ trợ tốt hơn các biểu tượng cảm xúc. Phiên bản hiện tại trả về trường biểu tượng cảm xúc ở dạng chuỗi – với bản cập nhật này, webhook cảm xúc sẽ trả về định dạng unicode mới. Lưu ý rằng trường "reaction" (cảm xúc) sẽ chỉ hỗ trợ các biểu tượng cảm xúc mặc định. Đối với mọi biểu tượng cảm xúc khác, trường cảm xúc sẽ trả về "other" (khác), giống như MSGR.

Thay đổi quan trọng này sẽ có hiệu lực trong các phiên bản API Đồ thị trước kể từ ngày 13/12/2021. Để tiếp tục hỗ trợ các biểu tượng cảm xúc, tất cả nhà phát triển sẽ phải chuyển sang unicode mới mà chúng tôi trả về trước ngày 13/12/2021. Vui lòng tham khảo Tài liệu dành cho nhà phát triển webhook để biết chi tiết.

Các phiên bản API ngừng hoạt động:

Trong khuôn khổ lịch biểu lập phiên bản API Đồ thị và API Marketing của Facebook, hãy lưu ý các phiên bản sắp ngừng hoạt động sau:

API Đồ thị

• Ngày 02/11/2021: API Đồ thị phiên bản 4.0 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng
• Ngày 03/02/2022: API Đồ thị phiên bản 5.0 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng
• Ngày 22/05/2022: API Đồ thị phiên bản 6.0 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng

Để tránh bị gián đoạn hoạt động kinh doanh, bạn nên chuyển tất cả lệnh gọi sang phiên bản API mới nhất được ra mắt hiện nay.

API Marketing

• API Marketing phiên bản 10.0 sẽ ngừng hoạt động từ ngày 04/10/2021
• API Marketing phiên bản 11.0 sẽ ngừng hoạt động từ ngày 23/02/2022

Để tránh bị gián đoạn hoạt động kinh doanh, bạn nên chuyển tất cả lệnh gọi sang phiên bản API Marketing mới nhất được ra mắt hiện nay. (Hãy xem nhật ký thay đổi để biết thêm chi tiết).

SDK Nền tảng Facebook

• Vào ngày 19/01/2021, chúng tôi đã thông báo lịch ngừng hoạt động sau 2 năm đối với SDK Nền tảng Facebook phiên bản 8.x trở xuống. Những phiên bản này sẽ ngừng hoạt động vào tháng 01/2023.
• Vào ngày 08/06/2021, chúng tôi đã phát hành SDK Nền tảng Facebook phiên bản 11.0, qua đó bắt đầu lịch ngừng hoạt động sau 2 năm của SDK Nền tảng Facebook phiên bản 9.0. SDK phiên bản 9.0 sẽ ngừng hoạt động vào tháng 06/2023.

Các tính năng chung ngừng hoạt động

Điểm cuối ưu đãi tự nhiên ngừng hoạt động

Vào ngày 08/06/2021, chúng tôi đã thông báo việc API Quảng cáo ưu đãi ngừng hoạt động. Thay đổi này sẽ có hiệu lực ngay lập tức khi phát hành API Đồ thị phiên bản 12.0.

Nền tảng Messenger – Mẫu dành cho hàng không

Vào ngày 08/06/2021, chúng tôi đã thông báo việc mẫu dành cho hàng không ngừng hoạt động. Thay đổi này sẽ có hiệu lực từ ngày 06/12/2021.