Phiên bản 3.1

Phát hành Ngày 26/07/2018 | Dùng được đến Ngày 27/10/2020 | Bài viết trên blog

Chung
Live API
API Marketing
Nền tảng Messenger
API Bạn chung
API Trang
Webhooks

Chung

Các thay đổi này sẽ áp dụng cho phiên bản 3.1 trở lên, sau đó sẽ áp dụng cho tất cả các phiên bản vào ngày 24/10/2018.

Tất cả các điểm cuối API Đồ thị hiện trả về mọi cấu trúc trống dưới dạng {} và mọi danh sách trống dưới dạng [].

Live API

Các thay đổi này sẽ áp dụng cho phiên bản 3.1 trở lên, sau đó, kể từ ngày 24/10/2018, sẽ áp dụng cho tất cả các phiên bản.

Thông số type hiện ngừng hoạt động đối với các cạnh sau. Thông số này đã được thay thế bằng thông số source mới.

/event/live_videos
/group/live_videos
/official_events/live_videos
/page/live_videos
/user/live_videos

Thông số source mới có thể chấp nhận một trong 2 giá trị là target và owner. Việc truy vấn cạnh /live_videos của một nút bằng source=target sẽ trả về video trực tiếp được phát tới nút đó, trong khi việc truy vấn source=owner sẽ trả về video trực tiếp được phát bởi nút đó.

Nút Sự kiện và Nhóm chỉ hỗ trợ các truy vấn target và một số truy vấn target có thể không thành công nếu bạn không có quyền xem nút được nhắm mục tiêu.

API Marketing

Phát hành Ngày 26/07/2018 | Dùng được đến Ngày 14/05/2019 | Bài viết trên blog

Quản lý quảng cáo

Hạng mục nhắm mục tiêu dựa trên hành vi - Chúng tôi đã ngừng sử dụng một số tùy chọn nhắm mục tiêu dựa trên hành vi dùng trong behaviors. Nếu cố tạo quảng cáo với một trong các hạng mục này, bạn sẽ nhận được thông báo lỗi The category you selected is no longer available. Để kiểm tra các hạng mục hợp lệ có thể dùng để nhắm mục tiêu, hãy sử dụng Tìm kiếm nhắm mục tiêu.
Không còn dùngPAGE_ENGAGEMENTlàmoptimization_goal - Chúng tôi không còn dùng PAGE_ENGAGEMENT làm optimization_goal cho các chiến dịch quảng cáo. Kể từ phiên bản 3.1, bạn không còn có thể tạo, cập nhật hoặc sao chép các chiến dịch quảng cáo khi optimization_goal được đặt thành PAGE_ENGAGEMENT. Nếu có sẵn các chiến dịch quảng cáo được tạo trước phiên bản 3.1, thì bạn vẫn có thể chạy các chiến dịch đó với cài đặt này. Ngoài ra, bạn vẫn có thể sử dụng PAGE_ENGAGEMENT làm dữ liệu chia nhỏ trong API Thông tin chi tiết cho các chiến dịch quảng cáo hiện tại sử dụng optimization_goal này.
Không còn dùng Quảng cáo lượt thích Trang bằng một hình ảnh mà không cần bài viết - Kể từ phiên bản 3.1, bạn không thể tạo quảng cáo lượt thích Trang bằng một hình ảnh mà không cần bài viết trên trang nữa. Thay vào đó, bạn phải tạo Quảng cáo lượt thích Trang với một bài viết, hãy xem phần Nội dung, Vị trí quảng cáo và Xem trước, Tạo quảng cáo lượt thích Trang.

Không truy xuất quảng cáo tìm kiếm khách hàng tiềm năng qua webhook đối với cấp nhà phát triển - Chúng tôi sẽ ngừng gửi dữ liệu thu thập được trong mẫu Quảng cáo tìm kiếm khách hàng tiềm năng qua webhook tới các ứng dụng ở Chế độ phát triển. Chúng tôi bắt đầu thực thi thay đổi này vào ngày 01/02/2019.
- Nếu bạn đăng ký các bản cập nhật trong phiên bản 3.1, thì chúng tôi sẽ không gửi bất kỳ bản cập nhật nào trừ khi ứng dụng của bạn ở phiên bản sản xuất cũng như ở Chế độ đã đăng.
- Nếu bạn tạo một ứng dụng mới sau khi có phiên bản 3.1, thì chúng tôi sẽ không gửi bất kỳ bản cập nhật nào trừ khi ứng dụng của bạn ở phiên bản sản xuất cũng như ở Chế độ đã đăng.
- Nếu có sẵn một ứng dụng thì ứng dụng đó cần phải ở Chế độ đã đăng vào ngày 1/2/2019. Cho tới ngày đó, bạn sẽ tiếp tục nhận bản cập nhật ở Chế độ phát triển.
Để biết thêm thông tin về các cấp truy cập Marketing API và chế độ ứng dụng, hãy xem Cấu trúc mới để truy cập Marketing API và Marketing API, Quyền truy cập và Xác thực.

