Tiêu đề của yêu cầu (không bắt buộc)

Khi sử dụng bất kỳ trường không bắt buộc nào trong một phương thức yêu cầu, thông báo yêu cầu phải được tạo bên ngoài phương thức đó và được chuyển vào dưới dạng một thông số duy nhất.

Các tiêu đề của yêu cầu không bắt buộc, ví dụ: tiêu đề page_sizevalidate_only trong phương thức GoogleAdsService.Search, không xuất hiện trong chữ ký phương thức dưới dạng tham số từ khoá. Vì vậy, các tiêu đề này phải được đặt trực tiếp trên thông báo yêu cầu.

Để xác định xem trường đối tượng yêu cầu là bắt buộc hay không bắt buộc, bạn có thể tham chiếu các định nghĩa protobuf cho dịch vụ và tìm các trường chứa chú giải [(google.api.field_behavior) = REQUIRED].

Dưới đây là ví dụ đặt các trường page_sizevalidate_only không bắt buộc trong yêu cầu GoogleAdsService.Search:

request = client.get_type("SearchGoogleAdsRequest")
request.customer_id = customer_id
request.query = query
request.page_size = 10000
request.validate_only = True

response = googleads_service.search(request=request)