Bir API isteğinde seçenekler alanlarını ayarlarken istek mesajı nesnesini doğrudan oluşturmanız ve hizmet yöntemine tek bir request parametresi olarak iletmeniz gerekir.
GoogleAdsService.Search yöntemindeki validate_only alanı gibi isteğe bağlı istek alanları, anahtar kelime parametrelerini yönetilebilir tutmak için düzleştirilmiş yöntem imzalarından çıkarılır. Bu nedenle, bunları doğrudan istek mesajı örneğinde ayarlamanız gerekir.
Bir istek nesnesi alanının zorunlu mu yoksa isteğe bağlı mı olduğunu belirlemek için Google Ads API protobuf hizmet tanımlarına bakın ve [(google.api.field_behavior) = REQUIRED] ek açıklamasını içeren alanları arayın.
Bu ek açıklamanın bulunmadığı alanlar isteğe bağlıdır.
Aşağıdaki örnekte bir SearchGoogleAdsRequest nesnesi oluşturulur ve GoogleAdsService.Search isteğinde isteğe bağlı validate_only alanı ayarlanır:
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)