نقشه برداری های میدانی

از نگاشت‌های فیلد برای ارتقاء هر مرحله از گردش‌های کاری لینک شریک خود از API گوگل ادز به API مدیریت داده استفاده کنید:

• نگاشت‌های فیلد شیء شامل نگاشت‌های فیلد برای منبعی است که یک شیء پیوند شریک را نشان می‌دهد.
• نگاشت‌های درخواست مدیریت لینک شامل نگاشت‌های فیلد برای درخواست‌های ایجاد و حذف لینک همکار است.
• نگاشت‌های درخواست بازیابی لینک شامل نگاشت‌های فیلد برای بازیابی لینک‌های همکار هستند.

نگاشت‌های فیلد شیء

از نگاشت‌های موجود در جداول برای نگاشت یک ProductLink در API تبلیغات گوگل به معادل PartnerLink آن در API مدیریت داده استفاده کنید.

ProductLink (API تبلیغات گوگل)	PartnerLink (رابط برنامه‌نویسی کاربردی مدیریت داده)	یادداشت‌ها
advertising_partner data_partner google_ads merchant_center	partner_account	رابط برنامه‌نویسی کاربردی مدیریت داده (Data Manager API) برای هر نوع حساب کاربری مرتبط، فیلدهای جداگانه‌ای ندارد. برای همه انواع حساب‌های کاربری، فیلد partner_account را روی ProductAccount تنظیم کنید و account_type و account_id آن را برای شناسایی حساب کاربری مرتبط تنظیم کنید.
product_link_id	partner_link_id
resource_name	name	در API گوگل ادز، customer_id مربوط به resource_name یک ProductLink نشان می‌دهد که کدام حساب مالک یک لینک موجود است. وقتی یک ProductLink ایجاد می‌کنید، با تنظیم customer_id مربوط به CreateProductLinkRequest ، مالک لینک را مشخص می‌کنید. در رابط برنامه‌نویسی کاربردی مدیریت داده (Data Manager API)، ترکیب accountType و accountId از owning_account نشان می‌دهد که کدام حساب مالک یک لینک موجود است. وقتی یک PartnerLink ایجاد می‌کنید، با تنظیم name آن به نام منبع مالک، مالک لینک را مشخص می‌کنید. برای جزئیات بیشتر به نام‌های منابع و ایجاد درخواست مراجعه کنید.
type	owning_account.account_type

نام منابع

رابط برنامه‌نویسی کاربردی مدیریت داده (Data Manager API) از قالب نام منبع متفاوتی نسبت به رابط برنامه‌نویسی کاربردی گوگل ادز (Google Ads API) استفاده می‌کند.

رابط برنامه‌نویسی کاربردی گوگل ادز

در API گوگل ادز، نام منبع ProductLink از قالب زیر استفاده می‌کند:

customers/{customer_id}/productLinks/{product_link_id}

رابط برنامه‌نویسی کاربردی مدیریت داده

در رابط برنامه‌نویسی کاربردی مدیریت داده (Data Manager API)، نام منبع PartnerLink از قالب زیر استفاده می‌کند:

accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}

نگاشت‌های درخواست مدیریت لینک

از نگاشت‌های درخواست در این بخش برای تبدیل درخواست‌های ایجاد، حذف و بازیابی لینک‌های همکار استفاده کنید.

ایجاد درخواست

در اینجا نگاشت‌های فیلد برای تبدیل CreateProductLinkRequest در API گوگل ادز به معادل آن CreatePartnerLinkRequest در API مدیریت داده آمده است.

CreateProductLinkRequest (API تبلیغات گوگل)	CreatePartnerLinkRequest (رابط برنامه‌نویسی کاربردی مدیریت داده)	یادداشت‌ها
customer_id	parent	روی نام منبع حساب تبلیغ‌کننده‌ی مالک تنظیم کنید.
product_link	partner_link	روی منبع PartnerLink تنظیم شود. به نگاشت‌های فیلد شیء مراجعه کنید.

درخواست حذف

در اینجا نگاشت‌های فیلد برای تبدیل یک RemoveProductLinkRequest در API تبلیغات گوگل به معادل آن DeletePartnerLinkRequest در API مدیریت داده آمده است.

RemoveProductLinkRequest (API تبلیغات گوگل)	DeletePartnerLinkRequest (رابط برنامه‌نویسی کاربردی مدیریت داده)	یادداشت‌ها
customer_id	معادلی ندارد.	فیلد name حساب‌های مالک و شریک را در بر می‌گیرد، بنابراین نیازی به این فیلد اضافی نیست.
resource_name	name	روی نام منبع PartnerLink که می‌خواهید حذف کنید، تنظیم کنید.
validate_only	معادلی ندارد.

نگاشت‌های درخواست بازیابی لینک

رویکرد بازیابی لینک‌های همکار بین API گوگل ادز و API دیتا منیجر متفاوت است.

رابط برنامه‌نویسی کاربردی گوگل ادز

یک درخواست SearchGoogleAdsRequest حاوی یک query ارسال کنید. عبارت WHERE اختیاری کوئری، منابعی که باید برگردانده شوند را تعریف می‌کند. عبارت SELECT کوئری، فیلدهایی را که باید روی منابع جزئی برگردانده شده، پر شوند، تعریف می‌کند.

SELECT
  product_link.product_link_id,
  ...
FROM product_link
WHERE
  ...

رابط برنامه‌نویسی کاربردی مدیریت داده

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

در اینجا نگاشت‌های فیلد برای تبدیل یک SearchGoogleAdsRequest در API تبلیغات گوگل به معادل آن SearchPartnerLinksRequest در API مدیریت داده آمده است.

SearchGoogleAdsRequest (API تبلیغات گوگل)	SearchPartnerLinksRequest (API مدیریت داده)	یادداشت‌ها
customer_id	parent	روی نام منبع حساب مورد نظر برای جستجو تنظیم کنید.
page_size	page_size
page_token	page_token
query	filter	filter را طوری تنظیم کنید که مشخص کند کدام منابع برگردانده شوند. رابط برنامه‌نویسی کاربردی مدیریت داده، منابع کامل را برمی‌گرداند، بنابراین معادلی برای عبارت SELECT وجود ندارد.
search_settings	معادلی ندارد.
validate_only	معادلی ندارد.

برای اطلاعات بیشتر، از جمله نحوه ساخت filter درخواست SearchPartnerLinksRequest و تنظیم هدرهای درخواست برای سناریوهای مختلف، به لینک‌های Retrieve partner مراجعه کنید.