Pré-requisitos

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

Você precisa de 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 a Google AdMob

Para esta documentação da API, pressupomos que você já tenha usado o Google AdMob e conheça os conceitos de programação e formatos de dados da Web.

Se você ainda não usou a AdMob, teste a interface do usuário antes de começar a codificar.

Criar um projeto para o cliente

Antes de enviar solicitações à Google AdMob, informe o Google sobre seu cliente e ative o acesso à API. Faça isso usando o Console de APIs do Google para criar um projeto, que é uma coleção nomeada de configurações e informações de acesso à API, e registre seu aplicativo.

Para começar a usar a API AdMob, primeiro use a ferramenta de configuração, que orienta você na criação de um projeto no console de APIs do Google e na ativação da API.

Aprender os fundamentos da REST

REST é um estilo de arquitetura de software que fornece uma abordagem conveniente e consistente para solicitar e modificar dados.

O termo REST é a abreviação de "Representational State Transfer (Transferência de Estado Representacional)". 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, uma ação é especificada no cliente usando um verbo HTTP como POST, GET, PUT ou DELETE. Um recurso é definido por meio de um URI global 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 AdMob

As operações da API AdMob são mapeadas diretamente para os verbos HTTP REST.

Os formatos específicos para os URIs da API AdMob são:

https://admob.googleapis.com/v1/resourcePath?parameters

O conjunto completo de URIs usados para cada operação compatível na API está resumido no documento de referência da API AdMob.

Conhecer os fundamentos do JSON

A API AdMob 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).