Thông tin chi tiết về quảng cáo và đo lường

Chúng tôi đã đổi tên cost_per_store_visit và store_visits cho API Thông tin chi tiết thành cost_per_store_visit_actions và store_visit_actions. Thay đổi này ảnh hưởng đến:
- GET {adaccount-id}/insights,
- GET {campaign-id}/insights,
- GET {adset-id}/insights,
- GET {ad-id}/insights,
- POST {adaccount-id}/insights,
- POST {campaign-id}/insights,
- POST {adset-id}/insights và
- POST {ad-id}/insights.
Để biết thông tin về các số liệu mới đặt tên, hãy xem phần Lượt ghé thăm cửa hàng, Đo lường. Lưu ý rằng API Lượt ghé thăm cửa hàng và tài liệu liên quan chỉ được cung cấp hạn chế. Để có quyền truy cập, hãy liên hệ với Đại diện Facebook của bạn.

API Trình quản lý kinh doanh

Trong phiên bản 3.1, chúng tôi giới thiệu khái niệm mới về các quyền dựa trên tác vụ để thay thế cho quyền dựa trên vai trò hiện tại. Điều này ảnh hưởng đến quyền truy cập vào các tài khoản quảng cáo thuộc quản lý của Trang và API Trình quản lý kinh doanh. Quyền truy cập dựa trên vai trò vào tài khoản quảng cáo và Trang vẫn có hiệu lực nhưng sẽ không được chấp nhận trong tương lai. Điều này tác động đến các vai trò sau đây và cung cấp các tác vụ tương đương cho tài khoản quảng cáo:

Vai trò	Tác vụ	Mô tả
`ADMIN`	`['MANAGE', 'ADVERTISE', 'ANALYZE']`	Quản lý tất cả các khía cạnh của chiến dịch quảng cáo, báo cáo, lập hóa đơn và quyền đối với tài khoản quảng cáo.
`GENERAL_USER`	`['ADVERTISE', 'ANALYZE']`	Tạo quảng cáo bằng nguồn vốn liên kết với tài khoản quảng cáo. Chạy báo cáo.
`GENERAL_USER`	`['ANALYZE']`	Chạy báo cáo.

Thao tác này thay thế các vai trò sau trong API Trình quản lý kinh doanh bằng các tác vụ sau:

Vai trò	Tác vụ
`MANAGER`	`['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']`
`CONTENT_CREATOR`	`['CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']`
`MODERATOR`	`['MODERATE', 'ADVERTISE', 'ANALYZE']`
`ADVERTISER`	`['ADVERTISE', 'ANALYZE']`
`INSIGHTS_ANALYST`	`['ANALYZE']`

Đối với việc quản lý Facebook Pixel, thay đổi này sẽ tác động đến các vai trò đó và tạo ra các tác vụ mới:

Vai trò	Tác vụ
`PIXEL_EDITOR`	`['EDIT', 'ANALYZE']`
`PIXEL_ANALYST`	`['ANALYZE']`

Nằm trong thay đổi này, chúng tôi sẽ ngừng sử dụng các trường API Quản lý doanh nghiệp sau đây và thay thế bằng các trường sau:

Khu vực	Không dùng nữa	Trường mới
`GET {adaccount-id}/users`	`permissions`, `role`	`tasks`
`POST {adaccount-id}/users`	`role`, `uidRoles`, `emailRoles`	`tasks`
`GET {user-id}/adaccounts`	`permissions`, `role`	`tasks`
`GET {user-id}/assigned_ad_accounts`	`role`, `permitted_role`	`tasks`, `permitted_tasks`
`GET {user-id}/assigned_pages`	`role`, `permitted_role`	`tasks`, `permitted_tasks`
`GET {adaccount-id}/assigned_users`	`role`, `permitted_role`	`tasks`, `permitted_tasks`
`POST {adaccount-id}/assigned_users`	`role`	`tasks`
`GET {page-id}/assigned_users`	`role`, `permitted_role`	`tasks`, `permitted_tasks`
`POST {page-id}/assigned_users`	`role`	`tasks`
`GET {fb-pixel-id}/assigned_users`	`role`, `permitted_role`	`tasks`, `permitted_tasks`
`GET {adaccount-id}/userpermissions`	`role`	`tasks`
`POST {adaccount-id}/userpermissions`	`role`	`tasks`
`GET {page-id}/userpermissions`	`role`	`tasks`
`POST {page-id}/userpermissions`	`role`	`tasks`
`GET {business-id}/client_ad_accounts`	`permitted_role`	`permitted_tasks`
`POST {business-id}/client_ad_accounts`	`permitted_role`	`permitted_tasks`
`GET {business-id}/client_pages`	`permitted_role`	`permitted_tasks`
`POST {business-id}/client_pages`	`permitted_role`	`permitted_tasks`
`GET {business-id}/client_pixels`	`permitted_role`	`permitted_tasks`
`GET {adaccount-id}/agencies`	`permitted_role`	`permitted_tasks`
`POST {adaccount-id}/agencies`	`permitted_role`	`permitted_tasks`
`GET {page-id}/agencies`	`permitted_role`	`permitted_tasks`
`POST {page-id}/agencies`	`permitted_role`	`permitted_tasks`
`GET {business-id}/pending_client_pages`	`permitted_role`	`permitted_tasks`
`GET {business-id}/pending_client_ad_accounts`	`permitted_role`	`permitted_tasks`

