בקשת קישורים

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

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