Method: customers.operations.wait

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

בקשת HTTP

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