الأخطاء غير المتزامنة

بما أنّ 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/v25/customers/CUSTOMER_ID/experiments/EXPERIMENT_ID:listExperimentAsyncErrors?pageSize=100