La API de Google Business Performance tiene un método de API NUEVO que permite recuperar varias métricas "DailyMetrics" en una sola solicitud a la API.
Revise el programa de baja y las instrucciones para migrar del método de la API de reportInsights versión 4 a la API de rendimiento del Perfil de Negocio de Google.

Se usó la API de Cloud Translation para traducir esta página.

Preguntas frecuentes

¿Qué son las APIs de GBP?

Las APIs del Perfil de Negocio son interfaces de programación que permiten a los desarrolladores escribir aplicaciones para administrar los datos de ubicación y de su cuenta del Perfil de Negocio. Las APIs permiten que los comercios o sus representantes administren cómo se presentan sus datos en Google y controlen quién los administra en conjunto. Los datos creados por los usuarios, como fotos, publicaciones y opiniones, también se pueden administrar a través de las APIs.

Las APIs del Perfil de Negocio ofrecen casi las mismas funciones que la interfaz de usuario del Perfil de Negocio, además de algunas funciones adicionales específicas de las APIs. Los usuarios de las APIs pueden esperar que las actualizaciones de Google ocurran tal como lo hacen para los usuarios de la interfaz de usuario.

¿Quiénes pueden acceder a las APIs de GBP?

Las APIs de GBP no están abiertas al público. Los usuarios deben solicitar acceso a las APIs de GBP para usarlas. Se aprueba el acceso de todas las personas físicas o empresas que puedan demostrar un motivo empresarial legal para acceder a las APIs de GBP. Algunas recomendaciones para demostrar la legalidad como empresa son:

Usa una dirección de correo electrónico empresarial válida que esté vinculada al dominio de tu empresa.
Asegurarte de que el sitio web de la empresa esté actualizado y publicado

¿Los usuarios tienen acceso a las APIs de GBP que pueden consultar los datos del Perfil de Negocio de Google?

No. Aunque tengas acceso a las APIs de GBP, no podrás consultar los datos del Perfil de Negocio de Google, a menos que tengas acceso a ese Perfil de Negocio de Google en particular.

¿Cuáles son las políticas relevantes para los usuarios de la API de GBP?

Los socios deben cumplir con las políticas del Perfil de Negocio de Google, junto con todas las políticas y los Términos y Condiciones de las APIs.

¿Cómo acceden los usuarios a la API de GBP?

Para crear correctamente tu primera aplicación cliente, debes completar los siguientes requisitos previos:

Obtén una Cuenta de Google.
Prueba el Perfil de Negocio.
Crea un proyecto en la Consola de APIs de Google.
Solicita acceso a la API: Las solicitudes se revisan en un plazo de 14 días.

¿Cómo acceden los usuarios a una API específica dentro de la API de GBP?

Hay ocho APIs asociadas con el Perfil de Negocio que se deben habilitar en la Consola de APIs de Google:

API de Google My Business 4.9, que incluye las siguientes llamadas importantes a la API de funciones:
- FoodMenus
- Media
- Reviews
- LocalPosts
API de My Business Account Management
API de My Business Lodging
API de My Business Place Actions
API de My Business Notifications
API de My Business Verifications
API de Business Information para Mi Negocio
API de My Business Q&A
API de rendimiento del Perfil de Negocio

Si se aprueba la solicitud de un usuario para solicitar acceso, se le otorga una cuota predeterminada estándar para las ocho APIs.

¿Cómo funciona el acceso a la API de GBP?

El acceso a la API de GBP se otorga a nivel de proyecto de Google Cloud. Si un usuario A solicitó acceso a la API del Perfil de Negocio de Google para el proyecto 12345678, se otorga acceso al proyecto número 12345678. Por lo tanto, cualquier usuario, incluido el usuario A con acceso al proyecto de Google Cloud, puede hacer llamadas a las APIs del Perfil de Negocio de Google. Los socios deben controlar el acceso al proyecto de Google Cloud según su necesidad de acceso para evitar abusos.

¿Tiene un resumen de las APIs y las capacidades de ejemplo?

Consulta la siguiente tabla para conocer las diferentes APIs y sus capacidades.

