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