קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
גם שותפים בשופינג וגם חשבונות של מוכרים פרטיים יכולים לכלול כמה קישורים מסומנים בין החשבונות שלהם לבין חשבונות אחרים.
השיטה 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.
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-08-13 (שעון UTC)."],[[["\u003cp\u003eThe Merchant API is the new version of the Content API for Shopping and represents the future of the platform.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003elistlinks\u003c/code\u003e method allows retrieval of all flagged links between accounts, providing insight into account relationships.\u003c/p\u003e\n"],["\u003cp\u003eEach service within a link has a status, starting as \u003ccode\u003epending\u003c/code\u003e, transitioning to \u003ccode\u003eactive\u003c/code\u003e upon approval, and ultimately becoming \u003ccode\u003einactive\u003c/code\u003e when removed.\u003c/p\u003e\n"],["\u003cp\u003eA simple HTTP GET request to the \u003ccode\u003elistlinks\u003c/code\u003e endpoint is sufficient to retrieve link information without requiring any parameters.\u003c/p\u003e\n"]]],["The beta version of the Merchant API, the new Content API for Shopping, is introduced. The `listlinks` method retrieves all links between merchant accounts without parameters via a `GET` request. Each service within a link has a `status`: `pending` (awaiting merchant approval), `active` (approved), or `inactive` (removed, but other services remain). Once all services are removed, the link is no longer listed. A `GET` request example and the `listlinks` method's response format are provided.\n"],null,["# List links\n\nBoth Shopping partners and individual merchant accounts can have multiple\nflagged links between their accounts and others.\nThe [`listlinks`](/shopping-content/reference/rest/v2.1/accounts/listlinks) method\nreturns a list of all these links for the merchant center account\nmaking the API call. It does not require any parameters and is invoked using an\nHTTP `GET` request.\n\nService status\n--------------\n\nWhen listing links, responses will show a `status` for each individual `service`\nwithin a link. Merchants have the option to either approve all listed services\nor only a subset of those proposed in the request.\n\nServices start out in a `pending` status until explicitly [approved by a\nmerchant](/shopping-content/guides/flagging/approve). After they are approved, services have an `active` status.\n\nRemoved services will show a status of `inactive` if there are other `pending`\nor `active` services also present. Once all services comprising a link are\nremoved, the link will no longer be returned by the\n[`listlinks`](/shopping-content/reference/rest/v2.1/accounts/listlinks) method.\n\nExample request\n---------------\n\nTo list the link request sent by partner `123456789`, send a `GET`\nrequest with no parameters using the [`listlinks`](/shopping-content/reference/rest/v2.1/accounts/listlinks) method. \n\n GET https://shoppingcontent.googleapis.com/content/v2.1/123456789/accounts/123456789/listlinks\n\nExample response\n----------------\n\nIn this example, the merchant `98765` has yet to approve the request, so the\nindividual services have a `pending` status. \n\n {\n \"linkedAccountId\": \"98765\",\n \"services\": [\n {\n \"service\": \"shoppingAdsProductManagement\",\n \"status\": \"pending\"\n },\n {\n \"service\": \"shoppingActionsOrderManagement\",\n \"status\": \"pending\"\n }\n ]\n }\n\nThe [next section](/shopping-content/guides/flagging/approve) describes how to approve a linking request."]]
