Method: permissions.list

Lista as permissões de um arquivo ou drive compartilhado. Para mais informações, consulte Compartilhar arquivos, pastas e drives.

Solicitação HTTP

GET https://www.googleapis.com/drive/v3/files/{fileId}/permissions

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
fileId

string

O ID do arquivo ou drive compartilhado.

Parâmetros de consulta

Parâmetros
pageSize

integer

O número máximo de permissões a serem retornadas por página. Quando não definido para arquivos em um drive compartilhado, no máximo 100 resultados serão retornados. Quando não definido para arquivos que não estão em um drive compartilhado, toda a lista será retornada.
pageToken

string

O token para continuar uma solicitação de lista anterior na próxima página. Defina esse valor como nextPageToken da resposta anterior.
supportsAllDrives

boolean

Se o aplicativo solicitante é compatível com o Meu Drive e os drives compartilhados.
supportsTeamDrives
(deprecated)

boolean

Descontinuado: use supportsAllDrives.
useDomainAdminAccess

boolean

Faça a solicitação como administrador do domínio.

Se definido como true e se as seguintes condições adicionais forem atendidas, o solicitante terá acesso:

  1. O parâmetro "file ID" se refere a um drive compartilhado.
  2. O solicitante é administrador do domínio a que o drive compartilhado pertence.

Para mais informações, consulte Gerenciar drives compartilhados como administradores de domínio.
includePermissionsForView

string

Especifica quais permissões de visualização adicionais incluir na resposta. Somente published é aceito.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Uma lista de permissões para um arquivo.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "permissions": [
    {
      object (Permission)
    }
  ],
  "nextPageToken": string,
  "kind": string
}
Campos
permissions[]

object (Permission)

A lista de permissões. Se nextPageToken estiver preenchido, essa lista poderá estar incompleta, e uma página adicional de resultados precisará ser buscada.
nextPageToken

string

O token da próxima página de permissões. Esse campo não vai aparecer se o fim da lista de permissões for atingido. Se o token for rejeitado por qualquer motivo, ele deverá ser descartado, e a paginação precisará ser reiniciada na primeira página de resultados. O token de página geralmente é válido por várias horas. No entanto, se novos itens forem adicionados ou removidos, os resultados esperados poderão ser diferentes.
kind

string

Identifica o tipo de recurso. Valor: a string fixa "drive#permissionList".

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

Alguns escopos são restritos e exigem uma avaliação de segurança para que o app possa usá-los. Para mais informações, consulte o guia de autorização.