כדי לסמן קשר עם חשבון מוכר, שותף שופינג צריך קודם להשתמש בשיטה accounts.link כדי לשלוח בקשת קישור.
בקשת הקישור מכילה linkedAccountId
שמזהה את המוכר שמקבל את הבקשה, והסוג action שלה הוא request. כל קישור צריך גם לציין קבוצה של services שבה יפורטו כל התכונות שהשותף מספק למוכר. אפשר להשתמש בערכים הבאים של services.
| שירות | התיאור |
|---|---|
shoppingAdsProductManagement |
ניהול נתוני מוצרים למודעות שופינג |
shoppingActionsProductManagement |
ניהול נתוני מוצרים ל'קונים ב-Google' (לשעבר Shopping Actions) |
shoppingActionsOrderManagement |
ניהול הזמנות ב'קונים ב-Google' (לשעבר Shopping Actions) |
בנוסף, הבקשה צריכה לכלול גם linkType תקין שמתאר את סוג השותף ב-Google שופינג ששלח את הבקשה. לשותפים של שופינג מוקצית אחת מהתוויות הבאות, והם צריכים להשתמש בתווית הייעודית שלהם בשדה 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"
}
בקטע הבא מוסבר איך מקבלים רשימה של קישורים קיימים.