Trang

Doanh nghiệp có thể xác nhận quyền sở hữu các trang thuộc về họ. Nhờ vậy, quản trị viên có thể dễ dàng chỉ định người sẽ có quyền truy cập vào những trang đó.

Xác nhận quyền sở hữu trang

Các doanh nghiệp có thể xác nhận quyền sở hữu một trang thuộc về họ. Nhờ vậy, họ có thể quản lý mọi khía cạnh của trang đó, bao gồm cả việc xóa bất kỳ agency nào hoặc các doanh nghiệp khác đã được cấp quyền truy cập. Ngoài ra, các doanh nghiệp cũng có thể yêu cầu quyền truy cập agency vào một trang. Bằng cách này, họ có thể chạy quảng cáo trên trang đó thông qua các tài khoản quảng cáo mà họ có quyền truy cập.

Xác nhận quyền sở hữu trang với vai trò chủ sở hữu

Để xác nhận quyền sở hữu trang cho doanh nghiệp của mình với vai trò OWNER, bạn cần có ID trang và ID doanh nghiệp. Sau đó, hãy gửi yêu cầu POST:

Người yêu cầu cần có:

quyền quản trị trên trang
quyền đối với doanh nghiệp sở hữu. Nếu không, chủ sở hữu của doanh nghiệp sở hữu sẽ cần phải phê duyệt yêu cầu

Để tạo yêu cầu này, bạn phải sử dụng mã truy cập dành cho Người dùng quản trị hoặc Người dùng hệ thống là quản trị viên của doanh nghiệp bạn. Nếu người dùng thực hiện lệnh gọi là Quản trị viên Trang hoặc MANAGER của trang trong hơn 7 ngày, doanh nghiệp sẽ sở hữu Trang này ngay lập tức. Facebook sẽ trả về access_status được đặt là CONFIRMED trong phản hồi. Nếu ai đó trở thành Quản trị viên Trang hoặc MANAGER của trang trong khoảng thời gian nhỏ hơn hoặc bằng 7 ngày, chúng tôi sẽ không tự động phê duyệt yêu cầu API.

Nếu người dùng thực hiện lệnh gọi xác nhận quyền sở hữu với vai trò OWNER không có quyền thích hợp trên Trang, lệnh gọi này sẽ không thành công. Không giống như khi xác nhận quyền sở hữu tài khoản quảng cáo, bạn không cần gửi yêu cầu cho quản trị viên Trang để được phê duyệt.

curl \
  -F "page_id=<PAGE_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_pages"

Xác nhận quyền sở hữu trang với vai trò agency

Để xác nhận quyền sở hữu trang cho doanh nghiệp của mình với vai trò AGENCY, bạn cần có ID trang. Sau đó, hãy gửi yêu cầu POST:

Nếu người yêu cầu có quyền quản trị trên trang, yêu cầu này sẽ tự động được phê duyệt. Nếu không, Quản trị viên Trang sẽ cần phải phê duyệt yêu cầu.

Agency không thể chia sẻ lại Trang với một Doanh nghiệp khác.

Agency có thể bắt đầu chạy quảng cáo trên Trang (thông qua Tài khoản quảng cáo mà họ có quyền truy cập) ngay lập tức.

curl \
  -F "page_id=<PAGE_ID>" \
  -F "permitted_tasks=['ADVERTISE', 'ANALYZE']" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/client_pages"

Nếu bạn sử dụng AGENCY:

Bạn phải cung cấp permitted_tasks
Doanh nghiệp phải sở hữu trang
Mã truy cập phải có quyền pages_manage_metadata và pages_show_list

Nếu bạn thực hiện lệnh gọi xác nhận quyền sở hữu với vai trò AGENCY nhưng không có quyền thích hợp trên Trang, phản hồi sẽ là PENDING. Quản trị viên của Trang đó có thể đăng nhập và cấp/từ chối quyền truy cập hoặc báo cáo yêu cầu xác nhận quyền sở hữu nêu trên là spam. Nếu doanh nghiệp có quá nhiều yêu cầu quyền truy cập Trang bị báo cáo là spam, chúng tôi sẽ khóa Trình quản lý kinh doanh.

Để xem tất cả những trang của khách hàng mà bạn đã yêu cầu quyền truy cập nhưng đang chờ phê duyệt, hãy thực hiện lệnh gọi GET sau đây. Bạn cần có mã truy cập dành cho Người dùng hệ thống là quản trị viên:

curl -G \
-d "access_token=<ADMIN_SYSTEM_USER_ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/pending_client_pages"

Xem trang do doanh nghiệp sở hữu hoặc trang thuộc về khách hàng của doanh nghiệp

Để xem tất cả những trang mà doanh nghiệp bạn sở hữu, hãy sử dụng lệnh gọi GET sau đây:

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_pages"

