Guia de instruções

Nesta página, você encontra detalhes sobre como realizar tarefas comuns usando a API.

Como criar usuários

O UserService permite que um usuário com direitos de administrador crie um usuário diretamente na rede dele. Qualquer desenvolvedor pode fazer isso fazer com que o novo usuário se inscreva primeiro. Por exemplo, se você estiver testando a API para pela primeira vez, em vez de realizar cada chamada de API como administrador (o padrão para seu endereço de e-mail), convém criar alguns usuários com funções como vendedor, coordenador de publicidade ou anunciante para testar fluxos de trabalho reais.

  1. Crie alguns novos endereços do Gmail, como my.name.salesperson@gmail.com. Como alternativa, registre um endereço existente que não seja do Gmail como um novo Conta do Google.
  2. Chame createUsers com esse novo endereço e o Role escolhido.
  3. Você pode fazer a autenticação como esse novo usuário utilizando o OAuth 2.0 para gerar seu token de acesso.

Como buscar o bloco de anúncios raiz

Os AdUnit superiores aos quais é possível adicionar nós filhos e a profundidade permitida da hierarquia dependem do tipo de conta (Small Business ou Premium). A AdUnit superior que oferece suporte à modificação dos nós filhos é chamada de AdUnit raiz efetiva.

Para recuperar a raiz efetiva, chame NetworkService.getCurrentNetwork() e examine o campo effectiveRootAdUnitId no objeto Network retornado.

Observação:diferentes tipos de conta oferecem suporte a diferentes padrões hierárquicos.

Como consultar um objeto

Pesquise objetos pelos critérios de pesquisa usando o método getObjectsByStatement() exposto por muitos serviços, onde Object é um tipo de objeto específico. Isso método usa uma consulta PQL, que é similar a uma consulta SQL, pois permite especificar campos para pesquisar (onde os nomes dos campos mapeiam para propriedades no objeto), classificar, limitar e desviar os resultados da pesquisa. Consulte a PQL PQL para saber mais sobre PQL e em quais campos do objeto é possível filtrar.

Como criar um pedido

Para criar um pedido, crie um objeto Order e defina o anunciante, vendedor e coordenador de publicidade aos usuários apropriados, atribuir um nome exclusivo, e chamar createOrders(). O resultado vai incluir a Order recém-criada, ou um erro.

Exemplo

Veja o exemplo de código Java para criar um pedido.

Como criar um item de linha

Siga estas etapas para criar um novo item de linha:

  1. Crie um novo objeto Order ou use um existente.
  2. Crie um novo objeto LineItem e defina o tipo de rotação, a matriz do tamanho do criativo datas de início e término e outras propriedades.
  3. Crie um novo objeto InventoryTargeting e especifique quais objetos Placement ou AdUnit segmentar ou excluir.
  4. Una seu objeto InventoryTargeting dentro de um novo objeto Targeting e atribua à propriedade de segmentação do LineItem.
  5. Chame o método de serviço createLineItems() do item de linha com o novo objeto e examine o resultado para ver se esse objeto foi criado.

Exemplo

Veja um exemplo de código Java para criar um item de linha.

Como gerar um criativo

Diferentes tipos de criativos oferecem suporte a diferentes componentes: por exemplo, uma imagem o criativo aceita um único arquivo de origem para a imagem. que um criativo em Flash suporta dois arquivos de ativos subjacentes: um arquivo flash e um arquivo de imagem de backup, caso o arquivo não pode ser exibido. No caso de criativos hospedados em sites de terceiros, você fará o upload somente um snippet HTML que faça referência ao arquivo no servidor de terceiros. Consulte seu específica do Creative para saber quais recursos devem ser enviados por upload para gerar seu criativo.

Exemplo

Veja um exemplo de código Java para gerar um criativo de imagem.

Como modificar um objeto

Para modificar um objeto atual, consulte seu objeto chamando getObjectsByStatement(). atualize os valores nos objetos retornados e, em seguida, chame updateObjects().

Observação: os objetos atualizados substituirão completamente os objetos existentes. Portanto, se você deixar de definir um valor de propriedade no objeto enviado, o objeto salvo obter o valor padrão dessa propriedade, não o valor anterior.

Como alterar o status do objeto

O status do objeto é alterado chamando o método performObjectAction() expostas pelo seu serviço. Esse método usa dois parâmetros:

  • Uma instância do objeto de ação que descreve o que você quer fazer. Para exemplo, o serviço de pedido expõe várias ações, incluindo ApproveOrders, PauseOrders, e ArchiveOrders. Todos os objetos de ação derivam de uma apropriada para seu serviço.
  • Uma consulta PQL que descreve quais objetos mudar. É possível mudar o status de um ou mais objetos ao mesmo tempo especificando um objeto PQL .

Como gerar tags de anúncio

Não é possível gerar tags de anúncio usando a API. use o site do Google Ad Manager. Consulte a página da Central de Ajuda para mais informações.

Mais exemplos

Há muito mais exemplos de código na nossa biblioteca cliente, em vários linguagens de programação diferentes. Consulte as Bibliotecas de cliente e Exemplo de código para acessar um link com exemplos da sua linguagem de programação.