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

組み込みの Google サービス

Google Apps Script には、ユーザーデータ、他の Google システム、外部システムとやり取りするための 30 以上の組み込みサービスが用意されています。これらのサービスは、JavaScript の標準 Math オブジェクトと同様のグローバルオブジェクトとして提供されています。たとえば、Math が random() などのメソッドと PI などの定数を提供するのと同様に、Apps Script のスプレッドシートサービスは openById(id) などのクラス、Range などのクラス（子オブジェクト）、DataValidationCriteria などの列挙型を提供します。

Google Workspace プロダクトを制御するサービスのリファレンスドキュメントは、このサイトのサイドバーの [リファレンス] ヘッダーにある [Google Workspace サービス] セクションで収集されています。ユーティリティサービス（ユーザーインターフェースの作成、XML の解析、ログデータの書き込みなど）は、[スクリプトサービス] セクションで収集されます。

オートコンプリートを使用する

スクリプトエディタには、「コンテンツアシスト」機能（一般的には「オートコンプリート」）機能が用意されており、スクリプトの現在のコンテキストで有効なメソッドだけでなく、グローバルオブジェクトも表示されます。オートコンプリートの候補は、Apps Script クラスを返すグローバルオブジェクト、列挙型、またはメソッドの呼び出しの後にピリオドを入力するたびに自動的に表示されます。例:

グローバルオブジェクトの完全な名前を入力するか、オートコンプリートから 1 つ選択すると、.（ピリオド）と入力すると、そのクラスのすべてのメソッドと列挙型が表示されます。
数文字入力すると、その文字で始まる有効な候補がすべて表示されます。

グローバルオブジェクトについて

各サービスは少なくとも 1 つのグローバル（トップレベル）オブジェクトを提供します。たとえば、Gmail サービスには GmailApp オブジェクトからのみアクセスされます。一部のサービスでは、複数のグローバルオブジェクトが提供されます。たとえば、基本サービスには、Browser、Logger、MimeType、Session の 4 つのグローバルオブジェクトが含まれます。

呼び出し方法

ほぼすべての組み込みサービスまたは高度なサービスのグローバルオブジェクトには、データを返すメソッドまたは Apps Script クラスが含まれています。スクリプトは、次の形式のメソッド呼び出しを行います。

GlobalObjectName.methodName(argument1, argument2, ..., argumentN);

たとえば、次のようにスクリプトが Gmail サービスの sendEmail(recipient, subject, body) メソッドを呼び出してメールを送信できます。

GmailApp.sendEmail('claire@example.com', 'Subject line', 'This is the body.');

メソッドが別の Apps Script クラスを返す場合は、メソッド呼び出しを 1 行に連結できます。（戻り値の型は、オートコンプリートとメソッドのリファレンスドキュメントの両方に表示されます）。たとえば、メソッド DocumentApp.create() は Document を返します。そのため、コードの以下の 2 つのセクションは同等です。

var doc = DocumentApp.create('New document');
var body = doc.getBody();
body.appendParagraph('New paragraph.');

// Same result as above.
DocumentApp.create('New document').getBody().appendParagraph('New paragraph.');

子クラスへのアクセス

すべてのサービスには、グローバルオブジェクトのようにトップレベルからアクセスできない子クラスが 1 つ以上含まれています。Date などの標準 JavaScript クラスのように、new キーワードを使用してこれらのクラスを作成することはできません。子クラスにアクセスするには、そのクラスを返すメソッドを呼び出す必要があります。特定のクラスにアクセスする方法がわからない場合は、サービスのリファレンスドキュメントのルートページにアクセスして、必要なクラスを返すメソッドを探してください。

インターフェースの取り扱い

いくつかのサービスには、リファレンスドキュメントで「インターフェース」とラベル付けされた特別なクラスが含まれています。これらは、事前に正確な型を特定できないメソッドの戻り値の型として使用される汎用クラスです。たとえば、ドキュメントサービスメソッド Body.getChild(childIndex) は汎用 Element オブジェクトを返します。Element は、他のクラス（Paragraph または Table）を表すインターフェースです。インターフェースオブジェクトがそれ自体では有用になることはほとんどありません。通常は、Element.asParagraph() などのメソッドを呼び出して、オブジェクトを正確なクラスにキャストします。

列挙型の操作

ほとんどのサービスには、名前付き値の列挙型（列挙型）がいくつか含まれています。たとえば、ドライブサービスは列挙型 Access と Permission を使用して、ファイルやフォルダにアクセスできるユーザーを決定します。ほとんどの場合、これらの列挙型にはグローバルオブジェクトからアクセスできます。たとえば、メソッド Folder.setSharing(accessType, permissionType) の呼び出しは次のようになります。

// Creates a folder that anyone on the Internet can read from and write to. (Domain administrators can
// prohibit this setting for Google Workspace users.)
var folder = DriveApp.createFolder('Shared Folder');
folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);