Para marcar una relación con una cuenta de comerciante, un socio de Shopping primero debe usar el método accounts.link para enviar una solicitud de vinculación.
La solicitud de vinculación contiene un linkedAccountId que identifica al comercio que recibe la solicitud y tiene un tipo action de request. Cada vínculo también debe especificar un conjunto de services
que enumere las funciones que el socio le proporciona al comercio. Se admiten los siguientes valores services.
| Servicio | Descripción |
|---|---|
shoppingAdsProductManagement |
Administración de datos de productos para anuncios de Shopping |
shoppingActionsProductManagement |
Administración de datos de productos para Comprar con Google (antes conocida como Acciones de Shopping) |
shoppingActionsOrderManagement |
Administración de pedidos para Comprar con Google (antes conocida como Acciones de Shopping) |
Además, una solicitud también debe contener un linkType válido que describa el tipo de socio de Shopping que realiza la solicitud. A los socios de Shopping se les asigna una de las siguientes etiquetas y deben usar sus etiquetas designadas en el campo linkType cuando llamen a la API.
| LinkTypes válidos |
|---|
channelPartner |
eCommercePlatform |
Ejemplo
La siguiente llamada a la API envía una solicitud de vinculación desde la cuenta 123456789 de un socio a un comercio con un linkedAccountId de "98765".
El linkType "eCommercePlatform" identifica al socio como una plataforma de comercio electrónico. La lista services indica que el socio proporciona las funciones "shoppingAdsProductManagement" (administración de datos de productos para anuncios de Shopping) y "shoppingActionsOrderManagement" (administración de pedidos para Comprar con Google, antes conocida como Acciones de Shopping).
POST https://shoppingcontent.googleapis.com/content/v2.1/123456789/accounts/123456789/link
{
"linkedAccountId": "98765",
"linkType": "eCommercePlatform",
"services": ["shoppingAdsProductManagement", "shoppingActionsOrderManagement"],
"action": "request"
}
En la siguiente sección, se describe cómo obtener una lista de las vinculaciones existentes.