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

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

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

إنشاء رابط

أنشئ 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 لإنشاء رابط إلى حساب خاص بشريك بيانات في أنواع مختلفة من حسابات المعلِنين.

{
    "owningAccount": {
        "accountType": "GOOGLE_ADS",
        "accountId": "INSERT_GOOGLE_ADS_CUSTOMER_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

{
    "owningAccount": {
        "accountType": "DISPLAY_VIDEO_ADVERTISER",
        "accountId": "INSERT_DISPLAY_VIDEO_ADVERTISER_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

{
    "owningAccount": {
        "accountType": "DISPLAY_VIDEO_PARTNER",
        "accountId": "INSERT_DISPLAY_VIDEO_PARTNER_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

{
    "owningAccount": {
        "accountType": "GOOGLE_AD_MANAGER_AUDIENCE_LINK",
        "accountId": "INSERT_GAM_AUDIENCE_LINK_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

إرسال الطلب

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

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

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

حذف رابط

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