כדי לסמן קשר עם חשבון מוֹכרים, שותף שופינג צריך קודם להשתמש בשיטה accounts.link כדי לשלוח בקשת קישור.
בקשת הקישור מכילה linkedAccountId שמזהה את המוכר שמקבל את הבקשה, והיא מסוג request עם action. בכל קישור צריך גם לציין קבוצה של 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"
}
בקטע הבא מוסבר איך מקבלים רשימה של קישורים קיימים.