حقول الطلبات الاختيارية

عند ضبط الحقول الاختيارية في طلب بيانات من واجهة برمجة التطبيقات، عليك إنشاء عنصر رسالة الطلب مباشرةً وتمريره كمَعلمة request واحدة إلى طريقة الخدمة.

يتم حذف حقول الطلبات الاختيارية، مثل حقل validate_only في طريقة GoogleAdsService.Search، من توقيعات الطرق المبسّطة لإبقاء مَعلمات الكلمات الرئيسية قابلة للإدارة، لذا يجب ضبطها على مثيل رسالة الطلب مباشرةً.

لتحديد ما إذا كان حقل عنصر الطلب مطلوبًا أو اختياريًا، يُرجى الرجوع إلى تعريفات خدمة protobuf في Google Ads API والبحث عن الحقول التي تحتوي على التعليق التوضيحي [(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)