Method: projects.versions.create
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تنشئ نسخة جديدة غير قابلة للتغيير باستخدام الرمز الحالي، مع رقم إصدار فريد.
طلب HTTP
POST https://script.googleapis.com/v1/projects/{scriptId}/versions
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
scriptId |
string
رقم تعريف Drive لمشروع النص البرمجي
|
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
| تمثيل JSON |
{
"versionNumber": integer,
"description": string,
"createTime": string
} |
| الحقول |
versionNumber |
integer
رقم التعريف التزايدي الذي يتم إنشاؤه من خلال "برمجة التطبيقات" عند إنشاء إصدار يتم تعيين هذا الرقم بواسطة النظام وهو غير قابل للتغيير بعد إنشائه.
|
description |
string
تمثّل هذه السمة الوصف لهذا الإصدار.
|
createTime |
string (Timestamp format)
وقت إنشاء النسخة طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
|
نص الاستجابة
في حال نجاح الإجراء، يحتوي نص الاستجابة على مثيل Version تم إنشاؤه حديثًا.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/script.projects
لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eCreates a new immutable version of a script with a unique version number.\u003c/p\u003e\n"],["\u003cp\u003eRequires \u003ccode\u003ePOST\u003c/code\u003e request to the specified endpoint with \u003ccode\u003escriptId\u003c/code\u003e as a path parameter.\u003c/p\u003e\n"],["\u003cp\u003eRequest body accepts version description and returns a timestamp indicating creation time.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful response returns the newly created version details.\u003c/p\u003e\n"],["\u003cp\u003eNeeds authorization with \u003ccode\u003ehttps://www.googleapis.com/auth/script.projects\u003c/code\u003e scope.\u003c/p\u003e\n"]]],[],null,["# Method: projects.versions.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization Scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates a new immutable version using the current code, with a unique version number.\n\n### HTTP request\n\n`POST https://script.googleapis.com/v1/projects/{scriptId}/versions`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|-----------------------------------------|\n| `scriptId` | `string` The script project's Drive ID. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------|\n| ``` { \"versionNumber\": integer, \"description\": string, \"createTime\": string } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `versionNumber` | `integer` The incremental ID that is created by Apps Script when a version is created. This is system assigned number and is immutable once created. |\n| `description` | `string` The description for this version. |\n| `createTime` | `string (`[Timestamp](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp)` format)` When the version was created. A timestamp in RFC3339 UTC \"Zulu\" format, with nanosecond resolution and up to nine fractional digits. Examples: `\"2014-10-02T15:01:23Z\"` and `\"2014-10-02T15:01:23.045123456Z\"`. |\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Version](/apps-script/api/reference/rest/v1/projects.versions#Version).\n\n### Authorization Scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/script.projects`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
