שגיאות אסינכרוניות

מכיוון ש-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/v25/customers/CUSTOMER_ID/experiments/EXPERIMENT_ID:listExperimentAsyncErrors?pageSize=100