Enumerar vínculos

Tanto los socios de Shopping como las cuentas de comercios individuales pueden tener varios vínculos marcados entre sus cuentas y otras. El método listlinks muestra 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 mediante una solicitud HTTP GET.

Estado del servicio

Cuando se enumeran 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 de la lista o solo un subconjunto de los propuestos en la solicitud.

Los servicios comienzan con el estado pending hasta que un comercio lo aprueba de manera 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 de pending o active. Una vez que se quitan todos los servicios que incluyen un vínculo, el método listlinks ya no mostrará el vínculo.

Ejemplo de solicitud

Para enumerar la solicitud de vinculación que envió el socio 123456789, envía una solicitud GET sin parámetros mediante 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 todavía no aprobó la solicitud, por lo que los servicios individuales tienen un estado pending.

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

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