Ringkasan Manajemen Aset

Sebuah bisnis dapat mengakses beberapa aset. Bisnis Anda memiliki aset atau bisnis Anda mengaksesnya sebagai agensi. Gunakan API Aset Pengelolaan Bisnis Milik Facebook untuk menambah, menghapus, atau melakukan kueri hubungan antara bisnis dan asetnya, untuk mengelola aset bisnis dan akses ke aset tersebut.

Agensi mengacu pada jenis entitas bisnis yang dapat mengelola atau mengakses aset yang dimiliki oleh bisnis lain. Hubungan ini memungkinkan agensi untuk melakukan tugas atau tindakan tertentu atas nama klien, seperti mengelola akun iklan, halaman, atau aset digital lainnya.

Grup Aset Bisnis

Grup aset bisnis membantu pengiklan besar atau agensi secara efisien mengelola pengguna dan aset dalam bisnis mereka. Anda harus mengelola aset dan pengguna sedemikian rupa sehingga sesuai dengan operasi dunia nyata. Contoh, sebuah bisnis dapat menyusun aset dan penggunanya sesuai dengan merek, wilayah, klien, atau prinsip pengorganisasian pilihan mereka.

Grup aset bisnis dapat berisi akun iklan, Halaman, pixel Facebook, set peristiwa offline, aplikasi, katalog, konversi khusus, dan akun Instagram. Aset dapat dimiliki oleh bisnis atau dibagikan untuk memberikan akses ke agensi.

Anda dapat menggunakan API ini untuk menambahkan pengguna ke grup aset bisnis. Setelah ditambahkan, Anda dapat memberikan izin kepada orang untuk aset dalam grup aset bisnis. Ini membantu Anda memberikan akses ke beberapa aset sekaligus, tanpa membuat terlalu banyak admin di tingkat bisnis.

Dengan API ini, Anda dapat mengelola grup aset bisnis yang telah dibuat oleh seseorang melalui Pengelola Bisnis atau Anda dapat mengelola aset dalam grup aset bisnis. Anda dapat:

Mendapatkan daftar grup aset bisnis yang terkait dengan bisnis
Menghapus atau mengganti nama grup aset bisnis
Melihat semua aset dalam grup aset bisnis
Mendapatkan, menambahkan, mengedit, dan menghapus izin pengguna untuk aset dalam grup aset bisnis
Menetapkan pengguna ke grup aset bisnis
Mendapatkan, menambah, dan menghapus aset dari grup aset bisnis

Izin

Untuk menggunakan API Grup Aset Bisnis, aplikasi Anda memerlukan Tingkat Akses Marketing API yang sesuai:

Untuk semua penambahan dan penghapusan endpoint: Pengguna token akses harus menjadi admin bisnis. Jika tidak, akses akan ditolak.
Untuk semua endpoint API, aplikasi Anda memerlukan izin business_management.

Anda memerlukan izin ekstra untuk:

Endpoint Grup Aset Bisnis	Izin yang diperlukan
Dapatkan daftar Akun Iklan	`ads_management`
Dapatkan daftar katalog produk, tambahkan katalog produk atau hapus katalog produk	`ads_management`
Dapatkan daftar akun Instagram, tambahkan akun Instagram atau hapus akun Instagram	`ads_management`. Jika Anda menggunakan Marketing API v4.0, Anda juga membutuhkan `instagram_basic`.
Dapatkan daftar pixel	`ads_read`
Dapatkan daftar set peristiwa offline	`ads_management`
Dapatkan daftar konversi khusus	`ads_read`
Tambahkan konversi khusus	`ads_management`

Batasan

Anda melihat sebuah kesalahan jika berusaha mengurangi atau menghapus izin untuk aset yang terdapat dalam grup aset bisnis melalui panggilan API berikut:

DELETE meminta untuk /{page_id}/assigned_users
POST meminta untuk /{page_id}/assigned_users
DELETE meminta untuk /act_{ad_account_id}/assigned_users
POST meminta untuk /act_{ad_account_id}/assigned_users.

Untuk mengurangi atau menghapus izin, ikuti langkah-langkah berikut:

Buat panggilan untuk mendapatkan daftar grup aset yang terkait dengan bisnis. Cari grup aset di mana contained_asset_id sama dengan {page_id} atau {ad_account_id}.
Untuk setiap id grup aset bisnis yang dikembalikan, lakukan panggilan API untuk menghapus pengguna dari grup itu.
Kemudian, panggil permintaan DELETE atau POST untuk menghapus izin bagi pengguna tersebut di Halaman atau Akun Iklan.

Jika Anda menyediakan fitur manajemen izin di aplikasi Anda untuk bisnis lain, Anda harus menggunakan API ini untuk mencegah ketidakkonsistenan dan kesalahan antara API dan Pengelola Bisnis.

