מיפוי שדות

משתמשים במיפוי השדות כדי לשדרג כל שלב בתהליכי העבודה של קישור השותפים מ-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 כדי להגדיר אילו משאבים יוחזרו. ה-API של המרכז לניהול נתונים מחזיר משאבים מלאים, ולכן אין מקבילה לסעיף SELECT.
search_settings אין מקבילה.
validate_only אין מקבילה.

במאמר אחזור קישורים לשותפים מוסבר איך ליצור בקשת filter של SearchPartnerLinksRequest ולהגדיר כותרות של בקשות לתרחישים שונים.

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