Ủy quyền

Để truy cập các điểm cuối API Marketing, ứng dụng của bạn phải xóa nhiều lớp của quá trình ủy quyền API Đồ thị.

Lớp 1: Loại ứng dụng

Khi bạn tạo một ứng dụng Facebook, hệ thống sẽ hỏi bạn cách dùng ứng dụng đó. Lựa chọn mà bạn đưa ra sẽ quyết định loại của ứng dụng: Doanh nghiệp, Chơi game hoặc Không có. Hãy xem phần Loại ứng dụng.

Để truy cập các điểm cuối API Marketing, bạn cần tạo một ứng dụng dành cho Doanh nghiệp. Hãy xem phần Các sản phẩm hiện có cho ứng dụng dành cho doanh nghiệp.

Sau khi đăng ký ứng dụng, bạn có thể chỉ định vai trò cho bất kỳ ai có tài khoản nhà phát triển. Đây sẽ là người hỗ trợ bạn trong quá trình phát triển.

Lớp 2: Cấp độ truy cập, quyền và tính năng

Ứng dụng dành cho doanh nghiệp tuân theo lớp ủy quyền bổ sung của API Đồ thị có tên là cấp độ truy cập. Trong quy trình Xét duyệt ứng dụng, ứng dụng của bạn cũng phải yêu cầu các quyền và tính năng cụ thể.

Cấp độ truy cập tính năng

Cấp độ truy cập tính năng	Mô tả
Quyền truy cập tiêu chuẩn	Ứng dụng dành cho doanh nghiệp sẽ tự động được phê duyệt Quyền truy cập tiêu chuẩn đối với tất cả các Quyền và Tính năng hiện có cho Loại ứng dụng dành cho doanh nghiệp. Hãy sử dụng lựa chọn này nếu bạn mới bắt đầu. Bạn có thể tạo toàn bộ quy trình trước khi yêu cầu quyền đầy đủ. Bạn có thể truy cập vào bao nhiêu tài khoản quảng cáo cũng được. Một số lệnh gọi API có thể không dùng được với Quyền truy cập tiêu chuẩn vì các lệnh gọi này có thể thuộc về nhiều tài khoản hoặc không thể xác định tài khoản bị ảnh hưởng bằng cách lập trình.
Quyền truy cập nâng cao	Quyền truy cập nâng cao phải được phê duyệt thông qua quy trình Xét duyệt ứng dụng trên cơ sở từng Quyền và Tính năng. Để yêu cầu Quyền truy cập nâng cao, hãy chuyển đến bảng điều khiển của ứng dụng rồi nhấp vào Xét duyệt ứng dụng > Quyền và tính năng. Tìm quyền hoặc tính năng mà bạn muốn truy cập rồi nhấp vào Yêu cầu quyền truy cập nâng cao trong phần Hành động. Bạn có thể chọn một hoặc nhiều tính năng. Sau khi bạn chọn xong các lựa chọn của mình, hãy nhấp vào Tiếp tục yêu cầu. Khi đó, hệ thống sẽ chuyển bạn đến màn hình hướng dẫn về quy trình gửi. Sau khi bạn gửi thông tin, Facebook sẽ gửi lại thông báo phê duyệt hoặc từ chối, đồng thời gửi kèm thông tin nếu ứng dụng của bạn không đủ điều kiện nhận quyền truy cập tiêu chuẩn. Nếu được cấp Quyền truy cập nâng cao, bạn cần hoàn thành những yêu cầu sau để duy trì trạng thái của mình: Đã thực hiện thành công tối thiểu 1.500 lệnh gọi API Marketing trong 15 ngày qua. Đã thực hiện các lệnh gọi API Marketing với tỷ lệ lỗi dưới 10% trong 15 ngày qua.

Mô tả

Quyền truy cập tiêu chuẩn

Ứng dụng dành cho doanh nghiệp sẽ tự động được phê duyệt Quyền truy cập tiêu chuẩn đối với tất cả các Quyền và Tính năng hiện có cho Loại ứng dụng dành cho doanh nghiệp.

Hãy sử dụng lựa chọn này nếu bạn mới bắt đầu. Bạn có thể tạo toàn bộ quy trình trước khi yêu cầu quyền đầy đủ. Bạn có thể truy cập vào bao nhiêu tài khoản quảng cáo cũng được.

