Method: customers.operations.wait

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

בקשת HTTP

POST https://googleads.googleapis.com/v15/{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.