Method: permissions.list

Lista as permissões de um arquivo ou drive compartilhado.

Solicitação HTTP

GET https://www.googleapis.com/drive/v2/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
maxResults

integer

O número máximo de permissões a serem retornadas por página. Quando essa opção não está definida para arquivos em um drive compartilhado, até 100 resultados são retornados. Se ela não estiver definida para arquivos que não estão em um drive compartilhado, a lista inteira será retornada.
pageToken

string

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

boolean

Se o aplicativo que fez a solicitação é compatível com o Meu Drive e os drives compartilhados.
supportsTeamDrives
(deprecated)

boolean

Obsoleto: use supportsAllDrives.
useDomainAdminAccess

boolean

Emita a solicitação como administrador do domínio. Se definido como "true", o solicitante vai receber acesso se o parâmetro de ID do arquivo se referir a um drive compartilhado e o solicitante for um administrador do domínio a que o drive compartilhado pertence.
includePermissionsForView

string

Especifica as permissões de visualização extra que vão ser incluídas 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 associadas a um arquivo.

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

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

string

O token de página para a próxima página de permissões. Este campo estará ausente se o fim da lista de permissões tiver sido alcançado. Se o token for rejeitado por qualquer motivo, ele deverá ser descartado e a paginação precisará ser reiniciada a partir da primeira página de resultados.
kind

string

É sempre drive#permissionList.
etag

string

É a ETag da lista.
items[]

object (Permission)

Lista de permissões.

Escopos de autorização

Requer um dos seguintes escopos de OAuth:

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • 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 sejam usados pelo app. Para mais informações, consulte o Guia de autorização.