Một số lệnh gọi API có thể không dùng được với Quyền truy cập tiêu chuẩn vì các lệnh gọi này có thể thuộc về nhiều tài khoản hoặc không thể xác định tài khoản bị ảnh hưởng bằng cách lập trình.

Quyền truy cập nâng cao

Quyền truy cập nâng cao phải được phê duyệt thông qua quy trình Xét duyệt ứng dụng trên cơ sở từng Quyền và Tính năng.

Để yêu cầu Quyền truy cập nâng cao, hãy chuyển đến bảng điều khiển của ứng dụng rồi nhấp vào Xét duyệt ứng dụng > Quyền và tính năng.

Tìm quyền hoặc tính năng mà bạn muốn truy cập rồi nhấp vào Yêu cầu quyền truy cập nâng cao trong phần Hành động. Bạn có thể chọn một hoặc nhiều tính năng. Sau khi bạn chọn xong các lựa chọn của mình, hãy nhấp vào Tiếp tục yêu cầu. Khi đó, hệ thống sẽ chuyển bạn đến màn hình hướng dẫn về quy trình gửi.

Sau khi bạn gửi thông tin, Facebook sẽ gửi lại thông báo phê duyệt hoặc từ chối, đồng thời gửi kèm thông tin nếu ứng dụng của bạn không đủ điều kiện nhận quyền truy cập tiêu chuẩn.

Nếu được cấp Quyền truy cập nâng cao, bạn cần hoàn thành những yêu cầu sau để duy trì trạng thái của mình:

Đã thực hiện thành công tối thiểu 1.500 lệnh gọi API Marketing trong 15 ngày qua.
Đã thực hiện các lệnh gọi API Marketing với tỷ lệ lỗi dưới 10% trong 15 ngày qua.

Mỗi cấp độ đều có các hạn chế, hãy xem phần Cấp độ truy cập và tính năng. Mọi nhà phát triển đều phải tuân thủ tất cả Điều khoản của nền tảng Facebook và Chính sách dành cho nhà phát triển. Các lệnh gọi ở cấp độ truy cập BẤT KỲ sẽ dựa vào dữ liệu trong môi trường chính thức.

Để kiểm tra cấp độ truy cập hiện tại, hãy chuyển đến Bảng điều khiển ứng dụng > Xét duyệt ứng dụng > Quyền và tính năng.

Ánh xạ giữa Quyền truy cập API Quảng cáo với Quyền quản lý quảng cáo tiêu chuẩn

Quyền truy cập API Marketing	Quyền quản lý quảng cáo tiêu chuẩn	Hành động
Quyền truy cập phát triển	Quyền truy cập tiêu chuẩn	Theo mặc định
Quyền truy cập tiêu chuẩn	Quyền truy cập nâng cao	Yêu cầu đăng ký trên Bảng điều khiển ứng dụng

Quyền và tính năng

Các quyền bạn cần yêu cầu sẽ thay đổi tùy theo API bạn muốn truy cập.

Nếu ứng dụng chỉ đang quản lý tài khoản quảng cáo của bạn thì chỉ cần Quyền truy cập tiêu chuẩn và các quyền ads_read, ads_management là đủ. Nếu ứng dụng đang quản lý các tài khoản quảng cáo của người khác, bạn cần có Quyền truy cập nâng cao, cũng như các quyền ads_read và/hoặc ads_management. Hãy xem tất cả các quyền hiện có cho ứng dụng dành cho doanh nghiệp.

Các tính năng bạn cần yêu cầu sẽ thay đổi tùy theo cách bạn muốn sử dụng API của chúng tôi. Nếu bạn đang quản lý quảng cáo thì một tính năng chung cần yêu cầu là Ads Management Standard Access. Hãy xem tất cả các tính năng hiện có cho ứng dụng dành cho doanh nghiệp.

Để có Quyền truy cập nâng cao cho Quyền quản lý quảng cáo tiêu chuẩn, ứng dụng của bạn cần đáp ứng các yêu cầu sau đây:

Đã thực hiện thành công tối thiểu 1.500 lệnh gọi API Marketing trong 15 ngày qua.
Đã thực hiện các lệnh gọi API Marketing với tỷ lệ lỗi dưới 10% trong 15 ngày qua.

