선택적 요청 필드

API 요청에서 옵션 필드를 설정할 때는 요청 메시지 객체를 직접 구성하고 서비스 메서드에 단일 request 매개변수로 전달해야 합니다.

validate_only 메서드의 GoogleAdsService.Search 필드와 같은 선택적 요청 필드는 키워드 매개변수를 관리하기 위해 평면화된 메서드 서명에서 생략되므로 요청 메시지 인스턴스에서 직접 설정해야 합니다.

요청 객체 필드가 필수인지 선택사항인지 확인하려면 Google Ads API protobuf 서비스 정의를 참조하고 주석 [(google.api.field_behavior) = REQUIRED]이 포함된 필드를 찾으세요. 이 주석이 없는 필드는 선택사항입니다.

다음 예시에서는 SearchGoogleAdsRequest 객체를 구성하고 선택적 validate_only 필드를 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)