Google My Business API

La API de Google My Business proporciona una interfaz para administrar la información de la ubicación de la empresa en Google.

Servicio: mybusiness.googleapis.com

Para llamar a este servicio, te recomendamos que uses las bibliotecas cliente proporcionadas por Google. Si tu aplicación necesita usar tus propias bibliotecas para llamar a este servicio, usa la siguiente información cuando realices solicitudes a la API.

Documento de descubrimiento

Un Documento de descubrimiento es una especificación procesable para describir y consumir las API de REST. Se usa para compilar bibliotecas cliente, complementos IDE y otras herramientas que interactúan con las API de Google. Un servicio puede proporcionar varios documentos de descubrimiento. Este servicio proporciona los siguientes documentos de Discovery:

Extremo de servicio

Un extremo de servicio es una URL base que especifica la dirección de la red de un servicio de API. Un servicio puede tener varios extremos de servicio. Este servicio tiene el siguiente extremo, y todos los URI que se muestran a continuación son relativos a él:

  • https://mybusiness.googleapis.com

Recurso de REST: v4.accounts

Métodos
create
(deprecated)
POST /v4/accounts
Crea una cuenta con el nombre y el tipo especificados en el elemento superior determinado.
deleteNotifications
(deprecated)
DELETE /v4/{name=accounts/*/notifications}
Borra la configuración de notificaciones de Pub/Sub para la cuenta.
generateAccountNumber
(deprecated)
POST /v4/{name=accounts/*}:generateAccountNumber
Genera un número de cuenta para esta cuenta.
get
(deprecated)
GET /v4/{name=accounts/*}
Obtiene la cuenta especificada.
getNotifications
(deprecated)
GET /v4/{name=accounts/*/notifications}
Muestra la configuración de notificaciones de Pub/Sub para la cuenta.
list
(deprecated)
GET /v4/accounts
Enumera todas las cuentas del usuario autenticado.
listRecommendGoogleLocations GET /v4/{name=accounts/*}:recommendGoogleLocations
Enumera todas las GoogleLocation que se recomendaron para la cuenta del Perfil de Negocio especificada.
update
(deprecated)
PUT /v4/{name=accounts/*}
Actualiza la cuenta comercial especificada.
updateNotifications
(deprecated)
PUT /v4/{name=accounts/*/notifications}

Establece la configuración de notificaciones de Pub/Sub para la cuenta que informa al Perfil de Negocio sobre qué tema enviar notificaciones de Pub/Sub:

  • Nuevas opiniones para ubicaciones administradas por la cuenta

Recurso de REST: v4.accounts.admins

