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

Hôm nay, chúng tôi sẽ phát hành API Đồ thị phiên bản 10.0 và API Marketing phiên bản 10.0 của Facebook.

Bản phát hành này có nhiều công bố, các điểm cập nhật, các tính năng ngừng hoạt động và "các điểm cuối tiếp tục hoạt động" có thể ảnh hưởng đến cách ứng dụng tích hợp với nền tảng của chúng tôi. Bài viết này nêu những điểm cập nhật nói trên và các bước mà nhà phát triển cần thực hiện để tránh bị gián đoạn nếu có.

Sau đây là thông tin chi tiết về tất cả những thay đổi này. Để xem thông số kỹ thuật, vui lòng truy cập vào nhật ký thay đổi phiên bản 10.0 của chúng tôi.

Hãy truy cập vào Trung tâm Sáng kiến về nền tảng để tìm hiểu thêm về Nền tảng dành cho nhà phát triển của chúng tôi.

Công bố và cập nhật

Chứng nhận Kiểm tra việc sử dụng dữ liệu

Để tránh bị mất quyền truy cập vào API Nền tảng của Facebook, vui lòng hoàn thành quá trình Kiểm tra việc sử dụng dữ liệu (DUC) trong vòng 60 ngày kể từ khi đăng ký. Bạn có thể hoàn thành DUC bằng cách chuyển đến trang “Ứng dụng của tôi” trong Bảng điều khiển ứng dụng.

Mùa thu năm ngoái, Facebook đã ra mắt tính năng Kiểm tra việc sử dụng dữ liệu (DUC), một yêu cầu mới hàng năm đối với Nhà phát triển để chứng nhận rằng quyền truy cập vào API và việc họ sử dụng dữ liệu tuân thủ Điều khoản về nền tảng và Chính sách dành cho nhà phát triển của Facebook.

Trong quá trình chúng tôi triển khai dần cho tất cả ứng dụng, bạn sẽ nhận được ngày đến hạn và các hướng dẫn khác qua một cảnh báo cho nhà phát triển, cùng với email gửi đến địa chỉ liên hệ đã đăng ký và một thông báo trong danh sách Hành động yêu cầu trên Bảng điều khiển ứng dụng.

Để xem hướng dẫn chi tiết về cách hoàn thành DUC, bạn có thể tham khảo tài liệu dành cho nhà phát triển của chúng tôi. Ngoài ra, bạn cũng có thể tìm hiểu thêm trong phần Câu hỏi thường gặp dành riêng cho DUC.

Các giới hạn dữ liệu và cấp độ truy cập dữ liệu trong 90 ngày của API Nhóm:

Kể từ ngày 24/05/2021, khi sử dụng API Nhóm, khoảng thời gian có thể truy cập dữ liệu của ứng dụng sẽ được giới hạn ở 90 ngày.

Chúng tôi cũng sẽ ra mắt quyền truy cập API Nhóm theo cấp bậc cho các ứng dụng tiêu dùng dựa trên việc các ứng dụng đó ở Chế độ phát triển hay Chế độ chính thức. Giờ đây, quyền đối với API Nhóm sẽ hoạt động giống như Quyền truy cập thông thường và Quyền truy cập nâng cao cho các ứng dụng kinh doanh.

Hiện nay, các ứng dụng ở Chế độ phát triển có thể truy cập vào tất cả nội dung của Nhóm công khai và Nhóm riêng tư mà nhà phát triển là quản trị viên. Sau khi hoàn thành quy trình Xét duyệt ứng dụng, các ứng dụng này có thể truy cập vào tất cả nội dung của các nhóm đã cài đặt ứng dụng.

Vào ngày 24/05/2021, các ứng dụng ở Chế độ phát triển chỉ có thể truy cập vào nội dung của riêng mình trong Nhóm công khai và Nhóm riêng tư mà nhà phát triển là quản trị viên. Điều này có nghĩa là ứng dụng sẽ không có quyền truy cập vào nội dung mà những người dùng khác trong Nhóm (không có vai trò trên ứng dụng) đã đăng tải, chẳng hạn như bài viết và bình luận.

Hãy tìm hiểu thêm trong nhật ký thay đổi phiên bản 10.0

Các cấp độ truy cập cho quyền public_profile và email đối với Ứng dụng kinh doanh

Trong khuôn khổ sáng kiến liên tục nhằm bảo vệ dữ liệu người dùng, chúng tôi đã bổ sung thêm quyền public_profile (tức là Trường thông tin mặc định trên Trang cá nhân công khai) và email vào mô hình cấp độ truy cập mà chúng tôi đã công bố ở API Đồ thị phiên bản 8.0 đối với các ứng dụng kinh doanh mới và hiện có.

