Registro de cambios

v4.9

Nuevas funciones

MoreHours
Ahora se puede configurar
MoreHours como parte de la ficha de la empresa.
MoreHourTypes se puede recuperar para cada categoría con categories.batchGet.

Cambios en el comportamiento

Baja de las cuentas de v4.x
accounts, accounts.admins, accounts.invitations y accounts.locations.admins dejaron de estar disponibles en la API de Google My Business. Consulta el registro de cambios de baja para obtener más información.
Publicaciones de CallToAction
En el segundo trimestre de 2021, CallToAction las publicaciones con el ActionType GET_OFFER dejarán de ser válidas.

v4.8

Nuevas funciones

Comodidades del alojamiento
Recuperación y actualización de las comodidades de los alojamientos Más información
Se agregó el extremo GetGoogleUpdated para Alojamiento.
Se agregó el valor booleano canOperateLodgingData en LocationState.
Atributos de proveedores de atención médica
Recuperación y actualización de HealthProviderAttributes. Más información
Se agregó el valor booleano canOperateHealthData en LocationState
Redes de seguros
Lista de las redes de seguros que aceptan las ubicaciones. Más información

Cambios en el comportamiento

IDs de opinión
Los IDs de opinión se migraron a un formato nuevo. Este nuevo ID ahora se mostrará en todas las respuestas de la API correspondientes. Durante un período breve, los IDs de opiniones anteriores se resolverán cuando se usen para llamar a la API, pero es fundamental que actualices todos los IDs de opiniones almacenados en tu sistema en un plazo de 30 días, según lo exigen nuestras políticas, llamando al extremo listReviews.
Empresa de servicio en el área
En el 1ᵉʳ trimestre de 2021, Address ya no se mostrará en el objeto Location para las empresas de CUSTOMER_LOCATION_ONLY.

v4.7

Nuevas funciones

Menús de comida
Recuperación y actualización de FoodMenus. Más información

v4.6

Nuevas funciones

Listas de servicios
Ahora puedes recuperar y actualizar los servicios que ofrece una empresa. Más información
Se agregó el valor booleano canModifyServiceList en LocationState.
Indica si una ubicación es apta para modificar las listas de servicios.Más información
ServiceTypes predefinido para categorías
Los tipos de servicio predefinidos ahora se incluyen como en el objeto de categorías.Más información
CategoryView
Se puede especificar una vista BASIC o FULL para las categorías. La vista FULL mostrará detalles adicionales, como los tipos de servicio. Más información
Método Categories.BatchGet
Este nuevo método te permite ingresar una lista de categorías y muestra información solo sobre esas categorías. Más información

Versión 4.5, actualización 2 sobre el COVID-19

Nuevas funciones

Tipo de publicación de alerta sobre el COVID-19
Ahora puedes crear una publicación de COVID_19 a través de la API. Más información.

Versión 4.5, actualización 1 sobre el COVID-19

Nuevas funciones

Cerrado temporalmente
Ahora puedes configurar una empresa como CLOSED_TEMPORARILY a través de la API. Más información.

v4.5

Nuevas funciones

Pub/Sub para preguntas y respuestas
Ahora puedes recibir notificaciones de Google Cloud Pub/Sub para preguntas y respuestas nuevas o actualizadas en una ubicación. Más información.
Pub/Sub para el estado de las fichas
Ahora puedes recibir notificaciones de Google Cloud Pub/Sub por un cambio en el estado de la ficha. Más información.

v4.4

Nuevas funciones

Verificaciones de empresas de servicios locales
Ahora, la API puede verificar las empresas de servicios locales. Más información.
Cantidad de seguidores
Ahora puedes recuperar metadatos sobre los seguidores. Más información.
Grupos de usuarios y grupos por ubicación
Ahora se pueden crear grupos de usuarios y grupos por ubicación a través de la API. Más información
Se agregó el campo hasPendingEdits en LocationState.
Indica si las propiedades de una ubicación están en el estado de edición pendiente. Más información

Cambios de comportamiento

Open Date
Ahora puedes establecer una fecha de apertura futura para una ficha.
PointRadius
PointRadius ahora es de solo lectura. Para editar o crear empresas de servicios locales, deberás usar Lugares.

v4.3

Nuevas funciones

