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 compartilharem com seu aplicativo.

Antes de começar

• Confira a visão geral:compare a API Picker e a API Library para garantir que a API Picker seja a mais adequada para seu caso de uso.
• Configure seu app:ative a API e configure a autenticação. Consulte Configurar seu app para ver etapas detalhadas.

O fluxo da API Picker

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

1. Verificar o token 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 à 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 QR code). Esse URL vai abrir o app Google Fotos com segurança. Para aplicativos baseados na Web, você pode adicionar /autoclose a esse URI para fechar automaticamente a janela do Google Fotos depois que o usuário concluir a seleção.

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. Pesquise a sessão:seu app precisa pesquisar a sessão periodicamente para verificar o status. Você está procurando a propriedade mediaItemsSet para retornar "true", indicando que o usuário terminou a seleção.

   Observação: sempre que você pesquisa uma sessão, a resposta contém intervalos e tempos limite recomendados para configurar sua pesquisa.

6. Listar itens de mídia selecionados:quando mediaItemsSet retornar "true", use o método "list" para receber 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. Você pode buscar o conteúdo usando o baseUrl e utilizá-lo no seu aplicativo.

Próximas etapas

• Consulte os documentos de referência: confira 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 para ver a API Picker em ação e se inspirar para sua integração.