خطاهای غیرهم‌زمان

چون ExperimentService شامل چندین عملیات ناهمگام است، سازوکار واکشی خطاهای مربوط به این عملیات با عملیات همگام متفاوت است.

عملیات تحت‌تأثیر

عملیات ناهمگامی که از این سازوکار گزارش خطا استفاده می‌کنند عبارت‌اند از:

نحوه رسیدگی به خطاها در عملیات طولانی‌مدت

برای این روش‌ها، API یک عملیات طولانی‌مدت (google.longrunning.Operation) برمی‌گرداند که می‌توانید برای بررسی وضعیت اجرای ناهمگام، آن را نظرسنجی کنید. وقتی عملیات تکمیل می‌شود (done = true)، google.longrunning.Operation یا response (با google.protobuf.Empty درصورت موفقیت) یا error (با خلاصه google.rpc.Status درصورت وقوع خطاهای ناهمگام) را پر می‌کند.

اگر فهرست کامل خطاها مستقیماً در بار داده عملیات طولانی‌مدت برگردانده شود، درصورت توقف زودهنگام نظرسنجی ممکن است خطاها ازدست بروند و بار داده پاسخ ممکن است برای درخواست نظرسنجی بیش‌ازحد بزرگ شود. درعوض، فیلد error در عملیات طولانی‌مدت نشان می‌دهد که خطا رخ داده است و شما خطاهای دقیق Status را از نقطه پایانی صفحه‌بندی اختصاصی بازیابی می‌کنید.

واکشی خطاهای ناهمگام

برای بازیابی فهرست کامل خطاهای عملیات طولانی‌مدت آزمایش، ExperimentService.ListExperimentAsyncErrors را فراخوانی کنید. نام منبع آزمایش (resource_name) و یک page_size اختیاری را ارسال کنید، سپس بااستفاده از page_token، در ورودی‌های Status برگردانده‌شده صفحه‌بندی کنید، همان‌طور که برای هر درخواست فهرست Google Ads API دیگری انجام می‌دهید:

GET https://googleads.googleapis.com/v26/customers/CUSTOMER_ID/experiments/EXPERIMENT_ID:listExperimentAsyncErrors?pageSize=100