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