Để xem tất cả những trang mà doanh nghiệp bạn là agency, hãy sử dụng lệnh gọi GET sau đây:

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/client_pages"

Lệnh gọi này trả về danh sách các trang thuộc về khách hàng của Trình quản lý kinh doanh.

Thêm hàng loạt trang

Bạn có thể thêm các trang riêng lẻ vào Trình quản lý kinh doanh bằng giao diện người dùng Trình quản lý kinh doanh. Nếu bạn muốn thêm hàng loạt trang vào Trình quản lý kinh doanh, hãy thực hiện lệnh gọi POST sau đây:

curl \
-F 'access_token=<ACCESS_TOKEN>' \
-F 'batch=[
  {
    "method":"POST",
    "name":"test1",
    "relative_url":"<BUSINESS_ID>/owned_pages",
    "body":"page_id=<PAGE_ID_1>"
  }, 
  {
    "method":"POST",
    "name":"test2",
    "relative_url":"<BUSINESS_ID>/owned_pages",
    "body":"page_id=<PAGE_ID_2>"
  }, 
  {
    "method":"POST",
    "name":"test3",
    "relative_url":"<BUSINESS_ID>/owned_pages",
    "body":"page_id=<PAGE_ID_3>"
  }, 
]' \
"https://graph.facebook.com/<API_VERSION>"

Trong đó:

<ACCESS_TOKEN> là mã truy cập có quyền business_management.
<BUSINESS_ID> là ID của Trình quản lý kinh doanh sẽ xác nhận quyền sở hữu các trang.
<PAGE_ID_n> là các ID Trang sẽ được xác nhận quyền sở hữu.

Gỡ Trang

Để gỡ Trang khỏi Doanh nghiệp, hãy thực hiện lệnh gọi DELETE sau đây:

curl \
  -X DELETE \
  -F "page_id=<PAGE_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/pages"

Thêm người dùng vào Trang

Sau khi doanh nghiệp của bạn có Trang, bạn có thể chỉ định cho mọi người các tác vụ đối với Trang đó. Tác vụ gồm có:

Tên	Hằng số API	Mô tả
Quản trị viên	`['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']`	Có thể quản lý vai trò quản trị viên, gửi tin nhắn và đăng với vai trò Trang, tạo quảng cáo và xem báo cáo.
Biên tập viên	`['CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']`	Có thể chỉnh sửa Trang, gửi tin nhắn và đăng với vai trò Trang, tạo quảng cáo và xem báo cáo.
Người kiểm duyệt	`['MODERATE', 'ADVERTISE', 'ANALYZE']`	Có thể trả lời và xóa bình luận trên Trang, gửi tin nhắn với vai trò Trang, tạo quảng cáo và xem báo cáo.
Nhà quảng cáo	`['ADVERTISE', 'ANALYZE']`	Có thể tạo quảng cáo cho Trang và xem thông tin chi tiết.
Nhà phân tích	`['ANALYZE']`	Có thể xem báo cáo.

Bạn cần có:

page_id - ID Trang
user_id - ID người dùng cần thêm
Tác vụ cần chỉ định

Hãy thực hiện lệnh gọi POST sau đây để thêm ai đó có tác vụ ['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']:

ID doanh nghiệp phải là ID của doanh nghiệp sở hữu trang

curl \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "tasks=['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']" \
  -F "business=BUSINESS_ID" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users"

Thay đổi quyền truy cập Trang

Để thay đổi tác vụ của người dùng hiện tại, hãy sử dụng lệnh gọi POST tương tự như khi bạn thêm người dùng mới có tác vụ:

curl \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "tasks=['ADVERTISE', 'ANALYZE']" \
  -F "business=BUSINESS_ID" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users"

Xem quyền truy cập Trang

Để xem các trang có quyền người dùng, hãy thực hiện lệnh gọi GET sau đây:

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_SCOPED_USER_ID>/assigned_pages"

Để xem các quyền cụ thể trên Trang, hãy thực hiện lệnh gọi GET sau đây:

curl -G 
  -d "access_token=ACCESS_TOKEN"  
  "https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users?business=<BUSINESS_ID>"

Gỡ quyền truy cập Trang

Để có thể gỡ một trang khỏi Trình quản lý kinh doanh, bạn cũng phải xóa các quản trị viên của trang đó khỏi doanh nghiệp của mình.

Để gỡ quyền truy cập của ai đó khỏi Trang bạn sở hữu, bạn cần có

page_id - ID Trang
user_id - ID của người dùng cần xóa

Lệnh gọi DELETE như sau:

curl \
  -X DELETE \
  -F "user=BUSINESS_SCOPED_USER_ID" \
-F "access_token=ACCESS_TOKEN" \
"https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users"