بما أنّ ExperimentService يتضمّن عدّة عمليات غير متزامنة، تختلف آلية جلب الأخطاء المتعلّقة بهذه العمليات عن العمليات المتزامنة.
العمليات المتأثرة
العمليات غير المتزامنة التي تستخدم آلية الإبلاغ عن الأخطاء هذه هي:
كيفية تعامل العمليات الطويلة الأمد مع الأخطاء
بالنسبة إلى هذه الطرق، تعرض واجهة برمجة التطبيقات عملية طويلة
(google.longrunning.Operation) يمكنك التحقّق منها لمعرفة حالة
التنفيذ غير المتزامن. عند اكتمال العملية (done = true)،
تُعبئ google.longrunning.Operation إما response (باستخدام
google.protobuf.Empty في حال نجاح العملية) أو error (باستخدام ملخّص google.rpc.Status
في حال حدوث أي أخطاء غير متزامنة).
إذا تم عرض قائمة الأخطاء الكاملة مباشرةً في حمولة العملية الطويلة، قد يتم تفويت الأخطاء إذا توقّف الاستطلاع مبكرًا، وقد تصبح حمولة الاستجابة كبيرة جدًا بالنسبة إلى طلب الاستطلاع. بدلاً من ذلك، يشير الحقل error في العملية الطويلة إلى حدوث أخطاء، ويمكنك استرداد أخطاء Status التفصيلية من نقطة نهاية مخصّصة لتقسيم الصفحات.
جلب الأخطاء غير المتزامنة
لاسترداد القائمة الكاملة بالأخطاء في عملية طويلة الأمد لتجربة ما، اتّصِل بالدالة ExperimentService.ListExperimentAsyncErrors.
مرِّر اسم مورد التجربة (resource_name) وpage_size اختياريًا، ثم انتقِل بين صفحات إدخالات Status التي تم عرضها باستخدام page_token كما تفعل مع أي طلب قائمة آخر في Google Ads API:
GET https://googleads.googleapis.com/v26/customers/CUSTOMER_ID/experiments/EXPERIMENT_ID:listExperimentAsyncErrors?pageSize=100