プロジェクトの管理

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

projects.create

結果: プロジェクト ファイルとデフォルトのプロジェクト マニフェストのない基本的な空のプロジェクトが作成されます。

オプション: プロジェクトのタイトルを指定できます。また、スクリプトの親として機能する Google ドキュメント、Google スプレッドシート、Google フォーム、Google スライドのファイルの Google ドライブ ID を指定して、バインドされたスクリプトを作成することもできます。

projects.get

結果: プロジェクト メタデータを表す Project オブジェクトを取得します。このデータには、プロジェクトのタイトル、スクリプト ID、作成したユーザー、作成日時などの詳細が含まれます。

projects.getContent

結果: プロジェクト内のコードファイルと HTML ファイルごとに 1 つずつ、File オブジェクトの配列を返します。このリストには、プロジェクト マニフェストも JSON ファイルとして含まれています。ファイル オブジェクトには、ファイルのソース コンテンツ（File.source）と、ファイル内の関数のリスト（File.functionSet）などのメタデータが含まれます。

オプション: クエリ パラメータを使用して、取得するコンテンツのバージョンを指定できます。

projects.updateContent

結果: スクリプト プロジェクト内のファイルの内容が変更されます。新しいコンテンツは、File オブジェクトの配列として指定します。これらの File オブジェクトの 1 つは JSON 型で、スクリプト プロジェクトの新しいプロジェクト マニフェストを表す必要があります。新しいコンテンツは、プロジェクトの HEAD バージョンとして保存されます。これは、スクリプトがトリガーとして、スクリプト エディタで、アドオンのプレビュー モードで、またはウェブアプリまたは Apps Script API として開発モードで実行される場合に使用されます。

注: スクリプト プロジェクトのコンテンツを更新する場合は、まず projects.getContent リクエストを発行して既存の File の配列を取得し、それらのオブジェクトに必要な変更を加えて、File を projects.updateContent リクエストの入力として使用するのが一般的です。

警告: 新しいコンテンツは、スクリプト プロジェクト内の既存のファイルすべてに置き換えられます。リクエストによって更新されていないファイルは削除されます。

projects.getMetrics

結果: プロジェクトに関する特定の指標を読み取ります。これらの指標には、ユーザー数、実行の合計数、実行エラーの合計数などの詳細が含まれます。リクエストする情報を指定するには、 MetricType を使用します。

オプション: MetricsFilter を使用して、結果を特定のデプロイまたはスクリプト関数に制限します。 MetricsIntervalConfig を使用して、特定の指標間隔を定義することもできます。