כדי לסמן קשר עם חשבון מוכר, שותף שופינג צריך קודם להשתמש בשיטה accounts.link
כדי לשלוח בקשת קישור.
בקשת הקישור מכילה linkedAccountId
שמזהה את המוכר שמקבל את הבקשה, מסוג action
מסוג request
. כל קישור צריך גם לציין קבוצה של services
שמציינת אילו תכונות השותף מספק למוכר. הערכים הבאים של services
נתמכים.
שירות | תיאור |
---|---|
shoppingAdsProductManagement |
ניהול נתוני מוצרים למודעות שופינג |
shoppingActionsProductManagement |
ניהול נתוני מוצרים ב'קונים ב-Google' (לשעבר Shopping Actions) |
shoppingActionsOrderManagement |
ניהול הזמנות ב'קונים ב-Google' (לשעבר Shopping Actions) |
בנוסף, הבקשה צריכה לכלול גם linkType
חוקי שמתאר את הסוג של שותף שופינג ששלח את הבקשה. לשותפי שופינג מוקצית אחת מהתוויות הבאות, והם צריכים להשתמש בתווית הייעודית שלהם בשדה linkType
כששולחים קריאה ל-API.
סוגי קישור חוקיים |
---|
channelPartner |
eCommercePlatform |
דוגמה
הקריאה הבאה ל-API שולחת בקשת קישור מחשבון של השותף 123456789
אל המוכר עם linkedAccountId
של "98765"
.
השדה "eCommercePlatform"
linkType
מזהה את השותף כפלטפורמה למסחר אלקטרוני. ברשימה services
מצוין שהשותף מספק את התכונות "shoppingAdsProductManagement"
(ניהול נתוני מוצרים למודעות שופינג) ו-"shoppingActionsOrderManagement"
(ניהול הזמנות ב'קונים ב-Google', שנקראו בעבר Shopping Actions).
POST https://shoppingcontent.googleapis.com/content/v2.1/123456789/accounts/123456789/link
{
"linkedAccountId": "98765",
"linkType": "eCommercePlatform",
"services": ["shoppingAdsProductManagement", "shoppingActionsOrderManagement"],
"action": "request"
}
בקטע הבא מוסבר איך לקבל רשימה של קישורים קיימים.