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

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

أرسِل SearchPartnerLinkRequest. يحدّد حقل الطلب الاختياري 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 موارد كاملة، لذا لا يوجد ما يعادل عبارة `SELECT`.
`search_settings`	ما مِن مكافئ.
`validate_only`	ما مِن مكافئ.

اطّلِع على استرداد روابط الشركاء للحصول على مزيد من المعلومات، بما في ذلك كيفية إنشاء filter لطلب SearchPartnerLinksRequest وضبط عناوين الطلبات لمختلف السيناريوهات.

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

تعيينات الحقول تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.