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:

Cómo obtener 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 deben autenticarse con OAuth2.

Las bibliotecas cliente de la API de Ad Manager leen credenciales de las credenciales predeterminadas de la aplicación. Puedes configurarlos con 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);
    }
  }
}

Puedes encontrar más ejemplos en GitHub. Para obtener más información sobre las bibliotecas 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)

Puedes encontrar más ejemplos en GitHub. Para obtener más información 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);
        }
    }

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