Method: projects.versions.create
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
現在のコードを使用して、一意のバージョン番号を持つ新しい不変バージョンを作成します。
HTTP リクエスト
POST https://script.googleapis.com/v1/projects/{scriptId}/versions
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
| パラメータ |
scriptId |
string
スクリプト プロジェクトのドライブ ID。
|
リクエスト本文
リクエストの本文には、次の構造のデータが含まれます。
| JSON 表現 |
{
"versionNumber": integer,
"description": string,
"createTime": string
} |
| フィールド |
versionNumber |
integer
バージョンの作成時に Apps Script によって作成される増分 ID。これはシステムによって割り当てられた番号であり、作成後に変更することはできません。
|
description |
string
このバージョンの説明。
|
createTime |
string (Timestamp format)
バージョンの作成日時。 RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。
|
レスポンスの本文
成功した場合、レスポンスの本文には、新しく作成された Version のインスタンスが含まれます。
承認スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/script.projects
詳しくは、OAuth 2.0 の概要をご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-26 UTC。
[null,null,["最終更新日 2025-07-26 UTC。"],[[["\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)."]]