Nếu bạn đang quản lý quảng cáo của ai đó, hãy sử dụng thông số scope để nhắc ai đó cấp quyền ads_management hoặc ads_read. Ứng dụng của bạn sẽ có quyền truy cập khi ai đó nhấp vào Cho phép:

https://www.facebook.com/v21.0/dialog/oauth?
  client_id=<YOUR_APP_ID>
  &redirect_uri=<YOUR_URL>
  &scope=ads_management

Khi nhập trường YOUR_URL, hãy đặt / ở cuối. Ví dụ: http://www.facebook.com/

Ví dụ

Trường hợp sử dụng	Tính năng cần yêu cầu
Bạn muốn đọc và quản lý quảng cáo cho tài khoản quảng cáo mà mình sở hữu hoặc đã được chủ tài khoản quảng cáo đó cấp quyền truy cập.	Quyền: `ads_management` Tính năng: `Ads Management Standard Access`
Bạn muốn đọc báo cáo quảng cáo cho tài khoản quảng cáo mà mình sở hữu hoặc đã được chủ tài khoản quảng cáo đó cấp quyền truy cập.	Quyền: `ads_read` Tính năng: `Ads Management Standard Access`
Bạn muốn kéo báo cáo quảng cáo từ một nhóm ứng dụng, đồng thời muốn đọc và quản lý quảng cáo từ một nhóm ứng dụng khác.	Quyền: `ads_management` và `ads_read` Tính năng: `Ads Management Standard Access`

Cấp độ truy cập và tính năng

Bảng dưới đây cho thấy mức độ ảnh hưởng của các cấp độ truy cập Tiêu chuẩn và Nâng cao đến tính năng Quyền quản lý quảng cáo tiêu chuẩn.

	Quyền truy cập tiêu chuẩn	Quyền truy cập nâng cao
Giới hạn tài khoản	Quản lý tài khoản quảng cáo với số lượng không giới hạn. Quản trị viên hoặc nhà phát triển ứng dụng có thể thực hiện lệnh gọi API thay mặt cho quản trị viên hoặc nhà quảng cáo trên tài khoản quảng cáo.	Quản lý tài khoản quảng cáo với số lượng không giới hạn, giả định rằng bạn đã được cấp quyền `ads_read` hoặc `ads_management` từ tài khoản quảng cáo.
Giới hạn tốc độ	Giới hạn tốc độ nghiêm ngặt trên mỗi tài khoản quảng cáo. Chỉ dành cho phát triển. Không dành cho các ứng dụng chính thức đang chạy cho nhà quảng cáo đã đăng.	Giới hạn tốc độ một chút trên mỗi tài khoản quảng cáo.
Trình quản lý kinh doanh	Giới hạn quyền truy cập vào API Trình quản lý kinh doanh và Danh mục sản phẩm. Không có quyền truy cập Trình quản lý kinh doanh để quản lý tài khoản quảng cáo, quyền của người dùng và Trang.	Quyền truy cập vào tất cả API Trình quản lý kinh doanh và Danh mục sản phẩm.
Người dùng hệ thống	Có thể tạo 1 người dùng hệ thống và 1 người dùng hệ thống là quản trị viên.	Có thể tạo 10 người dùng hệ thống và 1 người dùng hệ thống là quản trị viên.
Tạo Trang	Không thể tạo trang thông qua API.	Không thể tạo trang thông qua API.

Cấp độ truy cập và Quyền quản lý quảng cáo tiêu chuẩn

Quyền và tính năng cho các ứng dụng có 2 cấp độ truy cập khác nhau: Quyền truy cập tiêu chuẩn và Quyền truy cập nâng cao. Lưu ý rằng việc sử dụng thuật ngữ "Quyền truy cập tiêu chuẩn" ở đây không liên quan đến tính năng Quyền quản lý quảng cáo tiêu chuẩn. Để có Quyền truy cập nâng cao cho tính năng Quyền quản lý quảng cáo tiêu chuẩn, ứng dụng vẫn cần phải vượt qua quy trình xét duyệt.

Lớp 3: Xác minh doanh nghiệp

Xác minh doanh nghiệp là một quy trình cho phép chúng tôi xác minh danh tính của bạn với tư cách một thực thể kinh doanh. Chúng tôi cần phải làm vậy nếu ứng dụng của bạn sẽ truy cập vào dữ liệu nhạy cảm. Tìm hiểu thêm về quy trình Xác minh doanh nghiệp.