ایجاد یا حذف لینک همکار

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

• حساب‌های کاربری گوگل ادز
• حساب‌های کاربری شریک Display & Video 360 یا تبلیغ‌کننده Display & Video 360

ایجاد لینک

با ارسال 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. اگر اطلاعات کاربری شما مربوط به یک حساب گوگل با دسترسی به حساب والد حساب تبلیغ‌کننده، مانند حساب مدیر تبلیغات گوگل یا حساب همکار Display & Video 360 است، سربرگ login-account همانطور که در پیکربندی مقصدها و سربرگ‌ها توضیح داده شده است، تنظیم کنید.

در اینجا نمونه درخواست‌هایی در قالب JSON برای ایجاد لینک به یک حساب شریک داده در انواع مختلف حساب‌های تبلیغ‌کننده ارائه شده است.

تبلیغات گوگل

باز کردن در کاوشگر API

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

تبلیغ کننده DV360

باز کردن در کاوشگر API

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

شریک DV360

باز کردن در کاوشگر API

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

درخواست را ارسال کنید

درخواست را ارسال کنید و در صورت لزوم، هدرهای درخواست را نیز اضافه کنید. از اعتبارنامه‌های یک حساب گوگل با دسترسی به owning_account استفاده کنید.

اگر درخواست با موفقیت انجام شود، پاسخ شامل PartnerLink ایجاد شده با id و name وارد شده است.

اگر درخواست با شکست مواجه شد، خطاها را بررسی کنید تا علت شکست را مشخص کنید، درخواست و هدرها را به‌روزرسانی کنید تا هرگونه مشکل را برطرف کنید و سپس درخواست و هدرهای به‌روزرسانی‌شده را ارسال کنید.

حذف یک لینک

برای حذف یک PartnerLink ، یک DeletePartnerLinkRequest با name که با نام منبع تنظیم شده است ارسال کنید. در صورت لزوم، هدرها را تنظیم کنید .