Para continuar, asegúrate de completar los pasos Requisitos previos y asegúrate de que aprobemos tu proyecto para el Perfil de Negocio el acceso a las APIs.
Habilitación de las API
Hay ocho APIs asociadas con el Perfil de Negocio que deben habilitarse en la API de Google Consola:
- API de Google My Business
- API de My Business Account Management
- API de Alojamiento de Mi Negocio
- API de My Business Place Actions
- API de My Business Notifications
- API de verificación de My Business
- API de Business Information para Mi Negocio
- API de My Business Q&A
Habilitar una API
Si completaste todos Requisitos previos y se te otorgó acceso a la API, pero aún no puedes Para usar el atajo proporcionado, sigue estos pasos para habilitar la API de forma manual.
Si deseas habilitar una API para tu proyecto, haz lo siguiente:
- Abre la Biblioteca de APIs en la Consola de APIs de Google. Si se te solicita, selecciona una un proyecto nuevo o crear uno nuevo. La Biblioteca de APIs enumera todas las opciones APIs, agrupadas por familia de productos y popularidad.
- Si la API que quieres habilitar no está en la lista, usa la búsqueda para encontrarla.
- Selecciona la API que deseas habilitar y, luego, haz clic en el botón Habilitar. .
- Si se te solicita, habilita la facturación.
- Si se te solicita, acepta las Condiciones del Servicio de la API.
Si eres usuario de Google Workspace, confirma que el Perfil de Negocio de Google esté activado para tu cuenta en tu organización de Google Workspace. Si el Perfil de Negocio de Google está desactivado en tu cuenta de tu organización de Google Workspace, obtendrás el “error 403: PERMISSION DENIED” cuando uses las APIs de GBP.
Cómo solicitar un ID de cliente de OAuth 2.0
Debido a que tu app accede a datos protegidos y no públicos, necesitas un ID de cliente de OAuth 2.0 Esto permite que tu app solicite autorización para acceder a los datos de ubicación de la organización en nombre de los usuarios de la app.
Tu aplicación debe enviar un token de OAuth 2.0 con cualquier solicitud a la API del Perfil de Negocio. que accede a datos privados del usuario.
Si aún no lo has hecho, ve a la sección “Credenciales” sección de la Consola de APIs de Google y haz clic en Crear credenciales > ID de cliente de OAuth para crear tus credenciales de OAuth 2.0. Después de haber creado las credenciales, puedes ver tu ID de cliente en la página Credenciales. Haz clic en el ícono ID de cliente para obtener detalles, como secreto del cliente, URI de redireccionamiento, dirección de origen de JavaScript y correo electrónico web.
Obtén información sobre los aspectos básicos de REST
Hay dos maneras de invocar las APIs:
- Enviar una solicitud HTTP y analizar las respuestas
- Usa bibliotecas cliente.
Si decides no usar bibliotecas cliente, debes comprender los conceptos básicos de REST.
REST es un estilo de arquitectura de software que brinda un enfoque conveniente y coherente para solicitar y modificar datos.
El término REST es la forma abreviada de “Transferencia de estado representacional”. En el contexto de las APIs de Google, se refiere al uso de verbos HTTP para recuperar y modificar representaciones de los datos que almacena Google.
Un sistema RESTful almacena recursos en un almacén de datos. Un cliente envía una solicitud para servidor para realizar una acción particular, como crear, recuperar, actualizar o borrar un recurso, y el servidor realiza la acción y envía una respuesta. Esa respuesta suele tener la forma del recurso especificado.
En las APIs de RESTful de Google, el cliente especifica una acción con un verbo HTTP, como
GET, POST, PUT o DELETE. El cliente especifica
un recurso mediante un identificador de recursos uniforme (URI) global único con el siguiente formato:
https://apiName.googleapis.com/apiVersion/resourcePath?parameters
Debido a que todos los recursos de la API tienen URI únicos accesibles a HTTP, REST permite el almacenamiento en caché de datos y es optimizados para funcionar con la infraestructura distribuida de la Web.
Es posible que encuentres el
definiciones de métodos en la documentación de estándares de HTTP 1.1
útiles. Incluyen especificaciones para GET, POST, PUT y
DELETE
REST en las APIs del Perfil de Negocio
Las operaciones de las APIs del Perfil de Negocio se asignan directamente a los verbos HTTP de REST.
El formato específico de las APIs del Perfil de Negocio se muestra en el siguiente URI:
https://apiName.googleapis.com/apiVersion/resourcePath?parameters
El conjunto completo de los URI que se usan para cada operación compatible en las APIs aparece en las APIs del Perfil de Negocio. Referencia.
Las rutas de acceso a los recursos varían según el extremo.
Por ejemplo, la ruta de acceso del recurso a una cuenta aparece como en el siguiente ejemplo:
accounts/accountId
La ruta de acceso al recurso de una ubicación se muestra de la siguiente manera:
locations/locationId
Obtén información sobre los aspectos básicos de JSON
Las APIs del Perfil de Negocio muestran datos en formato JSON.
La notación de objetos de JavaScript (JSON) es un formato de datos común e independiente del lenguaje que proporciona una representación de texto simple de estructuras de datos arbitrarias. Para obtener más información, consulta json.org.
Usa OAuth Playground para realizar una solicitud HTTP simple
Puedes usar la OAuth 2.0 Playground para experimentar con las APIs del Perfil de Negocio. Debido a que las APIs del Perfil de Negocio no son APIs públicas, debes seguir algunos pasos adicionales para usarlas en Playground. Tú Necesitas un ID de cliente para que una aplicación web continúe.
- Ve a la Consola de APIs de Google. y abre tu proyecto. Si no tienes un ID de cliente de OAuth para aplicaciones web, crea uno ahora:
- En la lista desplegable Crear credenciales, selecciona ID de cliente de OAuth.
- En Tipo de aplicación, haz clic en Aplicación web.
Agrega lo siguiente como un URI de redireccionamiento válido:
https://developers.google.com/oauthplayground
- Haz clic en Crear.
- Copia el ID de cliente en el portapapeles.
- Ve a OAuth 2.0 Playground.
- Haz clic en el ícono de ajustes para abrir las opciones de configuración y realizar los siguientes cambios:
- Configura el flujo de OAuth como del lado del cliente.
- Selecciona Usa tus propias credenciales de OAuth.
- Pega tu ID de cliente de OAuth.
- Cierra las opciones de configuración.
En "Paso 1: Selecciona y autorizar APIs", pega el siguiente alcance para APIs del Perfil de Negocio en el campo Input your own scope:
https://www.googleapis.com/auth/business.manage
- Haz clic en Autorizar API.
- Haz clic en Aceptar cuando se te solicite.
-
En "Paso 2: Configura la solicitud a la API", pega el siguiente URI en la Campo URI de solicitud:
https://mybusinessaccountmanagement.googleapis.com/v1/accounts
- Haz clic en Enviar la solicitud. La respuesta debería mostrar el estado
200 OK.
Para obtener más información sobre cómo realizar varios tipos de solicitudes, consulta la Referencia de las APIs del Perfil de Negocio
Bibliotecas cliente
Las bibliotecas cliente de las APIs del Perfil de Negocio admiten la funcionalidad de las APIs del Perfil de Negocio. Proporcionan común a todas las APIs de Google, como transporte HTTP, manejo de errores, autenticación, y análisis de JSON.
Para descargar bibliotecas cliente, consulta Bibliotecas.