מיפוי שדות

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

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

הקודם
שלבים לשדרוג