Listar links

Tanto os parceiros do Shopping quanto as contas individuais de comerciantes podem ter vários links sinalizados entre as contas deles e de outras pessoas. O método listlinks retorna uma lista de todos esses links para a conta do Merchant Center que faz a chamada de API. Ela não exige parâmetros e é invocada usando uma solicitação HTTP GET.

Status do serviço

Ao listar links, as respostas vão mostrar um status para cada service individual em um link. Os comerciantes podem aprovar todos os serviços listados ou apenas um subconjunto dos serviços propostos na solicitação.

Os serviços começam com o status pending até serem aprovados por um comerciante. Depois de aprovados, os serviços têm um status active.

Os serviços removidos vão mostrar o status inactive se houver outros serviços pending ou active também presentes. Depois que todos os serviços que compõem um link são removidos, o link não é mais retornado pelo método listlinks.

Exemplo de solicitação

Para listar a solicitação de vinculação enviada pelo parceiro 123456789, envie uma solicitação GET sem parâmetros usando o método listlinks.

GET https://shoppingcontent.googleapis.com/content/v2.1/123456789/accounts/123456789/listlinks

Exemplo de resposta

Neste exemplo, o comerciante 98765 ainda não aprovou a solicitação, então os serviços individuais têm um status pending.

{
    "linkedAccountId": "98765",
    "services": [
        {
            "service": "shoppingAdsProductManagement",
            "status": "pending"
        },
        {
            "service": "shoppingActionsOrderManagement",
            "status": "pending"
        }
    ]
}

A próxima seção descreve como aprovar uma solicitação de vinculação.