Como começar

Use a API REST do Google Ad Manager para ler seus dados do Ad Manager e gerar relatórios.

Para ajudar você a começar, oferecemos uma biblioteca de cliente para Java com mais em breve. Para fazer sua primeira solicitação de API, siga as etapas abaixo.

Acessar uma rede do Ad Manager

Se você ainda não tiver uma, faça sua inscrição no Ad Manager do Compute Engine.

Ativar a API Ad Manager

Ative o API Ad Manager na sua projeto do Console de APIs do Google.

Autenticar

Todas as solicitações de API precisam ser autenticadas com o OAuth2.

As bibliotecas de cliente da API REST do Ad Manager leem as credenciais Application Default Credentials. Para definir usando variáveis de ambiente ou gcloud, siga estas instruções.

Conta de serviço

export GOOGLE_APPLICATION_CREDENTIALS=/path/to/keyfile.json

Credenciais do usuário

gcloud auth application-default login --scopes="https://www.googleapis.com/auth/admanager"
# End user credentials must specify the cloud project where the API is enabled.
gcloud auth application-default set-quota-project PROJECT_ID

Configurar a biblioteca de cliente

Java

Para o Maven:

<!-- pom.xml -->
<dependency>
   <groupId>com.google.api-ads</groupId>
   <artifactId>ad-manager</artifactId>
   <version>0.1.0</version>
</dependency>

Para Gradle:

implementation 'com.google.api-ads:ad-manager:0.1.0'

Python

Instale a biblioteca de cliente do PyPi.

pip install google-ads-admanager

Fazer sua primeira solicitação

Java

import com.google.ads.admanager.v1.GetNetworkRequest;
import com.google.ads.admanager.v1.Network;
import com.google.ads.admanager.v1.NetworkName;
import com.google.ads.admanager.v1.NetworkServiceClient;

public class SyncGetNetwork {

  public static void main(String[] args) throws Exception {
    syncGetNetwork();
  }

  public static void syncGetNetwork() throws Exception {
    try (NetworkServiceClient networkServiceClient = NetworkServiceClient.create()) {
      GetNetworkRequest request =
          GetNetworkRequest.newBuilder()
              .setName(NetworkName.of("[NETWORK_CODE]").toString())
              .build();
      Network response = networkServiceClient.getNetwork(request);
    }
  }
}

Confira mais exemplos no GitHub.

Python

from google.ads import admanager_v1


def sample_get_network():
    # Create a client
    client = admanager_v1.NetworkServiceClient()

    # Initialize request argument(s)
    request = admanager_v1.GetNetworkRequest(
        name="name_value",
    )

    # Make the request
    response = client.get_network(request=request)

    # Handle the response
    print(response)

Confira mais exemplos no GitHub.

cURL

curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
 https://admanager.googleapis.com/v1/networks/NETWORK_CODE