Um papel é uma coleção de permissões que permite aos usuários realizar ações específicas nos recursos do Google Drive. Para disponibilizar permissões a usuários, grupos e contas de serviço, atribua papéis. Ao atribuir um papel, você concede todas as permissões contidas nele.
Cada permissão na API Google Drive tem uma função que define o que os usuários podem fazer com um arquivo, uma pasta ou um drive compartilhado. Para mais informações, consulte Cenários para compartilhamento de recursos do Drive.
Operações para arquivos e pastas
A tabela a seguir mostra as operações que os usuários podem realizar para cada função quando ela não está restrita a uma visualização. Para mais informações, consulte Visualizações.
| Operação permitida | owner |
organizer |
fileOrganizer |
writer |
commenter |
reader |
|---|---|---|---|---|---|---|
| Ler os metadados (como nome e descrição) do arquivo ou da pasta | ||||||
| Ler o conteúdo do arquivo | ||||||
| Ler a lista de itens na pasta | ||||||
| Adicionar comentários ao arquivo | ||||||
| Modificar os metadados do arquivo ou da pasta | ||||||
| Modificar o conteúdo do arquivo | ||||||
| Acessar revisões históricas | ||||||
| Adicionar itens à pasta | ||||||
| Remover itens da pasta "Meu Drive" | ||||||
| Compartilhar itens da pasta "Meu Drive" | ||||||
| Pode acessar permissões detalhadas de arquivos | ||||||
| Mover itens para a lixeira | ||||||
| Recuperar itens da lixeira | ||||||
| Esvaziar a lixeira | ||||||
| Excluir um arquivo ou uma pasta | ||||||
| Adicionar uma restrição de conteúdo a um arquivo em uma pasta do Meu Drive | ||||||
| Definir ou remover a configuração de acesso limitado nas pastas do Meu Drive |
Operações específicas para drives compartilhados
A tabela a seguir mostra as operações específicas do drive compartilhado que os usuários podem realizar para cada função, quando ela não está restrita a uma visualização. Para mais informações, consulte Visualizações.
| Operação permitida | owner |
organizer |
fileOrganizer |
writer |
commenter |
reader |
|---|---|---|---|---|---|---|
| Compartilhar um item do drive compartilhado | ||||||
| Adicionar arquivos a drives compartilhados | ||||||
| Modificar os metadados de um drive compartilhado | ||||||
| Adicionar membros a um drive compartilhado | ||||||
| Reorganizar itens em um drive compartilhado [1] | ||||||
| Mover itens para fora de um drive compartilhado [2] | ||||||
| Excluir itens em drives compartilhados [2] | ||||||
| Excluir um drive compartilhado vazio | ||||||
| Adicionar uma restrição de conteúdo a um arquivo em um drive compartilhado | ||||||
| Definir ou remover a configuração de acesso limitado em pastas de drives compartilhados |
Correlação entre as funções da API Drive e da interface do Drive
A API Drive e a interface do Drive usam o mesmo sistema de permissões. No entanto, os nomes dos papéis são um pouco diferentes entre os dois.
A tabela a seguir mostra como as funções correspondem a arquivos e pastas no Meu Drive.
| Função da API Drive | Função da interface do Drive | Descrição |
|---|---|---|
owner |
Proprietário | Concede controle total sobre o arquivo ou a pasta. |
writer |
Editor | Permite visualizar, adicionar comentários e editar o arquivo. Para pastas, é possível adicionar, editar e excluir arquivos ou subpastas. |
commenter |
Comentador | Permite visualizar o arquivo e adicionar comentários. |
reader |
Leitor | Concede a capacidade de visualizar o arquivo. |
A tabela a seguir mostra como as funções correspondem a arquivos e pastas em unidades compartilhadas.
| Função da API Drive | Função da interface do Drive | Descrição |
|---|---|---|
organizer |
Gerente | Concede a capacidade de gerenciar arquivos, pastas, pessoas e configurações. |
fileOrganizer |
Gerenciador de conteúdo | Concede a capacidade de contribuir e gerenciar conteúdo. Função padrão para novos membros. |
writer |
Colaborador | Permite visualizar, adicionar comentários e editar o arquivo. Também é possível criar arquivos em um drive compartilhado. |
commenter |
Comentador | Permite visualizar o arquivo e adicionar comentários. |
reader |
Leitor | Concede a capacidade de visualizar o arquivo. |
Visualizações
Uma permissão pode ser restrita a um
view. Nesse caso, a função se aplica apenas a essa visualização específica.
Uma permissão com view=published e role=reader concede a reader acesso à visualização publicada do arquivo, mas não ao arquivo em si.reader
Uma permissão com view=metadata e role=reader concede acesso de reader aos metadados da pasta, mas não ao conteúdo dela.
Por outro lado, qualquer permissão que não seja restrita a uma visualização específica concede acesso de
reader à visualização publicada do arquivo.