Listar links

Tanto as contas de parceiros do Shopping quanto as contas de comerciantes individuais podem ter diversos vínculos sinalizados entre as contas deles e outras. 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 requer 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 têm a opção de aprovar todos os serviços listados ou apenas um subconjunto daqueles propostos na solicitação.

Os serviços começam com o status pending até serem aprovados por um comerciante. Após a aprovação, os serviços ficam com o status active.

Os serviços removidos mostrarão um status de inactive se também houver outros serviços do pending ou active. Depois que todos os serviços que incluem um link forem removidos, o link não será mais retornado pelo método listlinks.

Exemplo de solicitação

Para listar o pedido 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. Portanto, 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 um pedido de vinculação.