API	Documentación de referencia	Funciones de ejemplo
API de Account Management	Documentación	Administrar el acceso a una ubicación Crea una cuenta con el nombre y el tipo especificados en el elemento superior determinado. Muestra una lista de todas las cuentas del usuario autenticado. Se muestra una lista de las invitaciones pendientes para la cuenta especificada. Transfiere una ubicación de una cuenta que es propiedad del usuario a otra cuenta. Actualiza al administrador para la ubicación especificada.
API de Business Information	Documentación	La API de Business Information permite administrar el ciclo de vida del perfil y agregar o administrar información de la empresa en el PNG. Permite que los comercios obtengan, creen, actualicen o borren Perfiles de Negocio de Google. Permite que los comercios obtengan o actualicen atributos de perfil. Permite a los comercios obtener o buscar cadenas o categorías de perfiles.
API de Lodging	Documentación	Permite la administración de datos de alojamiento, como comodidades de la propiedad y políticas de empresas en Google. La API es específica para empresas que proporcionan servicios de alojamiento, como hoteles. La API de Lodging permite a los desarrolladores actualizar los atributos de alojamiento de un Perfil de Negocio de Google.
API de Place Actions	Documentación	Permite administrar los vínculos de acción de lugar en las empresas. Redirecciona a los usuarios para que realicen acciones como reservar una cita, reservar una mesa y pedir comida a domicilio.
API de Notifications	Documentación	Habilita la administración de la configuración de notificaciones para cuentas específicas.
API de Verifications	Documentación	Inicia el proceso de verificación de una ubicación. Informa todas las opciones de verificación aptas para una ubicación en un idioma específico.
API de preguntas y respuestas	Documentación	Permite administrar las preguntas y respuestas de una ubicación.
API de rendimiento del Perfil de Negocio	Documentación	Permite a los comercios obtener estadísticas de rendimiento sobre la ficha de su empresa en Google. Las estadísticas incluyen impresiones de la empresa, solicitudes de instrucciones sobre cómo llegar, clics de llamada, clics en el sitio web, reservas, pedidos de comida, interacciones con los menús y mucho más.
API de Media	Documentación	Permite a los desarrolladores de API subir fotos y videos para un Perfil de Negocio.
API de Reviews	Documentación	Permite que los comercios obtengan opiniones y las respondan en un Perfil de Negocio.
API de Local Posts	Documentación	Permite que los comercios obtengan, creen o actualicen publicaciones locales.
API de FoodMenus	Documentación	Permite que los comercios obtengan, creen o actualicen menús de comidas para un Perfil de Negocio.

¿Cómo pueden los socios configurar la estructura de su cuenta para usar las APIs de GBP?

Si eres un socio externo que administra las fichas de las empresas, ten en cuenta lo siguiente:

Regístrate como agencia para tener una cuenta de organización del PNG.
Familiarízate con los conceptos de grupos de usuarios y grupos de ubicaciones de la empresa.
Consulta esta guía para comprender cómo administrar ubicaciones en nombre de las empresas.

¿Cómo autorizan las empresas a un socio de la API de GBP para que administre su ficha de la empresa?

Las empresas otorgan acceso a un socio externo de dos maneras:

Configuración de OAuth: Consulta esta guía para comprender cómo las plataformas de socios externos usan las credenciales del comercio para editar los datos del Perfil de Negocio de Google y acceder a ellos en nombre del comercio o la empresa.
Acceso de propietario o administrador: Si el comercio agrega a un socio externo como administrador del Perfil de Negocio de Google, quien debería ser el propietario principal de la PNG, el socio externo no necesita usar credenciales del comercio para usar las APIs de GBP para editar los datos de GBP y acceder a ellos.

Nota: Recomendamos que los socios externos no se agreguen como propietarios del PNG, sino que solo se agreguen como administradores.

Si una empresa tiene más de 10 ubicaciones, ¿hay alguna manera de realizar la verificación masiva?

Sí. Puedes solicitar la verificación masiva de más de 10 perfiles. Después de la verificación, las ubicaciones de cadenas publicadas se pueden administrar con las APIs del Perfil de Negocio de la misma manera que se administran otras ubicaciones, con algunas excepciones. Por ejemplo, los administradores del lugar reciben un trato diferente y pueden agregarse a ubicaciones de franquicia.

¿Cuáles son los límites de cuota para las distintas APIs?

Los límites de cuota estándar se enumeran en Límites de uso. Si necesitas aumentar los límites, puedes enviar una solicitud de cuota estándar.

¿Cuánta cuota puedo solicitar?

La cuota es un recurso limitado. El equipo de asistencia al cliente de la API de GBP determina la elegibilidad para solicitar un aumento de cuota confirmando tu uso de cuota anterior. Si el uso promedio de la cuota es inferior al 70% de los límites de cuota actuales, es posible que se rechacen los aumentos adicionales en los límites de cuota.

¿Pueden los socios de la API de GBP crear una cuenta de prueba para producción?

No. Lamentablemente, no hay una forma directa de crear una ficha de PNG falsa en producción a través de la IU o la API de GBP y de realizar pruebas con ella.

La moderación y suspensión de la mayoría de las fichas falsas que se crean se marcan. El consejo es usar una ficha de clientes y trabajar con ella fuera del horario de atención (siempre que no cambies ninguna información principal de la ficha, como el nombre, la dirección o la categoría) o crees una ficha para la sede central de tu empresa. Si quieres probar una respuesta de la API para verificar una lista o cualquier otra acción que requiera una lista de producción, puedes usar respuestas de la API de prueba.