Atención: Pronto se implementarán cambios importantes en la API, por lo que será necesario llevar a cabo una migración. Consulta la página de próximas versiones y programación de la desactivación con frecuencia para enterarte de las novedades. También puedes registrarte en nuestra lista de distribución para recibir las novedades.

Registro de cambios

Versión 4.9

Nuevas funciones

MoreHours
Ahora,
MoreHours puede definirse como parte de la ficha de empresa.
MoreHourTypes puede recuperarse en cada categoría mediante categories.batchGet.

Cambios en el comportamiento

Desactivación de cuentas de la versión 4.x
accounts, accounts.admins, accounts.invitations y accounts.locations.admins han dejado de estar disponibles en la API de Google My Business. Consulta el registro de cambios de la desactivación para obtener más información.
Publicaciones de llamada a la acción
En el segundo trimestre del 2021, CallToAction las publicaciones con GET_OFFER ActionType dejarán de ser válidas.

Versión 4.8

Nuevas funciones

Servicios de alojamiento
Ahora se pueden consultar y actualizar los servicios de alojamiento. Más información
Se ha añadido el punto final GetGoogleUpdated para servicios de alojamiento.
Se ha añadido el valor booleano canOperateLodgingData a LocationState
Atributos de proveedores de servicios sanitarios
Ahora se pueden consultar y actualizar los atributos de proveedores de servicios sanitarios. Más información
Se ha añadido el valor booleano canOperateHealthData a LocationState
Redes de seguros
Ahora se puede crear una lista con las redes de seguros aceptadas según la ubicación. Más información

Cambios en el comportamiento

IDs de reseña
Los ID de reseña se han migrado a un nuevo formato. Los nuevos ID se devolverán en todas las respuestas de API aplicables. Durante un breve periodo, los ID de reseña anteriores seguirán usándose para llamar a la API, pero es fundamental actualizar todos los ID de reseña almacenados en el sistema en un plazo de 30 días, tal y como exigen nuestras políticas. Para ello, hay que ejecutar el punto de conexión listReviews.
Empresas de servicios locales
En el primer trimestre del 2021, se dejará de devolver Address en el objeto Location de las empresas CUSTOMER_LOCATION_ONLY.

Versión 4.7

Nuevas funciones

Menús de comida
Ahora se pueden consultar y actualizar los menús de comida. Más información

Versión 4.6

Nuevas funciones

Listas de servicios
Ahora puedes consultar y actualizar los servicios que ofrecen las empresas. Más información
Se ha añadido el valor booleano canModifyServiceList a LocationState
El valor indica si se pueden modificar listas de servicios en una ubicación determinada. Más información
Tipos de servicio predefinidos ServiceTypes para Categories
Los tipos de servicio predefinidos ahora están incluidos en el objeto Categories. Más información
CategoryView
Ahora se pueden especificar vistas BASIC o FULL de categorías. La vista FULL devolverá información adicional, como los tipos de servicio. Más información
Método Categories.BatchGet
Este nuevo método permite introducir una lista con categorías y devuelve información solo sobre ellas. Más información

Segunda actualización sobre el COVID-19 de la versión 4.5

Nuevas funciones

Tipo de publicación de alertas sobre el COVID-19
Ahora se pueden crear publicaciones del tipo COVID_19 a través de la API. Más información

Primera actualización sobre el COVID-19 de la versión 4.5

Nuevas funciones

Cerrado temporalmente
Ahora puedes indicar que una empresa ha cerrado temporalmente usando el valor CLOSED_TEMPORARILY a través de la API. Más información

Versión 4.5

Nuevas funciones

Pub/Sub para preguntas y respuestas
Ahora puedes recibir notificaciones de Google Cloud Pub/Sub sobre preguntas y respuestas nuevas o que se hayan actualizado en una ubicación. Más información
Pub/Sub para el estado de la ficha
Ahora puedes recibir notificaciones de Google Cloud Pub/Sub sobre los cambios que se hagan en el estado de la ficha. Más información

Versión 4.4

Nuevas funciones

Verificación de empresas de servicios locales
Ya se pueden verificar empresas de servicios locales mediante la API. Más información
Recuento de seguidores
Ahora puedes consultar metadatos sobre los seguidores. Más información
Grupos de usuarios y de ubicaciones
Ahora se pueden crear grupos de usuarios y de ubicaciones mediante la API. Más información
Se ha añadido el campo hasPendingEdits a LocationState
El campo indica si las propiedades de una ubicación tienen cambios pendientes. Más información

Cambios de funcionamiento

Fecha de apertura
Ahora puedes fijar una fecha futura de apertura en una ficha.
PointRadius
PointRadius ahora es de solo lectura. Para modificar o crear empresas de servicios locales habrá que usar Places.

