מחכה עד שהפעולה השוטפת שנמשכת תסתיים או עד שתוביל לזמן קצוב לתפוגה, ותחזיר את המצב העדכני ביותר. אם הפעולה כבר בוצעה, הסטטוס האחרון יוחזר מיד. אם הזמן הקצוב לתפוגה שצוין ארוך מברירת המחדל של הזמן הקצוב לתפוגה של HTTP/RPC, המערכת משתמשת בזמן הקצוב לתפוגה של HTTP/RPC. אם השרת לא תומך בשיטה הזו, הוא מחזיר את הערך google.rpc.Code.UNIMPLEMENTED
. חשוב לשים לב שהשיטה הזו מבוססת על התוצאה הטובה ביותר. היא עשויה להחזיר את המצב האחרון לפני הזמן הקצוב לתפוגה שהוגדר (כולל באופן מיידי), כלומר אפילו תגובה מיידית לא מבטיחה שהפעולה תתבצע.
בקשת HTTP
POST https://adsdatahub.googleapis.com/v1/{name=operations/**}:wait
כתובת ה-URL כוללת תחביר gRPC קידוד מחדש.
פרמטרים של נתיב
פרמטרים | |
---|---|
name |
השם של משאב הפעולה שיש להמתין עליו. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "timeout": string } |
שדות | |
---|---|
timeout |
משך הזמן המקסימלי להמתנה לפני סיום הזמן הקצוב לתפוגה. אם משאירים את האפשרות הזו ריקה, ההמתנה תהיה לכל היותר מותרת על ידי פרוטוקול HTTP/RPC הבסיסי. אם מציינים גם תאריך יעד להקשר של הכנסה לקליק, המערכת תשתמש לזמן הקצר יותר. משך זמן בשניות עם עד 9 ספרות אחרי הנקודה העשרונית, המסתיים ב-' |
גוף התגובה
אם התגובה מוצלחת, גוף התגובה מכיל מופע של Operation
.
היקפי הרשאה
יש צורך בהיקף OAuth הבא:
https://www.googleapis.com/auth/adsdatahub