تم إيقاف إجراءات المحادثات نهائيًا في 13 حزيران (يونيو) 2023. لمزيد من المعلومات، يُرجى الاطّلاع على
إنهاء إجراءات المحادثة.
Method: projects.versions.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يسرد جميع الإصدارات وحالاتها الحالية.
طلب HTTP
GET https://actions.googleapis.com/v2/{parent=projects/*}/versions
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات |
parent |
string
مطلوب. تمثّل هذه السمة اسم المورد بالتنسيق projects/{project} . {project} هو رقم تعريف المشروع على السحابة الإلكترونية المرتبط بالمشروع.
|
معامِلات طلب البحث
المعلمات |
pageSize |
integer
الحد الأقصى لعدد الإصدارات المطلوب عرضها. قد تعرض الخدمة عددًا أقل من هذه القيمة. في حال عدم تحديده، سيتم عرض 50 نسخة كحدّ أقصى.
|
pageToken |
string
رمز مميّز للصفحة، تم تلقّيه من استدعاء سابق لتطبيق "versions.list ". يمكنك توفير هذا الحقل لاسترداد الصفحة التالية. عند التقسيم على صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى versions.list مع الاستدعاء الذي قدّم الرمز المميّز للصفحة.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
استجابة استدعاء إجراء عن بُعد لنُسخ البيانات
تمثيل JSON |
{
"versions": [
{
object (Version )
}
],
"nextPageToken": string
} |
الحقول |
versions[] |
object (Version )
قائمة بإصدارات رقم تعريف المشروع المحدّد.
|
nextPageToken |
string
رمز مميز يمكن إرساله على شكل pageToken لاسترداد الصفحة التالية. في حال إسقاط هذا الحقل، لن تظهر أي صفحات لاحقة.
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eLists all versions and their current states for a given project.\u003c/p\u003e\n"],["\u003cp\u003eAllows for pagination to retrieve large lists of versions.\u003c/p\u003e\n"],["\u003cp\u003eRequires an empty request body and provides a structured JSON response containing version details and a potential next-page token.\u003c/p\u003e\n"],["\u003cp\u003eUses gRPC Transcoding for URL structure and expects the project ID as a path parameter.\u003c/p\u003e\n"]]],["This document details how to list versions for a project using an HTTP GET request. The request URL uses gRPC Transcoding syntax and requires a `parent` path parameter in the format `projects/{project}`. Optional query parameters `pageSize` and `pageToken` control pagination. The request body must be empty. The response body, if successful, contains an array of `versions` and a `nextPageToken` for pagination. The `nextPageToken` if omitted indicates there are no more pages.\n"],null,["# Method: projects.versions.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListVersionsResponse.SCHEMA_REPRESENTATION)\n\nLists all versions and their current states.\n\n### HTTP request\n\n`GET https://actions.googleapis.com/v2/{parent=projects/*}/versions`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The name of the resource in the format `projects/{project}`. The `{project}` is the cloud project ID associated with the project. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of versions to return. The service may return fewer than this value. If unspecified, at most 50 versions will be returned. |\n| `pageToken` | `string` A page token, received from a previous `versions.list` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `versions.list` must match the call that provided the page token. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\nRPC response for listing versions\n\n| JSON representation ||\n|--------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"versions\": [ { object (/assistant/actions/api/reference/rest/v2/Version) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------------------------------------------------------|\n| `versions[]` | `object (`[Version](/assistant/actions/api/reference/rest/v2/Version)`)` List of the versions for the given project id. |\n| `nextPageToken` | `string` A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages. |"]]