Migra la administración de cuentas

La API de Accounts se divide en una colección de recursos para permitirte administrar tus cuentas de Merchant Center de manera más eficiente con un control más preciso en los diferentes aspectos de tu cuenta.

En esta guía, se explican los cambios clave y se te ayuda a migrar tu integración existente de administración de cuentas de Content API for Shopping a la API de Merchant.

De un recurso a muchos

En la Content API for Shopping, el recurso Account era un objeto monolítico que contenía todo, desde el nombre de la cuenta y la URL del sitio web hasta las listas de usuarios y la información de la empresa.

La API de Merchant divide este recurso en varios más pequeños y específicos. Este cambio permite realizar llamadas a la API más segmentadas y eficientes. Por ejemplo, para actualizar solo tu dirección comercial, ahora debes realizar una solicitud PATCH al recurso BusinessInfo en lugar de actualizar todo el objeto Account.

A continuación, se muestra un resumen de cómo se asignan los conceptos del recurso Account de la API de Content para Shopping a los nuevos recursos de la API de Merchant:

Nuevas funciones

La API de Merchant también presenta nuevas funciones para la administración de cuentas que no estaban disponibles en Content API for Shopping:

  • Condiciones del Servicio: Recupera y acepta las Condiciones del Servicio de forma programática con los recursos TermsOfService y TermsOfServiceAgreementState.
  • Creación de cuentas: El método accounts.createAndConfigure ahora admite la creación de cuentas con relaciones (como accountManagement), la configuración de un alias y la supresión de la verificación por correo electrónico con el campo user.verificationMailSettings.verificationMailMode en favor de la verificación basada en la API con el nuevo método accounts.verifySelf.
  • Acceso a la cuenta por alias: Accede a las cuentas con un formato providerId~accountAlias, lo que proporciona una forma coherente para que las empresas que administran varias cuentas usen sus propios identificadores de cuenta.

Solicitudes

En esta tabla, se proporciona una comparación consolidada de las URLs de solicitud para las tareas comunes de administración de cuentas entre Content API for Shopping y la API de Merchant.

Descripción de la solicitud Content API for Shopping API de Merchant
Obtener cuenta GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId} GET https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
Obtener cuenta por alias No está disponible directamente GET https://merchantapi.googleapis.com/accounts/v1/accounts/{provider}~{alias}
Cómo enumerar las cuentas secundarias GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts GET https://merchantapi.googleapis.com/accounts/v1/accounts/{provider}:listSubaccounts
Crear una cuenta secundaria POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts POST https://merchantapi.googleapis.com/accounts/v1/accounts:createAndConfigure
Actualiza los datos de la cuenta PUT https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId} PATCH en el recurso adecuado. Por ejemplo, para actualizar el nombre de la cuenta, usa el siguiente comando: PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
Borrar cuenta secundaria DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId} DELETE https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
Reclamar sitio web POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite POST https://merchantapi.googleapis.com/accounts/v1/accounts/{account}/homepage:claim
Vincular cuentas POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/link POST https://merchantapi.googleapis.com/accounts/v1/accounts/{account}/services:propose

Administra la información principal de la cuenta

El recurso Account de la API de Merchant contiene los detalles esenciales de una cuenta de Merchant Center, como su nombre, ID y configuración básica.

Comparación de solicitudes

Descripción de la solicitud Content API for Shopping API de Merchant
Obtener detalles de la cuenta GET /content/v2.1/{merchantId}/accounts/{accountId} (accede a atributos principales, como name y adult_content) GET /accounts/v1/accounts/{account}
Cómo crear una cuenta secundaria POST /content/v2.1/{merchantId}/accounts POST /accounts/v1/accounts:createAndConfigure
Actualiza los detalles de la cuenta PUT /content/v2.1/{merchantId}/accounts/{accountId} (actualización de atributos principales) PATCH /accounts/v1/accounts/{account}
Cómo borrar una cuenta secundaria DELETE /content/v2.1/{merchantId}/accounts/{accountId} DELETE /accounts/v1/accounts/{account}

Comparación detallada de campos

