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 y 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 Merchant API.

De un recurso a muchos

En la API de Content 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 esto en varios recursos más pequeños y enfocados. Este cambio permite realizar llamadas a la API más segmentadas y eficientes. Por ejemplo, para actualizar solo la dirección de tu empresa, 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 los conceptos del mapa de recursos de la API de Content for Shopping se relacionan con los nuevos recursos de la API de Merchant:Account

Nuevas capacidades

La API de Merchant también introduce nuevas capacidades 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.
  • 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 Merchant API.

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}
Enumera 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, haz lo siguiente: PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
Borra la cuenta secundaria DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId} DELETE https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
Reclama el 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 en Merchant API 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
Obtén detalles de la cuenta GET /content/v2.1/{merchantId}/accounts/{accountId} (acceso 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 los 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 de la cuenta legible para las personas.
language language_code El nombre del campo ahora es language_code.

Administra la información de la empresa

Usa el recurso BusinessInfo para administrar la información pública sobre tu empresa, como la dirección y los contactos de atención al cliente. Este cambio 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
Obtener información de la empresa GET /content/v2.1/{merchantId}/accounts/{accountId} (acceso al atributo business_information) GET /accounts/v1/accounts/{account}/businessInfo
Actualiza la información de la empresa PUT /content/v2.1/{merchantId}/accounts/{accountId} (actualización del atributo business_information) PATCH /accounts/v1/accounts/{account}/businessInfo

Comparación detallada de los 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.

Administra 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} (acceso al atributo website_url) GET /accounts/v1/accounts/{account}/homepage
Actualiza la URL de la página principal PUT /content/v2.1/{merchantId}/accounts/{accountId} (actualización del 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
Rechazar la página principal No disponible POST /accounts/v1/accounts/{account}/homepage:unclaim

Comparación detallada de los 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 reclamó 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, agregar un usuario 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} (acceso al atributo users) GET /accounts/v1/accounts/{account}/users
Crea un usuario PUT /content/v2.1/{merchantId}/accounts/{accountId} (actualización del atributo users) POST /accounts/v1/accounts/{account}/users
Actualiza un usuario PUT /content/v2.1/{merchantId}/accounts/{accountId} (actualización del atributo users) PATCH /accounts/v1/accounts/{account}/users/{email}
Borra un usuario PUT /content/v2.1/{merchantId}/accounts/{accountId} (actualización del atributo users) DELETE /accounts/v1/accounts/{account}/users/{email}

Comparación detallada de los 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 Es 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 recursos AccountService y AccountRelationship, que requieren un proceso de acuerdo (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 los 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) Tipo de servicio que se proporciona (p.ej., ACCOUNT_AGGREGATION).
status handshake.approval_state (en AccountService) Es el estado de la vinculación (p.ej., PENDING, ESTABLISHED).

Configuración de impuestos de la cuenta

El servicio accounttax de Content API for Shopping no está disponible en Merchant API. 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. Este cambio 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} (acceso al atributo business_identity) GET /accounts/v1/accounts/{account}/businessIdentity
Actualiza la identidad de la empresa PUT /content/v2.1/{merchantId}/accounts/{accountId} (actualización del atributo business_identity) PATCH /accounts/v1/accounts/{account}/businessIdentity

Comparación detallada de los 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) Un valor booleano global se reemplaza por un enum más descriptivo (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)", que exponía un método accounts.list para enumerar las cuentas secundarias de la cuenta de varios clientes determinada. Las cuentas avanzadas de la API de Merchant son mucho más potentes y permiten una mayor variedad de tipos de cuentas y relaciones. Para permitir una migración sencilla para las cuentas avanzadas, Merchant API 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 filtrar cuentas de forma avanzada.

Comparación de solicitudes

Descripción de la solicitud Content API for Shopping API de Merchant
Enumera las cuentas secundarias GET /content/v2.1/{merchantId}/accounts GET /accounts/v1/accounts/{providerId}:listSubaccounts
Enumera todas las cuentas a las que se puede acceder No disponible GET /accounts/v1/accounts

Comparación detallada de los campos (parámetros de la 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.