إشعار: يجب
إثبات أهلية جميع المشاريع غير التجارية المسجّلة لاستخدام Earth Engine قبل
15 أبريل 2025 من أجل الحفاظ على إمكانية الوصول إلى Earth Engine.
Method: projects.operations.wait
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
ينتظر إلى أن تكتمل العملية المحدّدة التي تستغرق وقتًا طويلاً أو تصل إلى مهلة محدّدة كحد أقصى، مع عرض أحدث حالة. إذا سبق أن اكتملت العملية، يتم عرض الحالة الأخيرة على الفور. إذا كانت مهلة الانتظار المحدّدة أكبر من مهلة الانتظار التلقائية لبروتوكول HTTP/RPC، يتم استخدام مهلة الانتظار لبروتوكول HTTP/RPC. إذا لم يكن الخادم متوافقًا مع هذه الطريقة، يتم عرض google.rpc.Code.UNIMPLEMENTED. يُرجى العِلم أنّ هذه الطريقة تستند إلى أقصى الجهود المبذولة. وقد يعرض أحدث حالة قبل انتهاء مهلة الانتظار المحدّدة (بما في ذلك على الفور)، ما يعني أنّ الردّ الفوري لا يضمن اكتمال العملية.
طلب HTTP
POST https://earthengine.googleapis.com/v1beta/{name=projects/*/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/earthengine
https://www.googleapis.com/auth/cloud-platform
لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eWaits for a specified operation to complete or until a timeout is reached, returning the operation's latest state.\u003c/p\u003e\n"],["\u003cp\u003eUses HTTP/RPC timeout or the specified timeout, whichever is shorter, with a best-effort approach to provide the latest state.\u003c/p\u003e\n"],["\u003cp\u003eAccepts a timeout duration in the request body to customize the waiting period.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific OAuth scopes for authorization, such as \u003ccode\u003ehttps://www.googleapis.com/auth/earthengine\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eReturns the Operation details upon successful completion.\u003c/p\u003e\n"]]],["This API method waits for a long-running operation to complete or reach a specified timeout, returning the latest operation state. It uses the HTTP/RPC timeout if the specified timeout is longer. The `name` parameter identifies the operation resource. The request body can include a `timeout` field, formatted as a duration string. The method is best-effort and may return before the timeout. It uses POST method with gRPC Transcoding, and a successful response is an `Operation` object, requiring specific OAuth scopes for authorization.\n"],null,["# Method: projects.operations.wait\n\nWaits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.\n\n### HTTP request\n\n`POST https://earthengine.googleapis.com/v1beta/{name=projects/*/operations/**}:wait`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|---------------------------------------------------------|\n| `name` | `string` The name of the operation resource to wait on. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------|\n| ``` { \"timeout\": string } ``` |\n\n| Fields ||\n|-----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `timeout` | `string (`[Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration)` format)` The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used. A duration in seconds with up to nine fractional digits, ending with '`s`'. Example: `\"3.5s\"`. |\n\n### Response body\n\nIf successful, the response body contains an instance of [Operation](/earth-engine/reference/rest/Shared.Types/ListOperationsResponse#Operation).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/earthengine`\n- `\n https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
