מתחיל ביטול אסינכרוני בפעולה ממושכת. השרת פועל כמיטב יכולתו כדי לבטל את הפעולה, אך ההצלחה אינה מובטחת. אם השרת לא תומך בשיטה הזו, הוא מחזיר את הערך google.rpc.Code.UNIMPLEMENTED
. הלקוחות יכולים להשתמש ב-Operations.GetOperation
או בשיטות אחרות כדי לבדוק אם הביטול הצליח או אם הפעולה הושלמה למרות הביטול. כאשר הביטול מתבצע בהצלחה, הפעולה לא נמחקת. במקום זאת, היא הופכת לפעולה עם ערך Operation.error
עם google.rpc.Status.code
מסוג 1, שתואמת ל-Code.CANCELLED
.
בקשת HTTP
POST https://adsdatahub.googleapis.com/v1/{name=operations/**}:cancel
כתובת ה-URL כוללת תחביר gRPC קידוד מחדש.
פרמטרים של נתיב
פרמטרים | |
---|---|
name |
השם של משאב הפעולה לביטול. |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התגובה
אם התגובה מוצלחת, גוף התגובה ריק.
היקפי הרשאה
יש צורך בהיקף OAuth הבא:
https://www.googleapis.com/auth/adsdatahub