تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

تعيينات الحقول

استخدِم عمليات ربط الحقول لترقية كل خطوة من خطوات سير عمل روابط خدمات الشركاء من 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

في 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
  ...

Data Manager API

أرسِل 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 وضبط عناوين الطلبات في سيناريوهات مختلفة.

خطوات الترقية