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

ライブラリ

ライブラリは、他のスクリプトで関数を再利用できるスクリプトプロジェクトです。

図書館を利用する

プロジェクトにライブラリを含めるには、少なくともビューレベルが必要です。必要ありません。リンクするライブラリの作成者ではない場合作成者に連絡してアクセス権をリクエストします

含めるライブラリのスクリプト ID が必要です。新しい [プロジェクトの設定] でスクリプト ID を確認できます。ページ。

スクリプトプロジェクトにライブラリを追加する

Apps Script エディタの左側にある [ライブラリ] の横で、[ ライブラリ。
[スクリプト ID] で、フィールドに、ライブラリのスクリプト ID を貼り付けます。
[Look up] をクリックします。
エラーが発生した場合は、少なくともビューレベルのアクセス権があること
[Version] プルダウンをクリックして、ライブラリのバージョンを選択します。使用できます。
デフォルトの「Identifier」がトレーニング済みのデータを使用します。これは、スクリプトで使用される名前で、ご覧ください。たとえば、Test に設定すると、次のようになります。 Test.libraryMethod() のように、そのライブラリのメソッドを呼び出します。
使用する ID 名が名前と一致する識別子を使用している場合、 Cloud Shell などの既存のサービスから MailApp、または以前最新のライブラリを追加した場合は、使用しないでください。
[追加] をクリックします。

ライブラリを使用する

デフォルトのサービスの場合と同様に、インクルードされているライブラリを使用します。対象たとえば、ライブラリの識別子が Test の場合は、次のように入力します。 Test の直後にピリオドを付けると、ライブラリ内のメソッドのリストが表示されます。

含まれているライブラリのリファレンスドキュメントは、次の手順で開くことができます。手順は次のとおりです。

スクリプトエディタの左側で、ライブラリ名の横にあるその他アイコン >新しいタブで開く。

ライブラリを削除する

スクリプトエディタの左側で、ライブラリ名の横にあるその他アイコン >削除 >ライブラリの削除。

ライブラリを更新する

ライブラリのバージョンを変更したり、ライブラリの識別子を更新したりできます。

エディタ左側の [ライブラリ] セクションで図書館名をクリックします。
変更を加えて [保存] をクリックします。

ライブラリを作成して共有する

スクリプトプロジェクトをライブラリとして使用、共有する手順は次のとおりです。

バージョニングされた Deployment を作成する使用できます。
ライブラリのすべての潜在的ユーザーと、ビューレベル以上のアクセス権を共有します。
該当するユーザーにスクリプト ID を付与してください。ID は、プロジェクト設定 ページ。

ベストプラクティス

ライブラリを作成する際は、次のガイドラインに従ってください。

プロジェクトにはわかりやすい名前を付けてください。他のライブラリがライブラリに含まれている場合、デフォルトの識別子が使用されます。
スクリプトの 1 つ以上のメソッドを非表示にしたい場合（またはメソッド名を使用します。たとえば、myPrivateMethod_() です。
ライブラリのユーザーには、列挙可能なグローバルプロパティのみが表示されます。これには、宣言、var を使用して関数外で作成された変数、明示的に設定されたプロパティ設定されます。たとえば、enumerable を false に設定した Object.defineProperty() です。は、ライブラリで使用できるシンボルを作成しますが、ユーザーはこのシンボルにアクセスできません。

ライブラリのユーザーがスクリプトエディタの予測入力と使用する場合は、JSDoc 形式のドキュメント、ドキュメントをご覧ください。次の例をご覧ください。

/**
 * Raises a number to the given power, and returns the result.
 *
 * @param {number} base the number we're raising to a power
 * @param {number} exp the exponent we're raising the base to
 * @return {number} the result of the exponential calculation
 */
function power(base, exp) { ... }

リソースのスコープ設定

ライブラリを扱う場合、次の 2 種類のリソースを使用します。共有されません。共有リソースとは、ライブラリとそれを含むリソースの両方がスクリプトには、リソースの同じインスタンスへのアクセスが組み込まれています。「次の図に、共有リソースを示します。ユーザープロパティ:

共有リソース

非共有リソースとは、ライブラリとインクルードスクリプトの両方にそのリソースのインスタンスにのみアクセスが許可されます。ただし、ライブラリを使用すれば、リソースへのアクセスを提供する明示的な関数を持たせることで、操作できます。この例は、この例に含める関数をスクリプトプロパティを公開します。

  function getLibraryProperty(key) {
    return ScriptProperties.getProperty(key);
  }

次の図は、共有されていないリソースについて、スクリプトのプロパティ:

共有されていないリソース

次の表に、共有リソースと非共有リソースの一覧を示します。

リソース	共有中*	未共有**	メモ
ロック			同じインスタンスは、作成されたプロジェクトを含むすべてのスクリプトにライブラリです。
スクリプトプロパティ			同じインスタンスは、作成されたプロジェクトを含むすべてのスクリプトにライブラリです。
キャッシュ			同じインスタンスは、作成されたプロジェクトを含むすべてのスクリプトにライブラリです。
トリガー			ライブラリで作成された単純なトリガーが、インクルードによってトリガーされない使用します。
ScriptApp
UiApp
ユーザープロパティ
ロガーと実行の文字起こし
Google サイト、スプレッドシート、その他のコンテナ			`getActive()` を呼び出すと、指定したオブジェクトのコンテナが返されます。あります。
MailApp と GmailApp
* つまり、ライブラリには、関数の固有のインスタンスがスクリプトによって作成されたものが代わりに使用されます呼び出すことができます。 ** これは、ライブラリがリソース/機能の独自のインスタンスを持つことを意味します。ライブラリを使用するすべてのスクリプトが同じインスタンスです

ライブラリをテストする

ライブラリをテストするには、ヘッドデプロイを使用します。編集者レベルの権限を持つユーザーヘッドデプロイを使用できます

ライブラリをデバッグする

ライブラリを含むプロジェクトでデバッガを使用すると、含まれているライブラリの関数にステップインできます。コードは適切なバージョンに配置します。