Visão geral do Google Picker

Este documento apresenta o Google Picker e a API Google Picker. Ele também ajuda você a decidir qual abordagem é melhor para seu app.

O Google Picker oferece uma caixa de diálogo "Abrir arquivo" refinada para informações armazenadas no Google Drive. É uma maneira de permitir que os usuários selecionem ou façam upload de fotos, vídeos e documentos da conta do Drive sem sair do seu aplicativo.

A API Google Picker é a interface técnica usada para implementar o Google Picker no seu app. Ao usar essa API, você cria uma interface familiar que lida com a complexidade da autenticação e da navegação de arquivos, retornando metadados específicos (como IDs e URLs) para seu app depois que um usuário faz uma seleção.

Principais casos de uso

O Google Picker é versátil e pode ser adaptado a vários fluxos de trabalho de aplicativos:

  • Alternativa de upload de arquivo: os usuários podem fazer upload de um arquivo diretamente para o Drive usando o Google Picker.
  • Ferramentas de colaboração: permitem que os usuários vinculem Documentos ou Planilhas Google específicos a uma tarefa de gerenciamento de projetos ou a um evento compartilhado do Google Agenda.
  • Anexos de recursos: use o Google Picker para que os usuários anexem documentação de suporte do Drive a um relatório de despesas ou tíquete de suporte.

Comparação entre apps da Web e apps para computador e dispositivos móveis

Embora a funcionalidade principal permaneça consistente, a implementação da API Google Picker varia dependendo de onde o app está sendo executado. A tabela de comparação a seguir lista as diferenças técnicas e funcionais ao implementar para apps da Web em comparação com apps para computador e dispositivos móveis.

Recurso Apps da Web Apps para computador e dispositivos móveis
Tecnologia principal Biblioteca JavaScript do lado do cliente. Parâmetros de URL e redirecionamentos HTTP do OAuth 2.0.
Renderização Integra-se ao layout da interface do app. Abre em uma nova guia do navegador padrão do sistema do usuário. Não pode mais ser exibido em um WebView incorporado.
Fluxo de autenticação Requer um token de acesso específico transmitido por setOAuthToken. Acionado ao adicionar trigger_onepick=true à solicitação OAuth.
Método de resposta Callbacks diretos do JavaScript. URIs de redirecionamento ou esquemas de URL personalizados.
Escopos Flexível; pode usar drive.file, drive.readonly etc. Estrito: apenas drive.file é permitido e não pode ser combinado com outros escopos.
Configuração Usa a interface fluente PickerBuilder em JavaScript. Usa parâmetros de string de consulta no URL de autorização.

O usuário precisa estar conectado ao acessar o Google Picker.

As principais diferenças estratégicas são:

  • Os web apps são projetados para alta interatividade e personalização avançada, como visualizações específicas por tipo de arquivo e restrição da visualização a pastas específicas do Drive.
  • Os apps para dispositivos móveis e computadores foram projetados para serem seguros e simples, usando o navegador do sistema para lidar com a autenticação e a seleção de arquivos em um fluxo único e unificado.