v4.9
Nuevas funciones
MoreHours
- Ahora se pueden establecer MoreHours como parte de la ficha de la empresa.
MoreHourTypes
se puede recuperar para cada categoría con categories.batchGet.
Cambios de comportamiento
- Baja de cuentas v4.x
- accounts, accounts.admins, accounts.invitations y accounts.locations.admins ya no están disponibles en la API de Google My Business. Para obtener más información, consulta el registro de cambios de baja.
- Publicaciones de llamado a la acción
- En el 2o trim. de 2021,
CallToAction
las publicaciones con GET_OFFERActionType
dejarán de ser válidas.
v4.8
Nuevas funciones
- Comodidades del alojamiento
- Recuperación y actualización de las comodidades del alojamiento. Más información
- Se agregó el extremo GetGoogleUpdated para el alojamiento.
- Adición del valor booleano
canOperateLodgingData
en LocationState - Atributos del proveedor de salud
- Recuperación y actualización de HealthProviderAttributes. Más información
- Incorporación del valor booleano
canOperateHealthData
en LocationState - Redes de seguros
- Enumera redes de seguros que aceptan las ubicaciones. Más información
Cambios de comportamiento
- ID de revisión
- Se migraron los IDs de opiniones a un formato nuevo. Este ID nuevo ahora se mostrará en todas las respuestas de la API aplicables. Por un período breve, los IDs de opiniones anteriores se resolverán cuando se usen para llamar a la API, pero es fundamental actualizar todos los IDs de opiniones almacenados en tu sistema en un plazo de 30 días (según lo que exigen nuestras políticas) llamando al extremo listReviews.
- Empresa de servicio en el área
- En el primer trimestre de 2021, ya no se mostrará
Address
en el objeto Ubicación para las empresas deCUSTOMER_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
- Adición del 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 servicios predefinidos ahora se incluyen como en el objeto de categorías.Más información
- CategoryView
- Se puede especificar una vista
BASIC
oFULL
para las categorías. La vistaFULL
mostrará detalles adicionales, como los tipos de servicios. 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
Actualización 2 del COVID-19 v4.5
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. More Info.
Actualización 1 del COVID-19 v4.5
Nuevas funciones
- Cerrado temporalmente
- Ahora puedes configurar un negocio como
CLOSED_TEMPORARILY
a través de la API. More Info.
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 que se hagan en una ubicación. More Info.
- Pub/Sub para el estado de la lista
- Ahora puedes recibir notificaciones de Google Cloud Pub/Sub sobre cambios en el estado de la ficha. More Info.
v4.4
Nuevas funciones
- Verificaciones de Empresas de Servicios Locales
- Ahora las empresas de servicios locales pueden verificarse con la API. More Info.
- Cantidad de seguidores
- Ahora puedes recuperar metadatos sobre los seguidores. More Info.
- Grupos de usuarios y grupos por ubicación
- Los grupos de usuarios y por ubicación ahora se pueden crear con la API. Más información
- Se agregó el campo
hasPendingEdits
a LocationState - Indica si las propiedades de una ubicación se encuentran en el estado de edición pendiente. Más información
Cambios de comportamiento
- Open Date
- Ahora puedes establecer una fecha de apertura en el futuro para una ficha.
PointRadius
- PointRadius ahora es de solo lectura. Para editar o crear empresas de servicios locales, será necesario utilizar Places.
v4.3
Funciones nuevas
- APIs de preguntas y respuestas
- Recupera preguntas, publica respuestas y proporciona preguntas frecuentes sobre las ubicaciones de tu empresa. More Info.
- Lectura masiva de opiniones
- Recupera las opiniones de varias ubicaciones en una sola llamada. More Info.
- Ubicaciones de Google recomendadas
- Consulta las ubicaciones no reclamadas que Google considera que podrían ser de tu propiedad. More Info.
- Informar problemas con la ubicación de Google
- Informa problemas con los resultados de
RecommendedGoogleLocations
oGoogleLocations
. More Info. - Enumeración de servicio para
PriceList
secciones - Identifica que una sección
PriceList
contenga artículos de ALIMENTO o SERVICIOS proporcionados. More Info. - Descripción del contenido multimedia
- Incluye una leyenda cuando subas nuevo contenido multimedia. More Info.
- Estadísticas de
CHAINS_QUERIES
- Recupera la cantidad de veces que se mostró una ubicación como resultado de una búsqueda de la cadena a la que pertenece. More Info.
Cambios de comportamiento
- Notificaciones de las cuentas de organización y los grupos por ubicación
- Las cuentas configuradas para notificaciones de Pub/Sub ahora también recibirán esas notificaciones para cualquier ficha que se encuentre en una cuenta de organización o en grupos por ubicación de los que sea administrador.
ListLocations
para la cuenta de la organización y los grupos por ubicación- Ahora
accounts.locations.list
llamada con una cuenta de organización o grupo de usuarios muestra todas las ubicaciones a las que puede acceder esa cuenta.
v4.2
Funciones nuevas
- APIs de verificación
- Enumera y activa los métodos de verificación disponibles para las ubicaciones sin verificar. More Info.
- API de GoogleLocations
- Busca ubicaciones existentes en Google para reclamar o recupera un vínculo a fin de solicitar acceso a las ubicaciones reclamadas. More Info.
- Filtros de ubicación expandidos
- Opciones adicionales para limitar los resultados que se muestran de una llamada a Locations.List. More Info
- Membresía de la cadena
- Indican la membresía de una ubicación como parte de una cadena (p. ej., Walmart, Target, etcétera). More Info.
- Información de la organización
- Ahora la información de las cuentas de organización se mostrará como parte de los objetos de la cuenta. More Info.
- Foto de perfil del revisor
- Las URLs de las fotos de perfil de los revisores ahora se incluyen en el objeto de opinión. More Info.
v4.1
Funciones nuevas
- Medios proporcionados por el cliente
- Ahora puedes recuperar y consultar estadísticas de fotos y videos generados por los usuarios de las ubicaciones que administras y de tu propiedad. More Info.
- APIs de Admin Management
- Ahora puedes enumerar, aceptar y rechazar invitaciones relacionadas con la cuenta y la ubicación para tu cuenta. More Info.
Profile
(descripción proporcionada por el comercio)- Describe tu empresa y compártela con los usuarios sobre su historia única y sus ofertas. More Info.
- Campo
openingDate
- Proporciona la fecha en la que abrió tu sucursal. More Info.
- Publicaciones sobre el tipo de oferta
- Es un nuevo tipo de Publicación en Google que ayuda a los usuarios a encontrar ofertas disponibles en tus ubicaciones. More Info.
v4
Funciones nuevas
- publicaciones en Google
- Ahora puedes crear Publicaciones en Google directamente a través de la API.
- Cargar
- Ahora las fotos se pueden subir directamente a través de la API, además de la carga de URL existente.
- Filtro/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 habilite, en lugar de enviarse a todos los usuarios.
UPDATED_REVIEW
notificaciones- Ahora puedes suscribirte a notificaciones en tiempo real para recibir actualizaciones sobre las opiniones de los clientes.
- Compatibilidad con grupos de usuarios
- La API de Google My Business ahora admite cuentas del tipo de grupo de usuarios.
Cambios incompatibles con versiones anteriores
Las fotos, que antes eran un campo de objetos
location
, ahora son un recurso en ubicación (accounts/account_ID/locations/location_ID/photos
).El campo de dirección
Country
ahora esregion_code
ysub_locality
ahora essublocality
.Se quitó el campo
Ownership
que ya estaba obsoleto.Antes, los copropietarios de cuentas y ubicaciones no se podían distinguir de los propietarios principales a través de la API (todos parecían ser
OWNER
). Ahora, a los propietarios principales se les otorgará la funciónOWNER
, mientras que a los demás propietarios se les otorgará la funciónCO_OWNER
.AccountType.BUSINESS
ahora se llamaAccountType.LOCATION_GROUP
.Cuando uses una máscara de campo para actualizar ubicaciones, proporciona
update_mask
en lugar delfield_mask
existente.El mensaje de categoría que se usó para
primary_category
yadditional_categories
ya no contiene el formato legible. Los usuarios deben usar el servicio de categorías de la API de Google My Business para obtener nombres de categorías traducidos y legibles.
v3.3
Funciones nuevas
- Menús estructurados
Ahora puedes agregar, actualizar o borrar lo siguiente:
Varios menús en una ubicación determinada
Incluir varias secciones del menú en un mismo menú
Lista de elementos de menú con nombre, descripción, precio y fotos
v3.2
Funciones nuevas
- Información valiosa
- Ahora puedes obtener estadísticas de ubicación y métricas de conducción a través de la API.
- Notificaciones
- Ahora puedes suscribirte a las notificaciones en tiempo real de las nuevas Actualizaciones de Google.
Cambios incompatibles con versiones anteriores
Se quitaron los campos
languageCodes
yplatforms
deUrlAttributeValue
que no se usaban anteriormente.SAME
en la enumeración de propiedad obsoleta ahora solo se aplica si la ubicación que este duplicado tiene el mismo propietario principal. Anteriormente, el comportamiento se basaba en un cálculo de propiedad más complejo.
v3.1
Funciones nuevas
- Notificaciones
- Ahora puedes suscribirte a notificaciones en tiempo real de 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 vincular fácilmente a Google Maps.
- Estados de la ubicación
- Estados de ubicación adicionales que indican cuándo la ficha se publica, inhabilita o tiene pendiente la verificación.
- Volver a abrir la marca
- La marca
canReopen
indica las ubicaciones cerradas de forma permanente que se pueden volver a abrir frente a aquellas que no 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 y por idioma (reemplaza a los archivos CSV).
v3
Funciones nuevas
- Opiniones
- Ahora puedes recuperar y responder opiniones de empresas a través de la API.
- Atributos
- Proporciona información adicional y específica de categoría sobre las ubicaciones.
- Buscar ubicación coincidente
- Busca ubicaciones de mapas existentes y asócialas manualmente con la ubicación de tu empresa.
- Transferir ubicación
- Nueva acción en
Location :transfer
. Permite transferir una ubicación de una cuenta (empresarial o personal) a otra. - Foto preferida
- Indica 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 incluyen
any_google_updates
,is_suspended
yis_duplicate
. - Nuevos estados de ubicación
- Los estados de ubicación ahora también incluyen
is_verified
yneeds_reverification
. - Mejoras en la URL de las fotos
- La API ahora acepta URLs de fotos sin 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 silenciosamente).
Los campos
location_name
ycategory_name
ahora son solo de salida. Solo usa los IDs de categoría cuando configures categorías.Las máscaras de campo 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; otros parámetros se mueven a la cadena de consulta.
v2
Cambios incompatibles con versiones anteriores
Ahora debes especificar un
request_id
en las llamadas a CreateLocation. Este ID debe ser único para cada ubicación y ayuda a evitar la creación de ubicaciones duplicadas en tu cuenta. Los intentos de crear una ubicación en la que el ID de solicitud coincida con una ubicación creada con anterioridad simplemente muestra la ubicación existente y evita crear un duplicado en tu cuenta.- Se cambió el nombre de
business_hours
en Location aregular_hours
.
- Se cambió el nombre de