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, "name": string, "type": string, "role": string, "additionalRoles": [ string ], "authKey": string, "value": string, "kind": string, "withLink": boolean, "photoLink": string, "selfLink": string, "emailAddress": string, "domain": string, "etag": string, "permissionDetails": [ { "permissionType": string, "role": string, "additionalRoles": [ string ], "inheritedFrom": string, "inherited": boolean } ], "expirationDate": string, "teamDrivePermissionDetails": [ { "teamDrivePermissionType": string, "role": string, "additionalRoles": [ string ], "inheritedFrom": string, "inherited": boolean } ], "deleted": boolean, "view": string, "pendingOwner": boolean } |
Champs | |
---|---|
id |
ID de l'utilisateur auquel cette autorisation fait référence et identique à |
name |
Uniquement en sortie. Nom de cette autorisation. |
type |
Type de compte. Les valeurs autorisées sont les suivantes :
|
role |
Rôle principal de cet utilisateur. Même si de nouvelles valeurs seront peut-être acceptées à l'avenir, les éléments suivants sont actuellement autorisés:
|
additionalRoles[] |
Rôles supplémentaires pour cet utilisateur. Seule la valeur |
authKey |
Uniquement en sortie. Obsolète. |
value |
Adresse e-mail ou nom de domaine de l'entité. Il est utilisé lors des insertions et n'est pas renseigné dans les réponses. Lorsque vous effectuez une requête |
kind |
Uniquement en sortie. Il s'agit toujours de |
withLink |
Indique si le lien est requis pour cette autorisation. |
photoLink |
Uniquement en sortie. Lien vers la photo du profil, si disponible. |
selfLink |
Uniquement en sortie. Un lien vers cette autorisation. |
emailAddress |
Uniquement en sortie. Adresse e-mail de l'utilisateur ou du groupe auquel cette autorisation fait référence. Il s'agit d'un champ en sortie uniquement qui est présent lorsque le type d'autorisation est |
domain |
Uniquement en sortie. Nom de domaine de l'entité à laquelle cette autorisation fait référence. Ce champ n'est disponible qu'en sortie et présent lorsque le type d'autorisation est |
etag |
Uniquement en sortie. ETag de l'autorisation. |
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[].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[].additionalRoles[] |
Uniquement en sortie. Rôles supplémentaires pour cet utilisateur. Seule la valeur |
permissionDetails[].inheritedFrom |
Uniquement en sortie. ID de l'élément dont cette autorisation est héritée. Ce champ est en sortie uniquement. |
permissionDetails[].inherited |
Uniquement en sortie. Indique si cette autorisation est héritée. Ce champ est toujours renseigné. Ce champ est en sortie uniquement. |
expirationDate |
Heure d'expiration de cette autorisation (date et heure RFC 3339). Les dates d'expiration sont soumises aux restrictions suivantes:
|
teamDrivePermissionDetails[] |
Uniquement en sortie. Obsolète: utilisez plutôt |
teamDrivePermissionDetails[] |
Uniquement en sortie. Obsolète: utilisez plutôt |
teamDrivePermissionDetails[] |
Uniquement en sortie. Obsolète: utilisez plutôt |
teamDrivePermissionDetails[] |
Uniquement en sortie. Obsolète: utilisez plutôt |
teamDrivePermissionDetails[] |
Uniquement en sortie. Obsolète: utilisez plutôt |
teamDrivePermissionDetails[] |
Uniquement en sortie. Obsolète: utilisez plutôt |
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. |
pendingOwner |
Indique si le compte associé à cette autorisation est un propriétaire en attente. Renseigné uniquement pour les autorisations de type |
Méthodes |
|
---|---|
|
Supprime une autorisation associée à un fichier ou à un Drive partagé. |
|
Récupère une autorisation par ID. |
|
Renvoie l'ID d'autorisation pour une adresse e-mail. |
|
Insère une autorisation pour un fichier ou un Drive partagé. |
|
Liste les autorisations d'un fichier ou d'un Drive partagé. |
|
Met à jour une autorisation à l'aide de la sémantique "patch". |
|
Met à jour une autorisation. |