Thiết kế mới này cũng tác động đến API Trang, xem phần API Đồ thị 3.1, API Trang, Thay đổi lớn. Để có tài liệu về API Trình quản lý kinh doanh, hãy xem:

Nền tảng Messenger

Đối với các ứng dụng được tạo trước ngày 26/7/2018, các thay đổi này sẽ có hiệu lực vào ngày 8/1/2019. Đối với các ứng dụng được tạo sau ngày 26/07/2018, các thay đổi này sẽ có hiệu lực ngay lập tức.

API Trang cá nhân người dùng hiện chỉ trả về các trường thông tin first_name, last_name và profile_pic theo mặc định. Các trường thông tin bổ sung hiện yêu cầu xét duyệt sản phẩm thông qua tab Nền tảng Messenger của Bảng điều khiển ứng dụng.

Các trường thông tin last_ad_referral và is_payment_enabled không còn dùng nữa và sẽ bị gỡ khỏi API vào ngày 30/10/2018.

API Bạn chung

Các thay đổi này sẽ áp dụng cho phiên bản 3.1 trở lên, sau đó sẽ áp dụng cho tất cả các phiên bản vào ngày 24/10/2018.

API Bạn chung đã ngừng hoạt động vào ngày 4/4/2018, đồng thời các điểm cuối dưới đây đã bắt đầu trả về tập dữ liệu trống. Các điểm cuối này hiện hoàn toàn ngừng hoạt động và sẽ trả về lỗi.

/user-context/all_mutual_friends
/user-context/mutual_friends
/user-context/three_degree_mutual_friends

API Trang

Các quyền

Các thay đổi sau đây sẽ áp dụng cho phiên bản 3.1 trở lên, sau đó, kể từ ngày 1/2/2019, sẽ áp dụng cho tất cả các phiên bản.

Quyền pages_manage_cta hiện yêu cầu Xét duyệt ứng dụng đối với tất cả các yêu cầu POST và DELETE. Các ứng dụng được tạo trước ngày 26/7/2018 có thể tiếp tục sử dụng quyền này nhưng phải gửi đi xét duyệt trước ngày 1/2/2019 để dùng tiếp pages_manage_cta.

Vai trò trên Trang

Các thay đổi sau đây áp dụng cho phiên bản 3.1 trở lên.

Vai trò trên Trang sắp ngừng hoạt động và sẽ được thay thế bằng Tác vụ trên Trang. Thay vì cấp cho Người dùng một vai trò trên Trang, giờ đây, bạn phải cấp cho Người dùng các tác vụ tương đương.

Vai trò	Tác vụ tương đương
`Admin`	`ADVERTISE`, `ANALYZE`, `CREATE_CONTENT`, `MANAGE`, `MODERATE`
`Advertiser`	`ADVERTISE`, `ANALYZE`
`Analyst`	`ANALYZE`
`Editor`	`ADVERTISE`, `ANALYZE`, `CREATE_CONTENT`, `MODERATE`
`Moderator`	`ADVERTISE`, `ANALYZE`, `MODERATE`

Cho đến khi các quyền dựa trên vai trò được thay thế hoàn toàn bằng các quyền dựa trên tác vụ, khi cấp các tác vụ qua /page/roles, bạn phải cấp mọi tác vụ tương đương của một vai trò, nếu không thao tác POST sẽ không thành công.

Để hỗ trợ các thay đổi này, trường perms và role đã ngừng hoạt động và được thay thế bằng trường tasks mới. Điều này ảnh hưởng đến các cạnh sau:

/me/accounts
/page/roles
/user/accounts

Vui lòng tham khảo Nhật ký thay đổi Marketing API để xem những thay đổi này có ảnh hưởng như thế nào đối với Marketing API và API Trình quản lý kinh doanh.

Webhooks

Các thay đổi này sẽ áp dụng cho phiên bản 3.1 trở lên, sau đó sẽ áp dụng cho tất cả các phiên bản vào ngày 24/10/2018.

Các trường webhook Người dùng sau đây không còn được dùng nữa:

pic_big_with_logo
pic_small_with_logo
pic_square_with_logo
pic_with_logo

Các trường webhook Người dùng sau đây hiện sử dụng URL HTTPS thay vì HTTP.

pic
pic_big
pic_small
pic_square
picture

Ngoài ra, URL của các trường này sẽ hết hạn - điều này ảnh hưởng ngay lập tức đến tất cả các phiên bản API.