Recurso: permissão
Permissão para um arquivo. A permissão concede a um usuário, grupo, domínio ou ao mundo o 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 do usuário. Novos valores podem ser suportados no futuro, mas os seguintes são permitidos no momento:
|
additionalRoles[] |
Funções adicionais para esse usuário. No momento, somente |
authKey |
Apenas saída. Obsoleto. |
value |
Endereço de e-mail ou nome de domínio da entidade. É usado durante inserções e não é preenchido nas respostas. Ao fazer uma solicitação |
kind |
Apenas saída. É sempre |
withLink |
Indica se o link é necessá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 retornar a esta permissão. |
emailAddress |
Apenas saída. O endereço de e-mail do usuário ou grupo a que esta permissão se refere. Este é um campo somente para saída que está presente quando o tipo de permissão é |
domain |
Apenas saída. O nome de domínio da entidade a que esta permissão se refere. Este é um campo somente para 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 sobre se as permissões neste item do drive compartilhado são herdadas ou diretamente neste item. Este é um campo somente para saída que aparece apenas para os itens dos drives compartilhados. |
permissionDetails[].permissionType |
Apenas saída. O tipo de permissão do usuário. Novos valores podem ser adicionados no futuro, mas no momento é possível:
|
permissionDetails[].role |
Apenas saída. A função principal do usuário. Novos valores podem ser adicionados no futuro, mas no momento é possível fazer o seguinte:
|
permissionDetails[].additionalRoles[] |
Apenas saída. Funções adicionais para esse usuário. No momento, só é possível usar |
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 |
O horário em que essa permissão vai expirar (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. Se a conta associada a essa permissão foi excluída. Esse campo só diz respeito a permissões de usuários e grupos. |
view |
Indica a visualização dessa 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 para 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 de 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. |