Saat menetapkan bidang Options pada permintaan API, Anda harus membuat objek pesan permintaan secara langsung dan meneruskannya sebagai satu request parameter ke metode layanan.
Kolom permintaan opsional—seperti kolom
validate_only dalam
metode GoogleAdsService.Search
dihapus dari tanda tangan metode yang diratakan agar parameter kata kunci
tetap mudah dikelola, sehingga Anda harus menetapkannya langsung pada instance pesan permintaan.
Untuk menentukan apakah kolom objek permintaan wajib atau opsional, lihat
definisi layanan protobuf Google Ads API dan cari
kolom yang berisi anotasi [(google.api.field_behavior) = REQUIRED].
Kolom tanpa anotasi ini bersifat opsional.
Contoh berikut membuat objek SearchGoogleAdsRequest dan menetapkan kolom validate_only opsional pada permintaan GoogleAdsService.Search:
from google.ads.googleads.client import GoogleAdsClient
client = GoogleAdsClient.load_from_storage()
googleads_service = client.get_service("GoogleAdsService")
# Initialize the request object and set required fields.
request = client.get_type("SearchGoogleAdsRequest")
request.customer_id = customer_id
request.query = query
# Set the optional validate_only field.
request.validate_only = True
response = googleads_service.search(request=request)