Google公式User Guide勝手翻訳


Google Apps Scriptの概要

google apps scriptによってユーザーはグーグルの機能を新たな次元で操作出来るようになります。JavaScriptを使ってSpredsheetや他の機能を操作できるようになり、更にそれを他の人と共有することができます。ブラウザベースのJavaScriptと違い、スクリプトはGoogleのサーバーで実行されます


更に、Google Apps Scriptは、Google sitesからも使うことができます。

このドキュメントにはたくさんのコードサンプルがあります。Google Spreadsheetを開始して、スクリプトエディタを起動してコードを試してみよう!
  1. Google Docsからの起動    New > Spreadsheet
  2. Spreadsheet内からの起動  Tools > Scripts > Script Editor
Google Apps ScriptはGoogle Apps Script Tutorialsでも学ぶことができます。できるだけ更新するので、定期的に来てみてください。 すぐ使えるテンプレートはこちらGoogle Apps Script Template Gallery 。もしもあなたが経験豊かなプログラマーならこちらを見て下さい Google Apps Script API documentation tipsや新たな機能は Google Apps Script Blogで。 アップデートはこちらをチェック Release Notes



このドキュメントについて

このガイドはGoogle Apps Scriptを使うための情報を提供します。Google Apps ScriptはJavaScriptに基づいた、Google Appsと一緒にGoogleのサーバーで動くサーバーサイドのスクリプトです。これらのスクリプトはGoogle Spreadsheets、 Google Finance、 Google Sites、他様々なアプリケーションと程度は違えども協調することができます。Google Apps Scriptはその強力で柔軟性に富んだ機能で幅広い機能を実現でき、更にはプログラマーでなくても簡単に作ることができます。

もしあなたが複雑なGoogle Apps内のタスクを自動化するためにGoogle Apps Scriptを学びたいのなら、このドキュメントはまさにあなたのための物です。

Google Apps Script言語を使ったりGoogle Apps を使うためにはGoogle Accountとサポートするブラウザが必要です。

対象者

Google Apps Scriptを使うのにプログラマーである必要はありません。このガイドはプログラマーではない人を念頭において書かれています。

もしあなたがJavaScriptプログラマーではないなら、全てのドキュメントを読んで下さい。たくさんの詳細なコード断片や短いサンプルが書かれてます。

Spreadsheetマクロや公式、さらにはループや分岐などのプログラミングに明るい方ならGoogle Apps Scriptを学ぶのはより簡単に感じると思います。

なぜならこのドキュメントは包括的なプログラミングマニュアルではないからです。もしJavaScriptについて詳しく学びたいなら書籍や他のサイトが役に立つこととでしょう。 例えばビギナー向けにも書かれてる http://www.w3schools.com/js/default.asp 等。(これらのサイトの制作にはGoogleは関係してないので、それゆえに責任はこのサイトのオーナーにありGoogleにはないものとします。)

もしあなたがJavaScriptや他のオブジェクト指向言語に慣れ親しんでるなら,すんなりとGoogle Apps Scriptの世界に入っていくことができるでしょう。

こちらEventsUser InterfacesSecurityTroubleshooting の章を読んで下さい。Google Apps Scriptの重要な点について書いてあります。 

 Google Apps Script API documentationこちらはGoogle Apps Scriptに組み込まれてるオブジェクトやメソッドの詳細について解説してます。


スクリプトを編集して実行するために必要なもの

Google Apps Scriptを実行編集するには二つ必要なものがあります。
  • Google アカウント コンシューマーアカウントか、Google Apps アカウント。
  • Google Chrome, Mozilla Firefox, and Safariなどの機能をサポートするブラウザ。

スクリプトって何?

スクリプトとは特定のタスクを達成するためにコンピューター言語で書いた一連の命令のことです。指示をタイプしてスクリプトとして保存します。そのスクリプトはあなたが定義した環境下でのみ動きます。

Google Apps ScriptはJavaScriptです。Google Apps Script API はオブジェクトのセットを供給します。そのオブジェクトと関連したメソッドを使うことによってGoogle DocsやSpreadsheets, Gmail, Google Finance,その他のGoogle applicationsにアクセスできます。 更にオブジェクトとメソッドについてはUsing the Google Apps Script APIs参照して下さい。


スクリプトを動かすには最初にGoogle SpreadsheetかGoogle Siteにスクリプトエディタを使ってスクリプトを追加しなければなりません。スクリプトはある特定のSpreadsheetに好きなだけ加えることができ、好きなときに動かすことができます。

あなたのスクリプトはたいてい Spreadsheetのデータに対して動かすことになりますが、Spreadsheetのデータに限定されていると言うことではありません。

広範囲のGoogle Appsやサービス、更にウェブページやXMLソースを含めた外部ソースから情報を引き出すこともできます。Google Apps Scriptをメールspreadsheet、Google Sites上のページ、更には Google Docs Document内のファイルを作り出すことができます。

スクリプトの命令は関数にまとめてあります。それぞれの関数はより大きなタスクを行います。 例えば、もし予算を運用するスクリプトを書いたとしたら、最初の関数はSpreadsheetにカスタムメニューを表示し、2つ目は追加の情報を挿入するためのダイアログボックスを表示するような感じになると思います。

Google Apps Scriptはダイアログボックスや、カレンダーイベント、Google Sitesのページ生成やその他たくさんの機能を実現する豊富なAPI (Applications Programming Interface) オブジェクトやメソッドを供給します。Google Apps Script API ドキュメントはここ


Google Apps Scriptでどんなタスクを自動化できるのか?

とてもシンプルなタスクかとても複雑なタスクを自動化できる。例を挙げると
  • メニューとボタンでSpreadsheetをカスタマイズ
  • 予算を作成
  • 株価を追跡
  • クラブの月謝を追跡
  • XMLフォーマットでデータを操作
  • Google Sitesにページを生成
  • Spreadsheetの情報を下にメールを送信
スクリプトを使ってどんなデータでも操作できる。例えば数値、ファイナンス、文字、XMLドキュメント等。


Google Apps Scriptを使ってアクセスできるGoogle Applications

Google Apps Script は以下のアプリケーションのデータをコントロールするためのオブジェクトやメソッドを含む
  • Google Spreadsheets
  • Google Document List  実験的
  • Gmail Contacts 
  • Google Finance 
  • Google Calendar 
  • Google Sites 
  • Google Maps  実験的

その他のGoogle Apps Scriptを使ってアクセスできるサービス

  • UiApp サービス インタラクティブな要素を表示することができる 実験的
  • JDBC (Java Database Connectivity) サービス リレーショナルデータベースと通信できる 実験的
  • DocsList サービス フォルダー、サブフォルダー、ファイルをGoogleDocsドキュメントリストに追加できる 実験的
  • Base サービス。ユーザー、セッション、ブラウザインフォメーションにアクセスできる。
  • SOAP サービス (Simple Object Access Protocol)    ウェブサービスにアクセスできる
  • XML サービス (eXtensible Markup Language) XMLからデータを抜き出し、操作できる
  • Language サービス 他の言語への翻訳をすることができる
  • Mail サービス メールを送ることが出来る
  • UrlFetch サービス インターネット上の他のホストと通信を行い、リソースを獲得できる
  • Utilities サービス 文字列やフォーマットデータをエンコードやディコードできる
  • Properties サービス ユーザーとスクリプトごとにプロパティを保存できる  実験的
  • Contacts サービス Google Contactsにおけるグループや個人へのコンタクト情報を生成、更新、削除できる