Implementar o suporte a drives compartilhados

Os drives compartilhados seguem modelos de organização, compartilhamento e propriedade diferentes do Meu Drive. Se o app for criar e gerenciar arquivos em drives compartilhados, será necessário implementar o suporte a drives compartilhados. A complexidade da implementação depende da funcionalidade do app.

Para começar, é necessário incluir o parâmetro de consulta supportsAllDrives=true nas solicitações quando o app realizar 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 seu aplicativo foi projetado para processar arquivos em drives compartilhados.

Os aplicativos que leem ou modificam permissões, rastreiam mudanças ou precisam pesquisar em vários corpora exigem mais funcionalidades do drive compartilhado. O restante deste documento destaca outras mudanças necessárias para realizar essas tarefas.

Pesquisar conteúdo em um drive compartilhado

Use o método files.list para pesquisar unidades compartilhadas. Esta seção aborda os campos específicos do drive compartilhado no método files.list. Para pesquisar o drive compartilhado, consulte Pesquisar arquivos e pastas.

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

  • driveId: o 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 definido como falso, os itens do drive compartilhado não serão retornados.

  • corpora: corpos de itens (arquivos/documentos) a que a consulta se aplica. Os corpos compatíveis são user, domain, drive e allDrives. Para otimizar a eficiência, dê preferência a user ou drive em vez de allDrives.

  • supportsAllDrives: indica se o aplicativo solicitante oferece suporte a Meu Drive e a drives compartilhados. Se for falso, os itens do drive compartilhado não serão incluídos na resposta.

Os modos de consulta a seguir são específicos para drives compartilhados:

includeItemsFromAllDrives corpora Descrição da consulta
true user Consulta arquivos acessados pelo usuário, incluindo 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 arquivos que o usuário acessou e todos os drives compartilhados em que ele é participante. 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.

Acompanhar as alterações em um drive compartilhado

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

  • 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 a mudanças nos arquivos mostrados ao usuário. Para se referir a uma mudança específica de drive compartilhado, é necessário usar o ID do drive compartilhado e o ID da mudança como identificadores.
  • supportsAllDrives: define se o aplicativo solicitante oferece suporte a drives compartilhados. Se for falso, os itens do drive compartilhado, incluindo drives compartilhados e arquivos em um drive compartilhado, não serão retornados.
  • includeItemsFromAllDrives: se os arquivos ou as mudanças do drive compartilhado precisam ser incluídas na lista de mudanças.

Os modos de consulta a seguir são específicos para drives compartilhados:

includeItemsFromAllDrives driveId Descrição da consulta
true Não As mudanças são refletidas em arquivos dentro ou fora de drives compartilhados que o usuário acessou, bem como em drives compartilhados em que o usuário é participante.
true Sim As mudanças são refletidas no drive compartilhado especificado e nos itens dentro dele.

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

Ativar o suporte a drives compartilhados na interface do Drive

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

Como usar o seletor de arquivos com drives compartilhados

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

Próximas etapas

Continue em Gerenciar drives compartilhados para saber como criar e gerenciar as permissões de drives compartilhados.