إنشاء رابط شريك أو حذفه

إليك كيفية إنشاء مورد PartnerLink أو حذفه. تتيح واجهة برمجة التطبيقات Data Manager API إنشاء روابط شركاء لأنواع الحسابات التالية:

  • حسابات "إعلانات Google"
  • حسابات الشركاء أو المعلِنين على "مساحة العرض والفيديو 360 "

أنشئ PartnerLink عن طريق إرسال CreatePartnerLinkRequest.

إنشاء نص الطلب

أنشئ مورد PartnerLink. في ما يلي الحقول المطلوب ضبطها.

owning_account

تحدّد هذه السمة حساب المعلِن الذي يملك الرابط. يجب ضبطها على عنصر ProductAccount.

اضبط account_type على AccountType حساب المعلِن.

اضبط قيمة account_id على معرّف حساب المعلِن.

راجِع دليل الوجهات والعناوين للحصول على تعليمات بشأن رقم التعريف الذي يجب استخدامه لكل نوع من المعلِنين.

partner_account

تحدّد هذه السمة حساب الشريك. يجب ضبطها على عنصر ProductAccount.

اضبط account_type على AccountType حساب الشريك. على سبيل المثال، إذا كان الرابط من حساب معلِن إلى حساب شريك بيانات، اضبط هذا الحقل على DATA_PARTNER.

اضبط قيمة account_id على رقم تعريف حساب الشريك.

إنشاء الطلب

لإنشاء رابط شريك، أنشئ CreatePartnerLinkRequest.

  1. اضبط parent على اسم المورد لحساب المعلِن. استخدِم التنسيق التالي:

    accountTypes/{account_type}/accounts/{account}

  2. اضبط قيمة partner_link على مرجع PartnerLink الذي أنشأته.

  3. إذا كانت بيانات الاعتماد خاصة بحساب Google يملك إذن الوصول إلى حساب رئيسي لحساب المعلِن، مثل حساب إداري على "إعلانات Google" أو حساب شريك على "مساحة العرض والفيديو 360"، اضبط العنوان login-account كما هو موضّح في إعداد الوجهات والعناوين.

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

فتح في "مستكشف واجهات برمجة التطبيقات" 
{
    "parent": "accountTypes/GOOGLE_ADS/accounts/INSERT_GOOGLE_ADS_CUSTOMER_ID",
    "partner_link": {
        "owning_account": {
            "accountType": "GOOGLE_ADS",
            "accountId": "INSERT_GOOGLE_ADS_CUSTOMER_ID"
        },
        "partner_account": {
            "accountType": "DATA_PARTNER",
            "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
        }
    }
}

المُعلن في "مساحة العرض والفيديو 360"

فتح في "مستكشف واجهات برمجة التطبيقات" 
{
    "parent": "accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/INSERT_DISPLAY_VIDEO_ADVERTISER_ID",
    "partner_link": {
        "owning_account": {
            "accountType": "DISPLAY_VIDEO_ADVERTISER",
            "accountId": "INSERT_DISPLAY_VIDEO_ADVERTISER_ID"
        },
        "partner_account": {
            "accountType": "DATA_PARTNER",
            "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
        }
    }
}

شريك "مساحة العرض والفيديو 360"

فتح في "مستكشف واجهات برمجة التطبيقات" 
{
    "parent": "accountTypes/DISPLAY_VIDEO_PARTNER/accounts/INSERT_DISPLAY_VIDEO_PARTNER_ID",
    "partner_link": {
        "owning_account": {
            "accountType": "DISPLAY_VIDEO_PARTNER",
            "accountId": "INSERT_DISPLAY_VIDEO_PARTNER_ID"
        },
        "partner_account": {
            "accountType": "DATA_PARTNER",
            "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
        }
    }
}

إرسال الطلب

أرسِل الطلب، وأدرِج عناوين الطلب إذا لزم الأمر. استخدِم بيانات اعتماد لحساب Google لديه إذن الوصول إلى owning_account.

في حال نجاح الطلب، تتضمّن الاستجابة PartnerLink الذي تم إنشاؤه مع ملء id وname.

إذا تعذّر إكمال الطلب، افحص الأخطاء لتحديد سبب تعذّره، وعدِّل الطلب والعناوين لحلّ أي مشاكل، ثم أرسِل الطلب والعناوين المعدَّلة.

لحذف PartnerLink، أرسِل DeletePartnerLinkRequest مع ضبط name على اسم المورد. ضبط العناوين إذا لزم الأمر

السابق
نظرة عامة
التالي
استرداد روابط الشركاء