Este guia contém tarefas relacionadas ao gerenciamento de drives compartilhados, como criar drives compartilhados e gerenciar participantes e permissões.
Para mais informações sobre os limites de pastas do drive compartilhado, consulte Limites de pastas.
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 de back-end indeterminado, a
mesma solicitação poderá ser repetida. O requestId
e o corpo da solicitação precisam
permanecer os mesmos.
Se o drive compartilhado foi criado em uma solicitação anterior ou devido a uma
tentativa, a resposta normal será retornada. Às vezes, por exemplo, após um período
prolongado ou se o corpo da solicitação tiver mudado, um erro 409
poderá ser
retornado indicando que o requestId
precisa ser descartado.
Adicionar ou remover participantes de um drive compartilhado
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 em um drive compartilhado para conceder privilégios adicionais 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 drives.
Excluir um drive compartilhado
Use o método drives.delete
para excluir uma
unidade compartilhada. Todo o conteúdo do drive compartilhado precisa ser movido para a lixeira ou excluído
antes da exclusão do drive compartilhado.
Gerenciar drives compartilhados para administradores de 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 para drives
compartilhados que pertencem à organização, independentemente da participação do administrador
em um determinado drive compartilhado.
Recuperar um drive compartilhado que não tem um organizador
O exemplo abaixo mostra como usar esses recursos para recuperar drives compartilhados que não têm mais um organizador.
Java
Python
Node.js
PHP
.NET
Limites de pastas
As pastas do drive compartilhado têm alguns limites de armazenamento. Para mais informações, consulte 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.
Quando o limite é atingido, o drive compartilhado não aceita mais itens. Para receber arquivos novamente, os usuários precisam excluir permanentemente os itens da pasta. Os itens na lixeira são contabilizados no limite, mas os excluídos permanentemente não são. Para mais informações, consulte Esvaziar a lixeira ou excluir arquivos e pastas.
Limite de profundidade da pasta
Uma pasta em um drive compartilhado não pode conter mais de 100 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 se aplica apenas a pastas filhas.
As tentativas de adicionar mais de 100 níveis de pastas retornam uma
resposta de código de status HTTP
teamDriveHierarchyTooDeep
.