מיפוי שדות

כדי לשדרג כל שלב בתהליכי העבודה של קישור השותפים מ-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 ולהגדיר כותרות של בקשות בתרחישים שונים.