Python

Google menyediakan library klien Python untuk berinteraksi dengan Ad Manager API. Sebaiknya gunakan library klien dengan PyPI.

Untuk memulai, buat project baru di IDE pilihan Anda atau tambahkan dependensi terhadap project yang ada. Google memublikasikan artefak library klien PyPI sebagai google-ads-admanager.

pip install google-ads-admanager

Mengonfigurasi kredensial

Library klien Python menggunakan OAuth2 dan Kredensial Default Aplikasi (ADC) untuk mengautentikasi.

ADC mencari kredensial secara berurutan di lokasi berikut:

  1. Variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS.
  2. Kredensial pengguna yang disiapkan melalui Google Cloud CLI (gcloud CLI).
  3. Saat berjalan di Google Cloud, akun layanan dikaitkan ke resource Google Cloud.

Untuk membuat dan mengonfigurasi kredensial ADC, lihat Autentikasi.

Membuat permintaan pertama Anda

Setiap layanan memiliki objek ServiceClient dengan metode sinkron dan asinkron yang berbeda untuk setiap metode REST. Contoh berikut membaca Network secara sinkron.

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

Untuk contoh metode dan resource lainnya, lihat repositori GitHub googleapis/google-cloud-python

Menangani error

Semua error API memperluas class dasar GoogleAPIError.

Kolom alasan error mengidentifikasi jenis error secara unik. Gunakan kolom ini untuk menentukan cara menangani error.

try:
  network = client.get_network(request=request)
  print(network)
except GoogleAPIError as e:
  # Handle error
  print(e.reason)

Error Ad Manager API juga menyertakan requestId unik yang dapat Anda berikan ke dukungan untuk mendapatkan bantuan dalam memecahkan masalah. Contoh berikut mengekstrak requestId dari GoogleAPIError;

except GoogleAPIError as e:
  requestInfoType = "type.googleapis.com/google.rpc.RequestInfo"
  requestInfo = [detail for detail in e.details if detail['@type'] == requestInfoType][0]
  print(requestInfo['requestId'])

Mengonfigurasi setelan proxy

Library klien Python mengikuti setelan variabel lingkungan http_proxy dan https_proxy.