Introdução à API Picker

A API Picker oferece uma maneira segura para os usuários selecionarem fotos e vídeos da biblioteca do Google Fotos e compartilhar com o aplicativo.

Antes de começar

Fluxo da API Picker

Confira uma visão geral de como a API Picker funciona:

  1. Verifique o token do OAuth:antes de iniciar o fluxo da API Picker, verifique se há um token de acesso OAuth 2.0 válido para o usuário. Se não houver um token, inicie o fluxo de autorização do OAuth 2.0 para receber um.

  2. Criar uma sessão:inicie o processo fazendo uma chamada para a API Picker para criar uma nova sessão. Essa chamada vai retornar um pickerUri exclusivo.

  3. Direcione os usuários ao app Google Fotos:forneça o pickerUri aos usuários (como um link clicável ou um código QR). Esse URL vai abrir o app Google Fotos com segurança.

  4. O usuário seleciona itens de mídia:no app Google Fotos, os usuários podem navegar pela biblioteca e selecionar as fotos e os vídeos que querem compartilhar com seu app. Leia uma visão geral da experiência de seleção do usuário.

  5. Solicitar a sessão:o app precisa solicitar a sessão periodicamente para verificar o status. Você quer que a propriedade mediaItemsSet retorne "true", indicando que o usuário terminou a seleção.

  6. Listar itens de mídia selecionados:depois que mediaItemsSet retornar "true", você poderá usar o método de lista para conferir detalhes sobre os itens de mídia selecionados.

  7. Recuperar e usar itens de mídia:agora você tem acesso aos itens de mídia selecionados. É possível buscar o conteúdo usando o baseUrl e usá-los no seu app.

Próximas etapas

  • Analise os documentos de referência: consulte a documentação de referência da API Picker para saber mais sobre todos os métodos e parâmetros disponíveis.
  • Teste os exemplos: confira nosso exemplo (em inglês) para ver a API Picker em ação e se inspirar para sua integração.