Começar a usar a API Library

A API Library permite interagir com fotos, vídeos e álbuns nas bibliotecas do Google Fotos dos usuários, mas com um foco importante: você só pode acessar e gerenciar o conteúdo criado pelo seu aplicativo.

Antes de começar

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

Principais casos de uso da API Library

A API Library é ideal para cenários em que seu app precisa:

• Fazer upload e armazenar mídia: importe fotos e vídeos (gerados pelo seu app) com segurança para as bibliotecas do Google Fotos dos usuários.
• Organize o conteúdo:crie e gerencie álbuns para ajudar os usuários a organizar as mídias relacionadas a apps.
• Aprimorar fotos e álbuns: adicione contexto a itens de mídia e álbuns com enriquecimentos, como títulos, descrições ou informações de local.
• Acessar dados criados pelo app: extraia e interaja com as fotos, os vídeos e os álbuns que o app criou anteriormente.

Fluxo de trabalho típico da API Library

Embora a API Library ofereça várias funcionalidades, um fluxo de trabalho comum pode envolver estas etapas:

1. Fazer upload de mídia: use o endpoint de uploads para fazer upload seguro de bytes de fotos ou vídeos para o Google Fotos. Essa etapa gera um uploadToken.

2. Criar itens de mídia: use o método mediaItems.batchCreate, fornecendo o uploadToken, para criar itens de mídia na biblioteca do usuário.

3. Criar álbuns (opcional): use o método albums.create para criar álbuns na biblioteca do usuário e organizar os itens de mídia.

4. Gerenciar álbuns:

   • Adicione itens de mídia (criados pelo seu app) a álbuns usando albums.batchAddMediaItems.
   • Remova itens de mídia de álbuns usando albums.batchRemoveMediaItems.
   • Adicione enriquecimentos a álbuns (como títulos ou locais) usando albums.addEnrichment.
   • Extraia informações sobre álbuns específicos usando albums.get.
   • Liste os álbuns criados pelo seu app usando albums.list.

5. Acessar mídia criada pelo app:

   • Extrair detalhes sobre itens de mídia específicos usando mediaItems.get ou mediaItems.batchGet.
   • Pesquise itens de mídia criados pelo seu app usando mediaItems.search.
   • Lista itens de mídia em um álbum específico criado pelo app usando mediaItems.search com o ID do álbum.

Próximas etapas

• Consulte a documentação de referência: explore a documentação de referência da API Library detalhada para saber mais sobre todos os métodos e parâmetros disponíveis.
• Teste as amostras: confira nossa amostra para ver a API Library em ação e se inspirar para a integração.