Grup Aset dan Pengguna

Kelola grup aset bisnis Anda dan pelajari cara menghubungkan pengguna bisnis Anda ke grup aset. 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.

Grup Aset

Mendapatkan Daftar Grup

Untuk mendapatkan daftar grup aset yang terkait dengan bisnis, kirim permintaan GET ke endpoint BusinessBusinessAssetGroups.

Contoh Permintaan

curl -i -X GET 
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/business_asset_groups
    ?access_token=<ACCESS_TOKEN>"

Contoh Tanggapan

{
  "data": [
    {
      "id": "BUSINESS-ID",
      "name": "Northern Region"
    },
    {
      "id": "BUSINESS-ID",
      "name": "Western Region"
    }
  ],
....
}

Mendapatkan Grup Tertentu

Untuk mendapatkan detail tentang grup aset bisnis tertentu, kirim permintaan GET ke endpoint BusinessAssetGroup.

Contoh Permintaan

curl -i -X GET 
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>
    ?access_token=<ACCESS_TOKEN>"

Contoh Tanggapan

{
  "id": "BUSINESS-ASSET-GROUP-ID", "name": "BUSINESS-ASSET-GROUP-NAME"
}

Mengganti Nama Grup

Untuk mengganti nama grup aset tertentu, kirim permintaan POST ke endpoint BusinessAssetGroup dan atur name ke nilai baru.

Contoh Permintaan

curl -i -X POST 
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>
   ?name=BUSINESS-ASSET-GROUP-NAME
   &access_token=<ACCESS_TOKEN>"

Contoh Tanggapan

"success":  "true"

Menghapus Grup

Untuk menghapus grup aset tertentu, kirim permintaan DELETE ke endpoint BusinessAssetGroup.

Contoh Permintaan

curl -i -X DELETE 
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>
    ?access_token=<ACCESS_TOKEN>"

Contoh Tanggapan

"success":  "true"

Pengguna

Kolom Pengguna Publik bagi Pengguna yang memiliki peran pada bisnis yang telah mengeklaim aplikasi.

Persyaratan

• Fitur Akses Profil Pengguna Aset Bisnis memungkinkan aplikasi Bisnis untuk membaca satu set kecil Kolom publik tentang Pengguna, selama Pengguna terlibat dengan aset milik Bisnis yang telah mengeklaim aplikasi.

Baca referensi Akses Profil Pengguna Aset Bisnis untuk daftar Kolom Pengguna yang dapat dibaca.

Mendapatkan Akses Pengguna ke Grup

Untuk melihat daftar semua grup aset bisnis yang dapat diakses oleh pengguna lingkup bisnis, kirim permintaan GET ke endpoint BusinessScopedUser/AssignedBusinessAssetGroups.

Contoh Permintaan

curl -i -X GET 
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_SCOPED_USER_ID>/assigned_business_asset_groups
    ?limit=1
    &access_token=<ACCESS_TOKEN>"

Contoh Tanggapan

Tanggapan mencakup peran yang menentukan level akses yang dimiliki pengguna per jenis aset:

{
  "data": [
    {
      "id": "BUSINESS-ID" 
      "name": "USER NAME",      
      "page_roles": [ "ANALYZE", "ADVERTISE" ],
      "offline_conversion_data_set_roles": ["UPLOAD"],
      "adaccount_roles": ["ANALYZE", "ADVERTISE"],      
      "pixel_roles": ["ANALYZE", "EDIT"]    
    }  
    ],
        ....
}

Mendapatkan Izin Pengguna

Untuk membaca daftar pengguna yang ditetapkan untuk grup aset, kirim permintaan GET ke endpoint BusinessAssetGroupAssignedUsers.

Contoh Permintaan

curl -i -X GET
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/assigned_users
    ?limit=2
    &business=<BUSINESS_ID>
    &access_token=<ACCESS_TOKEN>"

Contoh Tanggapan

{
  "data": [
    {
      "id": "BUSINESS-ID",
      "name": "Dabney Donigan",
      "page_roles": [ "ANALYZE" ],  
      "offline_conversion_data_set_roles": [ "ADVERTISE", "UPLOAD", "MANAGE" ],
      "adaccount_roles": [ "ANALYZE" ],
      "pixel_roles": [ "ANALYZE", "EDIT" ]
      }
      ],
   ....
}

Menetapkan Pengguna ke Grup Aset

Untuk menetapkan pengguna ke grup aset bisnis, kirim permintaan POST ke endpoint BusinessAssetGroupAssignedUsers.

Contoh Permintaan

curl -i -X POST 
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/assigned_users
    ?business=<BUSINESS_ID>
    &user=USER-ID 
    &page_roles=LIST-OF-PAGE-ROLES
    &adaccount_roles=LIST-OF-AD-ACCOUNT-ROLES
    &pixel_roles=LIST-OF-PIXEL-ROLES
    &offline_conversion_data_set_roles=LIST-OF-OFFLINE-CONVERSION-ROLES
    &access_token=<ACCESS_TOKEN>"

Contoh Tanggapan

"success":  "true"

Menghapus Pengguna dari Grup Aset

Untuk menghapus pengguna dari grup, kirim permintaan POST ke endpoint BusinessAssetGroup.

Contoh Permintaan

curl -i -X DELETE \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/assigned_users
    ?business=<BUSINESS_ID>
    &user=<USER_ID>
    &access_token=<ACCESS_TOKEN>"

Contoh Tanggapan

"success":  "true"