Preguntas frecuentes

¿Qué son las APIs de PEG?

Las APIs de Perfil de Empresa son interfaces de programación que permiten a los desarrolladores crear aplicaciones para gestionar sus cuentas de Perfil de Empresa y datos de sus ubicaciones. Además, las APIs permiten a los comerciantes o sus representantes gestionar cómo se presentan sus datos en Google y controlar quién gestiona esos datos. Los datos proporcionados por los usuarios, como las fotos, las publicaciones y las reseñas, también se pueden gestionar a través de las APIs.

Las APIs de Perfil de Empresa ofrecen la mayoría de las funciones de la interfaz de usuario de Perfil de Empresa, además de otras específicas. Los usuarios de las APIs pueden recibir actualizaciones de Google de la misma manera que las reciben los usuarios de la interfaz de usuario.

¿Quién puede acceder a las APIs de PEG?

Las APIs de PEG no son públicas, por lo que los usuarios deben solicitar acceso para usarlas. Se aprueba el acceso a cualquier persona física o empresa que pueda justificar un interés comercial legítimo. A continuación se incluyen algunas recomendaciones para demostrar el interés legalmente como empresa:

  • Usa una dirección de correo corporativa que esté asociada al dominio de tu empresa.
  • Asegúrate de que el sitio web de la empresa esté publicado y actualizado.

¿Un usuario con acceso a las APIs de PEG puede consultar datos de cualquier Perfil de Empresa en Google?

No. Aunque tengas acceso a las APIs de PEG, no puedes consultar datos de cualquier Perfil de Empresa en Google a menos que tengas acceso a ese perfil concreto.

¿Qué políticas se aplican a los usuarios de las APIs de PEG?

Los partners deben cumplir las políticas de Perfil de Empresa en Google, además de las políticas y los términos y condiciones de las APIs.

¿Cómo se consiguen las APIs de PEG?

Para crear tu primera aplicación cliente, tienes que cumplir estos requisitos:

  1. Crear una cuenta de Google.
  2. Probar Perfil de Empresa.
  3. Crear un proyecto en la consola de APIs de Google.
  4. Solicitar acceso a la API: las solicitudes se revisan en un plazo de 14 días.

¿Cómo se obtiene acceso a una determinada API dentro de las APIs de PEG?

Hay ocho APIs asociadas a Perfil de Empresa que se deben habilitar en la consola de APIs de Google:

  • API de Google My Business 4.9, que incluye estas importantes llamadas a la API:
    • FoodMenus
    • Media
    • Reviews
    • LocalPosts
  • API My Business Account Management
  • API My Business Lodging
  • API My Business Place Actions
  • API My Business Notifications
  • API My Business Verifications
  • API Business Information de My Business
  • API My Business Q&A
  • API Business Profile Performance

Si se aprueba la solicitud de acceso de un usuario, se le asignará la cuota predeterminada para las ocho APIs.

¿Cómo funciona el acceso a las APIs de PEG?

El acceso a las APIs de PEG se concede a nivel de proyecto de Google Cloud. Si el usuario A ha solicitado acceso a las APIs de Perfil de Empresa en Google para el proyecto 12345678, se concederá el acceso al 12345678. Así, cualquier usuario (entre los que se incluye el usuario A) que tenga acceso al proyecto de Google Cloud podrá hacer llamadas a las APIs de Perfil de Empresa en Google. Los partners deben controlar el acceso al proyecto de Google Cloud para evitar un uso inadecuado.

¿Hay disponible algún resumen de las APIs y ejemplos de sus funciones?

En la siguiente tabla puedes consultar las diferentes APIs y sus funciones.

API Documentación de referencia Ejemplos de funciones
API Account Management Documentación
  • Gestiona el acceso a una ubicación.
  • Crea una cuenta con el nombre y el tipo especificado en la cuenta superior en cuestión.
  • Enumera todas las cuentas del usuario autenticado.
  • Enumera las invitaciones pendientes de la cuenta especificada.
  • Mueve una ubicación de una cuenta propiedad del usuario a otra cuenta.
  • Actualiza el administrador de la ubicación especificada.
API Business Information Documentación
  • La API Business Information te permite gestionar el ciclo de vida del perfil y añadir o gestionar información de empresa en el Perfil de Empresa en Google.
  • Permite a los comerciantes obtener, crear, actualizar o eliminar Perfiles de Empresa en Google.
  • Permite a los comerciantes obtener o actualizar atributos del perfil.
  • Permite a los comerciantes obtener o buscar cadenas o categorías del perfil.
