링크 나열

Merchant API의 베타 버전을 소개합니다. Content API의 새로운 버전이자 미래입니다.

쇼핑 파트너와 개별 판매자 계정 모두 해당 계정과 다른 계정 간에 신고된 여러 개의 링크가 있을 수 있습니다. 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"
        }
    ]
}

다음 섹션에서는 연결 요청을 승인하는 방법을 설명합니다.