- Solicitação HTTP
- Parâmetros de caminho
- Parâmetros de consulta
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- Faça um teste
Lista as permissões de um arquivo ou drive compartilhado.
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 |
O ID do arquivo ou drive compartilhado |
Parâmetros de consulta
Parâmetros | |
---|---|
pageSize |
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 |
O token para continuar uma solicitação de lista anterior na próxima página. Deve ser definido como o valor de "nextPageToken" da resposta anterior. |
supportsAllDrives |
Se o aplicativo que fez a solicitação é compatível com o Meu Drive e os drives compartilhados. |
supportsTeamDrives |
Obsoleto: use |
useDomainAdminAccess |
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 |
Especifica as permissões de visualização extra que vão ser incluídas na resposta. Somente "Publicado" é compatível. |
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 |
---|
{
"nextPageToken": string,
"kind": string,
"permissions": [
{
object ( |
Campos | |
---|---|
nextPageToken |
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. O token de página normalmente é válido por várias horas. No entanto, se novos itens forem adicionados ou removidos, os resultados esperados poderão ser diferentes. |
kind |
Identifica o tipo de recurso. Valor: a string fixa |
permissions[] |
Lista de permissões. Se a nextPageToken for preenchida, essa lista poderá estar incompleta, e uma página adicional de resultados deverá ser buscada. |
Escopos de autorização
Requer um dos seguintes escopos de OAuth:
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.