API Lodging Documentación
  • Permite gestionar datos de alojamiento de empresas en Google, como servicios y políticas de alojamiento. La API es específica para empresas que prestan servicios de alojamiento, como hoteles. Esta API permite a los desarrolladores actualizar atributos de alojamiento de un Perfil de Empresa en Google.
API Place Actions Documentación
  • Permite gestionar enlaces de acción en el sitio de empresas.
  • Redirige a los usuarios para que puedan llevar a cabo acciones como concertar una cita, reservar una mesa o pedir comida a domicilio.
API Notifications Documentación
  • Permite gestionar los ajustes de notificaciones de las cuentas especificadas.
API Verifications Documentación
  • Inicia el proceso de verificación de una ubicación.
  • Muestra todas las opciones de verificación disponibles para una ubicación en un idioma específico.
API Q&A Documentación
  • Permite gestionar preguntas y respuestas relativas a una ubicación.
API Business Profile Performance Documentación
  • Permite a los comercios obtener estadísticas de rendimiento de su ficha de empresa en Google.
  • Entre las estadísticas, se incluyen impresiones de la empresa, solicitudes de indicaciones, clics de llamada, clics al sitio web, reservas, pedidos de comida, interacciones con menús y más.
API Media Documentación
  • Permite a desarrolladores de APIs subir fotos y vídeos de un Perfil de Empresa.
API Reviews Documentación
  • Permite a los comerciantes obtener reseñas y responderlas en un Perfil de Empresa.
API LocalPosts Documentación
  • Permite a los comerciantes obtener, crear o actualizar publicaciones locales.
API FoodMenus Documentación
  • Permite a los comerciantes obtener, crear o actualizar cartas de comidas de un Perfil de Empresa.

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

Si eres un tercero que gestiona fichas de empresas:

¿Cómo autorizan las empresas a un partner de APIs de PEG para gestionar su ficha?

Las empresas pueden dar acceso a un tercero de dos formas:

  • Configuración de OAuth: en esta guía se explica cómo usan las plataformas de terceros las credenciales de los comerciantes para consultar y editar en su nombre los datos de sus Perfiles de Empresa en Google.

  • Acceso de propietario o administrador: si un comerciante que es el propietario principal de un Perfil de Empresa en Google añade a un tercero como administrador, este no necesita las credenciales del comerciante para consultar y editar los datos mediante las APIs de PEG.

    Nota: Recomendamos encarecidamente que los terceros no se añadan a sí mismos como propietarios del Perfil de Empresa en Google, sino únicamente como administradores.

Si una empresa tiene 10 ubicaciones o más, ¿se pueden verificar en bloque?

Sí. Puedes solicitar la verificación en bloque a partir de 10 perfiles. Una vez verificadas, las ubicaciones publicadas de cadenas se pueden gestionar con las APIs de Perfil de Empresa de la misma manera en que se gestionan otras ubicaciones, con algunas excepciones. Por ejemplo, los administradores del sitio se gestionan de forma diferente y ellos mismos se pueden añadir a ubicaciones de franquicias.

¿Qué límite de cuota tienen las diferentes APIs?

La cuota estándar viene determinada en los límites de uso. Si necesitas límites más altos, puedes enviar una solicitud de cuota estándar.

¿Cuánto puedo ampliar el límite de cuota?

La cuota es un recurso limitado. El equipo de Asistencia de las APIs de PEG es quien determina la posibilidad de aumentar la cuota tras confirmar el uso que has hecho previamente. Si haces un uso medio de la cuota inferior al 70 % del límite aplicable, se podrían rechazar tus solicitudes de aumento.

¿Pueden los partners de las APIs de PEG crear una cuenta de prueba para producción?

No, no hay ninguna forma de crear una ficha de PEG falsa para hacer pruebas en producción, ni en la interfaz ni en ninguna API.

En la mayoría de los casos, nuestro equipo de moderación denuncia las fichas falsas que se crean y las suspende. Por eso, recomendamos usar una ficha cliente y usarla fuera del horario habitual (sin hacer cambios en la información principal, como el nombre, la dirección o la categoría), o bien crear una ficha para la sede de la empresa. Si quieres probar una respuesta de la API para verificar una ficha o llevar a cabo cualquier otra acción que requiera una ficha en producción, puedes usar respuestas de API simulada.