Preguntas frecuentes

¿Qué son las APIs del PNG?

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

Las APIs de Perfil de Negocio ofrecen casi las mismas funciones que la interfaz de usuario del Perfil de Negocio con algunas funciones adicionales específicas de las APIs. Los usuarios de las APIs pueden esperar que las actualizaciones de Google se produzcan de la misma manera que para los usuarios de la interfaz de usuario.

¿Quién puede obtener acceso 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 poder usarlas. Cualquier persona o empresa que pueda demostrar un motivo comercial legal para acceder a las APIs de GBP recibirá la aprobación para acceder. Estas son algunas recomendaciones para demostrar la legalidad de tu empresa:

  • Usa una dirección de correo electrónico comercial válida vinculada a tu dominio comercial.
  • Asegúrate de que el sitio web de la empresa esté actualizado y publicado.

¿El acceso a las APIs del PNG permite que los usuarios consulten datos del Perfil de Negocio de Google?

No. Incluso si tienes acceso a las APIs del PNG, no puedes consultar 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 del PNG?

Los socios deben cumplir con las políticas del Perfil de Negocio de Google, así como con todas las políticas y los Términos y Condiciones de la API.

¿Cómo pueden acceder los usuarios a la API del PNG?

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

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

¿Cómo obtienen los usuarios acceso a una API determinada 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:

  • La 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 Q&A de Mi Negocio
  • API de rendimiento del Perfil de Negocio

Si se aprueba la solicitud de acceso de un usuario, 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 del proyecto de Google Cloud. Si un usuario A solicitó acceso a la API del Perfil de Negocio de Google para el proyecto n° 12345678, se le otorgará acceso al proyecto núm. 12345678. Por lo tanto, cualquier usuario, incluido el usuario A con acceso al proyecto de Google Cloud, puede realizar llamadas a las APIs del Perfil de Negocio de Google. Los socios deben controlar el acceso al proyecto de Google Cloud según sea necesario para evitar abusos.

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

Consulta la siguiente tabla para obtener información sobre las diferentes APIs y sus capacidades.

API Documentación de referencia Capacidades 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.
  • Enumera todas las cuentas del usuario autenticado.
  • Muestra una lista de las invitaciones pendientes para la cuenta especificada.
  • Mueve una ubicación de una cuenta que pertenece al usuario a otra.
  • Actualiza el administrador de 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 GBP.
  • Permite que los comercios obtengan, creen, actualicen o borren perfiles de Negocio de Google.
  • Permite que los comercios obtengan o actualicen los atributos del perfil.
  • Permite que los comercios obtengan o busquen cadenas y categorías de perfil.
API de Lodging Documentación
  • Permite administrar datos de alojamiento, por ejemplo, las comodidades de la propiedad y las políticas de las empresas en Google. La API es específica para empresas que ofrecen servicios de alojamiento, como hoteles. La API de Alojamiento 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 para llevar.
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 Q&A Documentación
  • Permite administrar las preguntas y respuestas de una ubicación.
API de rendimiento del Perfil de Negocio Documentación
  • Permite que los comercios recuperen estadísticas de rendimiento sobre su ficha de la 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 el menú y mucho más.
API de Media Documentación
  • Permite que los desarrolladores de la API suban fotos y videos para un perfil de Negocio.
API de opiniones Documentación
  • Permite que los comercios obtengan opiniones y respondan a ellas 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 comida para un perfil de Negocio.

Si aún tienes dudas sobre los datos disponibles o cómo acceder a ellos, usa los siguientes formularios para presentar una solicitud:

¿Cómo pueden los socios configurar la estructura de sus cuentas para usar las APIs del PNG?

Si eres un socio externo que administra fichas de empresas, sigue estos pasos:

¿Cómo autorizan las empresas a un socio de la API de PNG para administrar 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 y acceder a los datos del Perfil de Negocio de Google 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, que debe ser el propietario principal del PNG, entonces el socio externo no necesita usar las credenciales del comercio para usar las APIs del PNG para editar y acceder a los datos del PNG.

    Nota: Te recomendamos que los socios externos no se agreguen como propietarios del GBP, sino solo como administradores.

Si una empresa tiene más de 10 ubicaciones, ¿hay alguna forma de verificarlas de forma 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 de Perfil de Negocio de la misma manera que se administran otras ubicaciones, con algunas excepciones. Por ejemplo, los administradores de sitios se tratan de manera diferente y pueden agregarse a las ubicaciones de franquicias.

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

Los límites de cuota estándar se indican en los Límites de uso. Si necesitas límites más altos, 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 la solicitud de aumento de cuota confirmando el uso de cuota anterior. Si el uso promedio de tu cuota es inferior al 70% de tus límites actuales, es posible que se te niegue cualquier aumento adicional en ellos.

¿Los socios de la API de GBP pueden crear una cuenta de prueba para producción?

No. Lamentablemente, no hay una forma directa de crear una ficha de GBP falsa en producción, ya sea a través de la IU o la API de GBP, y probarla.

La mayoría de las fichas falsas que se crean se marcan y suspenden con nuestro proceso de moderación. Te recomendamos que uses una ficha de cliente y trabajes con ella después del horario de atención (siempre que no cambies la información principal de la ficha, como el nombre, la dirección o la categoría) o que crees una ficha para la sede de tu empresa. Si deseas probar una respuesta de la API para verificar una ficha o cualquier otra acción que requiera una ficha de producción, puedes usar respuestas de API simuladas.