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.