Versión 4.3

Nuevas funciones

APIs de preguntas y respuestas
Ahora puedes consultar preguntas, publicar respuestas y publicar preguntas frecuentes sobre las ubicaciones de tu empresa. Más información
Leer reseñas en bloque
Ahora puedes consultar reseñas de varias ubicaciones en una sola llamada. Más información
Ubicaciones recomendadas por Google
Ahora puedes consultar las ubicaciones no reclamadas que Google cree que podrían ser de tu propiedad. Más información
Informar de problemas con GoogleLocations
Ahora puedes informar de problemas con los resultados de RecommendedGoogleLocations o de GoogleLocations. Más información
Enumeración de servicios para las secciones PriceList
Ahora puedes identificar una sección PriceList, según si contiene el valor FOOD o SERVICES. Más información
Descripción de contenido multimedia
Ahora puedes proporcionar un título cuando subas contenido multimedia. Más información
Estadísticas de CHAINS_QUERIES
Ahora puedes consultar el número de veces que se ha mostrado una ubicación como resultado de una búsqueda de la cadena a la que pertenece. Más información

Cambios de funcionamiento

Notificaciones sobre cuentas de organización y grupos de ubicaciones
Las cuentas configuradas para recibir notificaciones de Pub/Sub también recibirán notificaciones sobre las fichas de empresa que formen parte de cuentas de organización o de grupos de ubicaciones de los que sean administradores.
Listas de ubicaciones (ListLocations) para cuentas de organización y grupos de ubicaciones
Al hacer una llamada a accounts.locations.list con la cuenta de una organización o de un grupo de usuarios, ahora se muestran todas las ubicaciones a las que puede acceder esa cuenta.

Versión 4.2

Nuevas funciones

APIs de verificación
Permiten enumerar y activar los métodos que hay disponibles para verificar ubicaciones no verificadas. Más información
API GoogleLocations
Con esta API, puedes buscar ubicaciones en Google para reclamarlas o consultar un enlace para solicitar el acceso a las ubicaciones reclamadas. Más información
Más filtros de ubicación
Se han añadido opciones para limitar los resultados que devuelven las llamadas que se hacen a Locations.List. Más información
Pertenencia a una cadena
Ahora puedes indicar si una ubicación es parte de una cadena (por ejemplo, Carrefour, Alcampo, etc.). Más información
Información sobre la organización
La información sobre las cuentas de organización ahora se muestra como parte de los objetos Account. Más información
Imagen del perfil del autor de la reseña
La URL de la imagen de perfil del autor de la reseña ahora se incluye en la reseña en cuestión. Más información

Versión 4.1

Nuevas funciones

Contenido multimedia proporcionado por el cliente
Ahora puedes consultar datos de fotos y vídeos que hayan aportado clientes, de las ubicaciones de las que eres propietario o que gestionas. Más información
APIs de gestión de administradores
Ahora puedes enumerar, aceptar y rechazar invitaciones relacionadas con ubicaciones y cuentas en tu cuenta. Más información
Profile (descripción proporcionada por el comerciante)
Describe tu empresa con tus propias palabras y comparte su historia única y los productos y servicios que ofreces con los usuarios. Más información
Campo openingDate
En este campo puedes indicar la fecha en la que tu empresa abrió al público. Más información
Publicaciones sobre ofertas
Este nuevo tipo de publicación en Google ayuda a los usuarios a encontrar ofertas disponibles en tus ubicaciones. Más información

Versión 4

Nuevas funciones

Publicaciones en Google
Ahora puedes crear publicaciones en Google directamente a través de la API.
Subida de fotos
Además de subir fotos mediante la URL, ahora también se puede hacer directamente a través de la API.
Habilitación y filtrado de notificaciones
Ahora puedes decidir mediante un filtro qué notificaciones se envían a los temas de Pub/Sub. A partir de ahora, las notificaciones se habilitarán mediante este mecanismo en lugar de enviarse a todos los usuarios.
Notificaciones UPDATED_REVIEW
Ahora puedes suscribirte a las notificaciones en tiempo real sobre los cambios que se hagan en las reseñas de los clientes.
Compatibilidad con grupos de usuarios
La API de Google My Business ahora admite cuentas de grupo de usuarios.

