Memulai

Gunakan Google Ad Manager API (Beta) untuk membaca data Ad Manager dan menjalankan laporan.

Untuk membuat permintaan API pertama Anda, selesaikan langkah-langkah berikut:

Mendapatkan akses ke jaringan Ad Manager

Jika Anda belum memilikinya, daftar ke akun Ad Manager.

Mengaktifkan Ad Manager API

Aktifkan Ad Manager API di Project Konsol API Google Anda.

Autentikasikan

Semua permintaan API harus diautentikasi menggunakan OAuth2.

Library klien Ad Manager API membaca kredensial dari Kredensial Default Aplikasi. Anda dapat menetapkannya menggunakan variabel lingkungan atau gcloud.

Akun Layanan

Linux atau macOS

export GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

Windows

set GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

Kredensial pengguna

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

Untuk informasi selengkapnya tentang cara memilih jenis kredensial dan membuat kredensial, lihat panduan autentikasi.

Menyiapkan library klien

Java

Untuk Maven:

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

Untuk Gradle:

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

Python

Instal library klien dari PyPi.

pip install google-ads-admanager

.NET

Instal library klien dari NuGet.

Dari .NET CLI:

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

Sebagai referensi paket:

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

Membuat permintaan pertama Anda

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);
    }
  }
}

Contoh lainnya dapat ditemukan di GitHub. Untuk mengetahui informasi library klien tambahan, lihat panduan 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)

Contoh lainnya dapat ditemukan di GitHub. Untuk informasi library klien tambahan, lihat panduan 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);
        }
    }

Contoh lainnya dapat ditemukan di GitHub. Untuk mengetahui informasi library klien tambahan, lihat panduan.NET.

cURL

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