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

Class PropertiesService

1 つのスクリプトをスコープとする Key-Value ペアにシンプルなデータをスクリプトで保存できます。アドオンが使用される 1 つのドキュメントなどです。スクリプト間でプロパティを共有することはできません。各タイプのプロパティを使用するタイミングについて詳しくは、プロパティサービスのガイドをご覧ください。

// Sets three properties of different types.
var documentProperties = PropertiesService.getDocumentProperties();
var scriptProperties = PropertiesService.getScriptProperties();
var userProperties = PropertiesService.getUserProperties();

documentProperties.setProperty('DAYS_TO_FETCH', '5');
scriptProperties.setProperty('SERVER_URL', 'http://www.example.com/MyWeatherService/');
userProperties.setProperty('DISPLAY_UNITS', 'metric');

メソッド

メソッド	戻り値の型	概要
`getDocumentProperties()`	`Properties`	すべてのユーザーが開いているドキュメント、スプレッドシート、フォームです。
`getScriptProperties()`	`Properties`	すべてのユーザーがアクセスできるプロパティストアを取得しますが、このスクリプト内でのみアクセスできます。
`getUserProperties()`	`Properties`	現在のユーザーだけが、このスクリプト内でのみアクセスできるプロパティストアを取得します。

詳細なドキュメント

`getDocumentProperties()`

すべてのユーザーが開いているドキュメント、スプレッドシート、フォームです。スクリプトが公開され、実行中の場合にのみ使用できます。 Google ファイルにバインドされている場合あります。ドキュメントプロパティが使用できない場合、このメソッドは null を返します。ドキュメントスクリプトによって作成されたプロパティには、そのスクリプトの外部からはアクセスできない。他のスクリプトからもアクセスできないアクセスできません。

戻る

Properties - 現在のドキュメントのすべてのユーザーが実行できる、このスクリプト専用のプロパティストアスクリプトがアドオンまたは Google にバインドされていない場合は null Workspace ファイル

`getScriptProperties()`

すべてのユーザーがアクセスできるプロパティストアを取得しますが、このスクリプト内でのみアクセスできます。

戻る

Properties - スクリプトのすべてのユーザーがアクセスできるプロパティストア

`getUserProperties()`

現在のユーザーだけが、このスクリプト内でのみアクセスできるプロパティストアを取得します。

戻る

Properties - スクリプトの現在のユーザーのみがアクセスできるプロパティストア