عند استخدام أي حقول اختيارية في طريقة الطلب، يجب إنشاء رسالة الطلب خارج الطريقة وتمريرها كمَعلمة واحدة.
عناوين الطلبات الاختيارية، على سبيل المثال، عناوين
page_size
وvalidate_only في
طريقة GoogleAdsService.Search،
غير متوفرة في توقيع الطريقة كمَعلمات كلمات رئيسية، لذا يجب ضبطها في رسالة الطلب مباشرةً.
لتحديد ما إذا كان حقل كائن الطلب مطلوبًا أو اختياريًا، يمكنك الرجوع إلى تعريفات protobuf للخدمات والبحث عن الحقول التي تحتوي على التعليق التوضيحي [(google.api.field_behavior) =
REQUIRED].
في ما يلي مثال يحدّد الحقلَين page_size وvalidate_only الاختياريين في طلب 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)