ایجاد یا حذف پیوند شریک

در اینجا نحوه ایجاد یا حذف منبع PartnerLink آورده شده است. «میانای برنامه‌سازی کاربردی مدیر داده» از ایجاد پیوندهای شریک برای انواع حساب زیر پشتیبانی می‌کند:

• حساب‌های Google Ads
• حساب‌های شریک Display & Video 360 یا حساب‌های تبلیغ‌کننده Display & Video 360
• حساب‌های Google Ad Manager

ایجاد پیوند

با ارسال CreatePartnerLinkRequest، PartnerLink ایجاد کنید.

ساختن متن درخواست

یک منبع 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 Ads یا حساب «شریک» Display & Video 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 تنظیم‌شده روی نام منبع ارسال کنید. درصورت نیاز، سرایندها را تنظیم کنید.