Visão geral da interface REST

Importante: recomendamos usar nossas bibliotecas de cliente oficiais sempre que possível. Todas as bibliotecas de cliente fornecidas pelo Google são implementadas usando gRPC, exceto a biblioteca Perl, que usa a interface REST. A menos que você esteja procurando especificamente detalhes sobre REST, consulte a documentação de referência para detalhes que abrangem nossas bibliotecas de cliente oficiais e a camada de transporte REST.

Observação: se você não conhece a API Google Ads, recomendamos ler primeiro o guia Primeiros passos, que aborda como configurar sua conta e fazer sua primeira chamada de API. Siga a guia curl.

A API Google Ads pode ser chamada usando gRPC ou REST. As duas interfaces expõem um design orientado a recursos compartilhado com outras APIs do Google Cloud.

Recomendamos usar as bibliotecas de cliente oficiais do Google sempre que possível. Elas fornecem código idiomático e com segurança de tipos em cada linguagem compatível e processam muitos detalhes de baixo nível da comunicação com a API, como configurações de tempo limite, paginação do conjunto de resultados e autenticação. Nossas bibliotecas de cliente também incluem um conjunto abrangente de exemplos de código e utilitários que ajudam em tarefas comuns, como a criação de nomes de recursos e o processamento de máscaras de campo.

Este guia apresenta detalhes específicos do REST e explica o que você precisa saber para chamar a interface REST diretamente, sem o uso de uma biblioteca de cliente compatível com o Google. Este guia pode ser útil se você estiver escrevendo seu próprio código personalizado para usar a REST diretamente ou uma biblioteca de cliente HTTP de terceiros.