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

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 la configuración de la confirmación de compra.

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.

• Se lanzó el derecho de acceso de solo lectura. Los usuarios con 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 Program 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 de la Política de devoluciones en línea, que permite a los usuarios de la API crear, actualizar y borrar políticas de devoluciones.
• Se lanzaron OmnichannelSettingsService y el recurso OmnichannelSetting, que permiten a los usuarios de la API administrar su experiencia en varios canales.
• Se lanzaron 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.
  • Se lanza el tipo de servicio LocalListingManagement en AccountService, que vincula el grupo de empresas 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 objeto TermsOfServiceAgremeentState que se aceptó, encapsulado en 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/...) 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

• En el caso de las cuentas de filtrado, 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 a nivel de service. Un filtro como relationship(externalAccountId = "foo") ya no funcionará y deberá 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:

• Actualizaciones de elementos
• Mejoras en las imágenes
• Mejoras en el envío

Para obtener más información, consulta Cómo habilitar 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 el usuario tiene acceso, 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 muestran cuentas de manera coherente eventual en lugar de ser una lectura sólida.

Semana del 20 de enero de 2025

El campo users del objeto CreateAndConfigureAccountRequest está obsoleto y se reemplazó por un nuevo user. El CreateUserRequest al que se hizo 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 en los errores devueltos ahora se propaga 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, 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 generará un error en el futuro cercano. En toda la documentación, solo se mencionará el nuevo formato.

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), lo que significa que el campo ya no se anota como referencia de cuenta. Sin embargo, también es posible usar nombres de cuenta como accounts/123 para garantizar la retrocompatibilidad.

El proveedor en ListSubAccountsRequest ahora debería tener la forma providers/123, pero, para 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 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 al Centro de ayuda de Google Business para los operadores admitidos en el 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 del 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 sub-API de Accounts en versión beta