Configurer l'intégration de l'interface utilisateur Drive

Pour afficher votre application dans Google Drive lorsqu'un utilisateur crée ou ouvre un fichier, vous devez d'abord configurer une intégration de l'interface utilisateur (UI). La configuration est également requise pour référencer votre application dans Google Workspace Marketplace.

Activer l'API Drive

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.

Pour commencer l'intégration à l'interface utilisateur Google Drive, vous devez activer l'API Drive. Vous aurez ainsi accès à l'API et aux fonctionnalités d'intégration de l'UI.

  • Dans la console Google Cloud, activez l'API Google Drive.

    Activer l'API

Configurer l'intégration de l'UI Drive

  1. Dans la console Google APIs, accédez à Menu > API et services > API et services activés.

    Accéder aux API et services activés

  2. Au bas du tableau de bord "API et services", cliquez sur API Google Drive. La page de configuration de l'API Google Drive s'affiche.
  3. Sélectionnez l'onglet Intégration de l'UI Drive.
  4. (Facultatif) Saisissez un nom dans le champ Application name (Nom de l'application). Le nom de l'application est visible par les utilisateurs dans l'onglet "Gérer les applications" des paramètres de Drive.
  5. (Facultatif) Saisissez une brève description d'une ligne dans le champ Description courte. La brève description est affichée pour les utilisateurs dans l'onglet "Gérer les applications" des paramètres Drive.
  6. (Facultatif) Saisissez une description complète dans le champ Description longue.
  7. Importez une ou plusieurs icônes d'application à afficher dans la liste des applications Drive connectées d'un utilisateur et dans le menu contextuel "Ouvrir avec". Les icônes doivent être au format PNG avec un arrière-plan transparent. L'affichage des icônes dans Drive peut prendre jusqu'à 24 heures.

  8. Pour utiliser l'élément de menu "Ouvrir avec" de l'UI Drive, saisissez l'URL de votre application dans le champ Ouvrir l'URL. Cette URL est utilisée par le menu contextuel "Ouvrir avec".

    • Cette URL doit contenir un nom de domaine complet. localhost ne fonctionne pas.
    • Cette URL doit être accessible aux utilisateurs prévus de votre application. Si vous disposez de plusieurs versions d'application, par exemple une version publique et une autre réservée à certains utilisateurs, chaque version doit utiliser une URL unique. Vous pouvez ensuite créer différentes configurations d'application pour chaque version.
    • Pour pouvoir référencer votre application sur Google Workspace Marketplace, vous devez valider la propriété de cette URL.
    • Par défaut, un paramètre de requête state est ajouté à cette URL pour transmettre les données de l'UI Drive à votre application. Pour en savoir plus sur le contenu du paramètre state, consultez la section Paramètre state.
  9. (Facultatif) Saisissez les types MIME et les extensions de fichier par défaut dans les champs Types MIME par défaut et Extensions de fichier par défaut. Les types MIME et les extensions de fichier par défaut représentent les fichiers à ouvrir de manière unique pour votre application. Par exemple, votre application peut ouvrir un format intégré pour la superposition et la modification d'images. N'incluez que des types de médias standards et assurez-vous qu'ils ne comportent pas de fautes de frappe ni de fautes d'orthographe. Si votre application n'ouvre que des fichiers de raccourci ou de raccourci tiers, vous pouvez laisser le type MIME vide.

  10. (Facultatif) Saisissez les types MIME secondaires et les extensions de fichier dans les champs Types MIME secondaires et Extensions de fichiers secondaires. Les types MIME secondaires et les extensions de fichier représentent des fichiers que votre application peut ouvrir, mais qui ne sont pas spécifiques à votre application. Par exemple, votre application peut être une application de retouche d'image qui ouvre des images au format PNG et JPG. N'incluez que des types de médias standards et assurez-vous qu'ils ne comportent pas de fautes de frappe ni de fautes d'orthographe. Si votre application n'ouvre que des fichiers de raccourci ou de raccourci tiers, vous pouvez laisser le type MIME vide.

  11. Pour utiliser le bouton "Nouveau " de l'interface utilisateur Drive et demander aux utilisateurs de créer un fichier avec votre application, cochez la case Créer des fichiers. Les champs Nouvelle URL et Nom du document facultatifs s'affichent.

    • Cette URL doit contenir un nom de domaine complet. localhost ne fonctionne pas.
    • Pour pouvoir référencer votre application sur Google Workspace Marketplace, vous devez valider la propriété de cette URL.
    • Par défaut, un paramètre de requête state est ajouté à cette URL pour transmettre les données de l'UI Drive à votre application. Pour en savoir plus sur le contenu du paramètre state, consultez la section Paramètre state.
  12. Saisissez une URL dans le champ Nouvelle URL. Cette URL est utilisée par le bouton "Nouveau" pour rediriger l'utilisateur vers votre application.

  13. (Facultatif) Si vous souhaitez que votre application ouvre les fichiers compatibles avec Google Workspace, cochez la case Importation.

  14. (Facultatif) Si votre application doit gérer les fichiers des Drive partagés, cochez la case Compatibilité des Drive partagés. Pour en savoir plus sur la compatibilité des Drive partagés dans votre application, consultez Intégrer la compatibilité avec les Drive partagés.

  15. Cliquez sur Envoyer.

Demander le niveau d'accès drive.install

Pour autoriser l'affichage d'applications en tant qu'options dans le menu "Ouvrir avec" ou "Nouveau", demandez l'intégration du champ d'application https://www.googleapis.com/auth/drive.install à l'UI Drive. Lorsqu'ils demandent ce champ d'application, les utilisateurs reçoivent une boîte de dialogue semblable à celle-ci:

Boîte de dialogue d'installation de l'interface utilisateur Google Drive
Figure 1 : Boîte de dialogue d'installation lorsque vous utilisez des champs d'application pour l'UI Drive.

Pour en savoir plus sur les champs d'application que vous pouvez demander pour les applications Drive et sur la manière de les demander, consultez la section Informations sur l'autorisation et l'authentification spécifiques aux API.

Paramètre state

Par défaut, un paramètre state est ajouté à l'URL d'ouverture et à la nouvelle URL pour transmettre les données de l'UI Drive à votre application. Ce paramètre contient une chaîne encodée au format JSON avec des variables de modèle et des données concernant la requête adressée à votre application. Les variables incluses dépendent du type d'URL utilisé (URL ouverte ou Nouvelle URL):

Variable de modèle Description URL de l'application
{ids} Liste des ID de fichiers en cours d'ouverture, séparés par une virgule. URL d'ouverture
{exportIds} Liste des ID de fichiers en cours d'exportation, séparés par une virgule (utilisée uniquement lors de l'ouverture des documents Google intégrés). URL d'ouverture
{resourceKeys} Dictionnaire JSON d'ID de fichier mappés avec leurs clés de ressource respectives. URL d'ouverture
{folderId} ID du dossier parent. Nouvelle URL
{folderResourceKey} Clé d'accès à la ressource du dossier parent. Nouvelle URL
{userId} ID de profil permettant d'identifier l'utilisateur. URL à ouvrir et nouvelle URL
{action} Action en cours d'exécution. La valeur est open si vous utilisez une URL d'ouverture ou create avec une nouvelle URL. URL à ouvrir et nouvelle URL

