Method: permissions.create

Cria uma permissão para um arquivo ou drive compartilhado. Para mais informações, consulte Compartilhar arquivos, pastas e drives.

Aviso:não é possível realizar operações simultâneas de permissões no mesmo arquivo. Somente 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 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ó entra em vigor se o item não estiver em um drive compartilhado e a solicitação tentar transferir a propriedade dele. Se definido como true, o item será movido para a pasta raiz do Meu Drive do novo proprietário, e todos os itens principais anteriores serão removidos. Se definido como false, os familiares responsáveis não serão alterados.
sendNotificationEmail

boolean

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

boolean

Se o aplicativo solicitante é compatível com o Meu Drive e 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 vai passar a ser um gravador. Esse parâmetro é obrigatório como uma confirmação do efeito colateral. Para mais informações, consulte Transferir a propriedade de arquivos.
useDomainAdminAccess

boolean

Faça a solicitação como administrador do domínio.

Se definido como true e se as seguintes condições adicionais forem atendidas, o solicitante terá acesso:

  1. O parâmetro "file ID" se refere a um drive compartilhado.
  2. O solicitante é administrador do domínio a que o drive compartilhado pertence.

Para mais informações, consulte Gerenciar drives compartilhados como administradores de domínio.
enforceExpansiveAccess

boolean

Se a solicitação precisa aplicar regras de acesso abrangentes.

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.