Administra las relaciones de la cuenta

Puedes usar la API de Accounts para administrar las relaciones entre tu cuenta de Merchant Center y otros proveedores de servicios. Una relación es una conexión formal que permite que un proveedor ofrezca servicios específicos a tu empresa. Un servicio define los permisos y las capacidades que se otorgan al proveedor, como la administración de productos o la administración de campañas. Por ejemplo, si vinculas tu cuenta de Merchant Center a una cuenta de Google Ads, esta última podrá usar tus datos de productos para publicar campañas publicitarias.

Una relación se compone de los siguientes atributos:

  • La cuenta de Merchant Center que recibe el servicio
  • El proveedor de servicios
  • El servicio o conjunto de servicios que se proporcionan a la cuenta de Merchant Center

Los proveedores de servicios pueden asociar un alias con las cuentas a las que prestan servicios (esto equivale al campo seller_id que estaba presente en el recurso account de la API de Content for Shopping). El alias se puede asignar con el campo opcional account_id_alias dentro del recurso AccountRelationship y sirve como identificador personalizado.

La estructura de URL para acceder a una cuenta con su alias es GET /accounts/v1/accounts/{provider}~{account_id_alias}.

Servicios

En la API de Accounts, las cuentas pueden recibir los siguientes servicios:

  • Agregación de cuentas: Modela la relación entre una cuenta avanzada y las cuentas a las que presta servicios. El proveedor de servicios (la cuenta avanzada) obtiene acceso completo y sin restricciones a las subcuentas vinculadas. En este caso, externalAccountId es el identificador de la cuenta de Merchant Center. Cuando crees una cuenta secundaria, se debe omitir externalAccountId, ya que se asignará al ID de la cuenta cuando se cree.

  • Administración de campañas: Este servicio modela la vinculación entre una cuenta de Merchant Center y una cuenta de Google Ads, lo que le otorga a la cuenta de Google Ads acceso a los datos de productos y de la cuenta necesarios para publicar campañas publicitarias. En este caso, el proveedor de servicios es GOOGLE_ADS y externalAccountId es el ID de la cuenta de Google Ads.

  • Comparación de productos: Representa la relación con un Servicio de comparación de productos (CSS) que opera la cuenta de Merchant Center.

  • Administración de fichas locales: Representa la relación con un administrador de la tienda para administrar el inventario y las fichas locales con un Perfil de Negocio de Google.

  • Administración de cuentas: Este servicio permite que el proveedor realice acciones administrativas en la cuenta de Merchant Center, como configurar los parámetros de configuración de la cuenta, administrar usuarios o actualizar la información de la empresa. La empresa también puede restringir el acceso otorgado.

  • Administración de productos: Este servicio permite a los proveedores administrar productos y funciones relacionadas, como fuentes de datos y reglas.

Apretón de manos

Para establecer un servicio, tanto la cuenta que lo proporciona como la que lo recibe deben autorizar la conexión. Este proceso de autorización se denomina handshake.

El protocolo de enlace es un proceso de dos pasos:

  1. Una de las partes propone una vinculación de servicio.
  2. La otra parte aprueba o rechaza la propuesta.

Una vez que se acepta una propuesta, se aprueba el servicio y se considera que está completamente establecido. Cualquier derecho de acceso conferido al proveedor de servicios ahora se otorga a los usuarios calificados (consulta los derechos de acceso a continuación).

Ten en cuenta que el usuario que crea, rechaza o aprueba una propuesta debe tener ADMIN derechos de acceso en la cuenta que inicia el proceso. Por lo tanto, si el proveedor de servicios propone un servicio, el usuario que realiza la propuesta debe ser un ADMIN en la cuenta del proveedor de servicios, y el usuario que acepta o rechaza la propuesta debe ser un ADMIN en la cuenta receptora.

Comportamiento de handshake específico del servicio

A continuación, se incluye una descripción de los requisitos específicos de protocolo de enlace para cada servicio individual:

  • Agregación de cuentas: Este servicio solo se puede establecer como parte de la creación de la cuenta. Se espera que el proveedor de servicios sea una cuenta avanzada, y el servicio se aprueba automáticamente, ya que los usuarios de la cuenta avanzada tienen acceso completo de ADMIN a la cuenta que se está creando.

  • Administración de campañas: Si bien sigue el proceso de acuerdo normal, las propuestas se realizan en un sistema (por ejemplo, Google Ads) y las aprobaciones se realizan en el otro sistema (por ejemplo, en Merchant Center o a través de la API de Merchant).

  • Administración de la ficha local: Para este servicio, el handshake se propone en un método dedicado y las aprobaciones se realizan en el otro sistema (por ejemplo, el Perfil de Negocio de Google). En la Guía para vincular un Perfil de Negocio de Google, se indican los pasos detallados.

  • Administración de cuentas: Para este servicio, se aplica el proceso de acuerdo habitual (propuesto por el proveedor de servicios o la empresa, seguido de la aceptación de la otra parte).

  • Administración de productos: Para este servicio, se aplica el proceso de acuerdo habitual (una de las partes lo propone y la otra lo acepta).

Derechos de acceso

Cada tipo de servicio proporciona un cierto nivel de acceso para los usuarios del proveedor de servicios a la cuenta a la que se le brinda el servicio:

  • Agregación de cuentas: Este servicio proporciona derechos de ADMIN completos.

  • Administración de campañas: Este servicio proporciona un derecho de acceso restringido, lo que permite que la cuenta de Google Ads asociada acceda a los productos y a la información básica de la cuenta.

  • Comparación de productos: Este servicio proporciona, de forma predeterminada, derechos de ADMIN completos. Sin embargo, la empresa puede restringir el acceso otorgado en Merchant Center.

  • Administración de la ficha local: Este servicio no proporciona derechos de acceso directo. En cambio, permite que la ficha sincronice sus productos con la cuenta de Merchant Center.

Importante: Los derechos de acceso que se describen para los siguientes tipos de servicios solo se aplican a los proveedores de servicios aprobados. Comunícate con nuestro equipo de asistencia al cliente si eres proveedor de servicios y quieres usar esta función. Si ya habías obtenido la aprobación para el método accounts.link para la administración de productos en Content API for Shopping, puedes usar este servicio en la API de Merchant sin necesidad de obtener más aprobaciones.

  • Administración de cuentas: Este servicio proporciona, de forma predeterminada, derechos completos de ADMIN.

  • Administración de productos: Este servicio proporciona derechos de ADMIN completos. Ten en cuenta que, en el futuro, esto se limitará solo a los derechos de acceso relacionados con el producto.

Cómo se aplican las relaciones a las plataformas de terceros

Si eres una plataforma externa que administra cuentas en nombre de otras empresas, a continuación, se muestra cómo se asignan los diferentes conceptos a la estructura de tu cuenta:

  1. Proveedor de servicios: Tu cuenta avanzada.
  2. Cuenta que recibe el servicio: Es una cuenta de Merchant Center que representa la empresa que administras.
  3. Servicio:
    • accountAggregation, si creas estas cuentas como subcuentas de tu cuenta avanzada Sin embargo, no se recomienda y el servicio preferido es accountManagement.
    • accountManagement, si estableces este servicio después de la creación de la cuenta para cuentas que no son subcuentas de tu cuenta avanzada

Para obtener detalles sobre cómo configurar una cuenta avanzada y vincularla a cuentas nuevas de Merchant Center, consulta Crea y administra cuentas secundarias.