Implementar o suporte a drives compartilhados

Os drives compartilhados seguem organizações, compartilhamentos e propriedades diferentes modelos em Meu Drive. Se o app criar e gerenciar arquivos em grupos você precisa implementar o suporte a drives compartilhados no seu app. A complexidade sua implementação depende da funcionalidade do seu app.

Para começar, você precisa incluir o parâmetro de consulta supportsAllDrives=true no suas solicitações quando o app 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 seu aplicativo foi projetado para lidar com arquivos em drives compartilhados.

Aplicativos que leem ou modificam permissões, rastreiam alterações ou precisam pesquisar em vários corpora exigem a funcionalidade adicional do drive compartilhado. O restante deste documento destaca as alterações adicionais necessárias para realizar 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 dos drives compartilhados na files.list. Para pesquisar um drive compartilhado, consulte Pesquise arquivos e pastas.

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

  • driveId: código 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 falsa, os itens do drive compartilhado serão enviados não serão retornadas.

  • corpora — Corpos de itens (arquivos/documentos) a em que a consulta se aplica. Os corpos aceitos são user, domain, drive e allDrives. Use user ou drive em vez de allDrives para aumentar a eficiência.

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

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

includeItemsFromAllDrives corpora Descrição da consulta
true user Consulta arquivos que o usuário acessou, 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 é membro. 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 os do drive compartilhado e do Meu Drive.

Rastrear alterações em um drive compartilhado

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

  • driveId: o drive compartilhado do qual as alterações são retornadas. Se especificado, os IDs das mudanças se referem às mudanças no drive compartilhado, não nos arquivos mostrados ao usuário. Para consultar um drive compartilhado específico alteração, o ID do drive compartilhado e o ID da mudança precisam ser usados como um identificador.
  • supportsAllDrives: se o aplicativo solicitante oferece suporte ao unidade de disco Se definida como falsa, os itens do drive compartilhado, inclusive os drives compartilhados e arquivos em um drive compartilhado, não são retornados.
  • includeItemsFromAllDrives: se os arquivos ou as alterações nos drives compartilhados precisam ser incluída na lista de alterações.

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

includeItemsFromAllDrives driveId Descrição da consulta
true Não Elas refletem as mudanças nos arquivos dentro ou fora dos drives compartilhados que o usuário acessou e em drives compartilhados de que o usuário participa.
true Sim Elas refletem as alterações feitas no drive compartilhado especificado e nos itens 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 do drive compartilhado usando a interface do Drive, marque a opção "Suporte aos drives compartilhados" no Console de APIs do Google. Para mais informações, consulte Configure uma integração com a interface do Drive.

Usar o seletor de arquivos com drives compartilhados

O seletor de arquivos permite selecionar itens em drives compartilhados. Saiba como ativar o suporte aos drives compartilhados e adicionar drives compartilhados No seletor de arquivos, consulte a API Google Picker.

Próximas etapas

Prossiga para Gerenciar drives compartilhados para Ajuda para criar drives compartilhados e gerenciar as permissões deles.