このページは Cloud Translation API によって翻訳されました。

Script Service

このサービスは、スクリプトトリガーとスクリプトの公開へのアクセスを提供します。

クラス

名前	概要
`AuthMode`	トリガーされた関数を介して Apps Script が実行できる承認済みサービスのカテゴリを識別する列挙型。
`AuthorizationInfo`	スクリプトの必要なスコープに対する承認をユーザーが付与しているかどうかを確認するオブジェクト。
`AuthorizationStatus`	スクリプトの承認ステータスを示す列挙型。
`CalendarTriggerBuilder`	カレンダートリガーのビルダー。
`ClockTriggerBuilder`	クロックトリガーのビルダー。
`DocumentTriggerBuilder`	ドキュメントトリガーのビルダー。
`EventType`	トリガーされたイベントのタイプを示す列挙型。
`FormTriggerBuilder`	フォームトリガーのビルダー。
`InstallationSource`	現在のユーザーのアドオンとしてスクリプトがインストールされた方法を示す列挙型。
`ScriptApp`	スクリプトの公開とトリガーにアクセスして操作します。
`Service`	スクリプトの公開にアクセスして操作します。
`SpreadsheetTriggerBuilder`	スプレッドシートトリガーのビルダー。
`StateTokenBuilder`	スクリプトがコールバック API（OAuth フローなど）で使用できる状態トークンを作成できるようにします。
`Trigger`	スクリプトトリガー。
`TriggerBuilder`	スクリプトトリガーの汎用ビルダー。
`TriggerSource`	トリガーを起動するイベントのソースを示す列挙型。

`AuthMode`

プロパティ

プロパティ	タイプ	説明
`NONE`	`Enum`	認証が必要なサービスへのアクセスを許可しないモード。
`CUSTOM_FUNCTION`	`Enum`	カスタムスプレッドシート関数で使用するために、サービスの限定されたサブセットへのアクセスを許可するモード。
`LIMITED`	`Enum`	サービスの限定されたサブセットへのアクセスを許可するモード。
`FULL`	`Enum`	認可が必要なすべてのサービスへのアクセスを許可するモード。

`AuthorizationInfo`

メソッド

メソッド	戻り値の型	概要
`getAuthorizationStatus()`	`AuthorizationStatus`	ユーザーが 1 つ以上のサービス（`ScriptApp.AuthorizationStatus.REQUIRED` など）を使用するためにこのスクリプトを承認する必要があるかどうかを示す値を取得します。
`getAuthorizationUrl()`	`String\|null`	スクリプトへのアクセス権の付与に使用できる認証 URL を取得します。
`getAuthorizedScopes()`	`String[]\|null`	スクリプトの承認済みスコープのリストを取得します。

`AuthorizationStatus`

プロパティ

プロパティ	タイプ	説明
`REQUIRED`	`Enum`	ユーザーは、1 つ以上のサービスを使用するためにこのスクリプトを承認する必要があります。
`NOT_REQUIRED`	`Enum`	ユーザーは、このスクリプトが現在必要とするすべての認証を付与しています。

`CalendarTriggerBuilder`

メソッド

メソッド	戻り値の型	概要
`create()`	`Trigger`	トリガーを作成して返します。
`onEventUpdated()`	`CalendarTriggerBuilder`	カレンダーエントリが作成、更新、削除されたときにトリガーされるトリガーを指定します。

`ClockTriggerBuilder`

メソッド

メソッド	戻り値の型	概要
`after(durationMilliseconds)`	`ClockTriggerBuilder`	トリガーが実行されるまでの現在時刻からの最小期間（ミリ秒単位）を指定します。
`at(date)`	`ClockTriggerBuilder`	トリガーが実行されるタイミングを指定します。
`atDate(year, month, day)`	`ClockTriggerBuilder`	トリガーが指定された日付に起動することを指定します。デフォルトでは、午前 0 時の前後 15 分です。
`atHour(hour)`	`ClockTriggerBuilder`	トリガーが実行されるトリガーの時間を指定します。
`create()`	`Trigger`	トリガーを作成します。
`everyDays(n)`	`ClockTriggerBuilder`	トリガーを `n` 日ごとに実行するように指定します。
`everyHours(n)`	`ClockTriggerBuilder`	トリガーを `n` 時間ごとに実行するように指定します。
`everyMinutes(n)`	`ClockTriggerBuilder`	トリガーを `n` 分ごとに実行するように指定します。
`everyWeeks(n)`	`ClockTriggerBuilder`	トリガーを `n` 週間ごとに実行するように指定します。
`inTimezone(timezone)`	`ClockTriggerBuilder`	トリガーが実行される指定された日付/時刻のタイムゾーンを指定します。
`nearMinute(minute)`	`ClockTriggerBuilder`	トリガーが実行される時刻（±15 分）を指定します。
`onMonthDay(day)`	`ClockTriggerBuilder`	トリガーが実行される月の日付を指定します。
`onWeekDay(day)`	`ClockTriggerBuilder`	トリガーが実行される曜日を指定します。

