للانتظار حتى يتم الانتهاء من العملية المحددة طويلة الأمد أو حتى الوصول إلى مهلة محددة على الأكثر، مع عرض آخر حالة. إذا سبق واكتملت العملية، يتم عرض أحدث حالة على الفور. إذا كانت المهلة المحددة أكبر من مهلة HTTP/RPC التلقائية، فسيتم استخدام مهلة HTTP/RPC. إذا كان الخادم لا يتيح هذه الطريقة، سيعرض google.rpc.Code.UNIMPLEMENTED
. تجدر الإشارة إلى أنّ هذه الطريقة تبذل قصارى جهدها. وقد يتم عرض أحدث حالة قبل انتهاء المهلة المحددة (بما في ذلك على الفور)، ما يعني أنّ الاستجابة الفورية لا تضمن إتمام العملية.
طلب HTTP
POST https://googleads.googleapis.com/v17/{name=customers/*/operations/*}:wait
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
name |
اسم مورد العملية المطلوب الانتظار فيه. |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "timeout": string } |
الحقول | |
---|---|
timeout |
تمثّل هذه السمة الحد الأقصى لمدة الانتظار قبل انتهاء المهلة. إذا تم ترك هذا الحقل فارغًا، فسيكون الانتظار في معظم الأوقات التي يسمح بها بروتوكول HTTP/RPC الأساسي. في حال تحديد الموعد النهائي لسياق استدعاء إجراء عن بُعد (RPC) أيضًا، سيتم استخدام الموعد الأقصر. مدة بالثواني تضم تسعة أرقام كسور كحد أقصى وتنتهي بـ " |
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Operation
.
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/adwords
لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.