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

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

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