גם חשבונות של שותפי שופינג וגם חשבונות מוכרים פרטיים יכולים לכלול כמה קישורים מסומנים בין החשבונות שלהם לחשבונות אחרים.
השיטה listlinks
מחזירה רשימה של כל הקישורים האלה לחשבון Merchant Center שמבצע את הקריאה ל-API. היא לא מחייבת פרמטרים כלשהם והיא מופעלת באמצעות בקשת GET
של HTTP.
סטטוס השירות
כשרושמים קישורים, בתשובות מופיע status
לכל service
בתוך קישור. המוכרים יכולים לאשר את כל השירותים שמופיעים ברשימה או רק חלק מהם.
השירותים מתחילים בסטטוס pending
עד שאושר במפורש על ידי המוכר. אחרי שהם מאושרים, השירותים מקבלים סטטוס active
.
אם יש שירותים נוספים של pending
או של active
, יוצג הסטטוס inactive
של השירותים שהוסרו. אחרי שמסירים את כל השירותים שמכילים קישור, השיטה listlinks
לא מחזירה יותר את הקישור.
בקשה לדוגמה
כדי לרשום את בקשת הקישור שנשלחה על ידי השותף 123456789
, צריך לשלוח בקשת GET
ללא פרמטרים באמצעות השיטה listlinks
.
GET https://shoppingcontent.googleapis.com/content/v2.1/123456789/accounts/123456789/listlinks
תשובה לדוגמה
בדוגמה הזו, המוכר 98765
עדיין לא אישר את הבקשה, ולכן
הסטטוס של השירותים הספציפיים הוא pending
.
{
"linkedAccountId": "98765",
"services": [
{
"service": "shoppingAdsProductManagement",
"status": "pending"
},
{
"service": "shoppingActionsOrderManagement",
"status": "pending"
}
]
}
בקטע הבא מוסבר איך מאשרים בקשת קישור.