Primeiros passos com a biblioteca de cliente PHP

Para começar a usar as APIs do Google Fotos com a biblioteca de cliente PHP, você precisará configure a biblioteca de cliente no seu ambiente de desenvolvimento. Antes de fazer isso, ative a API para configurar seu projeto. 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 do Google Fotos. Por exemplo, quando você cria álbuns no ou fazer upload de itens de mídia para a biblioteca do Google Fotos conta do Google Fotos, o usuário autoriza essas solicitações de API por meio do protocolo OAuth 2.0.

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

Configurar o app

Ativar a API

Antes de usar as APIs do Google Fotos, é necessário ativá-las para o 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 a Biblioteca de APIs do Google, no menu de navegação, selecione APIs e serviços > Biblioteca.
  4. Pesquise "APIs do Google Fotos". Selecione o resultado correto e clique em Ativar.

Solicitar um ID do cliente OAuth 2.0

Siga as etapas abaixo para solicitar um ID de cliente OAuth e configurá-lo para seu app. Este exemplo usa um aplicativo no qual todo o fluxo OAuth está do lado do servidor, como o de 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 de aplicativo é Aplicativo da Web.

  5. Registre as origens em que o app tem permissão para 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 seu app. Este 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

    3. O campo URI de redirecionamento autorizado é o endpoint que recebe do servidor OAuth 2.0. Normalmente, isso inclui o ambiente de desenvolvimento e aponta para um caminho no aplicativo.

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

    4. Clique em Criar.

  1. Na caixa de diálogo do cliente OAuth resultante, faça o download do arquivo JSON que contém a configuração do cliente. Os detalhes do cliente consistem nos seguintes elementos:

    • ID do cliente
    • Chave secreta do cliente

    Esse arquivo JSON será usado mais tarde para configurar a biblioteca do Google Auth para PHP, que funciona com essa biblioteca de cliente.

Antes de lançar um aplicativo público que acesse as APIs Photos, seu app precisa ser revisado pelo Google. Uma mensagem "App não verificado" vai aparecer na tela quando você testar o aplicativo, até que ele seja verificado.

Configure a biblioteca de cliente.

A biblioteca de cliente do PHP processa todas as chamadas de API de back-end para você e expõe objetos amigáveis para trabalhar, incluindo exemplos de código para algumas tarefas comuns de API. Primeiro, faça o download e instale a biblioteca de cliente das APIs do Google Fotos para PHP com as dependências do GitHub. Em seguida, configure suas credenciais do OAuth2 para PHP.

Opções de download

Use o composer para incluir a biblioteca como uma dependência no ambiente de desenvolvimento. Execute o comando a seguir para adicionar a biblioteca à configuração do seu projeto e fazer o download para o diretório vendor/.

composer require google/photos-library

Você também pode clonar o repositório ou fazer o download de um tarball compactado.

Configurar as credenciais do OAuth2 para PHP

Essa biblioteca de cliente funciona com a Biblioteca do Google Auth para PHP (em inglês). Para mais informações, consulte Uso do OAuth 2.0 com a biblioteca de cliente de APIs do Google para PHP.

Usar as credenciais de autenticação retornadas pela biblioteca de autenticação ao configurar o PhotosLibraryClient.

Testar algumas amostras

Use o código abaixo para fazer sua primeira chamada de API usando a biblioteca de cliente PHP.

use Google\Auth\Credentials\UserRefreshCredentials;
use Google\Photos\Library\V1\PhotosLibraryClient;
use Google\Photos\Library\V1\PhotosLibraryResourceFactory;

try {
    // Use the OAuth flow provided by the Google API Client Auth library
    // to authenticate users. See the file /src/common/common.php in the samples for a complete
    // authentication example.
    $authCredentials = new UserRefreshCredentials( /* Add your scope, client secret and refresh token here */ );

    // Set up the Photos Library Client that interacts with the API
    $photosLibraryClient = new PhotosLibraryClient(['credentials' => $authCredentials]);

    // Create a new Album object with at title
    $newAlbum = PhotosLibraryResourceFactory::album("My Album");

    // Make the call to the Library API to create the new album
    $createdAlbum = $photosLibraryClient->createAlbum($newAlbum);

    // The creation call returns the ID of the new album
    $albumId = $createdAlbum->getId();
} catch (\Google\ApiCore\ApiException $exception) {
    // Error during album creation
} catch (\Google\ApiCore\ValidationException $e) {
    // Error during client creation
    echo $exception;
}

Há mais amostras no GitHub para você testar.