Giờ đây, các ứng dụng kinh doanh mới tạo sẽ bắt đầu với Quyền truy cập thông thường cho quyền public_profile và email. Khi một ứng dụng có Quyền truy cập thông thường vào public_profile, chỉ người dùng có vai trò trên ứng dụng hoặc chỉ doanh nghiệp đã xác nhận ứng dụng mới có thể tìm kiếm hoặc đăng nhập vào ứng dụng. Nếu bạn cần người dùng bên ngoài đăng nhập vào ứng dụng, quản trị viên ứng dụng có thể yêu cầu Quyền truy cập nâng cao trong Bảng điều khiển ứng dụng. Quyền truy cập này sẽ được cấp tự động.

Hãy tìm hiểu thêm trong nhật ký thay đổi phiên bản 10.0

Lời nhắc về yêu cầu xóa dữ liệu

Như đã công bố vào ngày 10/11/2020, các loại ứng dụng Tiêu dùng và Chơi game gửi đi Xét duyệt ứng dụng hoặc chuyển đổi từ Chế độ phát triển sang Chế độ chính thức sẽ phải cung cấp lệnh gọi lại yêu cầu xóa dữ liệu hoặc một URL có hướng dẫn rõ ràng cho người dùng về cách yêu cầu xóa dữ liệu của họ. Theo dự kiến, chúng tôi sẽ thực thi yêu cầu này chậm nhất vào ngày 10/11/2022 và sẽ nhắc nhà phát triển ứng dụng 60 ngày trước khi thực thi.

Các tùy chọn thay đổi của API Đồ thị đối với Thông tin chi tiết về quảng cáo cho dự án giảm bớt thời gian lưu giữ

Giao diện người dùng Trình quản lý quảng cáo sẽ không còn hỗ trợ tùy chọn báo cáo số liệu thông tin chi tiết về quảng cáo từ hơn 37 tháng trước. API này sẽ trả về lỗi khi yêu cầu chứa khoảng ngày vượt quá thời gian lưu giữ 37 tháng. Chúng tôi sẽ tắt "date_preset = lifetime" và thay thế bằng "date_preset = maximum".

Các thay đổi của API Đồ thị phiên bản 10.0 đối với Thông tin chi tiết về quảng cáo, ngoại trừ "date_preset = lifetime", sẽ được áp dụng cho tất cả phiên bản khác của API Đồ thị sau 90 ngày. Trường thông tin cụ thể đã gọi không cần phải thay đổi. Sẽ có chức năng đặt sẵn và tất cả lệnh gọi "Lifetime" đều có thời gian lưu giữ tối đa mặc định là 37 tháng.

Sự thay đổi này sẽ không ảnh hưởng đến dữ liệu có liên quan đến nội dung quảng cáo, đối tượng, chế độ cài đặt phân phối hoặc tên đối tượng quảng cáo. Ngoài ra, sẽ không có thay đổi nào đối với việc tính toán số liệu hiện có. Sự thay đổi này sẽ áp dụng trên khắp giao diện báo cáo quảng cáo, bao gồm cả Trình quản lý quảng cáo, Báo cáo quảng cáo và Trải nghiệm quảng cáo dung lượng nhẹ.

• Ngày phát hành 23/02/2021:
  • Phiên bản 10.0
    • Bật "date_preset = maximum"
    • Tắt "date_preset = lifetime"
    • Trả về lỗi khi yêu cầu có chứa khoảng ngày rõ ràng vượt quá thời gian lưu giữ 37 tháng
  • Phiên bản 9.0 trở xuống
    • Không có thay đổi đối với chức năng hiện tại
• Sau khi phát hành 90 ngày - 24/05/2021:
  • Phiên bản 9.0 trở xuống
    • Bật "date_preset = maximum" (giống với phiên bản mới)
    • Trả về lỗi khi yêu cầu có chứa khoảng ngày rõ ràng vượt quá thời gian lưu giữ 37 tháng (giống với phiên bản mới)
    • "date_preset = lifetime" vẫn có thể hoạt động nhưng chỉ trả về dữ liệu trong vòng 37 tháng, tức là hoạt động như giá trị tối đa

Hãy tìm hiểu thêm trong nhật ký thay đổi phiên bản 10.0

Chính sách xóa mới cho dữ liệu thuộc sở hữu bên ngoài trên ThreatExchange

