از نگاشتهای فیلد برای ارتقا دادن هر مرحله از گردشهای کار پیوند شریک از 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) |
یادداشتها |
|---|---|---|
|
partner_account |
Data Manager API برای هر نوع حساب پیوندشده فیلدهای جداگانهای ندارد.
برای همه انواع حساب، فیلد partner_account را روی
ProductAccount تنظیم کنید،
و account_type و account_id آن را برای
شناسایی حساب پیوندشده تنظیم کنید.
|
product_link_id |
partner_link_id |
|
resource_name |
name |
در Google Ads API،
در Data Manager API، ترکیب برای جزئیات، نامهای منابع و ایجاد درخواست را ببینید. |
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 و تنظیم سرایندهای درخواست برای سناریوهای مختلف، بازیابی پیوندهای شریک را بررسی کنید.