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

Apenas saída. O ID dessa permissão. É um identificador exclusivo do beneficiário e é publicado nos recursos do usuário como permissionId. Os IDs precisam ser tratados como valores opacos.

string

Apenas saída. O nome "bonito" do valor da permissão. Confira a seguir uma lista de exemplos para cada tipo de permissão:

• user: nome completo do usuário, conforme definido para a Conta do Google, como "João Silva".
• group: nome do grupo do Google, como "Administradores da empresa".
• domain: nome de domínio de string, como "thecompany.com".
• anyone: nenhum displayName está presente.

string

O tipo de beneficiário. Os valores válidos são:

• user
• group
• domain
• anyone

Ao criar uma permissão, se type for user ou group, você precisará fornecer um emailAddress para o usuário ou grupo. Quando type for domain, você precisará fornecer um domain. Não são necessárias informações extras para um tipo anyone.

string

Apenas saída. Identifica o tipo de recurso. Valor: a string fixa "drive#permission".

object

Apenas saída. Detalhes sobre se as permissões no item do drive compartilhado são herdadas ou estão diretamente no item. Este é um campo somente saída que só aparece para itens de drive compartilhado.

string

Apenas saída. O tipo de permissão do usuário. Novos valores podem ser adicionados no futuro, mas atualmente é possível usar o seguinte:

• file
• member

string

Apenas saída. O ID do item de onde essa permissão é herdada. Este é um campo somente saída.

string

Apenas saída. A função principal do usuário. Novos valores podem ser adicionados no futuro, mas atualmente é possível fazer o seguinte:

• organizer
• fileOrganizer
• writer
• commenter
• reader

boolean

Apenas saída. Se essa permissão é herdada. Esse campo é sempre preenchido. Este é um campo somente saída.

string

Apenas saída. Um link para a foto do perfil do usuário, se disponível.

string

O endereço de e-mail do usuário ou grupo a que esta permissão se refere.

string

O papel concedido pela permissão. Embora novos valores possam ser aceitos no futuro, os seguintes são permitidos no momento:

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

boolean

Define se a permissão permite que o arquivo seja descoberto pela pesquisa. Isso é aplicável apenas para permissões do tipo domain ou anyone.

string

O domínio a que esta permissão se refere.

string

O horário de expiração da permissão (data e hora RFC 3339). Os tempos de expiração têm as seguintes restrições:

• Elas só podem ser definidas nas permissões de usuários e grupos.
• O horário precisa estar no futuro.
• O horário não pode ser mais de um ano no futuro.

object

Apenas saída. Descontinuado: somente saída. Use permissionDetails.

string

Descontinuado: somente saída. Use permissionDetails/permissionType.

string

Descontinuado: somente saída. Use permissionDetails/inheritedFrom.

string

Descontinuado: somente saída. Use permissionDetails/role.

boolean

Descontinuado: somente saída. Use permissionDetails/inherited.

boolean

Apenas saída. Se a conta associada a essa permissão foi excluída. Esse campo se aplica apenas às permissões de usuários e grupos.

string

Indica a visualização para essa permissão. Preenchido apenas para permissões que pertencem a uma visualização. "publicado" é o único valor aceito.

boolean

Se a conta associada a essa permissão é um proprietário pendente. Só é preenchido para permissões do tipo user para arquivos que não estão em um drive compartilhado.