Enumerar vínculos

Tanto los socios de Shopping como las cuentas de comerciante individuales pueden tener varios vínculos marcados entre sus cuentas y otras. El método listlinks devuelve una lista de todos estos vínculos para la cuenta de Merchant Center que realiza la llamada a la API. No requiere ningún parámetro y se invoca con una solicitud HTTP GET.

Estado del servicio

Cuando se enumeren vínculos, las respuestas mostrarán un status para cada service individual dentro de un vínculo. Los comercios tienen la opción de aprobar todos los servicios enumerados o solo un subconjunto de los que se proponen en la solicitud.

Los servicios comienzan con el estado pending hasta que un comerciante los aprueba de forma explícita. Una vez que se aprueban, los servicios tienen el estado active.

Los servicios quitados mostrarán el estado inactive si también hay otros servicios pending o active. Una vez que se quiten todos los servicios que componen un vínculo, el vínculo ya no se devolverá con el método listlinks.

Ejemplo de solicitud

Para enumerar la solicitud de vinculación enviada por el socio 123456789, envía una solicitud GET sin parámetros con el método listlinks.

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

Ejemplo de respuesta

En este ejemplo, el comercio 98765 aún no aprobó la solicitud, por lo que los servicios individuales tienen el estado pending.

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

En la próxima sección, se describe cómo aprobar una solicitud de vinculación.