Listar links

Tanto os parceiros do Shopping quanto as contas individuais do comerciante podem ter vários links 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 mostrarão 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 deles propostos na solicitação.

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

Os serviços removidos mostrarão um status inactive se outros serviços pending ou active também estiverem presentes. 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 enviado 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 precisa aprovar a solicitação, então os serviços individuais têm o 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.