APIs de preguntas y respuestas
Recupera preguntas, publica respuestas y proporciona preguntas frecuentes sobre las ubicaciones de tu empresa. Más información.
Cómo leer opiniones de forma masiva
Recupera opiniones de varias ubicaciones en una sola llamada. Más información.
GoogleLocations recomendadas
Consulta las ubicaciones sin reclamar que Google considera que podrían ser de tu propiedad. Más información.
Cómo informar problemas de GoogleLocation
Informa los problemas con los resultados de RecommendedGoogleLocations o GoogleLocations. Más información.
Enum de servicios para secciones PriceList
Identifica una sección PriceList como aquella que contiene elementos de COMIDA o SERVICIOS proporcionados. Más información.
Descripción del contenido multimedia
Proporciona una leyenda cuando subas contenido multimedia nuevo. Más información.
CHAINS_QUERIES Estadísticas
Recupera la cantidad de veces que se mostró una ubicación como resultado de una búsqueda de la cadena a la que pertenece. Más información.

Cambios en el comportamiento

Notificaciones para cuentas de organización y grupos de ubicaciones
Las cuentas configuradas para recibir notificaciones de Pub/Sub ahora también recibirán esas notificaciones para las fichas que se incluyan en una cuenta de organización o en grupos por ubicación de los que sean administradores.
ListLocations para cuentas de organización y grupos por ubicación
accounts.locations.list llamado con una cuenta de organización o de grupo de usuarios ahora muestra todas las ubicaciones a las que puede acceder esa cuenta.

v4.2

Nuevas funciones

APIs de verificación
Enumera y activa los métodos de verificación disponibles para las ubicaciones sin verificar. Más información.
API de GoogleLocations
Busca ubicaciones existentes en Google para reclamarlas o recupera un vínculo para solicitar acceso a las ubicaciones reclamadas. Más información.
Filtros de ubicación expandidos
Son opciones adicionales para limitar los resultados que se muestran de una llamada a Locations.List. Más información.
Membresía de la cadena
Indica la membresía de una ubicación como parte de una cadena (p. ej., Walmart, Target, etcétera). Más información.
Información sobre la organización
La información de las cuentas de organización ahora se mostrará como parte de los objetos de cuenta. Más información.
Foto de perfil del revisor
Las URLs de las fotos de perfil de los revisores ahora se incluyen en el objeto de opinión. Más información.

v4.1

Nuevas funciones

Contenido multimedia proporcionado por el cliente
Ahora puedes recuperar y ver estadísticas de las fotos y los videos generados por usuarios de las ubicaciones que posees y administras. Más información.
APIs de administración del administrador
Ahora puedes enumerar, aceptar o rechazar invitaciones relacionadas con la cuenta y la ubicación para tu cuenta. Más información.
Profile (descripción proporcionada por el comercio)
Describe tu empresa con tus propias palabras y comparte con los usuarios la historia única de tu empresa y tus ofertas. Más información.
Campo openingDate
Proporciona la fecha en que abrió tu ubicación. Más información.
Publicaciones de tipo de oferta
Un nuevo tipo de publicación en Google que ayuda a los usuarios a encontrar ofertas disponibles en tus ubicaciones. Más información.

v4

Nuevas funciones

Publicaciones en Google
Ahora puedes crear publicaciones en Google directamente a través de la API.
Cargar
Ahora se pueden subir fotos directamente a través de la API, además de la carga de URL existente.
Filtrado o habilitación de notificaciones
Ahora puedes filtrar qué notificaciones se envían a los temas de Pub/Sub. Las notificaciones futuras usarán este mecanismo para que se habiliten en lugar de enviarse a todos los usuarios.
UPDATED_REVIEW notificaciones
Ahora puedes suscribirte a notificaciones en tiempo real para recibir actualizaciones de las opiniones de los clientes.
Compatibilidad con grupos de usuarios
La API de Google My Business ahora admite cuentas de tipo de grupo de usuarios.

