מיפוי שדות

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

שלבים לשדרוג

מיפוי שדות קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.