Antes de começar a codificar seu primeiro aplicativo cliente, há algumas coisas que você precisa fazer, se ainda não tiver feito.
Criar uma Conta do Google
É necessário ter uma Conta do Google para criar um projeto no Console de APIs do Google. Se você já tem uma conta, então está tudo pronto.
Para fins de teste, utilize uma Conta do Google separada.
Teste o Relatório de experiências do anúncio do Google
Para esta documentação da API, pressupomos que você tenha usado o Relatório de experiências do anúncio do Google e que esteja familiarizado com os conceitos de programação e formatos de dados da Web.
Se você ainda não usou o relatório da experiência do anúncio do Google, teste a interface do usuário antes de começar a programar.
Criar um projeto para o cliente
Antes de enviar solicitações ao Relatório de experiências do anúncio do Google, você precisa informar o Google sobre seu cliente e ativar o acesso à API. Para fazer isso, use o Console de APIs do Google e crie um projeto, que é uma coleção nomeada de configurações e informações de acesso à API, e registre seu aplicativo.
Conhecer os fundamentos de REST
Há duas maneiras de invocar a API:
- Enviar solicitações HTTP e analisar as respostas.
- Usar bibliotecas de cliente.
Se você não quer usar as bibliotecas de cliente, precisa entender os fundamentos da REST.
O REST é um estilo de arquitetura de software que fornece uma abordagem conveniente e consistente para solicitar e modificar dados.
O termo REST é a sigla de "Representational State Transfer". No contexto das APIs do Google, ele se refere ao uso de verbos HTTP para recuperar e modificar representações de dados armazenados pelo Google.
Em um sistema RESTful, os recursos são mantidos em um armazenamento de dados. Um cliente envia uma solicitação para que uma ação específica seja executada no servidor, como a criação, recuperação, atualização ou exclusão de um recurso. Essa ação é executada e uma resposta é enviada, geralmente no formato de uma representação do recurso especificado.
Nas APIs RESTful do Google, o cliente especifica uma ação usando um verbo HTTP, como POST, GET, PUT ou DELETE. Ele especifica um recurso por um URI globalmente exclusivo no seguinte formato:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
Como todos os recursos da API têm URIs exclusivos acessíveis por HTTP, a REST permite o armazenamento em cache dos dados e é otimizada para funcionar na infraestrutura distribuída da Web.
As definições de método (em inglês) encontradas na documentação dos padrões HTTP 1.1 podem ser úteis. Nelas estão incluídas as especificações GET, POST, PUT e DELETE.
REST na API Google Ad Experience Report
As operações da API Google Ad Experience Report são mapeadas diretamente para verbos HTTP REST.
Os formatos específicos dos URIs da API Google Ad Experience Report são:
https://adexperiencereport.googleapis.com/v1/resourcePath?parameters
O conjunto completo de URIs usados em cada operação compatível na API é resumido no documento Referência da API do Relatório de experiências do anúncio do Google.
Conhecer os fundamentos do JSON
A API Google Ad Experience Report retorna dados no formato JSON.
JSON (JavaScript Object Notation) é um formato de dados comum e independente de linguagem que oferece uma representação de texto simples das estruturas de dados arbitrárias. Para mais informações, acesse json.org (em inglês).