Implementar o suporte a drives compartilhados

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

Para começar, inclua o parâmetro de consulta supportsAllDrives=true nas suas solicitações quando o app realizar as seguintes operações:

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 pesquisam em vários corpus exigem recursos extras 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 list no recurso files para encontrar arquivos do usuário em drives compartilhados. Para pesquisar um drive compartilhado, consulte Pesquisar drives compartilhados.

O método list contém os seguintes parâmetros de consulta específicos do drive compartilhado:

  • driveId: ID da unidade compartilhada a ser pesquisada.

  • corpora: corpos de itens (arquivos ou documentos) a que a consulta se aplica. Os corpos compatíveis são user, domain, drive e allDrives. Prefira user ou drive a allDrives para ter mais eficiência. Por padrão, o corpus é definido como user.

  • includeItemsFromAllDrives: se os itens do Meu Drive e do drive compartilhado devem ser incluídos nos resultados. Se não estiver presente ou for definido como "false", os itens do drive compartilhado não serão retornados.

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

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

includeItemsFromAllDrives corpora Descrição da consulta
true user Consulta os arquivos que o usuário acessou, incluindo os do drive compartilhado e do Meu Drive.
true domain Consulta arquivos compartilhados com o domínio, 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 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 corpus não foram pesquisados para essa solicitação.

Acompanhar as mudanças em um drive compartilhado

Use o método list no recurso changes para acompanhar as mudanças em um drive compartilhado. Para mais informações, consulte Rastrear mudanças para usuários e unidades compartilhadas.

O método list contém os seguintes parâmetros de consulta específicos do drive compartilhado:

  • driveId: o drive compartilhado de onde as mudanças são retornadas. Se especificados, os IDs de mudança se referem a mudanças nos itens do drive compartilhado, fornecendo o estado atual de um arquivo. Para se referir a uma mudança específica em um drive compartilhado, use o ID do drive e o ID da mudança como identificadores.

  • includeItemsFromAllDrives: se os arquivos ou as mudanças do drive compartilhado devem ser incluídos na lista de mudanças.

  • supportsAllDrives: se o aplicativo solicitante é compatível com unidades compartilhadas. Se for "false", os itens do drive compartilhado, incluindo drives compartilhados e arquivos dentro de um drive compartilhado, não serão retornados.

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

includeItemsFromAllDrives driveId Descrição da consulta
true Não As mudanças refletem as alterações feitas em arquivos dentro ou fora dos drives compartilhados que o usuário acessou, bem como as mudanças nos drives compartilhados de que ele participa.
true Sim As mudanças refletem as alterações feitas no drive compartilhado especificado e nos itens dentro dele.

Para mais detalhes sobre o comportamento do registro de mudanças, consulte Acompanhar mudanças para usuários e drives compartilhados.

Ativar o suporte a drives compartilhados na interface do Drive

Para acessar o conteúdo do drive compartilhado usando a interface do Drive, marque a caixa Suporte a drives compartilhados na guia Integração da interface do Drive da API Google Drive no console do Google Cloud. Para mais informações, consulte Configurar uma integração da interface do Drive.

Usar o Google Picker com drives compartilhados

O Google Picker permite selecionar itens em drives compartilhados. Para mais detalhes sobre como ativar o suporte a drives compartilhados e adicionar visualizações de drives compartilhados no seletor, consulte a API Google Picker.