Method: customers.operations.wait

בהמתנה עד שהפעולה הממושכת שצוינה תסתיים או תגיע לכל היותר הזמן הקצוב לתפוגה שהוגדר, והחזרת המצב האחרון. אם הפעולה כבר בוצעה, המצב העדכני ביותר מוחזר באופן מיידי. אם הזמן הקצוב לתפוגה שצוין גדול מהזמן הקצוב לתפוגה שמוגדר כברירת מחדל ל-HTTP/RPC, ייעשה שימוש בזמן הקצוב לתפוגה של HTTP/RPC. אם השרת לא תומך בשיטה זו, הוא מחזיר google.rpc.Code.UNIMPLEMENTED. שימו לב: השיטה הזו היא על בסיס התוצאה הטובה ביותר. היא יכולה להחזיר את המצב העדכני לפני הזמן הקצוב לתפוגה שצוין (כולל באופן מיידי). כלומר, גם תגובה מיידית לא מבטיחה שהפעולה תתבצע.

בקשת HTTP

POST https://googleads.googleapis.com/v16/{name=customers/*/operations/*}:wait

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של נתיב

פרמטרים
name

string

השם של משאב הפעולה שצריך להמתין עליו.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "timeout": string
}
שדות
timeout

string (Duration format)

משך הזמן המקסימלי שצריך להמתין לפני סיום הזמן הקצוב לתפוגה. אם תשאירו את השדה ריק, ההמתנה תהיה לכל היותר פרק הזמן המותר על ידי פרוטוקול HTTP/RPC הבסיסי. אם צוין גם המועד האחרון בהקשר של RPC, ייעשה שימוש ביעד הקצר יותר.

משך זמן בשניות עם עד תשע ספרות עשרוניות, המסתיים ב-'s'. דוגמה: "3.5s".

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה מכיל מופע של Operation.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/adwords

למידע נוסף, עיינו בסקירה הכללית על OAuth 2.0.