Kể từ ngày 24/05/2021, khi đối tác đặt expire_time cho dữ liệu mà họ tải lên ThreatExchange, chúng tôi sẽ “xóa vĩnh viễn” dữ liệu vào thời gian hết hạn được đề cập. Nếu bạn muốn cho biết dữ liệu không còn hợp lệ nữa, hãy đặt trường thông tin "expired_on" để xóa tự động.

Trước đây, xóa "tạm thời" có nghĩa là chúng tôi gắn nhãn nội dung đã hết hạn là đã hết hạn. Chúng tôi không hỗ trợ xóa tạm thời nữa. Sau khi hết hạn, nội dung sẽ bị xóa vĩnh viễn và không còn hiển thị trong ThreatExchange.

Ngoài ra, tất cả ThreatDescriptor không phải của Facebook trong ThreatExchange đều bị xóa vĩnh viễn sau khi hết hạn. Thời gian hết hạn sẽ vẫn do người tạo ThreatDescriptor đặt. Sau đó, quá trình xóa sẽ bắt đầu đối với tất cả ThreatDescriptor đã hết hạn và không phải do Facebook tạo. Nếu ứng dụng hiện đang có ThreatDescriptor đã hết hạn mà bạn không muốn xóa khi chính sách này có hiệu lực, bạn phải đẩy lùi ngày hết hạn hoặc đặt thành "0" để đảm bảo rằng dữ liệu không bao giờ hết hạn.

Nhấp vào đây để tìm hiểu thêm về các thay đổi

Các thay đổi về tùy chọn nhắm mục tiêu trong API mới

Vào ngày 24/05/2021, chúng tôi sẽ không yêu cầu thông số location_spec và country nữa khi tạo Đối tượng tùy chỉnh theo đối tượng tương tự trên tất cả phiên bản API.

Khi tạo Đối tượng tương tự, người dùng sẽ chọn nguồn Đối tượng tương tự và tỷ lệ mong muốn. Vị trí của Đối tượng tương tự sẽ được xác định theo vị trí quốc gia trong thông số nhắm mục tiêu của chiến dịch. Sự thay đổi này sẽ không ảnh hưởng đến các chiến dịch hiện có. Sự thay đổi này sẽ chỉ ảnh hưởng đến các chiến dịch mới và được chỉnh sửa.

Ra mắt trang mới có tên Trạng thái chính thức của nền tảng

Trang mới của Facebook có tên Trạng thái doanh nghiệp sẽ nâng cao tính minh bạch và tăng cường chủ động giao tiếp với nhà phát triển bên ngoài bằng các Sản phẩm nền tảng của Facebook. Trang này sẽ mang đến một nơi tập trung để kiểm tra trạng thái nền tảng của các sản phẩm cho doanh nghiệp trên Facebook (Quảng cáo, API WhatsApp Business, Nền tảng dành cho nhà phát triển của Facebook, v.v.). Trang này hiện đang hoạt động với Trình quản lý quảng cáo và API WhatsApp Business. Các sản phẩm khác cho doanh nghiệp sẽ được bổ sung đến hết tháng 05/2021.

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

Hộp thoại Phát trực tiếp ngừng hoạt động

Vào ngày 24/05/2021, chúng tôi sẽ cho SDK Hộp thoại Phát trực tiếp (GLD) ngừng hoạt động. Công cụ phát trực tiếp cũ sẽ ngừng hoạt động trên tất cả phiên bản API. Sự thay đổi này sẽ chỉ ảnh hưởng đến việc phát trực tiếp trên Facebook. Chúng tôi khuyến khích các nhà phát triển nên sử dụng Live Producer và Live API cho tất cả giải pháp phát trực tiếp chuyên biệt.

Các giải pháp phát trực tiếp sau khi SDK GLD ngừng hoạt động:

• Truy cập trực tiếp vào Live Producer qua facebook.com/live/producer (hoặc các điểm truy cập khác trên Facebook, chẳng hạn như nút “Video trực tiếp” trên Trang hoặc Trang cá nhân)
• Tích hợp bất kỳ giải pháp tùy chỉnh nào với Live API

Hãy tìm hiểu thêm trong nhật ký thay đổi phiên bản 10.0

Tính năng Nhắm đối tượng kết nối ngừng hoạt động

Vào ngày 24/05/2021, tính năng Nhắm đối tượng kết nối sẽ không còn được hỗ trợ khi tạo/chỉnh sửa nhóm quảng cáo. Yêu cầu này sẽ chỉ ảnh hưởng đến các chiến dịch mới và được chỉnh sửa. Các chiến dịch hiện có sẽ không bị ảnh hưởng.

