المستخدمون ومجموعات الأصول

يمكنك إدارة مجموعات الأصول الخاصة بالنشاط التجاري والتعرف على كيفية ربط مستخدمي النشاط التجاري بمجموعات الأصول. تساعد مجموعات أصول النشاط التجاري كبار المعلنين أو الوكالات في إدارة المستخدمين والأصول في النشاط التجاري. يجب تنظيم الأصول والمستخدمين بطريقة تلائم العمليات الفعلية. على سبيل المثال، يمكن للنشاط التجاري هيكلة الأصول والمستخدمين وفقًا للعلامة التجارية أو المنطقة أو العميل أو مبدأ تنظيمي من اختياره.

يمكن أن تحتوي مجموعات أصول النشاط التجاري على حسابات إعلانية وصفحات ووحدات بيكسل فيسبوك ومجموعات أحداث بلا اتصال وتطبيقات وكتالوجات وتحويلات مخصصة وحسابات Instagram. يمكن أن تكون الأصول مملوكة لنشاط تجاري ما أو تتم مشاركتها لتوفير الوصول إلى الوكالة.

مجموعات الأصول

الحصول على قائمة بالمجموعات

للحصول على قائمة بمجموعات الأصول المرتبطة بنشاط تجاري ما، أرسل طلب GET إلى نقطة النهاية BusinessBusinessAssetGroups.

مثال على الطلب

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

مثال على الاستجابة

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

الحصول على مجموعة محددة

للحصول على تفاصيل حول مجموعة أصول نشاط تجاري محددة، أرسل طلب GET إلى نقطة النهاية BusinessAssetGroup.

مثال على الطلب

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

مثال على الاستجابة

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

إعادة تسمية المجموعة

لإعادة تسمية مجموعة أصول محددة، أرسل طلب POST إلى نقطة النهاية BusinessAssetGroup مع تعيين name للقيمة الجديدة.

مثال على الطلب

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

مثال على الاستجابة

"success":  "true"

حذف المجموعة

لحذف مجموعة أصول محددة، أرسل طلب DELETE إلى نقطة النهاية BusinessAssetGroup.

مثال على الطلب

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

مثال على الاستجابة

"success":  "true"

المستخدمون

حقول المستخدم العام للمستخدم الذي له دور في النشاط التجاري الذي طالب بالتطبيق.

المتطلبات

• تسمح ميزة الوصول إلى الملف الشخصي لمستخدم أصل النشاط التجاري لتطبيقات الأعمال بقراءة مجموعة صغيرة من الحقول العامة لدى المستخدم، طالما أن المستخدم قد تفاعل مع الأصول المملوكة بواسطة نشاط تجاري قد طالب بالتطبيق.

وللحصول على قائمة بحقول المستخدم القابلة للقراءة، يمكنك الرجوع إلى مرجع الوصول إلى الملف الشخصي لمستخدم أصل النشاط التجاري.

الحصول على صلاحية وصول المستخدم إلى المجموعات

لعرض قائمة بجميع مجموعات أصول النشاط التجاري التي يمكن للمستخدم على مستوى النشاط التجاري الوصول إليها، أرسل طلب GET إلى نقطة النهاية BusinessScopedUser/AssignedBusinessAssetGroups.

مثال على الطلب

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

مثال على الاستجابة

تتضمن الاستجابة الأدوار التي تحدد مستويات الوصول المتوفرة لدى المستخدم لكل نوع من الأصول:

{
  "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"]    
    }  
    ],
        ....
}

الحصول على أذونات المستخدم

لقراءة قائمة بالمستخدمين المعينين لمجموعة أصول، أرسل طلب GET إلى نقطة النهاية BusinessAssetGroupAssignedUsers.

مثال على الطلب

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>"

مثال على الاستجابة

{
  "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" ]
      }
      ],
   ....
}

تعيين مستخدم إلى مجموعة أصول

لتعيين المستخدمين إلى مجموعة أصول نشاط تجاري، أرسل طلب POST إلى نقطة النهاية BusinessAssetGroupAssignedUsers.

مثال على الطلب

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>"

مثال على الاستجابة

"success":  "true"

إزالة مستخدم من مجموعة أصول

لإزالة مستخدم ما من المجموعة، أرسل طلب POST إلى نقطة النهاية BusinessAssetGroup.

مثال على الطلب

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>"

مثال على الاستجابة

"success":  "true"