Les guides de démarrage rapide expliquent comment configurer et exécuter une application qui appelle un API Google Workspace.
Les guides de démarrage rapide de Google Workspace utilisent les bibliothèques clientes des API pour gérer certaines les détails du flux d'authentification et d'autorisation. Nous vous recommandons vous utilisez les bibliothèques clientes pour vos propres applications. Ce guide de démarrage rapide utilise une approche d'authentification simplifiée, adaptée à un test environnement. Pour un environnement de production, nous vous recommandons de vous familiariser authentification et autorisation avant Choisir les identifiants d'accès adaptés à votre application.
Créer une application Web JavaScript qui envoie des requêtes à l'API Google Calendar
Objectifs
- configurer votre environnement ;
- Configurez l'exemple.
- Exécutez l'exemple.
Prérequis
- Node.js et npm installés.
- Un environnement Google Cloud projet.
- Un compte Google dans lequel Google Agenda est activé.
Configurer votre environnement
Pour suivre ce guide de démarrage rapide, configurez votre environnement.
Activer l'API
Avant d'utiliser les API Google, vous devez les activer dans un projet Google Cloud. Vous pouvez activer une ou plusieurs API dans un même projet Google Cloud.Dans la console Google Cloud, activez l'API Google Agenda.
Configurer l'écran de consentement OAuth
Si vous utilisez un nouveau projet Google Cloud pour suivre ce guide de démarrage rapide, configurez l'écran de consentement OAuth et ajoutez-vous en tant qu'utilisateur test. Si vous avez déjà avez réalisé cette étape pour votre projet Cloud, passez à la section suivante.
- Dans la console Google Cloud, accédez au menu > API et Services > Écran de consentement OAuth. .
- Pour Type d'utilisateur, sélectionnez Interne, puis cliquez sur Créer.
- Remplissez le formulaire d'inscription de l'application, puis cliquez sur Enregistrer et continuer.
Pour l'instant, vous pouvez ignorer l'ajout de champs d'application et cliquer sur Enregistrer et continuer. Par la suite, lorsque vous créerez une application à utiliser en dehors de votre d'une organisation Google Workspace, vous devez remplacer le Type d'utilisateur par Externe, puis : ajouter les niveaux d'autorisation requis par votre application.
- Consultez le récapitulatif d'enregistrement de votre application. Pour apporter des modifications, cliquez sur Modifier. Si l'application l'inscription vous semble correcte, cliquez sur Retour au tableau de bord.
Autoriser les identifiants pour une application Web
Pour authentifier les utilisateurs finaux et accéder aux données utilisateur dans votre application, vous devez créer un ou plusieurs ID client OAuth 2.0. Un ID client sert à identifier une application unique auprès des serveurs OAuth de Google. Si votre application s'exécute sur plusieurs plates-formes, vous devez créer un ID client distinct pour chaque plate-forme.- Dans la console Google Cloud, accédez à Menu > API et Services > Identifiants.
- Cliquez sur Créer des identifiants > ID client OAuth.
- Cliquez sur Type d'application > Application Web.
- Dans le champ Nom, saisissez un nom pour l'identifiant. Ce nom ne s'affiche que dans la console Google Cloud.
- Ajoutez les URI autorisés associés à votre application:
<ph type="x-smartling-placeholder">
- </ph>
- Applications côté client (JavaScript) : sous Origines JavaScript autorisées, cliquez sur Ajouter un URI. Saisissez ensuite un URI à utiliser pour les requêtes des navigateurs. Ce champ identifie les domaines à partir desquels votre application peut envoyer des requêtes API au serveur OAuth 2.0.
- Applications côté serveur (Java, Python, etc.) : sous URI de redirection autorisés, cliquez sur Ajouter un URI. Saisissez ensuite un URI de point de terminaison auquel le serveur OAuth 2.0 peut envoyer des réponses.
- Cliquez sur Créer. L'écran "Client OAuth créé" s'affiche. Il contient l'ID et le code secret du client.
Notez l'ID client. Les codes secrets du client ne sont pas utilisés pour les applications Web.
- Cliquez sur OK. Les nouveaux identifiants s'affichent sous ID clients OAuth 2.0.
Notez ces identifiants, car vous en aurez besoin dans la suite de ce guide de démarrage rapide.
Créer une clé API
- Dans la console Google Cloud, accédez au menu > API et Services > Identifiants. .
- Cliquez sur Créer des identifiants > Clé API :
- Votre nouvelle clé API s'affiche.
- Cliquez sur Copier . pour copier votre clé API et l'utiliser dans le code de votre application. La clé API peut aussi être qui se trouvent dans la section "Clés API" des identifiants de votre projet.
- Cliquez sur Restreindre la clé pour mettre à jour les paramètres avancés et limiter l'utilisation. de votre clé API. Pour en savoir plus, consultez Appliquer des restrictions de clés API.
Configurer l'exemple
- Dans votre répertoire de travail, créez un fichier nommé
index.html
. Dans le fichier
index.html
, collez l'exemple de code suivant:Remplacez les éléments suivants :
YOUR_CLIENT_ID
: ID client que vous avez créé lorsque vous identifiants autorisés pour une application Web.YOUR_API_KEY
: clé API que vous avez créée en tant que est un prérequis.
Exécuter l'exemple
Dans votre répertoire de travail, installez le package http-server:
npm install http-server
Dans votre répertoire de travail, démarrez un serveur Web:
npx http-server -p 8000
- Dans votre navigateur, accédez à
http://localhost:8000
. -
Un message vous invite à autoriser l'accès:
<ph type="x-smartling-placeholder">
- </ph>
- Si vous n'êtes pas encore connecté à votre compte Google, connectez-vous lorsque vous y êtes invité. Si vous êtes connecté à plusieurs comptes, sélectionnez un compte à utiliser pour l'autorisation.
- Cliquez sur Accepter.
Votre application JavaScript exécute et appelle l'API Google Calendar.
Étapes suivantes
- Créer des événements
- Résoudre les problèmes d'authentification et d'autorisation
- Documentation de référence de l'API Calendar
- Section
google-api-javascript-client
de GitHub