Method: permissions.insert

Insere uma permissão para um arquivo ou drive compartilhado.

Aviso:não há suporte para operações de permissões simultâneas no mesmo arquivo. Somente a última atualização é aplicada.

Solicitação HTTP

POST 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
emailMessage

string

Uma mensagem personalizada em texto simples para ser incluída nos e-mails de notificação.

enforceSingleParent
(deprecated)

boolean

Obsoleto: consulte moveToNewOwnersRoot para mais detalhes.

moveToNewOwnersRoot

boolean

Esse parâmetro só terá efeito se o item não estiver em um drive compartilhado e a solicitação estiver tentando transferir a propriedade do item. Se ele for definido como true, o item será movido para a pasta raiz do Meu Drive do novo proprietário, e todos os pais anteriores serão removidos. Se definido como false, os pais não serão alterados.

sendNotificationEmails

boolean

Se os e-mails de notificação serão enviados ao compartilhar com usuários ou grupos. Esse parâmetro será ignorado, e um e-mail será enviado se o role for owner.

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.

Corpo da solicitação

O corpo da solicitação contém uma instância de Permission.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de Permission.

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

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.