Implementar o suporte a drives compartilhados

Os drives compartilhados seguem modelos de organização, compartilhamento e propriedade diferentes 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 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 o 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 corpora exigem recursos adicionais de drives compartilhados. O restante deste documento destaca outras mudanças necessárias para realizar essas tarefas.

Pesquisar conteúdo em um drive compartilhado

Use o list método no files recurso para encontrar arquivos de usuários 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 do drive compartilhado a ser pesquisado.

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

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

  • supportsAllDrives: indica se o aplicativo solicitante é compatível com o Meu Drive e o drive compartilhado. Se for falso, 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 arquivos que o usuário acessou, incluindo arquivos 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 arquivos que o usuário acessou e todos os drives compartilhados em que ele é membro. Observação: a resposta pode incluir incompleteSearch:true, indicando que alguns corpora não foram pesquisados para esta solicitação.

Acompanhar mudanças em um drive compartilhado

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

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

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

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

  • supportsAllDrives: indica se o aplicativo solicitante é compatível com drives compartilhados. Se for falso, os itens do drive compartilhado, incluindo drives compartilhados e arquivos em 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 mudanças nos arquivos dentro ou fora dos drives compartilhados que o usuário acessou, bem como as mudanças nos drives compartilhados em que o usuário é membro.
true Sim As mudanças refletem as mudanças no drive compartilhado especificado e nos itens dentro desse drive compartilhado.

Para mais detalhes sobre o comportamento do registro de alterações, 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, certifique-se de que você marcou 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 oferece suporte à seleção de itens em drives compartilhados. Para detalhes sobre como ativar o suporte a drives compartilhados e adicionar visualizações de drives compartilhados no Picker, consulte a API Google Picker.