Cambios incompatibles con las versiones anteriores

  • Las fotos, anteriormente un campo de objetos location, ahora son un recurso en la ubicación (accounts/account_ID/locations/location_ID/photos).

  • El campo de dirección Country se ha sustituido por region_code, y sub_locality se ha sustituido por sublocality.

  • Se ha eliminado el campo Ownership, que ya se había desactivado.

  • Antes, los copropietarios de las cuentas y los de las ubicaciones no se podían distinguir de los propietarios principales mediante la API (todos se mostraban como OWNER). Ahora, a los propietarios principales se les asignará el rol OWNER y a los demás propietarios, CO_OWNER.

  • AccountType.BUSINESS ahora se llama AccountType.LOCATION_GROUP.

  • Al utilizar una máscara de campo para actualizar las ubicaciones, proporciona un valor de update_mask en lugar del de field_mask que ya haya.

  • El mensaje de categoría utilizado para primary_category y additional_categories ha dejado de tener un formato legible para las personas. Los usuarios deben utilizar el servicio de categorías de la API de Google My Business para obtener nombres de categorías traducidos y legibles por personas.

Versión 3.3

Nuevas funciones

Menús estructurados

Ahora puedes hacer los cambios siguientes:

  • Añadir, actualizar o eliminar varios menús en una ubicación determinada

  • Incluir varias secciones en un menú

  • Enumerar las opciones de un menú con sus nombres, descripciones, precios y fotos

Versión 3.2

Nuevas funciones

Estadísticas
Ahora puedes usar la API para consultar estadísticas sobre las ubicaciones y métricas relacionadas con las indicaciones para llegar en coche.
Notificaciones
Ahora puedes suscribirte para recibir notificaciones en tiempo real cuando haya actualizaciones de Google.

Cambios incompatibles con las versiones anteriores

  • Se han quitado los campos languageCodes y platforms de UrlAttributeValue, que ya no se usaban.

  • En la enumeración de propiedad que ya estaba desactivada, el miembro SAME solo se aplica si la ubicación que dicha enumeración duplica tiene el mismo propietario principal. Antes, el comportamiento se basaba en un cálculo de propiedad más complejo.

Versión 3.1

Nuevas funciones

Notificaciones
Ahora puedes suscribirte a las notificaciones en tiempo real para saber cuándo hay reseñas nuevas.
URLs de Maps
Las URLs de Google Maps se incluyen en las respuestas de ubicación para que los usuarios puedan acceder fácilmente a dicha plataforma.
Estados de ubicación
Ahora hay estados de ubicación adicionales que indican cuándo se ha publicado o inhabilitado una ficha o si está pendiente de verificación.
Marca de reapertura
El valor de la marca canReopen indica cuáles de las ubicaciones cerradas permanentemente pueden reabrir y cuáles no.
Atributos
Se ha añadido compatibilidad con atributos de URL y de enumeración.
Punto final de categorías
Permite consultar una lista con categorías admitidas por país e idioma. Sustituye a los archivos CSV.

Versión 3

Nuevas funciones

Reseñas
Ahora puedes consultar las reseñas de tu empresa y responderlas a través de la API.
Atributos
Ahora puedes proporcionar más información sobre ubicaciones específicas por categorías.
Buscar ubicaciones coincidentes
Busca en Maps ubicaciones que correspondan a la de tu empresa y asócialas manualmente.
Transferir ubicaciones
Ahora hay una nueva acción en Location :transfer. Dicha acción permite transferir una ubicación de una cuenta (de empresa o personal) a otra.
Foto preferida
Puedes indicar qué foto prefieres que aparezca primero en Google Maps y en la Búsqueda.
Nuevos filtros de búsqueda
Los nuevos filtros de búsqueda son any_google_updates, is_suspended y is_duplicate.
Nuevos estados de ubicación
Se han añadido los estados de ubicación is_verified y needs_reverification.
Mejoras a las URLs de las fotos
La API ahora acepta URLs de fotos sin sufijo de formato de imagen.

Cambios incompatibles con las versiones anteriores

  • Ahora las fotos solo se pueden actualizar en las ubicaciones con una página de Google+. Antes, estas fotos se aceptaban y descartaban sin avisar.

  • Los campos location_name y category_name ahora son solo de salida. Utiliza IDs de categoría solo cuando definas categorías.

  • Las máscaras de campo ya no deben contener el prefijo location. en los campos incluidos.

  • Las operaciones de creación y actualización ahora utilizan la ubicación como la carga útil del cuerpo, y los demás parámetros se pasan a la cadena de consulta.

Versión 2

Cambios incompatibles con las versiones anteriores

  • Ahora debes especificar el valor de request_id en las llamadas a CreateLocation. Este ID, que debe ser único para cada ubicación, ayuda a evitar que se creen ubicaciones duplicadas en la cuenta. Cuando se intenta crear una ubicación con el mismo ID de solicitud de una ubicación que ya existe, se devuelve dicha ubicación y así se evita crear un duplicado en la cuenta.

    • Ahora, el nombre de business_hours en Location se ha cambiado a regular_hours.