Method: permissions.create

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

Aviso:não é possível realizar operações de permissões simultâneas no mesmo arquivo. Apenas a última atualização é aplicada.

Solicitação HTTP

POST 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 do drive compartilhado.

Parâmetros de consulta

Parâmetros
emailMessage

string

Uma mensagem personalizada em texto simples para incluir no e-mail de notificação.
enforceSingleParent
(deprecated)

boolean

Descontinuado: consulte moveToNewOwnersRoot para mais detalhes.
moveToNewOwnersRoot

boolean

Esse parâmetro só vai entrar em vigor se o item não estiver em um drive compartilhado e a solicitação estiver tentando transferir a propriedade dele. Se definido como true, o item será movido para a pasta raiz do Meu Drive do novo proprietário, e todas as pastas mãe anteriores serão removidas. Se definido como false, os familiares responsáveis não são alterados.
sendNotificationEmail

boolean

Se um e-mail de notificação será enviado ao compartilhar com usuários ou grupos. O padrão é "true" para usuários e grupos, e não é permitido para outras solicitações. Ele não pode ser desativado para transferências de propriedade.
supportsAllDrives

boolean

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

boolean

Descontinuado: use supportsAllDrives.
transferOwnership

boolean

Indica se a propriedade será transferida para o usuário especificado e se o proprietário atual será rebaixado para o nível de colaborador. Esse parâmetro é necessário como um reconhecimento do efeito colateral.
useDomainAdminAccess

boolean

Emitir a solicitação como administrador de 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 do OAuth:

  • 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 o app possa usá-los. Para mais informações, consulte o guia de autorização.