Method: permissions.create

Cria 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/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 a ser incluída no e-mail 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.

sendNotificationEmail

boolean

Define 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. Ela não pode ser desativada para transferências de propriedade.

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.

transferOwnership

boolean

Define se a propriedade será transferida para o usuário especificado e downgrade do proprietário atual para redator. Esse parâmetro é obrigatório como uma confirmação do efeito colateral.

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/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.