מכיוון ש-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