Membuat, Mengambil, dan Memperbarui Pengguna Sistem

Membuat

Gunakan token pengguna sistem admin Anda atau token akses pengguna admin Anda sendiri untuk membuat pengguna sistem.

Catatan: Pengguna sistem hanya dapat diberi peran di aplikasi jika pengguna sistem dan aplikasi dimiliki oleh bisnis yang sama. Jika aplikasi Anda perlu mengakses data menggunakan pengguna sistem dan token akses milik bisnis lain, gunakan Business On Behalf Of API sebagai gantinya.

Berikut ini permintaan yang Anda perlukan untuk mendapatkan token pengguna sistem dan melakukan panggilan API. Tiga langkah pertama merupakan penyiapan yang juga dapat dilakukan di Pengelola Bisnis. Saat membuat pengguna sistem Anda yang pertama, Anda menggunakan token akses pengguna sungguhan, yang merupakan admin pengelola bisnis.

Buat Pengguna Sistem Admin dan Buat Token

1. Buat pengguna sistem admin dengan token akses pengguna admin Anda sendiri.
2. Instal aplikasi dengan pengguna sistem admin, menggunakan token akses pengguna admin.
3. Buat token pengguna sistem admin menggunakan token akses pengguna admin.

Buat pengguna sistem

1. Buat pengguna sistem menggunakan token akses pengguna admin.
2. Atau, buat pengguna sistem menggunakan token akses dari pengguna sistem admin pengelola bisnis Anda, jika sudah Anda buat.

Buat Token Akses Pengguna Sistem

1. Instal aplikasi dengan pengguna sistem, menggunakan token akses dari: pengguna admin, pengguna sistem admin, atau pengguna sistem lain.
2. Tetapkan izin ke aset (seperti akun iklan, Halaman) milik Pengelola Bisnis Anda. Izin harus ditetapkan kepada pengguna sistem yang baru dibuat menggunakan token akses dari: pengguna admin atau pengguna sistem admin.
3. Buat token akses pengguna sistem menggunakan token akses pengguna admin, atau pengguna sistem admin.
4. Sekarang gunakan token akses pengguna sistem untuk membuat panggilan API pada aset bisnis.

Untuk membuat pengguna sistem atau pengguna sistem admin melalui API, Anda perlu:

• Token akses: dari pengguna admin, atau pengguna sistem admin untuk Pengelola Bisnis ini
• Peran: ADMIN atau EMPLOYEE
• Nama: pengidentifikasi pengguna sistem atau pengguna sistem admin ini

Untuk mendapatkan pengguna sistem, buat permintaan POST:

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

Tindakan ini memberikan id lingkup aplikasi untuk pengguna sistem baru:

{
  "id" : "100000008899900"
}

Ini adalah ID lingkup aplikasi untuk pengguna sistem. Gunakan untuk melakukan panggilan API, bukan ID kanonikal di Business Manager > System Users.

Mengambil

Untuk mendapatkan daftar pengguna sistem, Anda memerlukan token akses pengguna admin atau pengguna sistem admin. Daftar ini mencakup pengguna sistem admin, dan ID lingkup aplikasi mereka.

Buat permintaan GET:

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

Ini memberikan daftar semua pengguna sistem, termasuk pengguna sistem admin, yang dimiliki oleh Pengelola Bisnis:

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

Memperbarui

Anda dapat mengubah nama pengguna sistem atau pengguna sistem admin:

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"

Membatalkan token akses

Anda tidak dapat menghapus pengguna sistem atau pengguna sistem admin, tetapi Anda dapat membatalkan semua token akses untuk pengguna tersebut. Membatalkan token dengan mengirim permintaan DELETE ke:

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

Tanggapan memberikan true, jika panggilan berhasil. Setelah itu, Anda dapat membuat token akses baru untuk pengguna sistem seperti di atas.