Le paramètre state est encodé en URL. Votre application doit donc gérer les caractères d'échappement et l'analyser au format JSON. Les applications peuvent détecter la valeur create dans le paramètre state pour vérifier une requête de création de fichier.

Exemple d'informations d'état au format JSON pour une nouvelle URL

Voici les informations state d'une nouvelle URL:

{
  "action":"create",
  "folderId":"FOLDER_ID",
  "folderResourceKey":"FOLDER_RESOURCE_KEY",
  "userId":"USER_ID"
}

Exemple d'informations d'état au format JSON pour une URL ouverte

Les informations state d'une URL ouverte sont les suivantes:

{
  "ids": ["ID"],
  "resourceKeys":{"RESOURCE_KEYS":"RESOURCE_KEYS"},
  "action":"open",
  "userId":"USER_ID"
}

Les ID et les clés de ressource permettent d'extraire les métadonnées des fichiers et de télécharger leur contenu. Une fois que votre application dispose de l'ID de fichier et d'un jeton d'accès, elle peut vérifier les autorisations, récupérer les métadonnées du fichier et télécharger le contenu du fichier comme décrit dans la méthode files.get.

Une application installée doit pouvoir créer, gérer et ouvrir les actions lancées à partir de l'interface utilisateur de Drive. Pour en savoir plus, consultez Intégrer le bouton "Nouveau " de l'UI Drive ou Intégrer le menu contextuel "Ouvrir avec " de l'UI Drive.