Este guia contém tarefas relacionadas ao gerenciamento de drives compartilhados, como criar drives compartilhados e gerenciar membros e permissões.
Criar drives compartilhados
Para criar um drive compartilhado, use o método drives.create
.
Java
Python
Node.js
PHP
.NET
As chamadas para o método drives.create
são idempotentes.
O parâmetro requestId
identifica a tentativa lógica de criar o drive compartilhado. Se a solicitação expirar ou retornar um erro indeterminado de back-end, a mesma solicitação poderá ser repetida. O requestId
e o corpo da solicitação precisam
permanecer os mesmos.
Se o drive compartilhado tiver sido criado em uma solicitação anterior ou devido a uma nova tentativa, a resposta normal será retornada. Às vezes, como depois de um tempo
prolongado ou se o corpo da solicitação tiver mudado, um erro 409
poderá ser
retornado, indicando que requestId
precisa ser descartado.
Adicionar ou remover participantes de drives compartilhados
Adicione ou remova membros do drive compartilhado usando o
recurso permissions
.
Para adicionar um participante, crie a permissão no drive compartilhado. Os métodos de permissão também podem ser usados em arquivos individuais de um drive compartilhado para conceder outros privilégios aos membros ou permitir que pessoas que não são membros colaborem em itens específicos.
Para mais informações e exemplos de código, consulte Compartilhar arquivos, pastas e unidades.
Excluir um drive compartilhado
Use o método drives.delete
para excluir um drive compartilhado. Todo o conteúdo no drive compartilhado precisa ser movido para a lixeira ou excluído antes da exclusão.
Gerenciar drives compartilhados para administradores do domínio
Aplique o parâmetro useDomainAdminAccess
com os recursos drives
e permissions
para gerenciar drives compartilhados em uma organização.
Os usuários que chamam esses métodos com useDomainAdminAccess=true
precisam ter o
privilégio
de administrador Drive and Docs
.
Os administradores podem pesquisar drives
compartilhados ou atualizar as permissões deles
da organização, seja qual for a assinatura do administrador
em um drive compartilhado.
Recuperar um drive compartilhado que não tem um organizador
O exemplo abaixo demonstra como usar esses recursos para recuperar drives compartilhados que não têm mais um organizador.
Java
Python
Node.js
PHP
.NET
Limites de pasta
As pastas dos drives compartilhados têm alguns limites de armazenamento. Veja mais informações em Limites do drive compartilhado no Google Drive.
Limite de itens
Cada pasta no drive compartilhado de um usuário tem um limite de 500.000 itens, incluindo arquivos, pastas e atalhos.
Limite de tamanho da pasta
Uma pasta em um drive compartilhado não pode conter mais de cem níveis de pastas aninhadas. Isso significa que uma pasta filha não pode ser armazenada em outra com mais de 99 níveis de profundidade. Essa limitação só se aplica a pastas filhas.
As tentativas de adicionar mais de 100 níveis de pastas retornam uma
resposta de código de status HTTP
teamDriveHierarchyTooDeep
.