כדי לשדרג כל שלב בתהליכי העבודה של קישור השותפים מ-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) |
הערות |
|---|---|---|
|
partner_account |
ב-Data Manager API אין שדות נפרדים לכל סוג של חשבון מקושר.
בכל סוגי החשבונות, צריך להגדיר את השדה partner_account לערך ProductAccount, ולהגדיר את השדות account_type ו-account_id כדי לזהות את החשבון המקושר.
|
product_link_id |
partner_link_id |
|
resource_name |
name |
ב-Google Ads API, השדה
ב-Data Manager API, השילוב של פרטים נוספים זמינים במאמרים שמות של משאבים ויצירת בקשה. |
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 ולהגדיר כותרות של בקשות בתרחישים שונים.