Métodos
create
(deprecated)
POST /v4/{parent=accounts/*}/admins
Invita al usuario especificado a convertirse en administrador de la cuenta especificada.
delete
(deprecated)
DELETE /v4/{name=accounts/*/admins/*}
Quita al administrador especificado de la cuenta especificada.
list
(deprecated)
GET /v4/{parent=accounts/*}/admins
Muestra una lista de los administradores de la cuenta especificada.
patch
(deprecated)
PATCH /v4/{name=accounts/*/admins/*}
Actualiza el administrador del administrador de la cuenta especificado.

Recurso de REST: v4.accounts.invitations

Métodos
accept
(deprecated)
POST /v4/{name=accounts/*/invitations/*}:accept
Acepta la invitación especificada.
decline
(deprecated)
POST /v4/{name=accounts/*/invitations/*}:decline
Rechaza la invitación especificada.
list
(deprecated)
GET /v4/{parent=accounts/*}/invitations
Muestra una lista de invitaciones pendientes para la cuenta especificada.

Recurso de REST: v4.accounts.locations

Métodos
associate POST /v4/{name=accounts/*/locations/*}:associate
Asocia una ubicación a un ID de lugar.
batchGet POST /v4/{name=accounts/*}/locations:batchGet
Obtiene todas las ubicaciones especificadas en la cuenta determinada.
batchGetReviews POST /v4/{name=accounts/*}/locations:batchGetReviews
Muestra la lista paginada de opiniones de todas las ubicaciones especificadas.
clearAssociation POST /v4/{name=accounts/*/locations/*}:clearAssociation
Borra una asociación entre una ubicación y su ID de lugar.
create POST /v4/{parent=accounts/*}/locations
Crea un location nuevo que pertenezca a la cuenta especificada y lo muestra.
delete DELETE /v4/{name=accounts/*/locations/*}
Borra una ubicación.
fetchVerificationOptions POST /v4/{name=accounts/*/locations/*}:fetchVerificationOptions
Informa todas las opciones de verificación aptas para una ubicación en un idioma específico.
findMatches POST /v4/{name=accounts/*/locations/*}:findMatches
Busca todas las ubicaciones posibles que coinciden con la ubicación especificada.
get GET /v4/{name=accounts/*/locations/*}
Obtiene la ubicación especificada.
getFoodMenus GET /v4/{name=accounts/*/locations/*/foodMenus}
Muestra los menús de comida de una ubicación específica.
getGoogleUpdated GET /v4/{name=accounts/*/locations/*}:googleUpdated
Obtiene la versión actualizada por Google de la ubicación especificada.
getHealthProviderAttributes GET /v4/{name=accounts/*/locations/*/healthProviderAttributes}
Muestra los atributos del proveedor de salud de una ubicación específica.
getServiceList GET /v4/{name=accounts/*/locations/*/serviceList}
Obtén la lista de servicios especificada de una ubicación.
list GET /v4/{parent=accounts/*}/locations
Muestra una lista de las ubicaciones de la cuenta especificada.
patch PATCH /v4/{name=accounts/*/locations/*}
Actualiza la ubicación especificada.
reportInsights POST /v4/{name=accounts/*}/locations:reportInsights
Muestra un informe que contiene estadísticas sobre una o más métricas por ubicación.
transfer
(deprecated)
POST /v4/{name=accounts/*/locations/*}:transfer
Traslada una ubicación de una cuenta que posee el usuario a otra cuenta que administra el mismo usuario.
updateFoodMenus PATCH /v4/{foodMenus.name=accounts/*/locations/*/foodMenus}
Actualiza los menús de comida de una ubicación específica.
updateHealthProviderAttributes PATCH /v4/{healthProviderAttributes.name=accounts/*/locations/*/healthProviderAttributes}
Actualiza los atributos del proveedor de salud de una ubicación específica.
updateServiceList PATCH /v4/{serviceList.name=accounts/*/locations/*/serviceList}
Actualiza la lista de servicios especificada de una ubicación.
verify POST /v4/{name=accounts/*/locations/*}:verify
Inicia el proceso de verificación de una ubicación.

Recurso de REST: v4.accounts.locations.admins

Métodos
create
(deprecated)
POST /v4/{parent=accounts/*/locations/*}/admins
Invita al usuario especificado a convertirse en administrador de la ubicación especificada.
delete
(deprecated)
DELETE /v4/{name=accounts/*/locations/*/admins/*}
Quita al administrador especificado como administrador de la ubicación especificada.
list
(deprecated)
GET /v4/{parent=accounts/*/locations/*}/admins
Muestra una lista de todos los administradores de la ubicación especificada.
patch
(deprecated)
PATCH /v4/{name=accounts/*/locations/*/admins/*}
Actualiza el administrador del administrador de ubicación especificado.

Recurso de REST: v4.accounts.locations.followers

Métodos
getMetadata GET /v4/{name=accounts/*/locations/*/followers/metadata}
Obtén la configuración de seguidores de una ubicación.

Recurso de REST: v4.accounts.locations.insuranceNetworks

Métodos
list GET /v4/{parent=accounts/*/locations/*}/insuranceNetworks
Muestra una lista de todas las redes de seguros compatibles con Google.

Recurso de REST: v4.accounts.locations.localPosts

Métodos
create POST /v4/{parent=accounts/*/locations/*}/localPosts
Crea una nueva publicación local asociada con la ubicación especificada y la muestra.
delete DELETE /v4/{name=accounts/*/locations/*/localPosts/*}
Borra una publicación local.
get GET /v4/{name=accounts/*/locations/*/localPosts/*}
Obtiene la publicación local especificada.
list GET /v4/{parent=accounts/*/locations/*}/localPosts
Muestra una lista de publicaciones locales asociadas con una ubicación.
patch PATCH /v4/{name=accounts/*/locations/*/localPosts/*}
Actualiza la publicación local especificada y muestra la publicación local actualizada.
reportInsights POST /v4/{name=accounts/*/locations/*}/localPosts:reportInsights
Muestra estadísticas de un conjunto de publicaciones locales asociadas con una sola ficha.

Recurso de REST: v4.accounts.locations.media

Métodos
create POST /v4/{parent=accounts/*/locations/*}/media
Crea un nuevo elemento multimedia para la ubicación.
delete DELETE /v4/{name=accounts/*/locations/*/media/*}
Borra el elemento multimedia especificado.
get GET /v4/{name=accounts/*/locations/*/media/*}
Muestra los metadatos del elemento multimedia solicitado.
list GET /v4/{parent=accounts/*/locations/*}/media
Muestra una lista de elementos multimedia asociados con una ubicación.
patch PATCH /v4/{name=accounts/*/locations/*/media/*}
Actualiza los metadatos del elemento multimedia especificado.
startUpload POST /v4/{parent=accounts/*/locations/*}/media:startUpload
Genera un MediaItemDataRef para la carga de elementos multimedia.

Recurso de REST: v4.accounts.locations.media.customers

Métodos
get GET /v4/{name=accounts/*/locations/*/media/customers/*}
Muestra los metadatos del elemento multimedia del cliente solicitado.
list GET /v4/{parent=accounts/*/locations/*}/media/customers
Muestra una lista de elementos multimedia asociados con una ubicación que aportaron los clientes.

Recurso de REST: v4.accounts.locations.questions

Métodos
create POST /v4/{parent=accounts/*/locations/*}/questions
Agrega una pregunta para la ubicación especificada.
delete DELETE /v4/{name=accounts/*/locations/*/questions/*}
Borra una pregunta específica escrita por el usuario actual.
list GET /v4/{parent=accounts/*/locations/*}/questions
Muestra la lista paginada de preguntas y algunas de sus respuestas para una ubicación especificada.
patch PATCH /v4/{name=accounts/*/locations/*/questions/*}
Actualiza una pregunta específica escrita por el usuario actual.

Recurso de REST: v4.accounts.locations.questions.answers

Métodos
delete DELETE /v4/{parent=accounts/*/locations/*/questions/*}/answers:delete
Borra la respuesta que escribió el usuario actual en una pregunta.
list GET /v4/{parent=accounts/*/locations/*/questions/*}/answers
Muestra la lista paginada de respuestas de una pregunta específica.
upsert POST /v4/{parent=accounts/*/locations/*/questions/*}/answers:upsert
Crea una respuesta o actualiza la respuesta existente que escribió el usuario para la pregunta especificada.

Recurso de REST: v4.accounts.locations.reviews

Métodos
deleteReply DELETE /v4/{name=accounts/*/locations/*/reviews/*}/reply
Borra la respuesta a la opinión especificada.
get GET /v4/{name=accounts/*/locations/*/reviews/*}
Muestra la opinión especificada.
list GET /v4/{parent=accounts/*/locations/*}/reviews
Muestra la lista paginada de opiniones de la ubicación especificada.
updateReply PUT /v4/{name=accounts/*/locations/*/reviews/*}/reply
Actualiza la respuesta a la opinión especificada.

Recurso de REST: v4.accounts.locations.verifications

Métodos
complete POST /v4/{name=accounts/*/locations/*/verifications/*}:complete
Completa una verificación de PENDING.
list GET /v4/{parent=accounts/*/locations/*}/verifications
Obtén una lista de las verificaciones de una ubicación, ordenadas según la hora de creación.

Recurso de REST: v4.attributes

Métodos
list GET /v4/attributes
Muestra la lista de atributos disponibles que estarían disponibles para una ubicación con la categoría principal y el país especificados.

Recurso de REST: v4.categories

Métodos
batchGet GET /v4/categories:batchGet
Muestra una lista de categorías de empresas para el lenguaje y los IDs de GConcept proporcionados.
list GET /v4/categories
Muestra una lista de categorías de empresa.

Recurso de REST: v4.chains

Métodos
get GET /v4/{name=chains/*}
Obtiene la cadena especificada.
search GET /v4/chains:search
Busca la cadena según su nombre.

Recurso de REST: v4.googleLocations

Métodos
report POST /v4/{name=googleLocations/*}:report
Informa un GoogleLocation.
search POST /v4/googleLocations:search
Busca en todas las ubicaciones posibles que coincidan con la solicitud especificada.

Servicio: mybusiness.googleapis.com

Para llamar a este servicio, te recomendamos que uses las bibliotecas cliente proporcionadas por Google. Si tu aplicación necesita usar tus propias bibliotecas para llamar a este servicio, usa la siguiente información cuando realices solicitudes a la API.

Documento de descubrimiento

Un Documento de descubrimiento es una especificación procesable para describir y consumir las API de REST. Se usa para compilar bibliotecas cliente, complementos IDE y otras herramientas que interactúan con las API de Google. Un servicio puede proporcionar varios documentos de descubrimiento. Este servicio proporciona los siguientes documentos de Discovery:

Extremo de servicio

Un extremo de servicio es una URL base que especifica la dirección de la red de un servicio de API. Un servicio puede tener varios extremos de servicio. Este servicio tiene el siguiente extremo, y todos los URI que se muestran a continuación son relativos a él:

  • https://mybusiness.googleapis.com

Recurso de REST: v1.media

Métodos
upload POST /v1/media/{resourceName=**}
POST /upload/v1/media/{resourceName=**}
Sube contenido multimedia.