Atualiza uma permissão com semântica de patch. Faça o teste agora.
Solicitação
Solicitação HTTP
PATCH https://www.googleapis.com/drive/v3/files/fileId/permissions/permissionId
Parâmetros
| Nome do parâmetro | Valor | Descrição |
|---|---|---|
| Parâmetros de caminho | ||
fileId |
string |
Mostra o ID do arquivo ou drive compartilhado. |
permissionId |
string |
ID da permissão. |
| Parâmetros de consulta opcionais | ||
fields |
string |
Os caminhos dos campos que você quer incluir na resposta. Se não for especificado, a resposta incluirá um conjunto padrão de campos específicos a esse método. Para o desenvolvimento, é possível usar o valor especial * para retornar todos os campos, mas você terá um desempenho melhor selecionando apenas os campos necessários. Veja mais informações em Retornar campos específicos de um arquivo.
|
removeExpiration |
boolean |
Define se a data de validade deve ser removida.
Padrão: false.
|
supportsAllDrives |
boolean |
Indica se o aplicativo solicitante é compatível com os itens "Meu Drive" e drives compartilhados.
Padrão: false.
|
supportsTeamDrives |
boolean |
O uso suspenso oferece suporte a AllAllDrives.
Padrão: false
|
transferOwnership |
boolean |
Define se a propriedade do usuário será transferida para o usuário especificado e o downgrade do proprietário atual para um gravador. Esse parâmetro é obrigatório como confirmação do efeito colateral. Os proprietários de arquivos só podem transferir a propriedade de arquivos no Meu Drive. Os arquivos em um drive compartilhado pertencem à organização proprietária do drive. As transferências de propriedade não são compatíveis com arquivos e pastas nos drives compartilhados. Os organizadores de um drive compartilhado podem mover itens desse drive para o Meu Drive, o que transfere a propriedade para eles.
Padrão: false.
|
useDomainAdminAccess |
boolean |
Emita a solicitação como administrador do domínio. Se ela for definida como verdadeira, o solicitante receberá acesso se o parâmetro do ID do arquivo se referir a um drive compartilhado e se o solicitante for um administrador do domínio a que ele pertence.
Padrão: false.
|
Autorização
Esta solicitação requer autorização com pelo menos um dos seguintes escopos:
| Escopo |
|---|
https://www.googleapis.com/auth/drive |
https://www.googleapis.com/auth/drive.file |
Alguns escopos são restritos e exigem uma avaliação de segurança para serem usados pelo app. Para mais informações, consulte a página de autenticação e autorização.
Corpo da solicitação
No corpo da solicitação, forneça as partes relevantes de um recurso Permissions, de acordo com as regras da semântica de patch, com as seguintes propriedades:
| Nome da propriedade | Valor | Descrição | Observações |
|---|---|---|---|
| Propriedades opcionais | |||
expirationTime |
datetime |
A hora em que essa permissão expira (RFC 3339, data e hora). Os prazos de validade têm as seguintes restrições:
|
gravável |
pendingOwner |
boolean |
Indica se a conta associada a esta permissão tem um proprietário pendente. Preenchido apenas para permissões do tipo user em arquivos que não estão em um drive compartilhado. |
gravável |
role |
string |
O papel concedido pela permissão. Embora novos valores possam ser compatíveis no futuro, os seguintes itens são permitidos:
|
gravável |
view |
string |
Indica a visualização dessa permissão. Preenchido apenas para permissões que pertencem a uma visualização. published é o único valor compatível. |
gravável |
Resposta
Se bem-sucedido, este método retornará um recurso Permissions no corpo da resposta.
Confira!
Use o APIs Explorer abaixo para chamar esse método em dados ativos e ver a resposta.