Method: permissions.create

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

Aviso: operações de permissões simultâneas no mesmo arquivo não são compatíveis. 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 de texto simples para incluir no e-mail de notificação.
enforceSingleParent
(deprecated)

boolean

Obsoleto: consulte moveToNewOwnersRoot para ver detalhes.
moveToNewOwnersRoot

boolean

Esse parâmetro só entrará em vigor se o item não estiver em um drive compartilhado e a solicitação estiver tentando transferir a propriedade do item. Se 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.
sendNotificationEmail

boolean

Se é necessário 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. Ele não pode ser desativado para transferências de propriedade.
supportsAllDrives

boolean

Se o aplicativo solicitante é compatível com "Meu Drive" e drives compartilhados.
supportsTeamDrives
(deprecated)

boolean

Obsoleto: use supportsAllDrives.
transferOwnership

boolean

Se a propriedade será transferida para o usuário especificado e o downgrade do proprietário atual para um gravador. Esse parâmetro é necessário como uma confirmação do efeito colateral.
useDomainAdminAccess

boolean

Emita a solicitação como administrador do domínio. Se ela for definida como verdadeira, o solicitante terá acesso se o parâmetro do 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/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 o Guia de autorização.