rocket
Content API for Shopping의 공식 후속 API인
Merchant API를 만나보세요.
update
새로운 Merchant API 기능, 버그 수정, 업데이트에 관한
최신 소식을 확인하세요.
add_alert
참고: Content API for Shopping은 2026년 8월 18일에 지원이 종료됩니다.
링크 나열
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
쇼핑 파트너와 개별 판매자 계정 모두 계정과 다른 계정 간에 플래그가 지정된 링크가 여러 개 있을 수 있습니다.
listlinks
메서드는 API 호출을 실행하는 판매자 센터 계정의 이러한 모든 연결 목록을 반환합니다. 매개변수가 필요하지 않으며 HTTP GET
요청을 사용하여 호출됩니다.
서비스 상태
링크를 나열할 때 응답에는 링크 내의 각 개별 service
에 대한 status
가 표시됩니다. 판매자는 요청에 제안된 모든 서비스를 승인하거나 일부 서비스만 승인할 수 있습니다.
서비스는 명시적으로 판매자가 승인할 때까지 pending
상태로 시작됩니다. 승인되면 서비스의 상태가 active
가 됩니다.
삭제된 서비스에는 다른 pending
또는 active
서비스도 있는 경우 inactive
상태가 표시됩니다. 링크를 구성하는 모든 서비스가 삭제되면 listlinks
메서드에서 더 이상 링크가 반환되지 않습니다.
요청 예시
파트너 123456789
가 보낸 연결 요청을 나열하려면 listlinks
메서드를 사용하여 매개변수 없이 GET
요청을 보냅니다.
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"
}
]
}
다음 섹션에서는 연결 요청을 승인하는 방법을 설명합니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-13(UTC)
[null,null,["최종 업데이트: 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."]]