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

استخدِم عمليات ربط الحقول لترقية كل خطوة من خطوات سير عمل روابط الشركاء من 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 API موارد كاملة ، لذا لا يوجد ما يعادل بند SELECT
search_settings لا يوجد ما يعادله.
validate_only لا يوجد ما يعادله.

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

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