Notas de la versión de la API de cuentas de comerciante

Semana del 20 de abril de 2026

Semana del 6 de abril de 2026

  • Se agregó el estado WAITING a Estado de aprobación. Para los Servicios de comparación de productos (CSS), WAITING es un estado de transición entre PENDING y ESTABLISHED. Se usa cuando el CSS original requiere tiempo para realizar cualquier limpieza necesaria antes de que la cuenta se transfiera por completo al nuevo CSS.

Semana del 16 de marzo de 2026

  • Se lanzó el método CreateTestAccount en la API de Accounts. Esto permite a los desarrolladores crear de forma programática cuentas de prueba dedicadas que operan en un entorno aislado similar a una zona de pruebas, lo que proporciona un espacio seguro para desarrollar y probar integraciones.

Semana del 17 de noviembre de 2025

  • CreateAndConfigureAccountRequest ahora ofrece nuevos servicios que se pueden configurar durante la configuración de la cuenta. Se debe especificar exactamente uno de los siguientes: AccountAggregation, AccountManagement y ComparisonShopping. Además, es posible especificar una cantidad arbitraria de servicios ProductsManagement y CampaignsManagement. Sin embargo, no debe haber dos servicios de este tipo que tengan el mismo proveedor y los mismos IDs de cuenta externos.

  • El método AccountsService.CreateAndConfigure ahora proporciona una configuración para controlar si se debe enviar un correo electrónico de verificación.

  • CreateAndConfigureAccountRequest.AddAccountService ahora tiene un external_account_id campo (este campo ya existe en el recurso AccountService) . Se puede especificar junto con los servicios CampaignsManagement y ProductsManagement.

  • Se agregó un servicio ComparisonShopping al recurso AccountService. Consulta https://support.google.com/merchants/answer/12653197 para obtener más detalles.

  • Ahora es posible establecer un alias para una relación durante la creación de la cuenta con el campo setAlias en CreateAndConfigureAccountRequest.

  • Se agregó un método VerifySelf a UserService que permite actualizar el estado de PENDING a VERIFIED para el recurso User que representa al usuario que realiza la llamada.

  • Se lanzó el nuevo campo radius_area en la carga útil Region de la API de Regions que permitirá a los comercios crear regiones con un área de radio.

Semana del 10 de noviembre de 2025

  • Se publicó la versión v1alpha de la API de Services.
  • Se lanzó el nuevo campo product_filters en la carga útil CampaignManagement de la API de Services que permitirá a los comercios compartir solo un subconjunto de su feed con las cuentas de Google Ads, según algún filtrado condicional de los atributos de los productos del comercio. Esta es una función incluida en la lista de entidades permitidas a la que solo puede acceder una cantidad limitada de comercios.

Semana del 25 de agosto de 2025

  • Se agregaron nuevos métodos por lotes a la API de Regions:
    • BatchCreateRegions: Permite crear varias regiones en una sola solicitud.
    • BatchUpdateRegions: Permite actualizar varias regiones en una sola solicitud.
    • BatchDeleteRegions: Proporciona la capacidad de borrar varias regiones por nombre en una sola solicitud.

Semana del 1 de julio de 2025

  • Se lanzó el recurso CheckoutSettings, que permite a los usuarios de la API crear, actualizar, borrar y obtener checkoutSettings.

Semana del 26 de mayo de 2025

  • Ahora es posible filtrar cuentas por capabilities. Por el momento, el único valor posible es CAN_UPLOAD_PRODUCTS. Este filtro te permite recuperar cuentas que pueden subir productos. Esto significa que las siguientes cláusulas ahora se pueden usar a nivel de la cuenta:

    • capabilities:CAN_UPLOAD_PRODUCTS
    • -capabilities:CAN_UPLOAD_PRODUCTS
    • NOT capabilities:CAN_UPLOAD_PRODUCTS Para obtener más información, consulta la guía de filtrado.

  • Se lanzó el derecho de acceso de solo lectura. Los usuarios con el derecho de acceso de solo lectura pueden ver los datos del comercio, pero no pueden modificarlos.

Semana del 19 de mayo de 2025

  • Se actualizó la documentación de la API de programas y se quitó la declaración incorrecta de que los métodos Enable/Disable están restringidos a los usuarios administradores.

Semana del 12 de mayo de 2025

  • Se lanzó el recurso Online Return Policy, que permite a los usuarios de la API crear, actualizar y borrar políticas de devoluciones.
  • Se lanzó OmnichannelSettingsService y el recurso OmnichannelSetting, que permite a los usuarios de la API administrar su experiencia omnicanal.
  • Se lanzó LfpProvidersService y el recurso LfpProvider, que permite a los usuarios de la API administrar su relación de asociación de feeds locales.
  • Se lanzó GbpAccountsService y el recurso GbpAccount, que permite a los usuarios de la API administrar su Perfil de Negocio de Google.
  • Se lanzó el tipo de servicio LocalListingManagement en AccountService, que vincula el grupo de ubicaciones de la empresa que se usa para los anuncios del inventario local o las fichas locales gratuitas.

Semana del 28 de abril de 2025

  • Se lanzaron los recursos AccountService y AccountRelationship, que permiten a los usuarios de la API administrar las relaciones y establecer servicios para los proveedores de servicios.

Semana del 14 de abril de 2025

  • TermsOfServiceService.AcceptTermsOfService ahora muestra el TermsOfServiceAgremeentState que se aceptó incluido en un tipo de respuesta.

  • El verbo de la acción TermsOfServiceService.AcceptTermsOfService ahora es POST (antes era GET).

  • Se aclaró que AccountsService.ListSubAccounts se debe llamar con el accounts/... formato (en lugar de providers/...). Esto es para evitar que este método quede fuera del permiso de accounts (es decir, GET accounts/123:listSubAccounts en lugar de GET providers/123:listSubAccounts).

