Usar OAuth

La API de Roads Selection usa la API de Roads Selection como un componente principal que proporciona datos de rutas a BigQuery y Pub/Sub.

La API de Roads Selection admite el uso de OAuth 2.0 para la autenticación. Google admite situaciones comunes de OAuth 2.0, como las de un servidor web.

En este documento, se describe cómo pasar un token de OAuth a la llamada a la API de Roads Selection en tu entorno de desarrollo. Para obtener más información sobre el uso de OAuth en un entorno de producción, consulta Autenticación en Google.

Antes de comenzar

Antes de comenzar a usar la API de Roads Selection, debes tener un proyecto con una cuenta de facturación y la API de Roads Selection habilitada. Para obtener más información, consulta Cómo configurar tu proyecto en la consola de Cloud.

Acerca de OAuth

Puedes crear y administrar tokens de acceso con OAuth de varias maneras, según tu entorno de implementación.

Por ejemplo, el sistema de Google OAuth 2.0 admite interacciones de servidor a servidor, como las que se producen entre tu aplicación y un servicio de Google. Para esta situación, debes tener una cuenta de servicio, que es una cuenta que pertenece a tu aplicación, no a un usuario individual. Tu aplicación llama a las APIs de Google en nombre de la cuenta de servicio porque los usuarios no participan directamente. Para obtener más información sobre los métodos de autenticación, consulta Autenticación en Google.

Como alternativa, puedes usar la API de Roads Selection como parte de una app para dispositivos móviles iOS o Android. Para obtener más información sobre cómo usar OAuth con la API de Roads Selection, incluida la información sobre cómo administrar tokens de acceso para diferentes entornos de implementación, consulta Usa OAuth 2.0 para acceder a las APIs de Google.

Acerca de los permisos de OAuth

Para usar OAuth con la API de Roads Selection, el token de OAuth debe tener el permiso https://www.googleapis.com/auth/cloud-platform.

Ejemplo: Prueba las llamadas a la API de REST en tu entorno de desarrollo local

Si quieres probar la API de Roads Selection con un token de OAuth, pero no tienes un entorno configurado para generar tokens, sigue el procedimiento de esta sección para realizar la solicitud.

En este ejemplo, se describe cómo usar el token de OAuth que proporcionan las credenciales predeterminadas de la aplicación (ADC) para realizar la llamada. Para obtener más información sobre el uso de ADC para llamar a las APIs de Google con bibliotecas cliente, consulta Autentícate con bibliotecas cliente.

Requisitos previos

Antes de realizar una solicitud REST con ADC, usa Google Cloud CLI para proporcionar credenciales a ADC:

  1. Si aún no lo hiciste, crea un proyecto y habilita la facturación siguiendo los pasos que se indican en Configura en la consola de Cloud.
  2. Instala e inicializa gcloud CLI

  3. Para crear tu archivo de credenciales, ejecuta el comando gcloud en tu máquina local:

    gcloud auth application-default login
  4. Cuando se te solicite, accede. Después de acceder, tus credenciales se almacenan en el archivo de credenciales local que usa ADC.

Para obtener más información, consulta la sección Entorno de desarrollo local de la documentación Proporciona credenciales para las credenciales predeterminadas de la aplicación.

Realiza una solicitud de REST

En este ejemplo, pasas dos encabezados de solicitud:

Realiza una llamada a la API de Roads Selection con un token de OAuth:

curl -X GET \
-H 'X-Goog-User-Project: PROJECT_NUMBER' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
https://roads.googleapis.com/selection/v1/projects/PROJECT_NUMBER/selectedRoutes/SELECTED_ROUTE_ID

Solución de problemas

Si en la solicitud se muestra un mensaje de error sobre la compatibilidad de las credenciales del usuario final con la API, consulta Las credenciales de usuario no funcionan.