Content API for Shopping (Account) API de Merchant (Account) Notas
id account_id El ID numérico ahora es un campo de solo salida. El identificador principal es el recurso name.
name account_name Es el nombre legible por humanos de la cuenta.
language language_code El nombre del campo ahora es language_code.

Administrar la información de la empresa

Usa el recurso BusinessInfo para administrar la información pública de tu empresa, como la dirección y los contactos de atención al cliente. Esto reemplaza el objeto businessInformation en Content API for Shopping.

Comparación de solicitudes

Descripción de la solicitud Content API for Shopping API de Merchant
Obtén información de la empresa GET /content/v2.1/{merchantId}/accounts/{accountId} (accede al atributo business_information) GET /accounts/v1/accounts/{account}/businessInfo
Actualizar información de la empresa PUT /content/v2.1/{merchantId}/accounts/{accountId} (actualizando el atributo business_information) PATCH /accounts/v1/accounts/{account}/businessInfo

Comparación detallada de campos

Content API for Shopping (business_information) API de Merchant (BusinessInfo) Notas
phone_number phone El campo ahora es phone y usa google.type.PhoneNumber.
customer_service.url customer_service.uri El nombre del campo ahora es uri.

Cómo administrar tu página principal

Para administrar la URL del sitio web de tu tienda y realizar la verificación y el reclamo, usa el recurso Homepage. Este cambio reemplaza el campo websiteUrl y el método accounts.claimwebsite de Content API for Shopping.

Comparación de solicitudes

Descripción de la solicitud Content API for Shopping API de Merchant
Obtén la URL de la página principal GET /content/v2.1/{merchantId}/accounts/{accountId} (accediendo al atributo website_url) GET /accounts/v1/accounts/{account}/homepage
Actualizar la URL de la página principal PUT /content/v2.1/{merchantId}/accounts/{accountId} (actualiza el atributo website_url) PATCH /accounts/v1/accounts/{account}/homepage
Página principal de reclamos POST /content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite POST /accounts/v1/accounts/{account}/homepage:claim
Cómo dejar de reclamar la página principal No disponible POST /accounts/v1/accounts/{account}/homepage:unclaim

Comparación detallada de campos

Content API for Shopping (Account) API de Merchant (Homepage) Notas
website_url uri Es la URL de la página principal de la tienda.
No está disponible directamente claimed Es un campo booleano que es true si se reclama la página principal.

Administrar usuarios

El recurso User te permite administrar quién puede acceder a una cuenta de Merchant Center. Esto reemplaza el array users dentro del recurso Account. Una diferencia clave es el proceso de creación de usuarios. En la API de Merchant, cuando se agrega un usuario, se envía una invitación. El usuario debe aceptar la invitación para poder acceder a la cuenta.

Comparación de solicitudes

Descripción de la solicitud Content API for Shopping API de Merchant
Mostrar lista de usuarios GET /content/v2.1/{merchantId}/accounts/{accountId} (accede al atributo users) GET /accounts/v1/accounts/{account}/users
Crea un usuario PUT /content/v2.1/{merchantId}/accounts/{accountId} (actualizando el atributo users) POST /accounts/v1/accounts/{account}/users
Actualiza un usuario PUT /content/v2.1/{merchantId}/accounts/{accountId} (actualizando el atributo users) PATCH /accounts/v1/accounts/{account}/users/{email}
Borra un usuario PUT /content/v2.1/{merchantId}/accounts/{accountId} (actualizando el atributo users) DELETE /accounts/v1/accounts/{account}/users/{email}

Comparación detallada de campos

Content API for Shopping (objeto de array users) API de Merchant (recurso User) Notas
email_address name (en formato accounts/{account}/users/{email}) El correo electrónico del usuario ahora forma parte del nombre del recurso.
admin, order_manager, reporting_manager, etcétera access_rights Los derechos de acceso ahora se consolidan en un campo de enumeración repetido.
No disponible state Un nuevo campo de solo salida que indica si el usuario es PENDING o VERIFIED.

Administra las relaciones y los servicios de la cuenta

En Content API for Shopping, las relaciones se administraban con accounts.link. La API de Merchant presenta un modelo más explícito con los recursos AccountService y AccountRelationship, que requieren un proceso de protocolo de enlace (propuesta y aceptación).

