Ressource: Permission
Autorisation pour un fichier. Une autorisation accorde à un utilisateur, à un groupe, à un domaine ou au monde entier l'accès à un fichier ou à une arborescence de dossiers.
Certaines méthodes de ressources (telles que permissions.update
) nécessitent un permissionId
. Utilisez la méthode permissions.list
pour récupérer l'ID d'un fichier, d'un dossier ou d'un Drive partagé.
Représentation JSON |
---|
{ "id": string, "displayName": string, "type": string, "kind": string, "permissionDetails": [ { "permissionType": string, "inheritedFrom": string, "role": string, "inherited": boolean } ], "photoLink": string, "emailAddress": string, "role": string, "allowFileDiscovery": boolean, "domain": string, "expirationTime": string, "teamDrivePermissionDetails": [ { "teamDrivePermissionType": string, "inheritedFrom": string, "role": string, "inherited": boolean } ], "deleted": boolean, "view": string, "pendingOwner": boolean } |
Champs | |
---|---|
id |
Uniquement en sortie. ID de cette autorisation. Cet identifiant unique est attribué au bénéficiaire. Il est publié dans les ressources utilisateur sous le nom |
displayName |
Uniquement en sortie. Nom "pretty" de la valeur de l'autorisation. Voici une liste d'exemples pour chaque type d'autorisation:
|
type |
Type du bénéficiaire. Les valeurs possibles sont les suivantes :
Lorsque vous créez une autorisation, si |
kind |
Uniquement en sortie. Identifie le type de ressource. Valeur: chaîne fixe |
permissionDetails[] |
Uniquement en sortie. Indique si les autorisations associées à cet élément de Drive partagé sont héritées ou directement sur cet élément. Ce champ n'est accessible qu'en sortie et ne s'affiche que pour les éléments de Drive partagés. |
permissionDetails[].permissionType |
Uniquement en sortie. Type d'autorisation attribué à cet utilisateur. Bien que de nouvelles valeurs puissent être ajoutées ultérieurement, les opérations suivantes sont actuellement possibles:
|
permissionDetails[].inheritedFrom |
Uniquement en sortie. ID de l'élément dont cette autorisation est héritée. Ce champ est en sortie uniquement. |
permissionDetails[].role |
Uniquement en sortie. Rôle principal de cet utilisateur. Bien que de nouvelles valeurs puissent être ajoutées ultérieurement, les opérations suivantes sont actuellement possibles:
|
permissionDetails[].inherited |
Uniquement en sortie. Indique si cette autorisation est héritée. Ce champ est toujours renseigné. Ce champ est en sortie uniquement. |
photoLink |
Uniquement en sortie. Lien vers la photo de profil de l'utilisateur, le cas échéant. |
emailAddress |
Adresse e-mail de l'utilisateur ou du groupe auquel cette autorisation fait référence. |
role |
Rôle accordé par cette autorisation. Même si de nouvelles valeurs seront peut-être acceptées à l'avenir, les éléments suivants sont actuellement autorisés:
|
allowFileDiscovery |
Indique si l'autorisation permet de découvrir le fichier par le biais d'une recherche. Cela ne s'applique qu'aux autorisations de type |
domain |
Domaine auquel cette autorisation fait référence. |
expirationTime |
Heure d'expiration de cette autorisation (date et heure RFC 3339). Les délais d'expiration sont soumis aux restrictions suivantes:
|
teamDrivePermissionDetails[] |
Uniquement en sortie. Obsolète: sortie uniquement. Utilisez |
teamDrivePermissionDetails[] |
Obsolète: sortie uniquement. Utilisez |
teamDrivePermissionDetails[] |
Obsolète: sortie uniquement. Utilisez |
teamDrivePermissionDetails[] |
Obsolète: sortie uniquement. Utilisez |
teamDrivePermissionDetails[] |
Obsolète: sortie uniquement. Utilisez |
deleted |
Uniquement en sortie. Indique si le compte associé à cette autorisation a été supprimé. Ce champ ne concerne que les autorisations d'utilisateur et de groupe. |
view |
Indique la vue pour cette autorisation. Renseigné uniquement pour les autorisations appartenant à une vue. 'publié' est la seule valeur acceptée. |
pendingOwner |
Indique si le compte associé à cette autorisation est un propriétaire en attente. Renseigné uniquement pour les autorisations de type |
Méthodes |
|
---|---|
|
Crée une autorisation pour un fichier ou un Drive partagé. |
|
Supprime une autorisation. |
|
Récupère une autorisation par ID. |
|
Liste les autorisations d'un fichier ou d'un Drive partagé. |
|
Met à jour une autorisation avec la sémantique "patch". |