בקשת קישורים

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

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