Comparación de solicitudes

Descripción de la solicitud Content API for Shopping API de Merchant
Vincular cuentas POST /content/v2.1/{merchantId}/accounts/{accountId}/link POST /accounts/v1/accounts/{account}/services:propose
Enumera las cuentas vinculadas GET /content/v2.1/{merchantId}/accounts/{accountId}/listlinks GET /accounts/v1/accounts/{account}/relationships y GET /accounts/v1/accounts/{account}/services

Comparación detallada de campos

Content API for Shopping (AccountLink) API de Merchant (AccountService, AccountRelationship) Notas
linked_account_id provider (en AccountService) Es el ID de la cuenta que proporciona el servicio.
service service_type (en AccountService) Es el tipo de servicio que se proporciona (p.ej., ACCOUNT_AGGREGATION).
status handshake.approval_state (en AccountService) Es el estado del vínculo (p.ej., PENDING, ESTABLISHED).

Configuración fiscal de la cuenta

El servicio accounttax de Content API for Shopping no está disponible en la API de Merchant. Ya no es obligatorio proporcionar el impuesto sobre las ventas de EE.UU. Para obtener más información, consulta la actualización de las especificaciones de datos de productos de Merchant Center para 2025.

Administra la identidad de la empresa

Usa el recurso BusinessIdentity para autodeclarar atributos sobre tu empresa. Esto reemplaza el objeto businessIdentity en Content API for Shopping.

Comparación de solicitudes

Descripción de la solicitud Content API for Shopping API de Merchant
Obtén la identidad de la empresa GET /content/v2.1/{merchantId}/accounts/{accountId} (accediendo al atributo business_identity) GET /accounts/v1/accounts/{account}/businessIdentity
Actualiza la identidad de la empresa PUT /content/v2.1/{merchantId}/accounts/{accountId} (actualiza el atributo business_identity) PATCH /accounts/v1/accounts/{account}/businessIdentity

Comparación detallada de campos

Content API for Shopping (business_identity) API de Merchant (BusinessIdentity) Notas
black_owned.self_identified (booleano) black_owned.identity_declaration (enumeración) El valor booleano se reemplaza por una enumeración (SELF_IDENTIFIES_AS, DOES_NOT_SELF_IDENTIFY_AS) para una declaración más explícita. Esto se aplica a todos los atributos de identidad.
include_for_promotions (booleano) promotions_consent (enumeración) Se reemplazó un booleano global por una enumeración más descriptiva (PROMOTIONS_CONSENT_GIVEN, PROMOTIONS_CONSENT_DENIED).

Mostrar cuentas

En Content API for Shopping, el único tipo de cuenta avanzada era una "cuenta de varios clientes (MCA)" y exponía un método accounts.list para enumerar las cuentas de la cuenta de varios clientes determinada. Las cuentas avanzadas en la API de Merchant son mucho más potentes, ya que permiten una gama más amplia de tipos de cuentas y relaciones. Para permitir una migración sencilla de las cuentas avanzadas, la API de Merchant proporciona un equivalente directo a accounts.list de Content API for Shopping como un método accounts.listSubaccounts. Presentamos un nuevo método accounts.list más potente que permite el filtrado avanzado de cuentas.

Comparación de solicitudes

Descripción de la solicitud Content API for Shopping API de Merchant
Enumera las cuentas de una cuenta avanzada GET /content/v2.1/{merchantId}/accounts GET /accounts/v1/accounts/{providerId}:listSubaccounts
Cómo obtener una lista de todas las cuentas a las que puedes acceder No disponible GET /accounts/v1/accounts

Comparación detallada de campos (parámetros de solicitud)

Content API for Shopping (accounts.list) API de Merchant (accounts.listSubaccounts) Notas
merchant_id (parámetro de ruta) provider (parámetro de ruta) Es el ID de la cuenta avanzada en el formato accounts/{account}.
max_results page_size Es la cantidad máxima de cuentas que se devolverán.
Anterior
Refactor code for concurrent requests
Siguiente
Migrate accountstatuses to Account Issues