Khi đặt các trường không bắt buộc trong một yêu cầu API, bạn phải trực tiếp tạo đối tượng thông báo yêu cầu và truyền đối tượng đó dưới dạng một tham số request duy nhất cho phương thức dịch vụ.
Các trường yêu cầu không bắt buộc (chẳng hạn như trường validate_only trong phương thức GoogleAdsService.Search) sẽ bị bỏ qua trong các chữ ký phương thức được rút gọn để giữ cho các tham số từ khoá có thể quản lý được, vì vậy, bạn phải đặt các trường này trực tiếp trên thực thể thông báo yêu cầu.
Để xác định xem một trường đối tượng yêu cầu là bắt buộc hay không bắt buộc, hãy tham khảo định nghĩa dịch vụ protobuf của Google Ads API và tìm các trường chứa chú thích [(google.api.field_behavior) = REQUIRED].
Các trường không có chú thích này là không bắt buộc.
Ví dụ sau đây tạo một đối tượng SearchGoogleAdsRequest và đặt trường validate_only không bắt buộc trong yêu cầu 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)