Hãy tìm hiểu thêm trong nhật ký thay đổi phiên bản 10.0

Các điểm cuối tiếp tục hoạt động

Cho điểm cuối gr:delete:Page/tabs tiếp tục hoạt động

Khi ra mắt API Đồ thị phiên bản 8.0, chúng tôi đã cho điểm cuối gr:delete:Page/tabs ngừng hoạt động đối với Tab Trang. Chúng tôi đã quyết định cho điểm cuối này tiếp tục hoạt động ngay đối với API Đồ thị phiên bản 10.0 và sẽ khôi phục quyền truy cập vào ngày 24/05/2021 trong mọi phiên bản API Đồ thị khác.

Hãy tìm hiểu thêm trong nhật ký thay đổi phiên bản 10.0

Cho các điểm cuối gr:post:Business/business_users, gr:post:Business/system_users và gr:post:User/access_tokens tiếp tục hoạt động

Khi ra mắt API Đồ thị phiên bản 9.0, chúng tôi đã hạn chế quyền truy cập vào 3 điểm cuối doanh nghiệp:

• gr:post:Business/business_users
• gr:post:Business/system_users
• gr:post:User/access_tokens

Khi ra mắt API Đồ thị phiên bản 10.0, chúng tôi sẽ mở lại những điểm cuối này cho các lệnh gọi API khi ứng dụng đáp ứng một trong 2 điều kiện sau:

• Doanh nghiệp mục tiêu là doanh nghiệp sở hữu ứng dụng gọi
• Doanh nghiệp mục tiêu là doanh nghiệp con (trong mô hình Doanh nghiệp 2 cấp bậc) của doanh nghiệp sở hữu ứng dụng gọi

Hãy tìm hiểu thêm trong nhật ký thay đổi phiên bản 10.0

Lịch biểu mục hành động

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

Trong khuôn khổ lịch biểu lập phiên bản API Marketing của chúng tôi, hãy lưu ý những phiên bản API Marketing sắp ngừng hoạt động:

• Ngày 03/03/2021: API Marketing phiên bản 7.0 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng
• Ngày 04/05/2021: API Marketing phiên bản 8.0 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng
• Ngày 25/08/2021: API Marketing phiên bản 9.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 Marketing mới nhất được ra mắt hiện nay. (Hãy xem nhật ký thay đổi để biết thêm thông tin chi tiết).

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

Trong khuôn khổ lịch biểu lập phiên bản API Đồ thị của chúng tôi, hãy lưu ý những phiên bản API Đồ thị sắp ngừng hoạt động trong danh sách bên dưới:

• Ngày 04/05/2021: API Đồ thị phiên bản 3.2 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng
• Ngày 03/08/2021: API Đồ thị phiên bản 3.3 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng

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

• Ngày 24/05/2021:
  • Hộp thoại Phát trực tiếp sẽ ngừng hoạt động và bị gỡ khỏi nền tảng
  • Tính năng Nhắm đối tượng kết nối sẽ ngừng hoạt động và bị gỡ khỏi nền tảng

Hành động nhà phát triển cần thực hiện

• Triển khai việc đăng ký: Chứng nhận Kiểm tra việc sử dụng dữ liệu
  • Sau khi đăng ký, bạn sẽ phải hoàn thành trong vòng 60 ngày
  • Phần Câu hỏi thường gặp dành riêng cho DUC.
• Ngày 23/02/2021: Chỉ ra mắt các thay đổi của API Đồ thị đối với Thông tin chi tiết về quảng cáo cho API Đồ thị phiên bản 10.0
• Ngày 24/05/2021:
  • Ra mắt các thay đổi của API Đồ thị đối với Thông tin chi tiết về quảng cáo cho API Đồ thị phiên bản 9.0 trở xuống
  • Các thay đổi đối với Cấp độ truy cập theo quy trình Xét duyệt ứng dụng sẽ có hiệu lực
    • Giới hạn quyền truy cập dữ liệu API Nhóm ở 90 ngày
    • Triển khai cấp độ dữ liệu API Nhóm theo cấp bậc
    • Sự thay đổi đối với quyền public_profile và email cho Ứng dụng kinh doanh sẽ có hiệu lực
  • Triển khai chính sách mới có tên “Xóa vĩnh viễn” dữ liệu trên ThreatExchange
• Ngày 10/11/2022: Hạn chót yêu cầu xóa dữ liệu