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

גם שותפים בשופינג וגם חשבונות של מוכרים פרטיים יכולים לכלול כמה קישורים מסומנים בין החשבונות שלהם לבין חשבונות אחרים. השיטה listlinks מחזירה רשימה של כל הקישורים האלה לחשבון Merchant Center שמבצע את קריאת ה-API. היא לא דורשת פרמטרים ומופעלת באמצעות בקשת HTTP GET.

סטטוס השירות

כשמפרטים קישורים, בתשובות יופיע status לכל service בקישור. המוֹכרים יכולים לאשר את כל השירותים שמופיעים ברשימה או רק קבוצת משנה מתוך השירותים שמוצעים בבקשה.

השירותים מתחילים בסטטוס pending עד שהמוֹכר מאשר אותם באופן מפורש. אחרי שהם מאושרים, השירותים מקבלים סטטוס active.

אם יש גם שירותים אחרים של pending או active, השירותים שהוסרו יופיעו עם הסטטוס inactive. אחרי שמסירים את כל השירותים שמרכיבים קישור, הקישור לא יוחזר יותר על ידי השיטה listlinks.

דוגמה לבקשה

כדי להציג את בקשת הקישור שנשלחה על ידי שותף 123456789, שולחים בקשת GET ללא פרמטרים באמצעות ה-method ‏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"
        }
    ]
}

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