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 drives compartilhados no app. A complexidade da implementação depende da funcionalidade do app.

Para começar, inclua 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 campos específicos do drive compartilhado 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 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.

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

  • supportsAllDrives: indica 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 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 é membro. A resposta pode incluir incompleteSearch : true, indicando que alguns corpus 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 mudanças em um drive compartilhado

Use o método changes.list para acompanhar as mudanças em um drive compartilhado. Esta seção aborda campos específicos do drive compartilhado no método changes.list. Para mais informações, consulte Rastrear mudanças para 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 mudanças são retornadas. Se especificados, 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 no drive compartilhado, use o ID do drive e o ID da mudança como identificadores.
  • supportsAllDrives: indica se o aplicativo solicitante é compatível com drives compartilhados. Se for "false", os itens do drive compartilhado, incluindo drives compartilhados e arquivos dentro de um drive compartilhado, não serão retornados.
  • includeItemsFromAllDrives: se os arquivos ou as mudanças do drive compartilhado precisam ser incluídos na lista de mudanças.

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 alterações, consulte Registros de alterações.

Ativar o suporte a drives compartilhados na interface do Drive

Para acessar o conteúdo dos drives compartilhados usando a interface 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 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 deles no seletor de arquivos, consulte a API Google Picker.

Próximas etapas

Acesse Gerenciar drives compartilhados para receber ajuda sobre como criar drives compartilhados e gerenciar as permissões deles.