Anda tidak dapat mengatur izin pada aplikasi, katalog, akun Instagram, dan konversi khusus melalui grup aset bisnis. Sebaliknya, Anda harus menetapkan izin di tingkat aset.

Contoh, jika Anda menambahkan Roger ke grup aset bisnis di pengelola bisnis milik Jasper, ia bisa mendapatkan izin ke Halaman, akun iklan, pixel, dan sebagainya, di grup aset bisnis tersebut. Namun, untuk menghapus atau mengedit izin Roger ke aset apa pun di grup aset bisnis milik Jasper, Anda harus melakukan tindakan ini di grup aset bisnis itu sendiri.

Anda dapat menambahkan izin pengguna di tingkat aset menggunakan API aset, seperti mengubah seseorang dari moderator Halaman menjadi admin. Lihat contoh untuk Halaman dan Akun Iklan.

Grup aset bisnis menggantikan Project API pada tanggal 13 Oktober 2019. Anda harus memigrasikan semua aplikasi di Project API ke grup aset bisnis.

Peran yang Diizinkan

Saat pengguna ditambahkan ke bisnis, salah satu dari dua peran berikut dapat ditetapkan melalui API Pengguna Bisnis:

Konstanta API	Nama	Deskripsi
`ADMIN`	Admin Bisnis	Dapat mengelola semua aspek pengaturan bisnis, termasuk mengubah atau menghapus akun dan menambahkan atau menghapus orang.
`EMPLOYEE`	Karyawan Bisnis	Jika pengguna adalah admin bisnis tersebut, pengguna ini dapat melihat semua informasi di pengaturan bisnis tetapi tidak dapat melakukan perubahan, kecuali menambahkan Halaman atau akun iklan.

Katalog

Peran berikut dapat ditetapkan ke setiap pengguna bisnis, Admin atau Karyawan, pada katalog yang dapat diakses oleh bisnis ini menggunakan API Katalog:

Konstanta API	Nama	Deskripsi
`['MANAGE', 'ADVERTISE']`	Admin Katalog	Dapat mengelola semua aspek katalog dengan akses baca dan tulis penuh, termasuk membuat/memperbarui/menghapus produk, mengelola kabar, melampirkan katalog ke pixel dan aplikasi, membuat set produk, menjalankan iklan katalog Advantage+ dengan katalog, mengubah pengaturan katalog, dan sebagainya.
`['ADVERTISE']`	Pengiklan Katalog	Dapat membuat set produk dan menjalankan iklan katalog Advantage+ dengan katalog. Tidak dapat mengedit produk, kabar, atau pengaturan katalognya.

Akun Iklan

Tugas-tugas berikut dapat ditetapkan kepada setiap pengguna bisnis untuk akun iklan yang dapat diakses oleh bisnis ini menggunakan API Akun Iklan:

Konstanta API	Nama	Deskripsi
`['MANAGE', 'ADVERTISE', 'ANALYZE']`	Admin Akun Iklan	Dapat mengelola semua aspek kampanye, pelaporan, tagihan, dan izin akun, dan dapat menetapkan batas pengeluaran akun iklan. Admin akun iklan juga dapat menghubungkan metode pembayaran bisnis.
`['ADVERTISE', 'ANALYZE']`	Pengiklan di akun iklan	Dapat melihat dan mengedit iklan serta menyiapkan iklan menggunakan metode pembayaran yang terhubung dengan akun iklan.
`['ANALYZE']`	Analis Akun Iklan	Dapat melihat kinerja iklan.

Halaman

Anda dapat menetapkan tugas-tugas berikut kepada setiap pengguna bisnis di Halaman yang dapat diakses oleh bisnis ini menggunakan Page API:

Konstanta API	Nama	Deskripsi
`['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']`	Admin halaman	Dapat mengelola peran Halaman, mengirim pesan dan memposting sebagai Halaman, membuat iklan, dan melihat insight.
`['CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']`	Editor halaman	Dapat mengedit Halaman, mengirim pesan dan memposting sebagai Halaman, membuat iklan, dan melihat insight.
`['MODERATE', 'ADVERTISE', 'ANALYZE']`	Moderator halaman	Dapat menanggapi dan menghapus komentar di Halaman, mengirim pesan sebagai Halaman, membuat iklan, dan melihat insight. Tidak dapat memposting sebagai Halaman.
`['ADVERTISE', 'ANALYZE']`	Pengiklan Halaman	Bisa membuat iklan untuk Halaman dan melihat insight. Tidak dapat memposting sebagai Halaman.
`['ANALYZE']`	Analis halaman	Dapat melihat insight. Tidak dapat memposting sebagai Halaman.

Aplikasi

Tidak ada peran atau API manajemen tugas untuk aplikasi di Pengelola Bisnis.

Akun Instagram

Tidak ada manajemen peran untuk akun Instagram di Pengelola Bisnis. Pengguna yang memiliki akses ke akun iklan yang tertaut ke akun Instagram dapat menjalankan iklan untuk akun Instagram tersebut.