בקשת קישורים

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

בקטע הבא מוסבר איך לקבל רשימה של קישורים קיימים.