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

في ما يلي كيفية إنشاء مورد 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"
        }
    }
}

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

{
    "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 على اسم المورد. اضبط العناوين إذا لزم الأمر.