`DocumentTriggerBuilder`

メソッド

メソッド	戻り値の型	概要
`create()`	`Trigger`	新しいトリガーを作成して返します。
`onOpen()`	`DocumentTriggerBuilder`	ドキュメントが開かれたときに起動するトリガーを指定します。

`EventType`

プロパティ

プロパティ	タイプ	説明
`CLOCK`	`Enum`	時間ベースのイベントが特定の時間に達すると、トリガーが 1 回起動します。
`ON_OPEN`	`Enum`	ユーザーが Google ドキュメント、スプレッドシート、フォームのファイルを開くと、トリガーが 1 回実行されます。
`ON_EDIT`	`Enum`	ユーザーが Google スプレッドシートファイルを編集すると（たとえば、セルに新しい値を入力すると、変更ではなく編集としてカウントされます）、トリガーが 1 回起動します。
`ON_FORM_SUBMIT`	`Enum`	ユーザーが Google フォームに回答すると、トリガーが 1 回実行されます。
`ON_CHANGE`	`Enum`	トリガーは、ユーザーが Google スプレッドシートファイルを変更したときに（たとえば、行を追加したとき。これは編集ではなく変更としてカウントされます）、1 回だけ起動します。
`ON_EVENT_UPDATED`	`Enum`	トリガーは、指定された Google カレンダーでイベントが作成、更新、削除されると 1 回だけ起動します。

`FormTriggerBuilder`

メソッド

メソッド	戻り値の型	概要
`create()`	`Trigger`	新しいトリガーを作成して返します。
`onFormSubmit()`	`FormTriggerBuilder`	フォームに回答が送信されたときにトリガーされるトリガーを指定します。
`onOpen()`	`FormTriggerBuilder`	フォームの編集ビューが開いたときに起動するトリガーを指定します。

`InstallationSource`

プロパティ

プロパティ	タイプ	説明
`APPS_MARKETPLACE_DOMAIN_ADD_ON`	`Enum`	アドオンがユーザーのドメインの管理者によってインストールされた。
`NONE`	`Enum`	スクリプトがアドオンとして実行されていません。
`WEB_STORE_ADD_ON`	`Enum`	ユーザーが Chrome ウェブストアからアドオンをインストールしました。

`ScriptApp`

プロパティ

プロパティ	タイプ	説明
`AuthMode`	`AuthMode`	トリガーされた関数を介して Apps Script が実行できる承認済みサービスのカテゴリを識別する列挙型。
`AuthorizationStatus`	`AuthorizationStatus`	スクリプトの承認ステータスを示す列挙型。
`EventType`	`EventType`	トリガーされたイベントのタイプを示す列挙型。
`InstallationSource`	`InstallationSource`	スクリプトがアドオンとしてユーザーにインストールされた方法を示す列挙型。
`TriggerSource`	`TriggerSource`	トリガーを起動するイベントのソースを示す列挙型。
`WeekDay`	`Weekday`	曜日を表す列挙型。

メソッド

メソッド	戻り値の型	概要
`deleteTrigger(trigger)`	`void`	指定されたトリガーを削除して、実行されないようにします。
`getAuthorizationInfo(authMode)`	`AuthorizationInfo`	ユーザーがすべてのスクリプト要件に対する承認を付与しているかどうかを確認するオブジェクトを取得します。
`getAuthorizationInfo(authMode, oAuthScopes)`	`AuthorizationInfo`	リクエストされたスコープに対する承認をユーザーが付与しているかどうかを確認するオブジェクトを取得します。
`getIdentityToken()`	`String\|null`	`openid` スコープが付与されている場合、有効なユーザーの OpenID Connect ID トークンを取得します。
`getInstallationSource()`	`InstallationSource`	スクリプトが現在のユーザーのアドオンとしてインストールされた方法を示す列挙型の値を返します（たとえば、ユーザーが Chrome ウェブストアから個人でインストールしたか、ドメイン管理者がすべてのユーザーにインストールしたかなど）。
`getOAuthToken()`	`String`	有効なユーザーの OAuth 2.0 アクセストークンを取得します。
`getProjectTriggers()`	`Trigger[]`	現在のプロジェクトと現在のユーザーに関連付けられているインストール可能なトリガーをすべて取得します。
`getScriptId()`	`String`	スクリプトプロジェクトの一意の ID を取得します。
`getService()`	`Service`	スクリプトをウェブアプリとして公開する制御に使用されるオブジェクトを取得します。
`getUserTriggers(document)`	`Trigger[]`	このユーザーが所有する、指定されたドキュメント内のこのスクリプトまたはアドオンのインストール可能なトリガーをすべて取得します。
`getUserTriggers(form)`	`Trigger[]`	このユーザーが所有する、指定されたフォームのインストール可能なトリガーを、このスクリプトまたはアドオンに対してのみ取得します。
`getUserTriggers(spreadsheet)`	`Trigger[]`	このユーザーが所有する、指定されたスプレッドシートのインストール可能なすべてのトリガーを、このスクリプトまたはアドオンに対してのみ取得します。
`invalidateAuth()`	`void`	有効なユーザーが現在のスクリプトを実行する権限を無効にします。
`newStateToken()`	`StateTokenBuilder`	コールバック API（OAuth フローなど）で使用できる状態トークンのビルダーを作成します。
`newTrigger(functionName)`	`TriggerBuilder`	インストール可能なトリガーを作成するプロセスを開始します。このトリガーが起動すると、指定された関数が呼び出されます。
`requireAllScopes(authMode)`	`void`	ユーザーがスクリプトでリクエストされたすべてのスコープに同意しているかどうかを検証します。
`requireScopes(authMode, oAuthScopes)`	`void`	ユーザーがリクエストされたスコープへの同意を付与しているかどうかを検証します。

