Configurar o app

Para começar a usar as APIs do Google Fotos, configure seu projeto ativando as APIs do Google Fotos necessárias no Console de APIs do Google e configurando um ID do cliente OAuth 2.0.

Seu aplicativo interage com o Google Fotos em nome de um usuário desse serviço. Por exemplo, quando você cria álbuns na biblioteca do Google Fotos de um usuário ou faz upload de itens de mídia para a conta do Google Fotos de um usuário, o usuário autoriza essas solicitações de API usando o protocolo OAuth 2.0.

O ID do cliente OAuth 2.0 permite que os usuários do aplicativo façam login, se autentiquem e usem as APIs do Google Fotos. As APIs do Google Fotos não oferecem suporte a contas de serviço. Para usar essas APIs, os usuários precisam fazer login em uma conta Google válida.

Configurar o app

Primeiro ative a API e, em seguida, solicite um ID do cliente OAuth 2.0.

Ativar a API

Antes de usar as APIs Photos, você precisa ativá-las no seu projeto.

  1. Vá para o Console de APIs do Google.
  2. Na barra de menus, selecione um projeto ou crie um novo.
  3. Para abrir uma das APIs do Google Fotos, no menu de navegação, selecione APIs e serviços > Biblioteca.
  4. Pesquise "Fotos". Selecione uma ou mais APIs Photos e clique em Ativar.

Captura de tela das APIs do seletor no console do Google Cloud

Solicitar um ID do cliente OAuth 2.0

Siga estas etapas para solicitar um ID de cliente OAuth e configurá-lo para seu aplicativo. Este exemplo usa um aplicativo em que todo o fluxo do OAuth é gerenciado do lado do servidor, como o dos nossos exemplos. O processo de configuração pode variar para outros cenários de implementação.

  1. Acesse o Console de APIs do Google e selecione seu projeto.
  2. No menu, selecione APIs e serviços > Credenciais.

  3. Na página Credenciais, clique em Criar credenciais > ID do cliente OAuth.

  4. Selecione o Tipo de aplicativo. Neste exemplo, o tipo é aplicativo da Web.

  5. Registre as origens em que o app pode acessar as APIs do Google da seguinte maneira:

    1. Para identificar o ID do cliente, insira um nome.
    2. No campo Origens JavaScript autorizadas, insira a origem do aplicativo. Esse campo não permite caracteres curinga.

    É possível inserir várias origens para permitir que o app seja executado em diferentes protocolos, domínios ou subdomínios. Os URLs inseridos podem iniciar uma solicitação OAuth.

    O exemplo a seguir mostra um URL de desenvolvimento local (nossos exemplos usam localhost:8080) e um URL de produção.

        http://localhost:8080
    https://myproductionurl.example.com
    ```

1.  The **Authorized redirect URI** field is the endpoint that receives
    responses from the OAuth 2.0 server. Typically, this includes your
    development environment and points to a path in your application.

```none
    http://localhost:8080/auth/google/callback
    https://myproductionurl.example.com/auth/google/callback
    ```

1.  Click **Create**.

  1. Na caixa de diálogo do cliente OAuth, copie o seguinte:

    • ID do cliente
    • Chave secreta do cliente

    O app pode acessar as APIs do Google ativadas usando esses valores.

Antes de lançar um aplicativo público que acesse as APIs do Google Fotos, ele precisa ser analisado pelo Google. Uma mensagem "App não verificado" aparece na tela quando você testa o aplicativo, até que ele seja verificado.

Depois de configurar o app, você pode começar:

Como alterar seu ID do cliente

Os recursos criados por qualquer uma das APIs do Google Fotos só podem ser acessados ou modificados usando o ID do cliente original usado para criá-los. Por exemplo, se você criar uma "sessão" na API Picker com um ID do cliente específico e depois mudar esse ID no seu app, o app perderá o acesso a todos os recursos de API criados com o ID do cliente anterior.

Planeje com cuidado e escolha o tipo de ID de cliente correto para a API do Google Fotos que você está usando. Altere seu ID do cliente apenas se for absolutamente necessário para evitar problemas de acesso.