Recurso: permissão
Uma permissão para um arquivo. Uma permissão concede a um usuário, grupo, domínio ou ao mundo acesso a um arquivo ou a uma hierarquia de pastas.
Alguns métodos de recurso, como permissions.update
, exigem um permissionId
. Use o método permissions.list
para recuperar o ID de um arquivo, uma pasta ou um drive compartilhado.
Representação 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 } |
Campos | |
---|---|
id |
O ID do usuário a que essa permissão se refere e idêntico ao |
name |
Apenas saída. O nome da permissão. |
type |
O tipo de conta. Os valores permitidos são:
|
role |
A função principal desse usuário. Embora novos valores possam ser compatíveis no futuro, os seguintes valores são permitidos atualmente:
|
additionalRoles[] |
São papéis adicionais para este usuário. No momento, apenas |
authKey |
Apenas saída. Obsoleto. |
value |
O endereço de e-mail ou nome de domínio da entidade. Ele é usado durante as inserções e não é preenchido nas respostas. Ao fazer uma solicitação |
kind |
Apenas saída. É sempre |
withLink |
Se o link é obrigatório para essa permissão. |
photoLink |
Apenas saída. Um link para a foto do perfil, se disponível. |
selfLink |
Apenas saída. Um link para a permissão. |
emailAddress |
Apenas saída. O endereço de e-mail do usuário ou grupo a que essa permissão se refere. Este é um campo somente de saída que está presente quando o tipo de permissão é |
domain |
Apenas saída. O nome de domínio da entidade a que essa permissão se refere. Este é um campo somente de saída que está presente quando o tipo de permissão é |
etag |
Apenas saída. A ETag da permissão. |
permissionDetails[] |
Apenas saída. Detalhes se as permissões neste item do drive compartilhado são herdadas ou diretamente neste item. Este é um campo somente para saída presente apenas nos itens dos drives compartilhados. |
permissionDetails[].permissionType |
Apenas saída. O tipo de permissão deste usuário. Embora novos valores possam ser adicionados no futuro, os seguintes são possíveis no momento:
|
permissionDetails[].role |
Apenas saída. A função principal desse usuário. No momento, é possível adicionar novos valores:
|
permissionDetails[].additionalRoles[] |
Apenas saída. São papéis adicionais para este usuário. No momento, apenas |
permissionDetails[].inheritedFrom |
Apenas saída. O ID do item do qual essa permissão é herdada. Este é um campo somente para saída. |
permissionDetails[].inherited |
Apenas saída. Indica se essa permissão é herdada. Esse campo é sempre preenchido. Este é um campo somente para saída. |
expirationDate |
A hora em que esta permissão expira (data-hora RFC 3339). As datas de validade têm as seguintes restrições:
|
teamDrivePermissionDetails[] |
Apenas saída. Obsoleto: use |
teamDrivePermissionDetails[] |
Apenas saída. Obsoleto: use |
teamDrivePermissionDetails[] |
Apenas saída. Obsoleto: use |
teamDrivePermissionDetails[] |
Apenas saída. Obsoleto: use |
teamDrivePermissionDetails[] |
Apenas saída. Obsoleto: use |
teamDrivePermissionDetails[] |
Apenas saída. Obsoleto: use |
deleted |
Apenas saída. Indica se a conta associada a essa permissão foi excluída. Este campo só diz respeito às permissões do usuário e do grupo. |
view |
Indica a visualização para essa permissão. Preenchido apenas para permissões que pertencem a uma vista. |
pendingOwner |
Indica se a conta associada a essa permissão é um proprietário pendente. Preenchido apenas com permissões do tipo |
Métodos |
|
---|---|
|
Exclui uma permissão de um arquivo ou drive compartilhado. |
|
Recebe uma permissão por ID. |
|
Retorna o ID de permissão para um endereço de e-mail. |
|
Insere uma permissão para um arquivo ou drive compartilhado. |
|
Lista as permissões de um arquivo ou drive compartilhado. |
|
Atualiza uma permissão usando semântica de patch. |
|
Atualiza uma permissão. |