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

از نگاشت‌های فیلد برای ارتقا دادن هر مرحله از گردش‌های کار پیوند شریک از Google Ads API به Data Manager API استفاده کنید:

اصالت‌سنجی

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

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

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

ProductLink (Google Ads API) PartnerLink (Data Manager API) یادداشت‌ها
  • 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

در Google Ads 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 استفاده می‌کند.

Google Ads API

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

customers/{customer_id}/productLinks/{product_link_id}

میانای برنامه‌سازی کاربردی مدیر داده‌ها

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

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

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

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

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

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

CreateProductLinkRequest (Google Ads API) CreatePartnerLinkRequest (Data Manager API) یادداشت‌ها
customer_id parent روی نام منبع حساب تبلیغ‌کننده مالک تنظیم شده است.
product_link partner_link روی منبع PartnerLink تنظیم شده است. تخصیص فیلدهای شیء را ببینید

حذف درخواست

در اینجا نگاشت‌های فیلد برای تبدیل RemoveProductLinkRequest در Google Ads API به معادل آن DeletePartnerLinkRequest در Data Manager API آورده شده است.

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

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

رویکرد بازیابی پیوندهای شریک بین Google Ads API و Data Manager API متفاوت است.

Google Ads API

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

SELECT
  product_link.product_link_id,
  ...
FROM product_link
WHERE
  ...
میانای برنامه‌سازی کاربردی مدیر داده‌ها

SearchPartnerLinksRequest ارسال کنید. فیلد درخواست اختیاری filter مشخص می‌کند کدام منابع برگردانده شوند. پاسخ حاوی منابع کامل است و همه فیلدها پر شده‌اند.

در اینجا نگاشت‌های فیلد برای تبدیل SearchGoogleAdsRequest در Google Ads API به معادل آن SearchPartnerLinksRequest در Data Manager API آورده شده است.

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

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