הצגת רשימה של קישורים

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

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