Semana del 31 de marzo de 2025

  • Para filtrar cuentas, el filtro externalAccountId se anunció como obsoleto en la semana del 2 de diciembre de 2024 y ahora no está disponible. Esto significa que el filtrado por externalAccountId ahora solo es posible a nivel de service. Un filtro como relationship(externalAccountId = "foo") ya no funcionará y debe expresarse como relationship(service(externalAccountId = "foo")).

  • Se aclaró en la documentación de AccountsService que no se pueden crear cuentas independientes.

Semana del 3 de marzo de 2025

-Se refactorizó accounts.onlineReturnPolicies#SeasonalOverride para mejorar la claridad y la coherencia. Estas actualizaciones incluyen lo siguiente:

  • Cambio de nombre de campos:
    • begin ahora es start_date.
    • end ahora es end_date.
  • Eliminación de campos:
    • Se quitó el campo policy obsoleto.

-Los desarrolladores deben actualizar su código para reflejar estos cambios.

Se lanzó el servicio AutomaticImprovements que puedes usar para administrar lo siguiente:

Para obtener más información, consulta Habilita las mejoras automáticas.

Semana del 17 de febrero de 2025

Se quitó el predicado callerHasAccessToProviderFilter() del filtro de cuenta.

Semana del 10 de febrero de 2025

  • Se mejoró la documentación del método AccountsService.List. Muestra todas las cuentas a las que tiene acceso el usuario, no solo las cuentas independientes.

  • Se agregó un plazo predeterminado de 10 minutos para todos los métodos RPC.

  • Se agregó la lista de nombres de programas disponibles a accounts.programs descripción del recurso.

  • User.accessRights ahora es REQUIRED, lo que afecta a los métodos UserService.Create y AccountsService.CreateAndConfigure.

Semana del 27 de enero de 2025

AccountsService.ListAccounts (y, por lo tanto, AccountsService.ListSubAccounts) ahora muestran las cuentas de manera coherente eventual en lugar de ser una lectura sólida.

Semana del 20 de enero de 2025

El campo users de CreateAndConfigureAccountRequest está obsoleto en favor de un nuevo user. El CreateUserRequest al que se hace referencia contiene el campo parent que no es obligatorio en el contexto de CreateAndConfigureAccountRequest.

Semana del 6 de enero de 2025

El campo user del mensaje CreateUserRequest ahora está marcado correctamente como OPTIONAL.

El campo domain de los errores que se muestran ahora se propaga con merchantapi.googleapis.com en lugar de global.

Semana del 2 de diciembre de 2024

Para filtrar cuentas, el externalAccountId predicado se mueve del relationship nivel al service nivel. Por lo tanto, un filtro relationship(externalAccountId = "foo") ahora debería escribirse como relationship(service(externalAccountId = "foo")). El formato anterior aún se admite para la retrocompatibilidad, pero está obsoleto y mostrará un error en el futuro cercano. Toda la documentación solo mencionará el formato nuevo.

Semana del 18 de noviembre de 2024

El proveedor en el campo CreateAndConfigureAccountRequest.service.provider ahora también puede ser uno de providers/GOOGLE_ADS o providers/GOOGLE_BUSINESS_PROFILE. Las demás cuentas deben denominarse providers/123 (en lugar de accounts/123). Esto significa que el campo ya no está anotado como una referencia de cuenta. Sin embargo, también es posible usar nombres de cuenta como accounts/123 para la retrocompatibilidad.

El proveedor en ListSubAccountsRequest ahora debe tener el formato providers/123, pero, para la retrocompatibilidad, aún será posible usar accounts/123.

Semana del 4 de noviembre de 2024

Marca promotions_consent como REQUIRED (de OPTIONAL) en el recurso BusinessIdentity. Esto afecta solo al método de actualización. Esto es para aclarar que no es posible actualizar promotions_consent a UNSPECIFIED. Esto ya no era posible, pero el error ahora es más descriptivo y el campo está anotado correctamente.

Semana del 28 de octubre de 2024

Se mejoró la documentación de varios recursos de la sub-API de Accounts, como User, Homepage, BusinessInfo, etcétera.

Semana del 21 de octubre de 2024

Se mejoró la documentación de los campos update_mask en las solicitudes de actualización para indicar específicamente qué campos se admiten para la actualización.

Se agregó el vínculo del Centro de ayuda de Google Business para los operadores admitidos al documento externo del recurso ShippingSettings.

Semana del 14 de octubre de 2024

Marca provider como REQUIRED en AccountsService.CreateAndConfigureAccountRequest.AddAccountService.

Haz que update_mask sea opcional en toda la sub-API de Accounts (p.ej., identidad de la empresa, información de la empresa, página principal, etc.) y de forma retroactiva para el recurso ConversionSources.

Se agregó el parámetro overwrite a ClaimHomepageRequest.

Semana del 30 de septiembre de 2024

Se lanzó el parámetro "force" para el método "Accounts.delete".

Semana del 23 de septiembre de 2024

Marca region_code y kind como REQUIRED en RetrieveLatestTermsOfServiceRequest.

Semana del 16 de septiembre de 2024

Se cambió el tipo de parámetro time_zone a cadena en ListAccountIssuesRequest.

Semana del 12 de agosto de 2024

Se agregó el campo korean_business_registration_number al recurso BusinessInfo.

Semana del 27 de mayo de 2024

Lanzamiento en versión beta de la sub-API de Accounts