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

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

إعلانات Google

الفتح في "مستكشف واجهات برمجة التطبيقات"

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

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

الفتح في "مستكشف واجهات برمجة التطبيقات"

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

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

الفتح في "مستكشف واجهات برمجة التطبيقات"

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

إدارة إعلانات Google

الفتح في "مستكشف واجهات برمجة التطبيقات"

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