Cambios incompatibles con las versiones anteriores

  • Las fotos, que antes eran 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 ahora es region_code y sub_locality ahora es sublocality.

  • Se quitó el campo Ownership que anteriormente había quedado obsoleto.

  • Anteriormente, los copropietarios de cuentas y ubicaciones no se distinguían de los propietarios principales a través de la API (todos aparecían como OWNER). Ahora, los propietarios principales tendrán el rol OWNER y los demás propietarios tendrán el rol CO_OWNER.

  • AccountType.BUSINESS ahora se llama AccountType.LOCATION_GROUP.

  • Cuando uses una máscara de campo para actualizar ubicaciones, proporciona update_mask en lugar del field_mask existente.

  • El mensaje de categoría que se usa para primary_category y additional_categories ya no contiene el formato legible por humanos. Los usuarios deben usar el servicio de categorías de la API de Google Mi Negocio para obtener nombres de categorías traducidos y legibles por humanos.

v3.3

Nuevas funciones

Menús estructurados

Ahora puedes agregar, actualizar o borrar lo siguiente:

  • Varios menús en una ubicación determinada

  • Cómo incluir varias secciones de menú en un menú

  • Mencionar los elementos del menú con nombre, descripción, precio y fotos

v3.2

Nuevas funciones

Estadísticas
Ahora puedes recuperar estadísticas de ubicación y métricas de conducción a través de la API.
Notificaciones
Ahora puedes suscribirte a notificaciones en tiempo real para las nuevas actualizaciones de Google.

Cambios incompatibles con versiones anteriores

  • Se quitaron los campos languageCodes y platforms de UrlAttributeValue que no se usaban anteriormente.

  • SAME en la enum de Ownership obsoleta ahora solo se aplica si la ubicación que duplica tiene el mismo propietario principal. Anteriormente, el comportamiento se basaba en un cálculo de propiedad más complejo.

v3.1

Nuevas funciones

Notificaciones
Ahora puedes suscribirte a notificaciones en tiempo real para las opiniones nuevas.
URLs de Maps
Las URLs de Google Maps se incluyen en las respuestas de ubicación, lo que permite a los usuarios vincularse fácilmente a Google Maps.
Estados de la ubicación
Estados de ubicación adicionales que indican cuándo la ficha está publicada, inhabilitada o pendiente de verificación.
Marca de reapertura
La marca canReopen indica las ubicaciones cerradas de forma permanente que se pueden volver a abrir en comparación con las que no se pueden.
Atributos
Compatibilidad con los atributos URL y Enum.
Extremo de categoría
Obtén una lista de las categorías admitidas por país e idioma (reemplaza los archivos CSV).

v3

Nuevas funciones

Opiniones
Ahora puedes recuperar y responder las opiniones sobre empresas a través de la API.
Atributos
Proporciona información adicional y específica de la categoría sobre las ubicaciones.
Buscar ubicación coincidente
Busca y asocia manualmente las ubicaciones de Maps existentes con la ubicación de tu empresa.
Ubicación de transferencia
Acción nueva en Location :transfer. Permite transferir una ubicación de una cuenta (personal o comercial) a otra.
Foto preferida
Indica qué foto prefieres que aparezca primero en Google Maps y la Búsqueda.
Nuevos filtros de búsqueda
Los nuevos filtros de búsqueda incluyen any_google_updates, is_suspended y is_duplicate.
Estados de la nueva ubicación
Los estados de ubicación
ahora también incluyen is_verified y needs_reverification.
Mejoras en las URLs de fotos
La API ahora acepta URLs de fotos sin un sufijo de formato de imagen.

Cambios incompatibles con versiones anteriores

  • Ahora, solo se pueden actualizar las fotos de las ubicaciones que tienen una página de Google+ (antes se aceptaban y se eliminaban de forma silenciosa).

  • Los campos location_name y category_name ahora solo son de salida. Usa solo los IDs de categoría cuando configures las categorías.

  • Las máscaras de campos ya no deben incluir el prefijo location. para los campos incluidos.

  • Las operaciones de creación o actualización ahora toman la ubicación como la carga útil del cuerpo. Los demás parámetros se mueven a la cadena de consulta.

v2

Cambios incompatibles con las versiones anteriores

  • Ahora debes especificar un request_id en las llamadas a CreateLocation. Este ID debe ser único para cada ubicación. Esto ayuda a evitar que se creen ubicaciones duplicadas en tu cuenta. Los intentos de crear una ubicación en la que el ID de la solicitud coincida con una ubicación creada anteriormente solo muestran la ubicación existente y evitan crear un duplicado en tu cuenta.

    • Se cambió el nombre de business_hours en Ubicación a regular_hours.