Method: drives.list

Liste les Drive partagés de l'utilisateur.

Cette méthode accepte le paramètre q, qui est une requête de recherche combinant un ou plusieurs termes de recherche. Pour en savoir plus, consultez le guide Rechercher des Drive partagés.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
pageSize

integer

Nombre maximal de Drive partagés à renvoyer par page.

pageToken

string

Jeton de page pour les Drive partagés.

q

string

Chaîne de requête pour rechercher des Drive partagés.

useDomainAdminAccess

boolean

Envoyez la requête en tant qu'administrateur de domaine. Si cette valeur est définie sur "true", tous les Drive partagés du domaine dans lequel l'utilisateur à l'origine de la requête est administrateur sont renvoyés. Si cette valeur est définie sur "false" (valeur par défaut), 1 000 éléments sont renvoyés au maximum, même s'il y en a plus.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Liste des Drive partagés.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON
{
  "nextPageToken": string,
  "kind": string,
  "drives": [
    {
      object (Drive)
    }
  ]
}
Champs
nextPageToken

string

Jeton de page pour la page suivante des Drive partagés. Cette valeur est absente si la fin de la liste a été atteinte. Si le jeton est refusé pour une raison quelconque, il doit être supprimé et la pagination doit être redémarrée à partir de la première page de résultats. Le jeton de page est généralement valide pendant plusieurs heures. Toutefois, si de nouveaux éléments sont ajoutés ou supprimés, les résultats attendus peuvent différer.

kind

string

Identifie le type de ressource. Valeur: chaîne fixe "drive#driveList".

drives[]

object (Drive)

Liste des Drive partagés. Si nextPageToken est renseigné, cette liste peut être incomplète et une page de résultats supplémentaire doit être extraite.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.readonly

Certains champs d'application sont restreints et nécessitent une évaluation de sécurité pour que votre application puisse les utiliser. Pour en savoir plus, consultez le guide d'autorisation.