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.