- Requête HTTP
- Paramètres de chemin d'accès
- Paramètres de requête
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- Essayer
Liste les autorisations d'un fichier ou d'un Drive partagé.
Requête HTTP
GET https://www.googleapis.com/drive/v3/files/{fileId}/permissions
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres | |
---|---|
fileId |
ID du fichier ou du Drive partagé. |
Paramètres de requête
Paramètres | |
---|---|
pageSize |
Nombre maximal d'autorisations à renvoyer par page. Si cette règle n'est pas configurée pour les fichiers d'un Drive partagé, 100 résultats au maximum sont renvoyés. Si cette règle n'est pas configurée pour des fichiers qui ne se trouvent pas dans un Drive partagé, la liste complète est renvoyée. |
pageToken |
Jeton permettant de poursuivre une demande de liste précédente sur la page suivante. Elle doit être définie sur la valeur de "nextPageToken" de la réponse précédente. |
supportsAllDrives |
Indique si l'application à l'origine de la demande est compatible avec Mon Drive et les Drive partagés. |
supportsTeamDrives |
Obsolète: utilisez plutôt |
useDomainAdminAccess |
Envoyez la demande en tant qu'administrateur de domaine. Si cette règle est définie sur "True", le demandeur obtient l'accès si le paramètre d'ID de fichier fait référence à un Drive partagé et si le demandeur est un administrateur du domaine auquel appartient le Drive partagé. |
includePermissionsForView |
Spécifie les autorisations de vue supplémentaire à inclure dans la réponse. Seul l'état "Publié" est accepté. |
Corps de la requête
Le corps de la requête doit être vide.
Corps de la réponse
Liste des autorisations pour un fichier.
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,
"permissions": [
{
object ( |
Champs | |
---|---|
nextPageToken |
Jeton de page pour la page d'autorisations suivante. Ce champ sera absent si la fin de la liste des autorisations est atteinte. Si le jeton est refusé pour une raison quelconque, il doit être supprimé, et la pagination doit être relancé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 être différents. |
kind |
Identifie le type de ressource. Valeur: chaîne fixe |
permissions[] |
Liste des autorisations. 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.file
https://www.googleapis.com/auth/drive.metadata
https://www.googleapis.com/auth/drive.metadata.readonly
https://www.googleapis.com/auth/drive.photos.readonly
https://www.googleapis.com/auth/drive.readonly
Certains champs d'application sont limités et nécessitent une évaluation de sécurité pour que votre application puisse les utiliser. Pour en savoir plus, consultez le guide relatif aux autorisations.