REST Resource: permissions

{
  "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
}

string

Uniquement en sortie. ID de cette autorisation. Il s'agit d'un identifiant unique pour le bénéficiaire. Il est publié dans les ressources utilisateur en tant que permissionId. Les identifiants doivent être traités comme des valeurs opaques.

string

Uniquement en sortie. Le mot "joli" nom de la valeur de l'autorisation. Voici une liste d'exemples pour chaque type d'autorisation:

• user : nom complet de l'utilisateur, tel qu'il est défini dans son compte Google (par exemple, "Jean Dupont").
• group : nom du groupe Google, par exemple "Administrateurs de l'entreprise".
• domain : nom de domaine de type chaîne, tel que "l'entreprise.com".
• anyone : aucun élément displayName n'est présent.

string

Type de bénéficiaire. Les valeurs valides sont les suivantes :

• user
• group
• domain
• anyone

Lorsque vous créez une autorisation, si type est défini sur user ou group, vous devez fournir un emailAddress pour l'utilisateur ou le groupe. Lorsque type est défini sur domain, vous devez fournir un domain. Aucune information supplémentaire n'est requise pour un type anyone.

string

Uniquement en sortie. Identifie le type de ressource. Valeur: chaîne fixe "drive#permission".

object

Uniquement en sortie. Indique si les autorisations sur cet élément du Drive partagé sont héritées ou directement sur cet élément. Il s'agit d'un champ en sortie uniquement qui n'est présent que pour les éléments de Drive partagés.

string

Uniquement en sortie. Type d'autorisation pour cet utilisateur. Même si de nouvelles valeurs pourront être ajoutées ultérieurement, voici ce qui est possible actuellement:

• file
• member

string

Uniquement en sortie. Identifiant de l'élément dont cette autorisation est héritée. Il s'agit d'un champ en sortie uniquement.

string

Uniquement en sortie. Rôle principal de cet utilisateur. Bien que de nouvelles valeurs puissent être ajoutées à l'avenir, voici ce qui est possible actuellement:

• organizer
• fileOrganizer
• writer
• commenter
• reader

boolean

Uniquement en sortie. Indique si cette autorisation est héritée. Ce champ est toujours renseigné. Il s'agit d'un champ en sortie uniquement.

string

Uniquement en sortie. Un lien vers la photo de profil de l'utilisateur, si disponible.

string

Adresse e-mail de l'utilisateur ou du groupe auquel cette autorisation fait référence.

string

Rôle accordé par cette autorisation. Bien que de nouvelles valeurs soient acceptées à l'avenir, les valeurs suivantes sont actuellement autorisées:

• owner
• organizer
• fileOrganizer
• writer
• commenter
• reader

boolean

Indique si l'autorisation permet d'explorer le fichier par le biais d'une recherche. Cela ne s'applique qu'aux autorisations de type domain ou anyone.

string

Domaine auquel cette autorisation fait référence.

string

Date et heure d'expiration de l'autorisation (date et heure RFC 3339). Les délais d'expiration sont soumis aux restrictions suivantes:

• Elles ne peuvent être définies que sur des autorisations d'utilisateur et de groupe.
• L'heure doit être située dans le futur.
• La date ne peut pas être postérieure d'un an à plus tard.

object

Uniquement en sortie. Obsolète: sortie uniquement. Utilisez permissionDetails à la place.

string

Obsolète: sortie uniquement. Utilisez permissionDetails/permissionType à la place.

string

Obsolète: sortie uniquement. Utilisez permissionDetails/inheritedFrom à la place.

string

Obsolète: sortie uniquement. Utilisez permissionDetails/role à la place.

boolean

Obsolète: sortie uniquement. Utilisez permissionDetails/inherited à la place.

boolean

Uniquement en sortie. Indique si le compte associé à cette autorisation a été supprimé. Ce champ ne concerne que les autorisations des utilisateurs et des groupes.

string

Indique la vue pour cette autorisation. Renseigné uniquement pour les autorisations appartenant à une vue. 'publiée' est la seule valeur acceptée.

boolean

Indique si le compte associé à cette autorisation est en attente de propriété. Renseigné uniquement pour les autorisations de type user pour les fichiers qui ne se trouvent pas dans un Drive partagé.