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 ke project yang ada. Google memublikasikan artefak library klien ke PyPI sebagai google-ads-admanager.

pip install google-ads-admanager

Mengonfigurasi kredensial

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

ADC menelusuri 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 akan dilampirkan 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 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="networks/[NETWORK_CODE]",
    )

    # 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.

Membuat log permintaan dan respons HTTP

Library library klien Python menggunakan library logging Python standar untuk mencatat log permintaan dan respons HTTP. Secara default, logging dinonaktifkan.

Untuk mengaktifkan logging, tetapkan variabel lingkungan GOOGLE_SDK_PYTHON_LOGGING_SCOPE. Variabel lingkungan ini mengonfigurasi penanganan peristiwa logging di tingkat logging.DEBUG atau yang lebih tinggi.

# Log only Ad Manager API events
export GOOGLE_SDK_PYTHON_LOGGING_SCOPE=google.ads.admanager_v1

# Log all Google library events
export GOOGLE_SDK_PYTHON_LOGGING_SCOPE=google

Atau, Anda dapat menggunakan modul logging Python:

import logging

from google.ads import admanager_v1

logger = logging.getLogger("google.ads.admanager_v1")
logger.addHandler(logging.StreamHandler())
logger.setLevel(logging.DEBUG)

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.