Cómo comenzar

Utiliza la API de Google Ad Manager (beta) para leer tus datos de Ad Manager y ejecutar informes.

Para realizar tu primera solicitud a la API, completa los siguientes pasos:

Obtén acceso a una red de Ad Manager

Si aún no tienes una, regístrate para obtener una cuenta de Ad Manager.

Habilita la API de Ad Manager

Habilita la API de Ad Manager en tu proyecto de la Consola de APIs de Google.

Autenticar

Todas las solicitudes a la API se deben autenticar con OAuth2.

Las bibliotecas cliente de la API de Ad Manager leen las credenciales de la credencial predeterminada de la aplicación. Puedes configurarlas mediante variables de entorno o gcloud.

Cuenta de servicio

Linux o macOS

export GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

Windows

set GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

Credenciales de usuario 

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

Para obtener más información sobre cómo elegir y crear tipos de credenciales, consulta la guía de autenticación.

Configura tu biblioteca cliente

Java

Para 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

Instala la biblioteca cliente desde PyPi.

pip install google-ads-admanager

.NET

Instala la biblioteca cliente desde NuGet.

Desde la CLI de .NET:

dotnet add package Google.Ads.AdManager.V1 --version 1.0.0-beta01

Como referencia del paquete:

<PackageReference Include="Google.Ads.AdManager.V1" Version="1.0.0-beta01" />

Realiza tu primera solicitud

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);
    }
  }
}
SyncGetNetwork.java

Puedes encontrar más ejemplos en GitHub. Para obtener información adicional sobre la biblioteca cliente, consulta la guía de Java.

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)
admanager_v1_generated_network_service_get_network_sync.py

Puedes encontrar más ejemplos en GitHub. Para obtener información adicional sobre la biblioteca cliente, consulta la guía de Python.

.NET 

    using Google.Ads.AdManager.V1;

    public sealed partial class GeneratedNetworkServiceClientSnippets
    {
        public void GetNetwork()
        {
            // Create client
            NetworkServiceClient networkServiceClient = NetworkServiceClient.Create();
            // Initialize request argument(s)
            string name = "networks/[NETWORK_CODE]";
            // Make the request
            Network response = networkServiceClient.GetNetwork(name);
        }
    }
NetworkServiceClient.GetNetworkSnippet.g.cs

Puedes encontrar más ejemplos en GitHub. Para obtener más información sobre las bibliotecas cliente, consulta la guía de .NET.

cURL 

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