Migra la vinculación de cuentas

La administración de las relaciones entre cuentas evolucionó de un solo método link en la Content API for Shopping a un sistema más detallado y explícito en la Merchant API. La nueva API usa recursos específicos, como AccountRelationship y AccountService, para definir los servicios específicos que una cuenta proporciona a otra. Para obtener más detalles, consulta Relaciones entre cuentas.

Diferencias clave

  • Recursos dedicados para relaciones y servicios: En la API de Merchant, el recurso AccountRelationship define la conexión entre un proveedor de servicios y un comercio, mientras que el recurso AccountService especifica el servicio exacto que se proporciona (por ejemplo, accountAggregation). Esto reemplaza los campos genéricos linkType y services de la API de Content for Shopping.
  • Métodos de acción explícitos: En lugar de un solo método link con un parámetro action, la API de Merchant usa métodos distintos para administrar servicios, como propose, approve y reject.
  • Vinculación exclusiva del Perfil de Negocio de Google: La vinculación a un Perfil de Negocio de Google, que antes se controlaba configurando el campo googleMyBusinessLink, ahora tiene un método exclusivo, gbpAccounts.linkGbpAccount.
  • Creación de cuentas de cliente como servicio: Ahora, la creación de una cuenta de cliente en una cuenta avanzada se considera como una propuesta de servicio de accountAggregation con el método accounts.createAndConfigure. Puedes encontrar más información sobre las cuentas en la página de la API de Merchant Accounts. No es necesario ningún acuerdo, ya que el usuario tiene acceso tanto a la cuenta avanzada como a la cuenta de cliente.

Solicitudes

La API de Merchant proporciona extremos específicos para administrar diferentes tipos de vínculos de cuentas y servicios:

URLs de solicitudes a la API de Merchant Center

  • Proponer un servicio nuevo: POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/services:propose
  • Aprobar un servicio: POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:approve
  • Rechaza un servicio: POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:reject
  • Vincular a un Perfil de Negocio de Google: POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/gbpAccounts:linkGbpAccount
  • Crea una cuenta de cliente (vínculo de agregación de cuentas): POST https://merchantapi.googleapis.com/accounts/v1/ accounts:createAndConfigure

Comparación de URLs de solicitud

Descripción de la solicitud Content API for Shopping API de Merchant
Vincular cuentas (por ejemplo, plataformas de terceros) POST .../v2.1/{merchantId}/accounts/{accountId}/link POST .../v1/{parent=accounts/*}/services:propose
Vínculo al Perfil de Negocio de Google PUT .../v2.1/{merchantId}/accounts/{accountId} (con el campo googleMyBusinessLink) POST .../v1/{parent=accounts/*}/gbpAccounts:linkGbpAccount
Cómo crear una cuenta de cliente POST .../v2.1/{merchantId}/accounts POST .../v1/accounts:createAndConfigure

Métodos

Método de Content API for Shopping Método de la API de Merchant Disponibilidad y notas
accounts.link accountServices.propose Usa este método para iniciar un servicio nuevo con otra cuenta.
accounts.link (con action: "approve") accountServices.approve Usa este método para aprobar una propuesta de servicio pendiente.
accounts.link (con action: "remove") accountServices.reject Usa este método para rechazar un servicio pendiente o establecido.
accounts.insert (para cuentas de cliente) accounts.createAndConfigure Usa este método con un servicio de accountAggregation para crear una cuenta de cliente nueva en una cuenta avanzada.
accounts.update (con googleMyBusinessLink) gbpAccounts.linkGbpAccount Usa este método exclusivo para vincular una cuenta de Merchant Center a un Perfil de Negocio de Google.
accounts.update (con adsLinks) AccountRelationship recurso La vinculación a Google Ads se administra desde la IU de Google Ads. El vínculo resultante se representa como un AccountRelationship en la API de Merchant, que se puede ver, pero no crear directamente.

Cambios detallados en los campos

Content API for Shopping API de Merchant Descripción
AccountsLinkRequest.action Métodos propose, approve y reject El campo action único se reemplaza por métodos de API específicos para cada cambio de estado en el ciclo de vida del servicio.
AccountsLinkRequest.linkType AccountService.service_type La cadena linkType genérica se reemplaza por un campo service_type estructurado de tipo oneof dentro del recurso AccountService, como productsManagement o accountAggregation.
AccountsLinkRequest.services AccountService.service_type La lista de servicios basados en cadenas ahora se representa con el service_type específico elegido dentro del recurso AccountService.
AccountsLinkRequest.linkedAccountId ProposeAccountServiceRequest.provider El ID de la cuenta que proporciona el servicio ahora se especifica en el campo provider de la solicitud propose.
Account.googleMyBusinessLink LinkGbpAccountRequest El objeto que contiene los detalles de la vinculación de la GBP se reemplaza por un mensaje de solicitud dedicado para el método linkGbpAccount.
Account.adsLinks AccountRelationship Los vínculos de Google Ads se representan como un recurso AccountRelationship en el que provider es providers/GOOGLE_ADS. Por lo general, esta relación se administra desde la IU de Google Ads.