Tạo, truy xuất và cập nhật người dùng hệ thống

Nếu đây là lần đầu tiên tạo người dùng hệ thống, bạn chưa có mã người dùng hệ thống quản trị. Đầu tiên, bạn phải lấy mã truy cập của người dùng quản trị thật trong Trình quản lý kinh doanh.

Tạo

Hãy sử dụng mã người dùng hệ thống quản trị hoặc mã truy cập dành cho người dùng quản trị của riêng bạn để tạo người dùng hệ thống.

Lưu ý: Người dùng hệ thống chỉ được cấp vai trò trong ứng dụng nếu cả người dùng hệ thống và ứng dụng đều thuộc cùng một doanh nghiệp. Nếu ứng dụng của bạn cần truy cập vào dữ liệu bằng người dùng hệ thống và mã truy cập thuộc một doanh nghiệp khác, hãy sử dụng API Thay mặt doanh nghiệp.

Sau đây là những yêu cầu mà bạn cần để lấy mã người dùng hệ thống và thực hiện lệnh gọi API. Bạn cũng có thể thực hiện 3 bước thiết lập đầu tiên trong Trình quản lý kinh doanh. Khi tạo người dùng hệ thống đầu tiên, bạn sẽ sử dụng mã truy cập của người dùng thật. Người đó là admin của trình quản lý kinh doanh.

Tạo người dùng hệ thống quản trị và tạo mã

  1. Tạo người dùng hệ thống quản trị bằng mã truy cập dành cho người dùng quản trị của riêng bạn.
  2. Cài đặt ứng dụng có người dùng hệ thống quản trị bằng mã truy cập của người dùng quản trị.
  3. Tạongười dùng hệ thống quản trị bằng mã truy cập của người dùng quản trị.

Tạo người dùng hệ thống

  1. Tạo người dùng hệ thống bằng mã truy cập của người dùng quản trị.
  2. Hoặc tạo người dùng hệ thống bằng mã truy cập của người dùng hệ thống quản trị trong trình quản lý kinh doanh của bạn, nếu bạn đã tạo.

Tạo mã truy cập dành cho người dùng hệ thống

  1. Cài đặt ứng dụng có người dùng hệ thống bằng mã truy cập của người dùng quản trị, người dùng hệ thống quản trị hoặc người dùng hệ thống khác.
  2. Chỉ định quyền cho tài sản (ví dụ: tài khoản quảng cáo, Trang) thuộc Trình quản lý kinh doanh của bạn. Bạn nên chỉ định quyền cho người dùng hệ thống mới tạo bằng mã truy cập của người dùng quản trị hoặc người dùng hệ thống quản trị.
  3. Tạo mã truy cập dành cho người dùng hệ thống bằng mã truy cập của người dùng quản trị hoặc người dùng hệ thống quản trị.
  4. Giờ thì sử dụng mã truy cập dành cho người dùng hệ thống để thực hiện lệnh gọi API trên tài sản doanh nghiệp.

Để tạo người dùng hệ thống hoặc người dùng hệ thống quản trị qua API, bạn cần có:

  • Mã truy cập của người dùng quản trị hoặc người dùng hệ thống quản trị cho Trình quản lý kinh doanh này
  • Vai trò: ADMIN hoặc EMPLOYEE
  • Tên: thông tin nhận dạng của người dùng hệ thống hoặc người dùng hệ thống quản trị này

Để tạo người dùng hệ thống, hãy gửi yêu cầu POST:

curl \
-F "name=Ad Server" \
-F "role=EMPLOYEE" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/system_users"

Hệ thống sẽ trả về id trong ứng dụng của người dùng hệ thống mới:

{
  "id" : "100000008899900"
}

Đây là ID trong ứng dụng dành cho người dùng hệ thống. Bạn cần dùng ID này để thực hiện lệnh gọi API, chứ không dùng ID chính tắc trong Business Manager > System Users.

Truy xuất

Để lấy danh sách người dùng hệ thống, bạn cần có mã truy cập dành cho người dùng quản trị hoặc người dùng hệ thống quản trị. Danh sách này sẽ liệt kê người dùng hệ thống quản trị cùng ID trong ứng dụng của họ.

Gửi yêu cầu GET:

curl "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/system_users?access_token=<ACCESS_TOKEN>>"

Hệ thống sẽ trả về danh sách tất cả người dùng hệ thống (bao gồm cả người dùng hệ thống quản trị) thuộc một Trình quản lý kinh doanh:

{
  "data": [
    {
      "id": "1000081799813",
      "name": "Reporting server"
      "role": "ADMIN",
    }, 
  ]
}

Cập nhật

Bạn có thể thay đổi tên của người dùng hệ thống hoặc người dùng hệ thống quản trị:

curl \
-F "system_user_id=<APP_SCOPED_SYSTEM_USER_ID>" \
-F "name=FBX Server" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/system_users"

Vô hiệu hóa mã truy cập

Bạn không thể xóa người dùng hệ thống hoặc người dùng hệ thống quản trị, nhưng có thể vô hiệu hóa tất cả mã truy cập dành cho người dùng đó. Để vô hiệu hóa mã, hãy gửi yêu cầu DELETE đến:

https://graph.facebook.com/<API_VERSION>/<APP_SCOPED_SYSTEM_USER_ID>/access_tokens

Hệ thống sẽ trả về true nếu lệnh gọi thành công. Sau đó, bạn có thể tạo mã truy cập mới dành cho người dùng hệ thống như trên.