`Service`

メソッド

メソッド	戻り値の型	概要
`getUrl()`	`String`	ウェブアプリがデプロイされている場合はその URL を返し、それ以外の場合は `null` を返します。
`isEnabled()`	`Boolean`	スクリプトがウェブアプリとしてアクセス可能な場合は `true` を返します。

`SpreadsheetTriggerBuilder`

メソッド

メソッド	戻り値の型	概要
`create()`	`Trigger`	トリガーを作成して返します。
`onChange()`	`SpreadsheetTriggerBuilder`	スプレッドシートのコンテンツまたは構造が変更されたときに起動するトリガーを指定します。
`onEdit()`	`SpreadsheetTriggerBuilder`	スプレッドシートが編集されたときに起動するトリガーを指定します。
`onFormSubmit()`	`SpreadsheetTriggerBuilder`	スプレッドシートにフォームが送信されたときにトリガーされるトリガーを指定します。
`onOpen()`	`SpreadsheetTriggerBuilder`	スプレッドシートが開かれたときにトリガーされるトリガーを指定します。

`StateTokenBuilder`

メソッド

メソッド	戻り値の型	概要
`createToken()`	`String`	状態トークンの暗号化された文字列表現を構築します。
`withArgument(name, value)`	`StateTokenBuilder`	トークンに引数を追加します。
`withMethod(method)`	`StateTokenBuilder`	コールバック関数を設定します。
`withTimeout(seconds)`	`StateTokenBuilder`	トークンが有効な期間（秒単位）を設定します。

`Trigger`

メソッド

メソッド	戻り値の型	概要
`getEventType()`	`EventType`	トリガーが配信されるイベントタイプを返します。
`getHandlerFunction()`	`String`	トリガーが起動したときに呼び出される関数を返します。
`getTriggerSource()`	`TriggerSource`	トリガーを起動するイベントのソースを返します。
`getTriggerSourceId()`	`String`	ソースに固有の ID を返します。
`getUniqueId()`	`String`	トリガーを区別するために使用できる一意の識別子を返します。

`TriggerBuilder`

メソッド

メソッド	戻り値の型	概要
`forDocument(document)`	`DocumentTriggerBuilder`	指定されたドキュメントに関連付けられた `DocumentTriggerBuilder` を作成して返します。
`forDocument(key)`	`DocumentTriggerBuilder`	指定された ID のドキュメントに関連付けられた `DocumentTriggerBuilder` を作成して返します。
`forForm(form)`	`FormTriggerBuilder`	指定されたフォームに関連付けられた `FormTriggerBuilder` を作成して返します。
`forForm(key)`	`FormTriggerBuilder`	指定された ID のフォームに関連付けられた `FormTriggerBuilder` を作成して返します。
`forSpreadsheet(sheet)`	`SpreadsheetTriggerBuilder`	指定されたスプレッドシートに関連付けられた `SpreadsheetTriggerBuilder` を作成して返します。
`forSpreadsheet(key)`	`SpreadsheetTriggerBuilder`	指定された ID のスプレッドシートに関連付けられた `SpreadsheetTriggerBuilder` を作成して返します。
`forUserCalendar(emailId)`	`CalendarTriggerBuilder`	カレンダートリガーを作成するためのビルダーを返します。
`timeBased()`	`ClockTriggerBuilder`	時間ベースのトリガーをビルドするための `ClockTriggerBuilder` を作成して返します。

`TriggerSource`

プロパティ

プロパティ	タイプ	説明
`SPREADSHEETS`	`Enum`	Google スプレッドシートでトリガーが起動します。
`CLOCK`	`Enum`	時間ドリブンイベントにより、トリガーが起動します。
`FORMS`	`Enum`	Google フォームによってトリガーが起動します。
`DOCUMENTS`	`Enum`	Google ドキュメントでトリガーが配信されます。
`CALENDAR`	`Enum`	Google カレンダーがトリガーを配信します。

特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。

最終更新日 2025-12-11 UTC。

ブログ
Google Workspace Developers ブログを読む
Stack Overflow
google-apps-script タグで質問する
コードサンプル
コードサンプルを確認するかコピーして、独自のコードを構築します
動画
Apps Script のチュートリアルを見る