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

Semana del 26 de octubre de 2026

  • Se aclaró la documentación del método accounts.homepage.unclaim y el campo claimed del recurso Homepage. Si una cuenta hereda el reclamo de la página principal de su cuenta avanzada, unclaim devuelve una respuesta correcta, pero la página principal permanece reclamada. Si la cuenta en sí está exenta de reclamos, unclaim devuelve un error FAILED_PRECONDITION.

Semana del 28 de septiembre de 2026

  • Se agregó youtube_affiliate_management como un tipo de servicio al recurso AccountService en v1alpha. Nota: La administración de afiliados de YouTube es una función con acceso limitado.

  • Lanzamiento alfa del servicio de LoyaltyPrograms que puedes usar para administrar programas de lealtad. Esta función solo está disponible para comercios seleccionados. Para obtener más información, consulta la descripción general de los programas de lealtad.

  • Se agregó el campo home_page_uri de solo lectura al recurso accounts para devolver el URI de la página principal de la tienda.

Semana del 3 de agosto de 2026

  • Se agregó "ucp_checkout_management" como tipo de servicio al recurso de servicio de la cuenta. Nota: La confirmación de compra de UCP es una función con acceso limitado.
  • Se agregó compatibilidad con el programa "ucp-integration" (acceso limitado).
  • Se agregó compatibilidad con el tipo de condiciones del servicio "ucp_integration".

Semana del 29 de junio de 2026

Semana del 20 de abril de 2026

  • Se agregó youtube-affiliate a la lista de nombres de programas disponibles a la descripción del recurso accounts.programs.
  • Habilita la API del programa para afiliados de YouTube Shopping. Disponible para verificadores de confianza.

Semana del 6 de abril de 2026

  • Se agregó el estado WAITING a Estado de aprobación. En el caso de 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 que los desarrolladores creen de forma programática cuentas de prueba dedicadas que operen 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 servicios nuevos que se pueden configurar durante la configuración de la cuenta. Se debe especificar exactamente uno de los valores AccountAggregation, AccountManagement y ComparisonShopping. Además, es posible especificar una cantidad arbitraria de servicios de ProductsManagement y CampaignsManagement. Sin embargo, no debe haber dos servicios de este tipo que tengan el mismo proveedor y los mismos IDs de cuenta externa.

  • El método AccountsService.CreateAndConfigure ahora proporciona un parámetro de configuración para controlar si se debe enviar un mensaje de verificación.

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

  • Se agregó un servicio de 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.

  • Lanzar el nuevo campo radius_area en la carga útil Region de la API de Regions, que permitirá a los comercios crear regiones usando un área de radio

Semana del 10 de noviembre de 2025

  • Publica la versión v1alpha de la API de Services.
  • Lanzar 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 un filtrado condicional de los atributos de los productos del comercio Esta es una función de 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 las cuentas por capabilities. Por el momento, el único valor posible es CAN_UPLOAD_PRODUCTS. Este filtro te permite recuperar las cuentas que pueden subir productos. Esto significa que ahora se pueden usar las siguientes cláusulas 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.

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

Semana del 19 de mayo de 2025

  • Se actualizó la documentación de la API del programa 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ó el servicio OmnichannelSettingsService y el recurso OmnichannelSetting, que permiten a los usuarios de la API administrar su experiencia en varios canales.
  • Se lanzó el servicio LfpProvidersService y el recurso LfpProvider, que permiten a los usuarios de la API administrar su relación de asociación de feeds locales.
  • Se lanzaron GbpAccountsService y el recurso GbpAccount, que permiten a los usuarios de la API administrar su Perfil de Negocio de Google.
  • Inicia 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 relaciones y establecer servicios para los proveedores de servicios.

Semana del 14 de abril de 2025

  • TermsOfServiceService.AcceptTermsOfService ahora devuelve el TermsOfServiceAgremeentState que se aceptó, unido a un tipo de respuesta.

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

  • Se aclaró que se debe llamar a AccountsService.ListSubAccounts con el formato accounts/... (en lugar de providers/...). Esto es para evitar que este método quede fuera del alcance 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, se anunció que el filtro externalAccountId dejaría de estar disponible en la semana del 2 de diciembre de 2024 y ahora ya no está disponible. Esto significa que el filtrado por externalAccountId ahora solo es posible en el nivel 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 obsoleto policy.

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

Lanzamiento del servicio de 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 la cuenta.

Semana del 10 de febrero de 2025

  • Se mejoró la documentación del método AccountsService.List. Devuelve 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 de RPC.

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

  • 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, de forma transitiva, AccountsService.ListSubAccounts) ahora devuelven cuentas de manera coherente y eventual, en lugar de ser una lectura sólida.

Semana del 20 de enero de 2025

El campo users de CreateAndConfigureAccountRequest dejó de estar disponible y se reemplazó por un nuevo user. El CreateUserRequest al que se hace referencia contiene el campo parent que no es obligatorio en el contexto del 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 completa con merchantapi.googleapis.com en lugar de global.

Semana del 2 de dic. de 2024

Para filtrar cuentas, el predicado externalAccountId se mueve del nivel relationship al nivel service. Por lo tanto, ahora un filtro relationship(externalAccountId = "foo") debería escribirse como relationship(service(externalAccountId = "foo")). El formato anterior todavía se admite para mantener la retrocompatibilidad, pero dejó de estar disponible y arrojará un error en el futuro cercano. En toda la documentación, solo se mencionará el formato nuevo.

Semana del 18 de noviembre de 2024

El proveedor en el campo CreateAndConfigureAccountRequest.service.provider ahora también puede ser providers/GOOGLE_ADS o providers/GOOGLE_BUSINESS_PROFILE. Se debe hacer referencia a otras cuentas como providers/123 (en lugar de accounts/123). Esto significa que el campo ya no se anota como una referencia de cuenta. Sin embargo, también es posible usar nombres de cuenta, como accounts/123, para mantener la retrocompatibilidad.

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

Semana del 4 de noviembre de 2024

Marca promotions_consent REQUIRED (de OPTIONAL) en el recurso BusinessIdentity. Esto solo afecta 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 ahora el error 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 cuentas, como User, Homepage, BusinessInfo, etcétera.

Semana del 21 de octubre de 2024

Mejorar la documentación de los campos update_mask en las solicitudes de actualización para señalar específicamente qué campos se admiten para la actualización.

Se agregó el vínculo al 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.

Hacer 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 de la versión beta de la API secundaria de cuentas