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

عند ضبط الحقول الاختيارية في طلب بيانات من واجهة برمجة التطبيقات، عليك إنشاء عنصر رسالة الطلب مباشرةً وتمريره كمَعلمة 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)