Implementar o suporte a drives compartilhados

Os drives compartilhados seguem diferentes modelos de organização, compartilhamento e propriedade do Meu Drive. Se o app criar e gerenciar arquivos em drives compartilhados, você precisará implementar a compatibilidade com esses drives. A complexidade da implementação depende da funcionalidade do app.

Para começar, você precisa incluir o parâmetro de consulta supportsAllDrives=true nas solicitações quando o aplicativo executar as operações listadas abaixo:

API Drive v3

  • files.get
  • files.list
  • files.create
  • files.update
  • files.copy
  • files.delete
  • changes.list
  • changes.getStartPageToken
  • permissions.list
  • permissions.get
  • permissions.create
  • permissions.update
  • permissions.delete

API Drive v2

  • files.get
  • files.list
  • files.insert
  • files.update
  • files.patch
  • files.copy
  • files.trash
  • files.untrash
  • files.delete
  • files.touch
  • children.insert
  • parents.insert
  • changes.list
  • changes.getStartPageToken
  • changes.get
  • permissions.list
  • permissions.get
  • permissions.insert
  • permissions.update
  • permissions.patch
  • permissions.delete

O parâmetro supportsAllDrives=true informa ao Google Drive que o aplicativo foi projetado para processar arquivos em drives compartilhados.

Os aplicativos que leem ou modificam permissões, rastreiam alterações ou precisam pesquisar em vários corpora, exigem outras funcionalidades de drive compartilhado. No restante deste documento, destacamos outras mudanças necessárias para executar essas tarefas.

Pesquisar conteúdo em um drive compartilhado

Use o método files.list para pesquisar drives compartilhados. Nesta seção, abordamos campos específicos de drives compartilhados no método files.list. Para pesquisar um drive compartilhado, consulte Pesquisar arquivos e pastas.

O método files.list contém os seguintes campos e modos de consulta específicos do drive compartilhado:

  • driveId: ID do drive compartilhado a ser pesquisado.
  • includeItemsFromAllDrives: se os itens do drive compartilhado precisam ser incluídos nos resultados. Se não estiver presente ou for definida como "false", os itens do drive compartilhado não serão retornados.

  • corpora: corpos de itens (arquivos/documentos) aos quais a consulta se aplica. Os corpos com suporte são user, domain, drive e allDrives. Para eficiência, prefira user ou drive a allDrives.

  • supportsAllDrives: se o aplicativo solicitante é compatível com o Meu Drive e os drives compartilhados. Se for falso, os itens do drive compartilhado não serão incluídos na resposta.

Estes são os modos de consulta específicos dos drives compartilhados:

includeItemsFromAllDrives corpora Descrição da consulta
true user Consulta os arquivos que o usuário acessou, incluindo os arquivos do drive compartilhado e do "Meu Drive".
true drive consulta todos os itens no drive compartilhado especificado. O driveId precisa ser especificado na solicitação.
true allDrives Consulta os arquivos que o usuário acessou e todos os drives compartilhados de que ele participa. A resposta pode incluir incompleteSearch : true, indicando que alguns corpora não foram pesquisados para essa solicitação.
true domain Consulta arquivos compartilhados com o domínio, incluindo arquivos do drive compartilhado e do Meu Drive.

Controlar as alterações em um drive compartilhado

Use o método changes.list para acompanhar as alterações em um drive compartilhado. Nesta seção, abordamos campos específicos de drives compartilhados no método changes.list. Para mais informações, consulte Acompanhar alterações de usuários e drives compartilhados. O método changes.list contém os seguintes campos e modos de consulta específicos do drive compartilhado:

  • driveId: o drive compartilhado de onde as alterações são retornadas. Se especificado, os IDs de mudança se referem a mudanças no drive compartilhado, não nos arquivos mostrados ao usuário. Para se referir a uma alteração específica no drive compartilhado, o ID do drive compartilhado e o da alteração precisam ser usados como um identificador.
  • supportsAllDrives: se o aplicativo que faz a solicitação é compatível com drives compartilhados. Se for falso, os itens dos drives compartilhados, incluindo os drives compartilhados e os arquivos em um drive compartilhado, não serão retornados.
  • includeItemsFromAllDrives: se os arquivos ou alterações dos drives compartilhados devem ser incluídos na lista de alterações.

Estes são os modos de consulta específicos dos drives compartilhados:

includeItemsFromAllDrives driveId Descrição da consulta
true Não As alterações são refletidas nos arquivos dentro ou fora dos drives compartilhados acessados pelo usuário e nos drives compartilhados de que ele participa.
true Sim As alterações afetam o drive compartilhado especificado e os itens dentro dele.

Para mais detalhes sobre o comportamento do registro de alterações, consulte Registros de alterações.

Ativar o suporte ao drive compartilhado na interface do Drive

Para acessar o conteúdo dos drives compartilhados usando a IU do Drive, verifique se você marcou a opção "Suporte a drives compartilhados" no Console de APIs do Google. Para mais informações, consulte Configurar uma integração com a interface do Drive.

Como usar o seletor de arquivos com drives compartilhados

O seletor de arquivos permite a seleção de itens em drives compartilhados. Para detalhes sobre como ativar o suporte a drives compartilhados e adicionar a visualização desses drives no seletor de arquivos, consulte API Google Picker.

Próximas etapas

Consulte Gerenciar drives compartilhados se precisar de ajuda para criar e gerenciar as permissões deles.