Renvoyer les informations sur l'utilisateur

Google Drive propose deux options pour recueillir des informations sur les utilisateurs de Drive:

  • À l'aide de la ressource about, vous pouvez récupérer des informations sur l'utilisateur, ses paramètres Drive et ses fonctionnalités système.

  • À l'aide de la ressource apps, vous pouvez récupérer la liste des applications installées par l'utilisateur, avec des informations sur les types MIME, les extensions de fichier et d'autres détails compatibles avec chaque application.

Ce guide explique comment récupérer des informations utilisateur dans Drive.

Obtenir des informations sur un utilisateur

Pour renvoyer des informations sur un utilisateur Drive en tant qu'instance de about, utilisez la méthode get(). Les valeurs renvoyées sont mesurées en octets.

La méthode get() nécessite le paramètre fields pour lister les champs à renvoyer dans la réponse. Si vous omettez le paramètre, la méthode renvoie une erreur. Pour renvoyer les champs exacts dont vous avez besoin, consultez Renvoyer des champs spécifiques.

Afficher un exemple

L'exemple de code suivant montre comment fournir plusieurs fields en tant que paramètre de requête dans la requête. La réponse renvoie les valeurs des champs pour la requête.

Requête

GET https://www.googleapis.com/drive/v3/about/?fields=kind,user,storageQuota

Response (Réponse)

{
  "kind": "drive#about",
  "user": {
    "kind": "drive#user",
    "displayName": "DISPLAY_NAME",
    "photoLink": "PHOTO_LINK",
    "me": true,
    "permissionId": "PERMISSION_ID",
    "emailAddress": "EMAIL_ADDRESS"
  },
  "storageQuota": {
    "usage": "10845031958",
    "usageInDrive": "2222008387",
    "usageInDriveTrash": "91566"
  }
}

La réponse inclut les valeurs suivantes:

  • DISPLAY_NAME: nom de l'utilisateur en texte brut.
  • PHOTO_LINK: URL de la photo de profil de l'utilisateur.
  • PERMISSION_ID: ID de l'utilisateur dans les ressources Permission.
  • EMAIL_ADDRESS: adresse e-mail de l'utilisateur

Répertorier les applications utilisateur

Les applications Google Drive sont listées sur Google Workspace Marketplace et servent à rendre Drive plus pratique, comme l'application Google Docs ou un module complémentaire utilisé dans Docs pour signer des documents. Pour en savoir plus, consultez Utiliser les applications Google Drive.

Pour renvoyer la liste de toutes les applications installées par l'utilisateur en tant qu'instance de apps, utilisez la méthode list() sans paramètre.

Vous pouvez définir le paramètre fields pour lister les champs à renvoyer dans la réponse. Pour renvoyer les champs exacts dont vous avez besoin, consultez Renvoyer des champs spécifiques.

Afficher un exemple

L'exemple de code suivant montre comment renvoyer la liste de toutes les applications installées par l'utilisateur dans la requête. La réponse renvoie les valeurs des champs pour la requête.

Requête

GET https://www.googleapis.com/drive/v3/apps

Response (Réponse)

{
  "kind": "drive#appList",
  "selfLink": "https://www.googleapis.com/drive/v3/apps",
  "items": [
    {
      "kind": "drive#app",
      "id": "ID",
      "name": "Google Sheets",
      "supportsCreate": true,
      "supportsImport": true,
      "supportsMultiOpen": false,
      "supportsOfflineCreate": true,
      "productUrl": "https://chrome.google.com/webstore/detail/felcaaldnbdncclmgdcncolpebgiejap",
      "productId": "PRODUCT_ID"
    }
  ],
  "defaultAppIds": [
    "ID"
  ]
}

La réponse inclut les valeurs suivantes:

  • ID: ID de l'application.
  • PRODUCT_ID: ID de la fiche produit de cette application.

Lister les applications de l'utilisateur avec des paramètres de requête

Pour trouver une application spécifique, utilisez un ou plusieurs des paramètres de requête facultatifs suivants:

  • appFilterExtensions: filtre les résultats de recherche à l'aide d'une liste d'extensions de fichiers séparées par une virgule. Les applications du champ d'application de la requête qui peuvent ouvrir les extensions de fichier listées sont incluses dans la réponse. Si appFilterMimeTypes est également fourni, une union des deux listes d'applications générées est renvoyée. docx pour Microsoft Word et pptx pour Microsoft PowerPoint sont des exemples d'extensions. Pour obtenir d'autres exemples d'extensions de fichier, consultez Exporter des types MIME pour les documents Google Workspace.

    L'exemple de code suivant montre comment fournir plusieurs extensions de fichier en tant que paramètre de requête: GET https://www.googleapis.com/drive/v3/apps?appFilterExtensions=docx,pptx.

  • appFilterMimeTypes: filtrez les résultats de recherche à l'aide d'une liste de types MIME séparés par une virgule. Les applications du champ d'application de la requête qui peuvent ouvrir les types MIME listés sont incluses dans la réponse. Si appFilterExtensions est également fourni, une union des deux listes d'applications résultantes est renvoyée. application/vnd.google-apps.form pour Google Forms et application/vnd.google-apps.site pour Google Sites sont des exemples de types MIME. Pour en savoir plus sur les types MIME, consultez Types MIME compatibles avec Google Workspace et Google Drive.

    L'exemple de code suivant montre comment fournir plusieurs types MIME en tant que paramètre de requête: GET https://www.googleapis.com/drive/v3/apps?appFilterMimeTypes=application/vnd.google-apps.form,application/vnd.google-apps.site.

  • languageCode: filtre les résultats de recherche à l'aide d'un code de langue ou de paramètres régionaux, comme défini par BCP 47, avec certaines extensions du format LDML d'Unicode. Exemples de codes de langue : en-us pour l'anglais (États-Unis) et fr-ca pour le français (Canada).

    L'exemple de code suivant montre comment fournir plusieurs codes de langue en tant que paramètre de requête: GET https://www.googleapis.com/drive/v3/apps?languageCode=en-us,fr-ca.

Obtenir l'application de l'utilisateur par ID

Pour télécharger les informations détaillées sur l'application en tant qu'instance de apps, utilisez la méthode get() avec l'ID de l'application.

Afficher un exemple

L'exemple de code suivant montre comment fournir un appId en tant que paramètre de requête dans la requête. La réponse renvoie les valeurs des champs pour la requête.

Requête

GET https://www.googleapis.com/drive/v3/apps/APP_ID

Response (Réponse)

{
  "kind": "drive#app",
  "id": "ID",
  "name": "Google Sheets",
  "supportsCreate": true,
  "supportsImport": true,
  "supportsMultiOpen": false,
  "supportsOfflineCreate": true,
  "productUrl": "https://chrome.google.com/webstore/detail/felcaaldnbdncclmgdcncolpebgiejap",
  "productId": "PRODUCT_ID"
}

La réponse inclut les valeurs suivantes:

  • ID: ID de l'application.
  • PRODUCT_ID: ID de la fiche produit de cette application.

Voici quelques étapes que vous pouvez suivre: