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

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

סטטוס השירות

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

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

הסטטוס של שירותים שהוסרו יהיה inactive אם קיימים גם שירותי pending או active אחרים. אחרי שמסירים את כל השירותים שמרכיבים קישור, הקישור לא יוחזר יותר באמצעות השיטה 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"
        }
    ]
}

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