מכיוון ש-ExperimentService כולל כמה פעולות אסינכרוניות, המנגנון לאחזור שגיאות שקשורות לפעולות האלה שונה מפעולות סינכרוניות.
פעולות מושפעות
הפעולות האסינכרוניות שמשתמשות במנגנון הזה לדיווח על שגיאות הן:
איך מטפלים בשגיאות בפעולות ממושכות
בשיטות האלה, ה-API מחזיר פעולה ממושכת (google.longrunning.Operation) שאפשר לדגום כדי לבדוק את סטטוס הביצוע האסינכרוני. כשהפעולה מסתיימת (done = true), השדה google.longrunning.Operation מאוכלס ב-response (עם google.protobuf.Empty אם הפעולה הצליחה) או ב-error (עם סיכום של google.rpc.Status אם היו שגיאות אסינכרוניות).
אם הרשימה המלאה של השגיאות הייתה מוחזרת ישירות במטען הייעודי (payload) של הפעולה הממושכת, יכול להיות שהייתם מפספסים שגיאות אם הדגימה הייתה נפסקת מוקדם מדי, והמטען הייעודי של התגובה היה יכול להיות גדול מדי לבקשת דגימה. במקום זאת, השדה 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