あらかじめ準備しておいて、簡単に手早く添付できるようにしましょう。

添付に関するメソッドをすべて載せてます。少しでも参考になれば幸いです。

Ｇメールメッセージクラス[GmailMessage]の添付取得

Ｇメールのメッセージ添付取得メソッドです。

すべての添付ファイル取得1[getAttachments()]

getAttachments()
このメッセージのすべての添付ファイルを取得します。

Return
GmailAttachment[] - このメッセージのBlob添付ファイルの配列。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailMessage | Methods | getAttachments()

すべての添付ファイル取得2[getAttachments(オプション's)]

getAttachments(options)
このメッセージのすべての添付ファイルを取得します。

Return
GmailAttachment[] - このメッセージのBlob添付ファイルの配列。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailMessage | Methods | getAttachments(options)

Ｇメール添付クラス[GmailAttachment]

Gmailからの添付ファイル。これは通常のBlobですが、追加のgetSize()メソッドがあり、getBytes()。lengthを呼び出すよりも高速で、Gmailの読み取り割り当てにカウントされません。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailAttachment

function gmailAttachmentSample() {
  // 最初の100個の受信トレイスレッドの添付ファイルに関する情報を記録します。
  var threads = GmailApp.getInboxThreads(0, 100);
  var msgs = GmailApp.getMessagesForThreads(threads);
  for (var i = 0 ; i < msgs.length; i++) {
    for (var j = 0; j < msgs[i].length; j++) {
      var attachments = msgs[i][j].getAttachments();
      for (var k = 0; k < attachments.length; k++) {
        Logger.log('Message "%s" contains the attachment "%s" (%s bytes)',
        msgs[i][j].getSubject(), attachments[k].getName(), attachments[k].getSize());
      }
    }
  }
}

添付コピー[copyBlob()]

copyBlob()
このblobのコピーを返します。

Return
Blob - 新しいコピー。

添付変換取得[getAs(コンテンツタイプ)]

getAs(contentType)
このオブジェクト内のデータを、指定されたコンテンツタイプに変換されたblobとして返します。このメソッドは、ファイル名に適切な拡張子を追加します（たとえば、「myfile.pdf」）。ただし、最後のピリオド（存在する場合）に続くファイル名の部分は、置き換える必要がある既存の拡張子であると想定されます。その結果、「ShoppingList.12.25.2014」は「ShoppingList.12.25.pdf」になります。

Return
Blob - ブロブとしてのデータ。

添付データ取得[getBytes()]

getBytes()
このblobに保存されているデータを取得します。

Return
Byte[] - 格納されたバイト。

添付コンテンツタイプ取得[getContentType()]

getContentType()
このblobのバイトのコンテンツタイプを取得します。

Return
String - このデータのコンテンツタイプ（既知の場合）、またはnull。

添付UTF-8文字列データ取得[getDataAsString()]

getDataAsString()
このblobのデータをUTF-8エンコーディングの文字列として取得します。

Return
String - 文字列としてのデータ。

添付指定文字列データ取得[getDataAsString(文字コード)]

getDataAsString(charset)
このblobのデータを、指定されたエンコーディングの文字列として取得します。

Return
String - 文字列としてのデータ。

添付ハッシュ取得[getHash()]

getHash()
この添付ファイルのSHA1コンテンツハッシュを取得します。この方法は、Gmailの読み取りクォータにはカウントされません。

Return
String - 文字列としてのSHA1コンテンツハッシュ。

添付名取得[getName()]

getName()
このblobの名前を取得します。

Return
String - このデータの名前（わかっている場合）、またはnull。

添付ファイルサイズ取得[getSize()]

getSize()
この添付ファイルのサイズを取得します。このメソッドは、getBytes（）。lengthを呼び出すよりも高速で、Gmailの読み取りクォータにはカウントされません。

Return
Integer - 添付ファイルのサイズ（バイト単位）。

添付ファイルG Suite確認[isGoogleType()]

isGoogleType()
このblobがG Suiteファイル（シート、ドキュメントなど）かどうかを返します。

Return
Boolean - このblobがG Suiteファイルの場合はtrue。そうでない場合はfalse。

添付保存データ設定[setBytes(データ)]

setBytes(data)
このblobに保存されているデータを設定します。

Return
Blob - 連鎖用のBlob。

添付コンテンツタイプ設定[setContentType(コンテンツタイプ)]

setContentType(contentType)
このblobのバイトのコンテンツタイプを設定します。

Return
Blob - 連鎖用のBlob。

添付コンテンツタイプ拡張子設定[setContentTypeFromExtension()]

setContentTypeFromExtension()
ファイル拡張子に基づいて、このblobのバイトのコンテンツタイプを設定します。 contentTypeは、拡張子から推測できない場合はnullです。

Return
Blob - 連鎖用のBlob。

添付UTF-8文字列データ設定[setDataFromString(文字列]

setDataFromString(string)
UTF-8エンコーディングで文字列からこのblobのデータを設定します。

Return
Blob - 連鎖用のBlob。

添付指定文字列データ設定[setDataFromString(文字列, 文字コード)]

setDataFromString(string, charset)
指定されたエンコーディングで文字列からこのblobのデータを設定します。

Return
Blob - 連鎖用のBlob。

添付名設定[setName(名前)]

setName(name)
このblobの名前を設定します。

Return
Blob - 連鎖用のBlob。

最後に

Ｇメールの添付機能のまとめをご紹介させていただきました.

スプレッドシートと組み合わせるとさらに効果的です。

必要に応じて、有益な情報でさらに更新していきたいと思います。

プログラミングスキルを向上させるためには、本を読むだけでは脳にインプットされませんね。

実際に手を動かしてアウトプットしまくるのが一番の近道だと思います。

実際にサンプルソースをコピーして実行した結果がどうなるかを体験してみてください。

自分なりのアレンジを加えたり、なぜエラーになるのかを考え、何度も試行錯誤して問題を解決しまくり、着実に理解しながらスキルを向上させていきましょう。

GASはExcelVBAとはかなり違いますが、ベースとなっているJavaScriptは覚えて損はないプログラミング言語なのでショートカットキーなどと組み合わせてぜひ活用してみてください。

Googleスプレッドシート全ショートカットキー一覧はこちら↓↓↓

Googleスプレッドシートの全ショートカット集｜プルダウンメニューまで完全網羅

表計算ソフトとして、まだまだExcelのシェア率は高いですが、GoogleスプレッドシートにはExcelにはない超強力な関数があったり、Excelとは違って常に最新版を無料で使用できます。なにより、インターネットを使ったオンライン上での活用...

caymezon.com

2019.03.16

ショートカットキー一覧にもGASメソッドを載せています。どの操作からどのメソッドが呼ばれるのかイメージしてください。

The post 【GAS】Ｇメールの添付機能まとめ【サンプルソース付】 first appeared on CayTech Lab.

あらかじめ準備しておいて、簡単に手早く転送できるようにしましょう。

検索に関するメソッドをすべて載せてます。少しでも参考になれば幸いです。

Ｇメールメッセージクラス[GmailMessage]の転送

Ｇメールの転送メソッドです。

転送１[forward(受信者)]

forward(recipient)
このメッセージを新しい受信者に転送します。メールのサイズ（ヘッダーを含む）は制限されています。

function forward1Sample() {
  // 最初の受信トレイスレッドの最初のメッセージを受信者1と受信者2に転送します。両方とも@ example.com
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  var message = firstThread.getMessages()[0];
  message.forward("recipient1@example.com,recipient2@example.com");
}

Return
GmailMessage - 連携用のメッセージ

参照：Google Apps Script | REFERENCE | Gmail | Class GmailMessage | Methods | forward(recipient)

転送２[forward(受信者, オプション)]

forward(recipient, options)
オプションの引数を使用して、このメッセージを新しい受信者に転送します。

電子メールには、プレーンテキストとHTML本文の両方を含めることができます。メールのサイズ（ヘッダーを含む）は制限されています。

function forward2Sample() {
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  var message = firstThread.getMessages()[0];
  message.forward("recipient1@example.com,recipient2@example.com", {
    cc: "myboss@example.com",
    bcc: "mybosses-boss@example.com,vp@example.com"
  });
}

Advanced parameters

名前	タイプ	説明
attachments	BlobSource[]	電子メールで送信するファイルの配列
bcc	String	BCCへの電子メールアドレスのコンマ区切りリスト
cc	String	CCへの電子メールアドレスのコンマ区切りリスト
from	String	電子メールの送信元アドレス。GmailApp.getAliases（）によって返される値のいずれかである必要があります
htmlBody	String	設定すると、HTMLをレンダリングできるデバイスは、必要なbody引数の代わりにHTMLを使用します。メールにインライン画像がある場合は、HTML本文にオプションのinlineImagesフィールドを追加できます
inlineImages	Object	画像キー（String）から画像データ（BlobSource）へのマッピングを含むJavaScriptオブジェクト。これは、htmlBodyパラメーターが使用され、これらの画像への参照がの形式で含まれていることを前提としています
name	String	電子メールの送信者の名前（デフォルト：ユーザーの名前）
noReply	Boolean	受信者が電子メールに返信するのを阻止するために、一般的な返信なしの電子メールアドレスから電子メールを送信する必要がある場合はtrue。このオプションは、G Suiteアカウントでのみ使用でき、Gmailユーザーでは使用できません
replyTo	String	デフォルトの返信先アドレスとして使用するメールアドレス（デフォルト：ユーザーのメールアドレス）
subject	String	電子メールの新しい件名

Return
GmailMessage - 連携用のメッセージ

参照：Google Apps Script | REFERENCE | Gmail | Class GmailMessage | Methods | forward(recipient, options)

最後に

Ｇメールの転送機能のまとめをご紹介させていただきました.

スプレッドシートと組み合わせるとさらに効果的です。

必要に応じて、有益な情報でさらに更新していきたいと思います。

プログラミングスキルを向上させるためには、本を読むだけでは脳にインプットされませんね。

実際に手を動かしてアウトプットしまくるのが一番の近道だと思います。

実際にサンプルソースをコピーして実行した結果がどうなるかを体験してみてください。

自分なりのアレンジを加えたり、なぜエラーになるのかを考え、何度も試行錯誤して問題を解決しまくり、着実に理解しながらスキルを向上させていきましょう。

GASはExcelVBAとはかなり違いますが、ベースとなっているJavaScriptは覚えて損はないプログラミング言語なのでショートカットキーなどと組み合わせてぜひ活用してみてください。

Googleスプレッドシート全ショートカットキー一覧はこちら↓↓↓

Googleスプレッドシートの全ショートカット集｜プルダウンメニューまで完全網羅

表計算ソフトとして、まだまだExcelのシェア率は高いですが、GoogleスプレッドシートにはExcelにはない超強力な関数があったり、Excelとは違って常に最新版を無料で使用できます。なにより、インターネットを使ったオンライン上での活用...

caymezon.com

2019.03.16

ショートカットキー一覧にもGASメソッドを載せています。どの操作からどのメソッドが呼ばれるのかイメージしてください。

The post 【GAS】Ｇメールの転送機能まとめ【サンプルソース付】 first appeared on CayTech Lab.

あらかじめ準備しておいて、簡単に手早く返信できるようにしましょう。

検索に関するメソッドをすべて載せてます。少しでも参考になれば幸いです。

Ｇメールメッセージクラス[GmailMessage]の返信

Ｇメールの返信メソッドです。

返信１[reply(本文)]

reply(body)
返信先アドレスを使用して、このメッセージの送信者に返信します。メールのサイズ（ヘッダーを含む）は制限されています。

function reply1Sample() {
  // メッセージの作成者に確認応答します
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  var message = firstThread.getMessages()[0];
  message.reply("Got your message");
}

Return
GmailMessage - 連携用のメッセージ

参照：Google Apps Script | REFERENCE | Gmail | Class GmailMessage | Methods | reply(body)

返信２[reply(本文, オプション)]

reply(body, options)
返信先アドレスとオプションの引数を使用して、このメッセージの送信者に返信します。

電子メールには、プレーンテキストとHTML本文の両方を含めることができます。メールのサイズ（ヘッダーを含む）は制限されています。

function replySample() {
  // HTML本文テキストで応答します
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  var message = firstThread.getMessages()[0];
  message.reply("incapable of HTML", {
    htmlBody: "some HTML body text",
    noReply: true
  });
}

Advanced parameters

名前	タイプ	説明
attachments	BlobSource[]	電子メールで送信するファイルの配列
bcc	String	BCCへの電子メールアドレスのコンマ区切りリスト
cc	String	CCへの電子メールアドレスのコンマ区切りリスト
from	String	電子メールの送信元アドレス。GmailApp.getAliases（）によって返される値のいずれかである必要があります
htmlBody	String	設定すると、HTMLをレンダリングできるデバイスは、必要なbody引数の代わりにHTMLを使用します。メールにインライン画像がある場合は、HTML本文にオプションのinlineImagesフィールドを追加できます
inlineImages	Object	画像キー（String）から画像データ（BlobSource）へのマッピングを含むJavaScriptオブジェクト。これは、htmlBodyパラメーターが使用され、これらの画像への参照がの形式で含まれていることを前提としています
name	String	電子メールの送信者の名前（デフォルト：ユーザーの名前）
noReply	Boolean	受信者が電子メールに返信するのを阻止するために、一般的な返信なしの電子メールアドレスから電子メールを送信する必要がある場合はtrue。このオプションは、G Suiteアカウントでのみ使用でき、Gmailユーザーでは使用できません
replyTo	String	デフォルトの返信先アドレスとして使用するメールアドレス（デフォルト：ユーザーのメールアドレス）
subject	String	電子メールの新しい件名

Return
GmailMessage - 連携用のメッセージ

参照：Google Apps Script | REFERENCE | Gmail | Class GmailMessage | Methods | reply(body, options)

全員に返信１[replyAll(本文)]

replyAll(body)
このメッセージの返信先アドレスとすべての受信者を使用して、送信者に返信します。メールのサイズ（ヘッダーを含む）は制限されています。

function replyAll1Sample() {
  // スレッド内の最後のメールのすべての受信者（bcc'dを除く）に確認応答します
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  var message = firstThread.getMessages()[0];
  message.replyAll("Got your message");
}

Return
GmailMessage - 連携用のメッセージ

参照：Google Apps Script | REFERENCE | Gmail | Class GmailMessage | Methods | replyAll(body)

全員に返信２[replyAll(本文, オプション's)]

replyAll(body, options)
返信先アドレスとすべての受信者をオプションの引数とともに使用して、このメッセージの送信者に返信します。

電子メールには、プレーンテキストとHTML本文の両方を含めることができます。メールのサイズ（ヘッダーを含む）は制限されています。

function replyAll2Sample() {
  // HTML本文テキストで応答します
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  var message = firstThread.getMessages[0];
  messageThread.replyAll("incapable of HTML", {
    htmlBody: "some HTML body text",
    noReply: true
  });
}

Advanced parameters

名前	タイプ	説明
attachments	BlobSource[]	電子メールで送信するファイルの配列
bcc	String	BCCへの電子メールアドレスのコンマ区切りリスト
cc	String	CCへの電子メールアドレスのコンマ区切りリスト
from	String	電子メールの送信元アドレス。GmailApp.getAliases（）によって返される値のいずれかである必要があります
htmlBody	String	設定すると、HTMLをレンダリングできるデバイスは、必要なbody引数の代わりにHTMLを使用します。メールにインライン画像がある場合は、HTML本文にオプションのinlineImagesフィールドを追加できます
inlineImages	Object	画像キー（String）から画像データ（BlobSource）へのマッピングを含むJavaScriptオブジェクト。これは、htmlBodyパラメーターが使用され、これらの画像への参照がの形式で含まれていることを前提としています
name	String	電子メールの送信者の名前（デフォルト：ユーザーの名前）
noReply	Boolean	受信者が電子メールに返信するのを阻止するために、一般的な返信なしの電子メールアドレスから電子メールを送信する必要がある場合はtrue。このオプションは、G Suiteアカウントでのみ使用でき、Gmailユーザーでは使用できません
replyTo	String	デフォルトの返信先アドレスとして使用するメールアドレス（デフォルト：ユーザーのメールアドレス）
subject	String	電子メールの新しい件名行（最大250文字）

Return
GmailMessage - 連携用のメッセージ

参照：Google Apps Script | REFERENCE | Gmail | Class GmailMessage | Methods | replyAll(body, options)

Ｇメールスレッドクラス[GmailThread]の返信

Ｇメールの返信メソッドです。

返信１[reply(本文)]

reply(body)
replyToアドレスを使用して、このスレッドの最後のメッセージの送信者に返信します。

電子メールの合計サイズ（すべてのヘッダーを含む）は20KBを超えないことに注意してください。

function reply1Sample() {
  // スレッドの最後のメールの作成者に確認応答します
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  firstThread.reply("Got your message");
}

Return
GmailThread - 連携用のスレッド

参照：Google Apps Script | REFERENCE | Gmail | Class GmailThread | Methods | reply(body)

返信２[reply(本文, オプション)]

reply(body, options)
replyToアドレスとオプションの引数を使用して、このスレッドの最後のメッセージの送信者に返信します。電子メールには、プレーンテキストとHTML本文の両方を含めることができます。電子メールの合計サイズ（すべてのヘッダーを含むが、添付ファイルを除く）は20 KBを超えないことに注意してください。

function reply2Sample() {
  // HTML本文テキストで応答します。
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  firstThread.reply("incapable of HTML", {
    htmlBody: "some HTML body text",
    noReply: true
  });
}

Advanced parameters

名前	タイプ	説明
cc	String	CCへの電子メールアドレスのコンマ区切りリスト
bcc	String	BCCへの電子メールアドレスのコンマ区切りリスト
htmlBody	String	設定されている場合、HTMLをレンダリングできるデバイスは、必要なbody引数の代わりにHTMLを使用します。メールにインライン画像がある場合は、HTML本文にオプションのinlineImagesフィールドを追加できます
name	String	電子メールの送信者の名前（デフォルト：ユーザーの名前）
from	String	電子メールの送信元アドレス。GmailApp.getAliases（）によって返される値のいずれかである必要があります
replyTo	String	デフォルトの返信先アドレスとして使用するメールアドレス（デフォルト：ユーザーのメールアドレス）
noReply	Boolean	受信者が電子メールに返信するのを阻止するために、一般的な返信なしの電子メールアドレスから電子メールを送信する必要がある場合はtrue。このオプションは、G Suiteアカウントでのみ使用でき、Gmailユーザーでは使用できません
attachments	BlobSource[]	電子メールで送信するファイルの配列
inlineImages	Object	画像キー（String）から画像データ（BlobSource）へのマッピングを含むJavaScriptオブジェクト。これは、htmlBodyパラメーターが使用され、これらの画像への参照がの形式で含まれていることを前提としています

Return
GmailThread - 連携用のスレッド

参照：Google Apps Script | REFERENCE | Gmail | Class GmailThread | Methods | reply(body, options)

全員に返信１[replyAll(本文)]

replyAll(body)
送信者（replyToアドレスを使用）、およびこのスレッドの最後のメッセージのすべての受信者に返信します。

電子メールの合計サイズ（すべてのヘッダーを含む）は20KBを超えないことに注意してください。

function replyAll1Sample() {
  // 受信ボックスの最初のスレッドへの確認応答ですべてに応答します
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  firstThread.replyAll("Got your message");
}

Return
GmailThread - 連携用のスレッド

参照：Google Apps Script | REFERENCE | Gmail | Class GmailThread | Methods | replyAll(body)

全員に返信２[replyAll(本文, オプション's)]

replyAll(body, options)
送信者（replyToアドレスを使用）およびこのスレッドの最後のメッセージのすべての受信者に、オプションの引数を付けて返信します。電子メールには、プレーンテキストとHTML本文の両方を含めることができます。電子メールの合計サイズ（すべてのヘッダーを含むが、添付ファイルを除く）は20 KBを超えないことに注意してください。

function replyAll2Sample() {
  // HTML本文テキストで応答します。
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  firstThread.replyAll("incapable of HTML", {
    htmlBody: "some HTML body text",
    noReply: true
  });
}

Advanced parameters

名前	タイプ	説明
cc	String	CCへの電子メールアドレスのコンマ区切りリスト
bcc	String	BCCへの電子メールアドレスのコンマ区切りリスト
htmlBody	String	設定されている場合、HTMLをレンダリングできるデバイスは、必要なbody引数の代わりにHTMLを使用します。メールにインライン画像がある場合は、HTML本文にオプションのinlineImagesフィールドを追加できます
name	String	電子メールの送信者の名前（デフォルト：ユーザーの名前）
from	String	電子メールの送信元アドレス。GmailApp.getAliases（）によって返される値のいずれかである必要があります
replyTo	String	デフォルトの返信先アドレスとして使用するメールアドレス（デフォルト：ユーザーのメールアドレス）
noReply	Boolean	受信者が電子メールに返信するのを阻止するために、一般的な返信なしの電子メールアドレスから電子メールを送信する必要がある場合はtrue。このオプションは、G Suiteアカウントでのみ使用でき、Gmailユーザーでは使用できません
attachments	BlobSource[]	電子メールで送信するファイルの配列
inlineImages	Object	画像キー（String）から画像データ（BlobSource）へのマッピングを含むJavaScriptオブジェクト。これは、htmlBodyパラメーターが使用され、これらの画像への参照がの形式で含まれていることを前提としています

Return
GmailThread - 連携用のスレッド

参照：Google Apps Script | REFERENCE | Gmail | Class GmailThread | Methods | replyAll(body, options)

最後に

Ｇメールの返信機能のまとめをご紹介させていただきました.

スプレッドシートと組み合わせるとさらに効果的です。

必要に応じて、有益な情報でさらに更新していきたいと思います。

プログラミングスキルを向上させるためには、本を読むだけでは脳にインプットされませんね。

実際に手を動かしてアウトプットしまくるのが一番の近道だと思います。

実際にサンプルソースをコピーして実行した結果がどうなるかを体験してみてください。

自分なりのアレンジを加えたり、なぜエラーになるのかを考え、何度も試行錯誤して問題を解決しまくり、着実に理解しながらスキルを向上させていきましょう。

GASはExcelVBAとはかなり違いますが、ベースとなっているJavaScriptは覚えて損はないプログラミング言語なのでショートカットキーなどと組み合わせてぜひ活用してみてください。

Googleスプレッドシート全ショートカットキー一覧はこちら↓↓↓

Googleスプレッドシートの全ショートカット集｜プルダウンメニューまで完全網羅

表計算ソフトとして、まだまだExcelのシェア率は高いですが、GoogleスプレッドシートにはExcelにはない超強力な関数があったり、Excelとは違って常に最新版を無料で使用できます。なにより、インターネットを使ったオンライン上での活用...

caymezon.com

2019.03.16

ショートカットキー一覧にもGASメソッドを載せています。どの操作からどのメソッドが呼ばれるのかイメージしてください。

The post 【GAS】Ｇメールの返信機能まとめ【サンプルソース付】 first appeared on CayTech Lab.

目的に合わせてよく使う検索を設定しておき、簡単に探せるようにしておきましょう。

検索に関するメソッドをすべて載せてます。少しでも参考になれば幸いです。

ＧメールAPPクラス[GmailApp]の検索

Ｇメールの検索メソッドです。

検索１[search(クエリ)]

search(query)
指定されたクエリでGmailを検索します。

すべてのスレッドのサイズが大きすぎてシステムが処理できない場合、この呼び出しは失敗します。スレッドサイズが不明で、潜在的に非常に大きい場合は、「paged」呼び出しを使用し、各呼び出しで取得するスレッドの範囲を指定してください。

function search1Sample() {
  // 件名が付いたスター付きメッセージを検索する重要
  var threads = GmailApp.search('is:starred subject:"IMPORTANT"');
}

Return
GmailThread[] - このクエリに一致するGmailスレッドの配列

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | search(query)

検索２[search(クエリ, 開始, 最大)]

search(query, start, max)
指定されたクエリでGmailを検索します。

function search2Sample() {
  // 件名が重要なスター付きメッセージを検索し、10の2番目のバッチを返します。
  // 少なくとも11個あると仮定します。そうでない場合、空の配列を返します。
  var threads = GmailApp.search('is:starred subject:"IMPORTANT"', 10, 10);
}

Return
GmailThread[] - このクエリに一致するGmailスレッドの配列

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | search(query, start, max)

最後に

Ｇメールの検索機能のまとめをご紹介させていただきました.

スプレッドシートと組み合わせるとさらに効果的です。

必要に応じて、有益な情報でさらに更新していきたいと思います。

プログラミングスキルを向上させるためには、本を読むだけでは脳にインプットされませんね。

実際に手を動かしてアウトプットしまくるのが一番の近道だと思います。

実際にサンプルソースをコピーして実行した結果がどうなるかを体験してみてください。

自分なりのアレンジを加えたり、なぜエラーになるのかを考え、何度も試行錯誤して問題を解決しまくり、着実に理解しながらスキルを向上させていきましょう。

GASはExcelVBAとはかなり違いますが、ベースとなっているJavaScriptは覚えて損はないプログラミング言語なのでショートカットキーなどと組み合わせてぜひ活用してみてください。

Googleスプレッドシート全ショートカットキー一覧はこちら↓↓↓

Googleスプレッドシートの全ショートカット集｜プルダウンメニューまで完全網羅

表計算ソフトとして、まだまだExcelのシェア率は高いですが、GoogleスプレッドシートにはExcelにはない超強力な関数があったり、Excelとは違って常に最新版を無料で使用できます。なにより、インターネットを使ったオンライン上での活用...

caymezon.com

2019.03.16

ショートカットキー一覧にもGASメソッドを載せています。どの操作からどのメソッドが呼ばれるのかイメージしてください。

The post 【GAS】Ｇメールの検索機能まとめ【サンプルソース付】 first appeared on CayTech Lab.

重要なメールには、スターを付けてを目立たせることができますね。

後から見返したり、返信する必要のあるメールを整理するには必須の機能です。いろんな種類があります。

スターに関するメソッドをすべて載せてます。少しでも参考になれば幸いです。

ＧメールAPPクラス[GmailApp]のスター取得

Ｇメールのスター取得・追加・解除メソッドです。

スター付のスレッド取得[getStarredThreads()]

getStarredThreads()
ラベルに関係なく、すべてのスター付きスレッドを取得します。

すべてのスレッドのサイズが大きすぎてシステムが処理できない場合、この呼び出しは失敗します。スレッドサイズが不明で、潜在的に非常に大きい場合は、「paged」呼び出しを使用し、各呼び出しで取得するスレッドの範囲を指定してください。

function getStarredThreadsSample() {
  // スター付きスレッドの数を記録します
  Logger.log("＃スター付きスレッド：" + GmailApp.getStarredThreads().length);
}

Return
GmailThread[] - スター付きのGmailスレッドの配列。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | getStarredThreads()

スター付のスレッド範囲取得[getStarredThreads(開始, 最大)]

getStarredThreads(start, max)
ラベルに関係なく、スター付きスレッドの範囲を取得します。

function getStarredThreadsSample() {
  // スター付きスレッドの数を最大5まで記録します
  Logger.log("＃スター付きスレッド：" + GmailApp.getStarredThreads(0, 5).length);
}

Return
GmailThread[] - スター付きのGmailスレッドの配列。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | getStarredThreads(start, max)

スター付の未読スレッド数取得[getStarredUnreadCount()]

getStarredUnreadCount()
スター付きの未読スレッドの数を取得します。

function getStarredUnreadCountSample() {
  Logger.log("＃未読およびスター付き：" + GmailApp.getStarredUnreadCount());
}

Return
Integer - 未読メッセージがあるスター付きスレッドの数。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | getStarredUnreadCount()

スター追加[starMessage(メッセージ)]

starMessage(message)
このメッセージにスターを追加して、メッセージを強制的に更新します。

function starMessageSample() {
  // 受信トレイの最初のスレッドの最初のメッセージにスターを付けます
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  var message = firstThread.getMessages()[0];
  GmailApp.starMessage(message);
}

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | starMessage(message)

スター一括追加[starMessages(メッセージ's)]

starMessages(messages)
これらのメッセージに星を追加し、メッセージを強制的に更新します。

function starMessagesSample() {
  // 受信トレイの最初のスレッドの最初の3つのメッセージにスターを付けます
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  var coupleOfMessages = firstThread.getMessages().slice(0, 3);
  GmailApp.starMessages(coupleOfMessages);
}

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | starMessages(messages)

スター解除[unstarMessage(メッセージ)]

unstarMessage(message)
このメッセージからスターを削除し、メッセージを強制的に更新します。

function unstarMessageSample() {
  // 受信トレイの最初のスレッドの最初のメッセージのスターを外します
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  var message = firstThread.getMessages()[0];
  GmailApp.unstarMessage(message);
}

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | unstarMessage(message)

スター一括解除[unstarMessages(メッセージ's)]

unstarMessages(messages)
これらのメッセージから星を削除し、メッセージを強制的に更新します。

function unstarMessagesSample() {
  // 受信トレイの最初のスレッドの最初の3つのメッセージのスターを外します
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  var coupleOfMessages = firstThread.getMessages().slice(0, 3);
  GmailApp.unstarMessages(coupleOfMessages);
}

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | unstarMessages(messages)

スター確認[isStarred()]

isStarred()
このメッセージにスターを付けるかどうかを取得します。

function isStarredSample() {
  var thread = GmailApp.getInboxThreads(0,1)[0]; // 受信トレイで最初のスレッドを取得します
  var message = thread.getMessages()[0]; // 最初のメッセージを取得
  Logger.log("スター付き？ " + message.isStarred());
}

Return
Boolean - このメッセージにスターを付けるかどうか。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | isStarred()

Ｇメールメッセージクラス[GmailMessage]

Ｇメールメッセージのスター追加・解除メソッドです。

スター追加[star()]

star()
メッセージにスターを付けます。

function starSample() {
  var thread = GmailApp.getInboxThreads(0,1)[0]; // 受信トレイで最初のスレッドを取得します
  var message = thread.getMessages()[0]; // 最初のメッセージを取得
  message.star(); // メッセージにスターを付けます
}

Return
GmailApp - 連鎖用のGmailメッセージ。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailMessage | Methods | star()

スター解除[unstar()]

unstar()
メッセージのスターを外します。

function unstarSample() {
  var thread = GmailApp.getInboxThreads(0,1)[0]; // 受信トレイで最初のスレッドを取得します
  var message = thread.getMessages()[0]; // 最初のメッセージを取得
  message.unstar(); // メッセージのスターを外します
}

Return
GmailApp - 連鎖用のGmailメッセージ。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailMessage | Methods | unstar()

最後に

Ｇメールのスター機能のまとめをご紹介させていただきました.

スプレッドシートと組み合わせるとさらに効果的です。

必要に応じて、有益な情報でさらに更新していきたいと思います。

プログラミングスキルを向上させるためには、本を読むだけでは脳にインプットされませんね。

実際に手を動かしてアウトプットしまくるのが一番の近道だと思います。

実際にサンプルソースをコピーして実行した結果がどうなるかを体験してみてください。

自分なりのアレンジを加えたり、なぜエラーになるのかを考え、何度も試行錯誤して問題を解決しまくり、着実に理解しながらスキルを向上させていきましょう。

GASはExcelVBAとはかなり違いますが、ベースとなっているJavaScriptは覚えて損はないプログラミング言語なのでショートカットキーなどと組み合わせてぜひ活用してみてください。

Googleスプレッドシート全ショートカットキー一覧はこちら↓↓↓

Googleスプレッドシートの全ショートカット集｜プルダウンメニューまで完全網羅

表計算ソフトとして、まだまだExcelのシェア率は高いですが、GoogleスプレッドシートにはExcelにはない超強力な関数があったり、Excelとは違って常に最新版を無料で使用できます。なにより、インターネットを使ったオンライン上での活用...

caymezon.com

2019.03.16

ショートカットキー一覧にもGASメソッドを載せています。どの操作からどのメソッドが呼ばれるのかイメージしてください。

The post 【GAS】Ｇメールのスター機能まとめ【サンプルソース付】 first appeared on CayTech Lab.

大量のメールを扱う場合、取捨選択して整理するのは必須です。

見る必要がないので既読マーク、もう一度見るべきだから未読マーク、これは重要だから重要マークなど、いろいろ切り分けましょう。

マークに関するメソッドをすべて載せてます。少しでも参考になれば幸いです。

ＧメールAPPクラス[GmailApp]のメッセージマーク

Ｇメールメッセージのマークメソッドです。

メッセージの既読マーク[markMessageRead(メッセージ)]

markMessageRead(message)
このメッセージに既読のマークを付け、メッセージを強制的に更新します。

function markMessageReadSample() {
  // 受信トレイの最初のスレッドの最初のメッセージを既読にします
  var message = GmailApp.getInboxThreads(0, 1)[0].getMessages()[0];
  GmailApp.markMessageRead(message);
}

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | markMessageRead(message)

メッセージの未読マーク[markMessageUnread(メッセージ)]

markMessageUnread(message)
Marks this message unread and forces the message to refresh.

function markMessageUnreadSample() {
  // 受信トレイの最初のスレッドの最初のメッセージを未読としてマークします
  var message = GmailApp.getInboxThreads(0, 1)[0].getMessages()[0];
  GmailApp.markMessageUnread(message);
}

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | markMessageUnread(message)

複数メッセージの既読マーク[markMessagesRead(メッセージ's)]

markMessagesRead(messages)
これらのメッセージに既読のマークを付け、メッセージを強制的に更新します。

function markMessagesReadSample() {
  // 最初の受信トレイスレッドの最初の3つのメッセージを既読としてマークします。
  // 最初の受信トレイスレッドに3つのメッセージがあると仮定します。
  var threadMessages = GmailApp.getInboxThreads(0, 1)[0].getMessages();
  var messages = [threadMessages[0], threadMessages[1], threadMessages[2]];
  GmailApp.markMessagesRead(thread.getMessages());
}

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | markMessagesRead(messages)

複数メッセージの未読マーク[markMessagesUnread(メッセージ's)]

markMessagesUnread(messages)
これらのメッセージを未読としてマークし、メッセージを強制的に更新します。

function markMessagesUnreadSample() {
  // 最初の受信トレイスレッドの最初の3つのメッセージを未読としてマークします。
  // 最初の受信トレイスレッドに3つのメッセージがあると仮定します
  var threadMessages = GmailApp.getInboxThreads(0, 1)[0].getMessages();
  var messages = [threadMessages[0], threadMessages[1], threadMessages[2]];
  GmailApp.markMessagesUnread(thread.getMessages());
}

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | markMessagesUnread(messages)

ＧメールAPPクラス[GmailApp]のスレッドマーク

Ｇメールスレッドのマークメソッドです。

スレッドの重要マーク[markThreadImportant(スレッド)]

markThreadImportant(thread)
このスレッドを重要としてマークし、スレッドを強制的に更新します。

function markThreadImportantSample() {
  // 最初の受信トレイスレッドを重要としてマークします
  var thread = GmailApp.getInboxThreads(0, 1)[0];
  GmailApp.markThreadImportant(thread);
}

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | markThreadImportant(thread)

スレッドの既読マーク[markThreadRead(スレッド)]

markThreadRead(thread)
このスレッドを読み取り済みとしてマークし、スレッドを強制的に更新します。

function markThreadReadSample() {
  // 最初の受信トレイスレッドを既読としてマークします
  var thread = GmailApp.getInboxThreads(0, 1)[0];
  GmailApp.markThreadRead(thread);
}

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | markThreadRead(thread)

スレッドの重要ではないマーク[markThreadUnimportant(スレッド)]

markThreadUnimportant(thread)
このスレッドを重要でないものとしてマークし、スレッドを強制的に更新します。

function markThreadUnimportantSample() {
  // 最初の受信トレイスレッドを重要でないものとしてマークします
  var thread = GmailApp.getInboxThreads(0, 1)[0];
  GmailApp.markThreadUnimportant(thread);
}

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | markThreadUnimportant(thread)

スレッドの未読マーク[markThreadUnread(スレッド)]

markThreadUnread(thread)
このスレッドを未読としてマークし、スレッドを強制的に更新します。

function markThreadUnreadSample() {
  // 最初の受信トレイスレッドを未読としてマークします
  var thread = GmailApp.getInboxThreads(0, 1)[0];
  GmailApp.markThreadUnread(thread);
}

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | markThreadUnread(thread)

複数スレッドの重要マーク[markThreadsImportant(スレッド's)]

markThreadsImportant(threads)
これらのスレッドを重要としてマークし、スレッドを強制的に更新します。

function markThreadsImportantSample() {
  // 受信トレイの最初の2つのスレッドを重要としてマークします
  var threads = GmailApp.getInboxThreads(0, 2);
  GmailApp.markThreadsImportant(threads);
}

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | markThreadsImportant(threads)

複数スレッドの既読マーク[markThreadsRead(スレッド's)]

markThreadsRead(threads)
これらのスレッドを読み取り済みとしてマークし、スレッドを強制的に更新します。

function markThreadsReadSample() {
  // 受信ボックス内の最初の2つのスレッドを既読としてマークします
  var threads = GmailApp.getInboxThreads(0, 2);
  GmailApp.markThreadsRead(threads);
}

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | markThreadsRead(threads)

複数スレッドの重要ではないマーク[markThreadsUnimportant(スレッド's)]

markThreadsUnimportant(threads)
これらのスレッドを重要でないものとしてマークし、スレッドを強制的に更新します。

function markThreadsUnimportantSample() {
  // 受信トレイの最初の2つのスレッドを重要でないものとしてマークします
  var threads = GmailApp.getInboxThreads(0, 2);
  GmailApp.markThreadsUnimportant(threads);
}

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | markThreadsUnimportant(threads)

複数スレッドの未読マーク[markThreadsUnread(スレッド's)]

markThreadsUnread(threads)
これらのスレッドを未読としてマークし、スレッドを強制的に更新します。

function markThreadsUnreadSample() {
  // 受信トレイの最初の2つのスレッドを未読としてマークします
  var threads = GmailApp.getInboxThreads(0, 2);
  GmailApp.markThreadsUnread(threads);
}

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | markThreadsUnread(threads)

Ｇメールメッセージクラス[GmailMessage]

Ｇメールメッセージのマークメソッドです。

メッセージの既読マーク[markRead()]

markRead()
メッセージに既読のマークを付けます。

function markReadSample() {
  var thread = GmailApp.getInboxThreads(0,1)[0]; // 受信トレイで最初のスレッドを取得します
  var message = thread.getMessages()[0]; // 最初のメッセージを取得
  message.markRead(); // 既読にする
}

Return
GmailMessage - 連鎖用のGmailメッセージ。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailMessage | Methods | markRead()

メッセージの未読マーク[markUnread()]

markUnread()
メッセージを未読としてマークします。

function markUnreadSample() {
  var thread = GmailApp.getInboxThreads(0,1)[0]; // 受信トレイで最初のスレッドを取得します
  var message = thread.getMessages()[0]; // 最初のメッセージを取得
  message.markUnread(); // 未読としてマーク
}

Return
GmailMessage - 連鎖用のGmailメッセージ。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailMessage | Methods | markUnread()

Ｇメールスレッドクラス[GmailThread]

Ｇメールスレッドのマークメソッドです。

スレッドの重要マーク[markImportant()]

markImportant()
このスレッドを重要としてマークします。

function markImportantSample() {
  // 最初の受信トレイスレッドを重要としてマークする
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  firstThread.markImportant();
}

Return
GmailThread - 連鎖用のGmailスレッド。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailThread | Methods | markImportant()

スレッドの既読マーク[markRead()]

markRead()
このスレッドを既読としてマークします。

function markReadSample() {
  // 最初の受信トレイスレッドを既読にする
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  firstThread.markRead();
}

Return
GmailThread - 連鎖用のGmailスレッド。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailThread | Methods | markRead()

スレッドの重要ではないマーク[markUnimportant()]

markUnimportant()
このスレッドを重要でないものとしてマークします。

function markUnimportantSample() {
  // 最初の受信トレイスレッドを重要でないものとしてマークする
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  firstThread.markUnimportant();
}

Return
GmailThread - 連鎖用のGmailスレッド。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailThread | Methods | markUnimportant()

スレッドの未読マーク[markUnread()]

markUnread()
このスレッドを未読としてマークします。

function markUnreadSample() {
  // 最初の受信トレイスレッドを未読としてマークします
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  firstThread.markUnread();
}

Return
GmailThread - 連鎖用のGmailスレッド。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailThread | Methods | markUnread()

最後に

Ｇメールのマーク機能のまとめをご紹介させていただきました.

スプレッドシートと組み合わせるとさらに効果的です。

必要に応じて、有益な情報でさらに更新していきたいと思います。

プログラミングスキルを向上させるためには、本を読むだけでは脳にインプットされませんね。

実際に手を動かしてアウトプットしまくるのが一番の近道だと思います。

実際にサンプルソースをコピーして実行した結果がどうなるかを体験してみてください。

自分なりのアレンジを加えたり、なぜエラーになるのかを考え、何度も試行錯誤して問題を解決しまくり、着実に理解しながらスキルを向上させていきましょう。

GASはExcelVBAとはかなり違いますが、ベースとなっているJavaScriptは覚えて損はないプログラミング言語なのでショートカットキーなどと組み合わせてぜひ活用してみてください。

Googleスプレッドシート全ショートカットキー一覧はこちら↓↓↓

Googleスプレッドシートの全ショートカット集｜プルダウンメニューまで完全網羅

表計算ソフトとして、まだまだExcelのシェア率は高いですが、GoogleスプレッドシートにはExcelにはない超強力な関数があったり、Excelとは違って常に最新版を無料で使用できます。なにより、インターネットを使ったオンライン上での活用...

caymezon.com

2019.03.16

ショートカットキー一覧にもGASメソッドを載せています。どの操作からどのメソッドが呼ばれるのかイメージしてください。

The post 【GAS】Ｇメールのマーク機能まとめ【サンプルソース付】 first appeared on CayTech Lab.

大量のメールを移動してスッキリさせたいですよね？

複数のメッセ―ジやスレッドをまとめて制御して移動することができます。

移動に関するメソッドをすべて載せてます。少しでも参考になれば幸いです。

ＧメールAPPクラス[GmailApp]のメッセージ移動

Ｇメールのメッセージ移動メソッドです。

メッセージのゴミ箱移動[moveMessageToTrash(メッセージ)]

moveMessageToTrash(message)
メッセージをゴミ箱に移動し、メッセージを強制的に更新します。

function moveMessageToTrashSample() {
  // 受信トレイの最初のメッセージをゴミ箱に移動します
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  var firstMessage = firstThread.getMessages()[0];
  GmailApp.moveMessageToTrash(firstMessage);
}

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | moveMessageToTrash(message)

複数メッセージのゴミ箱移動[moveMessagesToTrash(メッセージ's)]

moveMessagesToTrash(messages)
指定されたメッセージをゴミ箱に移動し、メッセージを強制的に更新します。

function moveMessagesToTrashSample() {
  // 受信トレイの最初の2つのメッセージをゴミ箱に移動します
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  var messages = firstThread.getMessages();
  var toDelete = [messages[0], messages[1]];
  GmailApp.moveMessagesToTrash(toDelete);
}

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | moveMessagesToTrash(messages)

ＧメールAPPクラス[GmailApp]のスレッド移動

Ｇメールのスレッド移動メソッドです。

スレッドのアーカイブ移動[moveThreadToArchive(スレッド)]

moveThreadToArchive(thread)
このスレッドをアーカイブに移動し、スレッドを強制的に更新します。

function moveThreadToArchiveSample() {
  // 受信トレイの最初のスレッドをアーカイブします
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  GmailApp.moveThreadToArchive(firstThread);
}

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | moveThreadToArchive(thread)

スレッドの受信ボックス移動[moveThreadToInbox(スレッド)]

moveThreadToInbox(thread)
このスレッドを受信ボックスに移動し、スレッドを強制的に更新します。

function moveThreadToInboxSample() {
  // まだ受信トレイにないスレッドを見つけます
  var thread = GmailApp.search("-in:inbox")[0]; // 最初のものを取得
  GmailApp.moveThreadToInbox(thread);
}

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | moveThreadToInbox(thread)

スレッドのスパム移動[moveThreadToSpam(スレッド)]

moveThreadToSpam(thread)
このスレッドをスパムに移動し、スレッドを強制的に更新します。

function moveThreadToSpamSample() {
  // 受信トレイの最初のスレッドをスパムとしてタグ付けします
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  GmailApp.moveThreadToSpam(firstThread);
}

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | moveThreadToSpam(thread)

スレッドのゴミ箱移動[moveThreadToTrash(スレッド)]

moveThreadToTrash(thread)
このスレッドをゴミ箱に移動し、スレッドを強制的に更新します。

function moveThreadToTrashSample() {
  // 受信トレイの最初のスレッドをゴミ箱に移動します
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  GmailApp.moveThreadToTrash(firstThread);
}

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | moveThreadToTrash(thread)

複数スレッドのアーカイブ移動[moveThreadsToArchive(スレッド's)]

moveThreadsToArchive(threads)
これらのスレッドをアーカイブに移動し、スレッドを強制的に更新します。

function moveThreadsToArchiveSample() {
  // 受信ボックスの最初の2つのスレッドをアーカイブに移動します
  var firstTwoThreads = GmailApp.getInboxThreads(0,2);
  GmailApp.moveThreadsToArchive(firstTwoThreads);
}

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | moveThreadsToArchive(threads)

複数スレッドの受信ボックス移動[moveThreadsToInbox(スレッド's)]

moveThreadsToInbox(threads)
これらのスレッドを受信ボックスに移動し、スレッドを強制的に更新します。

function moveThreadsToInboxSample() {
  // まだ受信トレイにない2つのスレッドを見つけます
  var firstTwoThreads = GmailApp.search("-in:inbox", 0, 2);
  GmailApp.moveThreadsToInbox(firstTwoThreads);
}

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | moveThreadsToInbox(threads)

複数スレッドのスパム移動[moveThreadsToSpam(スレッド's)]

moveThreadsToSpam(threads)
これらのスレッドをスパムに移動し、スレッドを強制的に更新します。

function moveThreadsToSpamSample() {
  // 受信トレイの最初の2つのスレッドをスパムに移動します
  var firstTwoThreads = GmailApp.getInboxThreads(0,2);
  GmailApp.moveThreadsToSpam(firstTwoThreads);
}

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | moveThreadsToSpam(threads)

複数スレッドのゴミ箱移動[moveThreadsToTrash(スレッド's)]

moveThreadsToTrash(threads)
これらのスレッドをゴミ箱に移動し、スレッドを強制的に更新します。

function moveThreadsToTrashSample() {
  // 受信トレイの最初の2つのスレッドをゴミ箱に移動します
  var firstTwoThreads = GmailApp.getInboxThreads(0,2);
  GmailApp.moveThreadsToTrash(firstTwoThreads);
}

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | moveThreadsToTrash(threads)

Ｇメールメッセージクラス[GmailMessage]

Ｇメールのメッセージ移動メソッドです。

メッセージのゴミ箱移動[moveToTrash()]

moveToTrash()
メッセージをゴミ箱に移動します。

function moveToTrashSample() {
  var thread = GmailApp.getInboxThreads(0,1)[0]; // 受信トレイで最初のスレッドを取得します
  var message = thread.getMessages()[0]; // 最初のメッセージを取得
  message.moveToTrash(); // メッセージをゴミ箱に移動します
}

Return
GmailMessage - 連鎖用のGmailメッセージ。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailMessage | Methods | moveToTrash()

Ｇメールスレッドクラス[GmailThread]

Ｇメールのスレッド移動メソッドです。

スレッドのアーカイブ移動[moveToArchive()]

moveToArchive()
このスレッドをアーカイブに移動します。

function moveToArchiveSample() {
  // 最初の受信トレイスレッドをアーカイブします
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  firstThread.moveToArchive();
}

Return
GmailThread - 連鎖用のGmailスレッド。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailThread | Methods | moveToArchive()

スレッドの受信ボックス移動[moveToInbox()]

moveToInbox()
このスレッドを受信ボックスに移動します。

function moveToInboxSample() {
  // 最初の非受信スレッドを受信ボックスに移動します
  var firstThread = GmailApp.search("-in:inbox")[0];
  firstThread.moveToInbox();
}

Return
GmailThread - 連鎖用のGmailスレッド。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailThread | Methods | moveToInbox()

スレッドのスパム移動[moveToSpam()]

moveToSpam()
このスレッドをスパムに移動します。

function moveToSpamSample() {
  // 最初の受信トレイスレッドをスパムに移動します
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  firstThread.moveToSpam();
}

Return
GmailThread - 連鎖用のGmailスレッド。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailThread | Methods | moveToSpam()

スレッドのゴミ箱移動[moveToTrash()]

moveToTrash()
このスレッドをゴミ箱に移動します。

function moveToTrashSample() {
  // 最初の受信トレイのスレッドをゴミ箱に移動します
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  firstThread.moveToTrash();
}

Return
GmailThread - 連鎖用のGmailスレッド。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailThread | Methods | moveToTrash()

最後に

Ｇメールの移動機能のまとめをご紹介させていただきました.

スプレッドシートと組み合わせるとさらに効果的です。

必要に応じて、有益な情報でさらに更新していきたいと思います。

プログラミングスキルを向上させるためには、本を読むだけでは脳にインプットされませんね。

実際に手を動かしてアウトプットしまくるのが一番の近道だと思います。

実際にサンプルソースをコピーして実行した結果がどうなるかを体験してみてください。

自分なりのアレンジを加えたり、なぜエラーになるのかを考え、何度も試行錯誤して問題を解決しまくり、着実に理解しながらスキルを向上させていきましょう。

GASはExcelVBAとはかなり違いますが、ベースとなっているJavaScriptは覚えて損はないプログラミング言語なのでショートカットキーなどと組み合わせてぜひ活用してみてください。

Googleスプレッドシート全ショートカットキー一覧はこちら↓↓↓

Googleスプレッドシートの全ショートカット集｜プルダウンメニューまで完全網羅

表計算ソフトとして、まだまだExcelのシェア率は高いですが、GoogleスプレッドシートにはExcelにはない超強力な関数があったり、Excelとは違って常に最新版を無料で使用できます。なにより、インターネットを使ったオンライン上での活用...

caymezon.com

2019.03.16

ショートカットキー一覧にもGASメソッドを載せています。どの操作からどのメソッドが呼ばれるのかイメージしてください。

The post 【GAS】Ｇメールの移動機能まとめ【サンプルソース付】 first appeared on CayTech Lab.

大量のメールをラベルで整理できれば確実に効率が上がります。

メールにラベルを設定したり、特定ラベルのスレッドを調べたりもできます。

ラベルに関するメソッドをすべて載せてます。少しでも参考になれば幸いです。

ＧメールAPPクラス[GmailApp]のラベル作成・削除

Ｇメールのラベル作成・削除メソッドです。

ラベル作成[createLabel(ラベル名)]

createLabel(name)
指定された名前の新しいユーザーラベルを作成します。

function createLabelSample() {
  // ラベル@FOOを作成し、ラベルを記録します：FOO
  Logger.log("label: " + GmailApp.createLabel("FOO"));
}

Return
GmailLabel - 新しく作成されたラベル。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | createLabel(name)

ラベル削除[deleteLabel(指定ラベル)]

deleteLabel(label)
指定されたラベルを削除します。

function deleteLabelSample() {
  // 最初に名前でラベルを取得する必要があります
  var label = GmailApp.getUserLabelByName("FOO");
  GmailApp.deleteLabel(label);
}

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | deleteLabel(label)

ＧメールAPPクラス[GmailApp]のラベル取得

Ｇメールのラベル取得メソッドです。

ラベル取得[getUserLabelByName(ラベル名)]

getUserLabelByName(name)
ラベル名を指定してラベルを取得します。

function getUserLabelByNameSample() {
  var labelObject = GmailApp.getUserLabelByName("myLabel");
}

Return
GmailLabel - 指定された名前のGmailラベル。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | getUserLabelByName(name)

ラベル配列取得[getUserLabels()]

getUserLabels()
ユーザーが作成したラベルのリストを取得します。

function getUserLabelsSample() {
  // ラベルのすべての名前を記録します
  var labels = GmailApp.getUserLabels();
  for (var i = 0; i < labels.length; i++) {
    Logger.log("label: " + labels[i].getName());
  }
}

Return
GmailLabel[] - ユーザーが作成したラベルの配列。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | getUserLabels()

Ｇメールラベルクラス[GmailLabel]

ユーザーのGmailアカウントにユーザーが作成したラベル。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailLabel

ラベルの特定スレッド追加[addToThread(スレッド)]

addToThread(thread)
このラベルを特定のスレッドに追加し、スレッドを強制的に更新します（GmailThread.refresh()）。

function addToThreadSample() {
  // 受信トレイの最初のスレッドにMyLabelというラベルを付けます
  var label = GmailApp.getUserLabelByName("MyLabel");
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  label.addToThread(firstThread);
}

Return
GmailLabel - 連鎖用のラベル。

ラベルの特定スレッド配列追加[addToThreads(スレッド's)]

addToThreads(threads)
このラベルを特定のスレッドに追加し、スレッドを強制的に更新します。

function addToThreadsSample() {
  // 受信トレイの最初の3つのスレッドにMyLabelというラベルを付けます
  var label = GmailApp.getUserLabelByName("MyLabel");
  var threads = GmailApp.getInboxThreads(0,3);
  label.addToThreads(threads);
}

Return
GmailLabel - 連鎖用のラベル。

ラベル削除[deleteLabel()]

deleteLabel()
このラベルを削除します。

function deleteLabelSample() {
  var label = GmailApp.getUserLabelByName("MyLabel");
  label.deleteLabel();
}

Throws
Error - ラベルを削除できない場合。

ラベル名取得[getName()]

getName()
このラベルの名前を取得します。

function getNameSample() {
  var label = GmailApp.getUserLabelByName("MyLabel");
  Logger.log(label.getName()); // MyLabelを記録します
}

Return
String - ラベルの名前。

ラベルのスレッド取得[getThreads()]

getThreads()
このラベルでマークされたスレッドを取得します。

すべてのスレッドのサイズが大きすぎてシステムが処理できない場合、この呼び出しは失敗します。スレッドサイズが不明で、潜在的に非常に大きい場合は、getThreads(start, max)を使用して、各呼び出しで取得するスレッドの範囲を指定してください。

function getThreadsSample() {
  // MyLabelでラベル付けされたスレッドの件名行を記録します
  var label = GmailApp.getUserLabelByName("MyLabel");
  var threads = label.getThreads();
  for (var i = 0; i < threads.length; i++) {
    Logger.log(threads[i].getFirstMessageSubject());
  }
}

Return
GmailThread[] - このラベルでマークされたスレッドの配列。

ラベルのスレッド範囲取得[getThreads(開始, 最大)]

getThreads(start, max)
このラベルでマークされたスレッドの範囲を取得します。

function getThreadsSample() {
  // MyLabelというラベルで最初の30スレッドまでの件名行を記録します
  var label = GmailApp.getUserLabelByName("MyLabel");
  var threads = label.getThreads(0, 30);
  for (var i = 0; i < threads.length; i++) {
    Logger.log(threads[i].getFirstMessageSubject());
  }
}

Return
GmailThread[] - このラベルでマークされたスレッドの配列。

ラベルの未読スレッド数取得[getUnreadCount()]

getUnreadCount()
このラベルでタグ付けされた未読スレッドの数を取得します。

function getUnreadCountSample() {
  // MyLabelでラベル付けされた未読スレッドの数を記録します
  var label = GmailApp.getUserLabelByName("MyLabel");
  Logger.log(label.getUnreadCount());
}

Return
Integer - 未読のラベル付きスレッドの数。

指定スレッドからラベル削除[removeFromThread(スレッド)]

removeFromThread(thread)
指定されたスレッドからこのラベルを削除し、スレッドを強制的に更新します。

function removeFromThreadSample() {
  // 受信トレイの最初のスレッドからラベルMyLabelを削除します
  var label = GmailApp.getUserLabelByName("MyLabel");
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  label.removeFromThread(firstThread);
}

Return
GmailLabel - 連鎖用のラベル。

指定配列スレッドからラベル削除[removeFromThreads(スレッド's)]

removeFromThreads(threads)
指定されたスレッドからこのラベルを削除し、スレッドを強制的に更新します。

function removeFromThreadsSample() {
  // 受信トレイの最初の3つのスレッドからMyLabelラベルを削除します
  var label = GmailApp.getUserLabelByName("MyLabel");
  var threads = GmailApp.getInboxThreads(0,3);
  label.removeFromThreads(threads);
}

Return
GmailLabel - 連鎖用のラベル。

最後に

Ｇメールのラベル機能のまとめをご紹介させていただきました.

スプレッドシートと組み合わせるとさらに効果的です。

必要に応じて、有益な情報でさらに更新していきたいと思います。

プログラミングスキルを向上させるためには、本を読むだけでは脳にインプットされませんね。

実際に手を動かしてアウトプットしまくるのが一番の近道だと思います。

実際にサンプルソースをコピーして実行した結果がどうなるかを体験してみてください。

自分なりのアレンジを加えたり、なぜエラーになるのかを考え、何度も試行錯誤して問題を解決しまくり、着実に理解しながらスキルを向上させていきましょう。

GASはExcelVBAとはかなり違いますが、ベースとなっているJavaScriptは覚えて損はないプログラミング言語なのでショートカットキーなどと組み合わせてぜひ活用してみてください。

Googleスプレッドシート全ショートカットキー一覧はこちら↓↓↓

Googleスプレッドシートの全ショートカット集｜プルダウンメニューまで完全網羅

表計算ソフトとして、まだまだExcelのシェア率は高いですが、GoogleスプレッドシートにはExcelにはない超強力な関数があったり、Excelとは違って常に最新版を無料で使用できます。なにより、インターネットを使ったオンライン上での活用...

caymezon.com

2019.03.16

ショートカットキー一覧にもGASメソッドを載せています。どの操作からどのメソッドが呼ばれるのかイメージしてください。

The post 【GAS】Ｇメールのラベル機能まとめ【サンプルソース付】 first appeared on CayTech Lab.

毎日決まった内容をいちいちメールしなければならない人、きっとたくさんいますよね。めんどくさくないですか？

定型文のメールを作成する場合は確実に時短に繋がります。宛て先や件名などは自動化して、本文の大事な内容に注力しましょう。

下書き（ドラフト）に関するメソッドをすべて載せてます。少しでも参考になれば幸いです。

ＧメールAPPクラス[GmailApp]の下書き（ドラフト）作成

Ｇメールの下書き作成メソッドです。

下書きメール作成1[createDraft(受信者, 件名, 本文)

createDraft(recipient, subject, body)
ドラフトメールメッセージを作成します。メールのサイズ（ヘッダーを含む）は制限されています。

function createDraft1Sample() {
  // 以下のコードは、現在の日付と時刻でドラフトメールを作成します。
  var now = new Date();
  GmailApp.createDraft("mike@example.com", "current time", "The time is: " + now.toString());
}

Return
GmailDraft - 新しく作成されたドラフト。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | createDraft(recipient, subject, body)

下書きメール作成2（オプション）[createDraft(受信者, 件名, 本文, オプション)]

createDraft(recipient, subject, body, options)
オプションの引数を使用してドラフトメールメッセージを作成します。電子メールには、プレーンテキストまたはHTML本文を含めることができます。電子メールのサイズ（ヘッダーを含むが、添付ファイルを除く）は割り当て制限されています。

function createDraft2Sample() {
  // PDFとして添付されたGoogleドライブのファイルを使用してドラフトメールを作成します。
  var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
  GmailApp.createDraft('mike@example.com', 'Attachment example', 'Please see attached file.', {
      attachments: [file.getAs(MimeType.PDF)],
      name: 'Automatic Emailer Script'
  });
}

Return
GmailDraft - 新しく作成されたドラフト。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | createDraft(recipient, subject, body, options)

ＧメールAPPクラス[GmailApp]の下書き（ドラフト）取得

Ｇメールの下書き取得メソッドです。

下書き取得[getDraft(下書きID)]

getDraft(draftId)
IDでメールメッセージの下書きを取得します。

これをGmailの下書きでgetId()と組み合わせて使用します。

function getDraftSample() {
  // 下書きフォルダ内の最初の下書きメッセージを取得します
  var draft = GmailApp.getDrafts()[0];
  // IDを取得します
  var draftId = draft.getId();
  // ここで、そのIDを使用して同じドラフトを取得します。
  var draftById = GmailApp.getDraft(draftId);
  // 同じメッセージである必要があるため、常にtrueを記録する必要があります
  Logger.log(draft.getMessage().getSubject() == draftById.getMessage().getSubject());
}

Return
GmailDraft - 指定されたIDのドラフト。

Throws
Error - 指定されたIDの下書きが見つからない場合。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | getDraft(draftId)

すべての下書きメッセージ取得[getDraftMessages()]

getDraftMessages()
すべての下書きメッセージを取得します。

function getDraftMessagesSample() {
  // 下書きメッセージの数を記録します
  var drafts = GmailApp.getDraftMessages();
  Logger.log(drafts.length);
}

Return
GmailMessage[] - 下書きのGmailメッセージの配列

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | getDraftMessages()

すべての下書き取得[getDrafts()]

getDrafts()
すべてのGmailドラフトメッセージを取得します。

function getDraftsSample() {
  var drafts = GmailApp.getDrafts();
  for (var i = 0; i < drafts.length; i++) {
    Logger.log(drafts[i].getId());
  }
}

Return
GmailDraft[] - Gmailの下書きメッセージの配列。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | getDrafts()

Ｇメール下書き（ドラフト）クラス[GmailDraft]

ユーザーのGmailアカウントにユーザーが作成した下書きメッセージ。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailDraft

下書き削除[deleteDraft()]

deleteDraft()
このドラフトメッセージを削除します。

function deleteDraftSample() {
  var draft = GmailApp.getDrafts()[0]; // 下書きフォルダ内の最初の下書きメッセージ
  draft.deleteDraft();
  draft.getMessage(); // 例外をスローします！
}

下書きID取得[getId()]

getId()
このドラフトメッセージのIDを取得します。

function getIdSample() {
  var draft = GmailApp.getDrafts()[0]; // 下書きフォルダ内の最初の下書きメッセージ
  var draftId = draft.getId();
  var draftById = GmailApp.getDraft(draftId);
  Logger.log(draft.getMessage().getSubject() == draftById.getMessage().getSubject());
}

Return
String - ドラフトID

下書きメッセージ取得[getMessage()]

getMessage()
このドラフトを表すGmailMessageを返します。

function getMessageSample() {
  var draft = GmailApp.getDrafts()[0]; // 下書きフォルダ内の最初の下書きメッセージ
  var message = draft.getMessage();
  Logger.log(message.getSubject());
}

Return
GmailMessage - このドラフトの内容を表すメッセージ

下書きメッセージID取得[getMessageId()]

getMessageId()
このドラフトを表すGmailMessageのIDを返します。

function getMessageIdSample() {
  var draft = GmailApp.getDrafts()[0]; // 書きフォルダ内の最初の下書きメッセージ
  var messageId = draft.getMessageId();
  Logger.log(messageId == draft.getMessage().getId());
}

Return
String - メッセージID

下書きメール送信[send()]

send()
このドラフトメールメッセージを送信します。メールのサイズ（ヘッダーを含む）は制限されています。

function sendSample() {
  var draft = GmailApp.getDrafts()[0]; // 下書きフォルダ内の最初の下書きメッセージ
  var msg = draft.send(); // それを送る
  Logger.log(msg.getDate()); // ほぼ現在のタイムスタンプである必要があります
}

Return
GmailMessage - 新しく送信されたメッセージ

下書きメッセージ変更1[update(受信者, 件名, 本文]

update(recipient, subject, body)
このドラフトメッセージの内容を置き換えます。メールのサイズ（ヘッダーを含む）は制限されています。

function update1Sample() {
  // 以下のコードは、現在の日付と時刻でドラフトメールを更新します。
  var draft = GmailApp.getDrafts()[0]; // 下書きフォルダ内の最初の下書きメッセージ
  var now = new Date();
  draft.update("mike@example.com", "current time", "The time is: " + now.toString());
}

Return
GmailDraft - 新しく更新されたドラフト

下書きメッセージ変更2（オプション）[update(受信者, 件名, 本文, オプション)]

update(recipient, subject, body, options)
オプションの引数を使用して、このドラフトメッセージの内容を置き換えます。電子メールには、プレーンテキストまたはHTML本文を含めることができます。メールのサイズ（ヘッダーを含む）は制限されています。

function update2Sample() {
  // GoogleドライブのファイルをPDFとして添付してドラフトメールを更新します。
  var draft = GmailApp.getDrafts()[0]; // 下書きフォルダ内の最初の下書きメッセージ
  var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
  draft.update('mike@example.com', 'Attachment example', 'Please see attached file.', {
      attachments: [file.getAs(MimeType.PDF)],
      name: 'Automatic Emailer Script'
  });
}

Return
GmailDraft - 新しく更新されたドラフト

最後に

Ｇメールの下書き（ドラフト）機能のまとめをご紹介させていただきました.

スプレッドシートと組み合わせるとさらに効果的です。

必要に応じて、有益な情報でさらに更新していきたいと思います。

プログラミングスキルを向上させるためには、本を読むだけでは脳にインプットされませんね。

実際に手を動かしてアウトプットしまくるのが一番の近道だと思います。

実際にサンプルソースをコピーして実行した結果がどうなるかを体験してみてください。

自分なりのアレンジを加えたり、なぜエラーになるのかを考え、何度も試行錯誤して問題を解決しまくり、着実に理解しながらスキルを向上させていきましょう。

GASはExcelVBAとはかなり違いますが、ベースとなっているJavaScriptは覚えて損はないプログラミング言語なのでショートカットキーなどと組み合わせてぜひ活用してみてください。

Googleスプレッドシート全ショートカットキー一覧はこちら↓↓↓

Googleスプレッドシートの全ショートカット集｜プルダウンメニューまで完全網羅

表計算ソフトとして、まだまだExcelのシェア率は高いですが、GoogleスプレッドシートにはExcelにはない超強力な関数があったり、Excelとは違って常に最新版を無料で使用できます。なにより、インターネットを使ったオンライン上での活用...

caymezon.com

2019.03.16

ショートカットキー一覧にもGASメソッドを載せています。どの操作からどのメソッドが呼ばれるのかイメージしてください。

The post 【GAS】Ｇメールの下書き（ドラフト）機能まとめ【サンプルソース付】 first appeared on CayTech Lab.

現時点で実装されている、面グラフ、棒グラフ、縦棒グラフ、コンボチャート(2つの単位の異なるグラフ)、ヒストグラムチャート、折れ線グラフ、円グラフ、散布図、テーブルチャート。

各グラフ毎のリファレンスを全部マージしてます。だいぶボリュームが膨れ上がってしまいましたが。。。各グラフで使用しているメソッドは表のマトリックスで表現してます。

すべてのチャートに関するメソッドをすべて載せてます。少しでも参考になれば幸いです。

Google Apps Script スプレッドシート 基礎 リファレンス

当ページは、GAS公式リファレンスを元にスプレッドシートの機能毎にまとめた基礎的な内容となっております。

若干、文言がおかしい可能性がありますが、あらかじめご了承ください。

GAS基本メソッドまとめ一覧はコチラ↓↓↓です。スプレッドシートの基本的な機能をまとめてますので、ぜひご活用ください。

【GAS】スプレッドシート基本メソッドまとめ一覧【初心者入門】

GAS開発者向けにスプレッドシートの基本的なメソッドを一覧にまとめました。各機能ごとのクラス、メソッドごとのサンプルソース付ページへリンクする一覧です。初心者にとって、スプレッドシートの基本的な操作・機能単位のメソッドを知るのには効果的な一...

caymezon.com

2019.07.29

まずは実際に動かしてみることをオススメします。マクロの登録方法は以下を参照いただければと思います。

【GAS】Googleスプレッドシートでマクロの使い方入門【動画付】

Googleの「Google Apps Script」通称GAS。GoogleマップやGメールなど、いろんなGoogle関連のサービスと自由に連携できたり、独自のWebアプリを開発することもできる、いろんな可能性を秘めたワクワクの言語ですね...

caymezon.com

2019.05.02

GASの本はまだまだ少ないですね。基礎レベルであれば、以下の参考書が初心者にはベストの本です。

基本的な仕様やよく使われる機能の設定方法がまとまっています。

※JavaScriptの知識が既にある程度ある人にとっては冗長かもしれません。

埋め込みチャートクラス[EmbeddedChart]

スプレッドシートに埋め込まれたグラフを表します。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class EmbeddedChart

次の例は、既存のチャートを変更する方法を示しています。

function chartModifySample() {
  var sheet = SpreadsheetApp.getActiveSheet();
  var range = sheet.getRange("A2:B8")
  var chart = sheet.getCharts()[0]; 
  chart = chart.modify()
      .addRange(range)
      .setOption('title', 'Updated!')
      .setOption('animation.duration', 500)
      .setPosition(2,2,0,0)
      .build();
  sheet.updateChart(chart);
}

この例は、新しいグラフを作成する方法を示しています。

function newChartSample(range, sheet) {
  var sheet = SpreadsheetApp.getActiveSheet();
  var chartBuilder = sheet.newChart();
  chartBuilder.addRange(range)
      .setChartType(Charts.ChartType.LINE)
      .setOption('title', 'My Line Chart!');
  sheet.insertChart(chartBuilder.build());
}

チャートコンテンツタイプ変換取得[getAs(コンテンツタイプ)]

getAs(contentType)
このオブジェクト内のデータを、指定されたコンテンツタイプに変換されたblobとして返します。このメソッドは、適切な拡張子をファイル名に追加します（たとえば、「myfile.pdf」）。ただし、最後のピリオド（存在する場合）に続くファイル名の部分は、置き換える必要がある既存の拡張子であると想定しています。その結果、「ShoppingList.12.25.2014」は「ShoppingList.12.25.pdf」になります。

Return
Blob - ブロブとしてのデータ。

チャートデータブロブ取得[getBlob()]

getBlob()
このオブジェクト内のデータをblobとして返します。

Return
Blob - ブロブとしてのデータ。

チャート識別子取得[getChartId()]

getChartId()
チャートを含むスプレッドシート全体で一意なチャートの安定した識別子を返します。チャートがスプレッドシートにない場合はnullを返します。

Return
Integer - 安定したチャート識別子。

チャート位置情報取得[getContainerInfo()]

getContainerInfo()
シート内のチャートの位置に関する情報を返します。

function getContainerInfoSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var chart = sheet.newChart()
      .setChartType(Charts.ChartType.BAR)
      .addRange(sheet.getRange("A1:B8"))
      .setPosition(5, 5, 0, 0)
      .build();

  var containerInfo = chart.getContainerInfo();

  // setPosition()で使用した値を記録します
  Logger.log("Anchor Column: %s\r\nAnchor Row %s\r\nOffset X %s\r\nOffset Y %s",
            containerInfo.getAnchorColumn(),
            containerInfo.getAnchorRow(),
            containerInfo.getOffsetX(),
            containerInfo.getOffsetY());
}

Return
ContainerInfo - チャートコンテナーの位置を含むオブジェクト

チャート行列非表示方法取得[getHiddenDimensionStrategy()]

getHiddenDimensionStrategy()
非表示の行と列の処理に使用する方法を返します。デフォルトはIGNORE_ROWSです。

function getHiddenDimensionStrategySample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var range = sheet.getRange("A1:B5");
  var chart = sheet.newChart()
      .setChartType(Charts.ChartType.BAR)
      .addRange(range)
      .setHiddenDimensionStrategy(Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS)
      .setPosition(5, 5, 0, 0)
      .build()

  // この場合はCharts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS
  // である非表示の行と列に使用する方法を記録します。
  Logger.log(chart.getHiddenDimensionStrategy());
}

Return
ChartHiddenDimensionStrategy - 非表示の行と列に使用する方法。

チャートオブジェクトID取得[getId()]

getId()
このオブジェクトに割り当てられたIDを返します。

これをapp.getElementById()と組み合わせて使用して、このオブジェクトへの参照を取得できます。

Return
String - このオブジェクトに割り当てられたID

チャートマージ方法取得[getMergeStrategy()]

getMergeStrategy()
複数の範囲が存在する場合に使用されるマージ方法を返します。 MERGE_ROWSの場合、行はマージされます。 MERGE_COLUMNSの場合、列はマージされます。デフォルトはMERGE_COLUMNSです。

function getMergeStrategySample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var range = sheet.getRange("A1:B10");
  var range2 = sheet.getRange("C1:C10");
  var chart = sheet.newChart()
      .setChartType(Charts.ChartType.BAR)
      .addRange(range)
      .addRange(range2)
      .setMergeStrategy(Charts.ChartMergeStrategy.MERGE_ROWS)
      .setPosition(5, 5, 0, 0)
      .build()

  // 複数の範囲の行（この場合はMERGE_ROWS）がマージされるかどうかを記録します。
  Logger.log(chart.getMergeStrategy());
}

Return
ChartMergeStrategy - 行が複数の範囲にわたってマージされる場合、MERGE_ROWS。列が複数の範囲にわたってマージされる場合、MERGE_COLUMNS。

チャートヘッダー行列数取得[getNumHeaders()]

getNumHeaders()
範囲としてヘッダーとして扱われる行または列の数を返します。

function getNumHeadersSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var range = sheet.getRange("A1:B5");
  var chart = sheet.newChart()
      .setChartType(Charts.ChartType.BAR)
      .addRange(range)
      .setNumHeaders(1)
      .setPosition(5, 5, 0, 0)
      .build()
  // ヘッダーとして使用する行または列の数を記録します。この場合は1です。
  //Logger.log(chart.getHeaders());
  Logger.log(chart.getNumHeaders());
}

Return
Integer - ヘッダーとして処理される行または列の数。負の値は、ヘッダーが自動検出されることを示します。

チャートオプション取得[getOptions()]

getOptions()
高さ、色、軸など、このチャートのオプションを返します。

返されるオプションは不変です。

Return
ChartOptions - 高さ、色、軸など、このグラフのオプション。

チャート範囲取得[getRanges()]

getRanges()
このチャートがデータソースとして使用する範囲を返します。

function getRangesSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var chart = sheet.newChart()
      .setChartType(Charts.ChartType.BAR)
      .addRange(sheet.getRange("A1:B8"))
      .setPosition(5, 5, 0, 0)
      .build();

  var ranges = chart.getRanges();

  // このグラフのデータソースとして1つの範囲しかないため、
  // 「A1：B8」をログに記録します
  for (var i in ranges) {
    var range = ranges[i];
    Logger.log(range.getA1Notation());
  }
}

Return
Range[] - このチャートのデータソースとして機能する範囲の配列。

チャートデータ行列転置取得[getTransposeRowsAndColumns()]

getTransposeRowsAndColumns()
trueの場合、グラフの設定に使用される行と列が切り替えられます。デフォルトはfalseです。

function getTransposeRowsAndColumnsSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var range = sheet.getRange("A1:B5");
  var chart = sheet.newChart()
      .addRange(range)
      .setChartType(Charts.ChartType.BAR)
      .setTransposeRowsAndColumns(true)
      .setPosition(5, 5, 0, 0)
      .build()

  // 行と列を転置するかどうかを記録します。この場合はtrueです。
  Logger.log(chart.getTransposeRowsAndColumns());
}

Return
Boolean - チャートの構築に使用される行と列が転置される場合はtrue。

チャートオブジェクトタイプ取得[getType()]

getType()
このオブジェクトのタイプを取得します。

Return
String - オブジェクトタイプ

チャート変更[modify()]

modify()
このチャートの変更に使用できるEmbeddedChartBuilderを返します。 sheet.updateChart(chart)を呼び出して、変更を保存します。

function getTypeSample() {
  var sheet = SpreadsheetApp.getActiveSheet();
  var chart = sheet.getCharts()[0];
  chart = chart.modify()
      .setOption('width', 800)
      .setOption('height', 640)
      .setPosition(5, 5, 0, 0)
      .build();
  sheet.updateChart(chart);
}

Return
EmbeddedChartBuilder - 埋め込みグラフを作成するためのビルダー。

埋め込みチャートID設定[setId(チャートID)]

setId(id)
UiAppで使用されるこのEmbeddedChartのIDを設定します。

Return
Chart - 連鎖用の埋め込みチャート

埋め込みチャートビルダークラス[EmbeddedChartBuilder]

EmbeddedChartの編集に使用されるビルダー。チャートに加えられた変更は、再構築されたチャートでSheet.updateChart(chart)が呼び出されるまで保存されません。

function embeddedChartBuilderSample() {
  var sheet = SpreadsheetApp.getActiveSheet();
  var range = sheet.getRange("A1:B8");
  var chart = sheet.getCharts()[0];
  chart = chart.modify()
      .addRange(range)
      .setOption('title', 'Updated!')
      .setOption('animation.duration', 500)
      .setPosition(2,2,0,0)
      .build();
  sheet.updateChart(chart);
}

チャート範囲追加[addRange(範囲)]

addRange(range)
このビルダーが変更するグラフに範囲を追加します。既にチャートに追加されている範囲は追加しません。

function addRangeSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var chart = sheet.newChart()
      .setChartType(Charts.ChartType.BAR)
      .addRange(sheet.getRange("A1:B8"))
      .setPosition(5, 5, 0, 0)
      .build();

  sheet.insertChart(chart);
}

Return
EmbeddedChartBuilder - 連鎖用ビルダー。

面グラフ設定[asAreaChart()]

asAreaChart()
チャートタイプをAreaChartに設定し、EmbeddedAreaChartBuilderを返します。

Return
EmbeddedAreaChartBuilder - 面グラフのビルダー。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class EmbeddedAreaChartBuilder

棒グラフ設定[asBarChart()]

asBarChart()
チャートタイプをBarChartに設定し、EmbeddedBarChartBuilderを返します。

Return
EmbeddedBarChartBuilder - 棒グラフのビルダー。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class EmbeddedBarChartBuilder

縦棒グラフ設定[asColumnChart()]

asColumnChart()
チャートタイプをColumnChartに設定し、EmbeddedColumnChartBuilderを返します。

Return
EmbeddedColumnChartBuilder - 縦棒グラフのビルダー。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class EmbeddedColumnChartBuilder

コンボチャート(2つの単位の異なるグラフ)設定[asComboChart()]

asComboChart()
チャートタイプをComboChartに設定し、EmbeddedComboChartBuilderを返します。

Return
EmbeddedComboChartBuilder - コンボチャートのビルダー。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class EmbeddedComboChartBuilder

ヒストグラムチャート設定[asHistogramChart()]

asHistogramChart()
チャートタイプをHistogramChartに設定し、EmbeddedHistogramChartBuilderを返します。

Return
EmbeddedHistogramChartBuilder - ヒストグラムチャートのビルダー。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class EmbeddedHistogramChartBuilder

折れ線グラフ設定[asLineChart()]

asLineChart()
チャートタイプをLineChartに設定し、EmbeddedLineChartBuilderを返します。

Return
EmbeddedLineChartBuilder - 折れ線グラフのビルダー。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class EmbeddedLineChartBuilder

円グラフ設定[asPieChart()]

asPieChart()
チャートタイプをPieChartに設定し、EmbeddedPieChartBuilderを返します。

Return
EmbeddedPieChartBuilder - 円グラフのビルダー。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class EmbeddedPieChartBuilder

散布図設定[asScatterChart()]

asScatterChart()
チャートタイプをScatterChartに設定し、EmbeddedScatterChartBuilderを返します。

Return
EmbeddedScatterChartBuilder - 散布図のビルダー。

参照：Google Apps Script | REFERENCE | SpreadSheet | Class EmbeddedScatterChartBuilder

テーブルチャート設定[asTableChart()]

asTableChart()
チャートタイプをTableChartに設定し、EmbeddedTableChartBuilderを返します。

Return
EmbeddedTableChartBuilder - テーブルチャートのビルダー

参照：Google Apps Script | REFERENCE | SpreadSheet | Class EmbeddedTableChartBuilder

チャート構築[build()]

build()
チャートに加えられたすべての変更を反映するようにチャートを作成します。

このメソッドは、スプレッドシートの上にグラフを自動的に描画しません。新しいチャートは、sheet.insertChart(chart)で挿入する必要があり、既存のチャートはsheet.updateChart(chart)で更新する必要があります。

function buildSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var range = sheet.getRange("A1:B5");
  var chart = sheet.newChart()
      .setChartType(Charts.ChartType.BAR)
      .addRange(range)
      .setPosition(5, 5, 0, 0)
      .build();

  sheet.insertChart(chart);
}

Return
EmbeddedChart - 作成されたグラフ。スプレッドシートに追加する必要があります。

チャート範囲削除[clearRanges()]

clearRanges()
このビルダーが変更するチャートからすべての範囲を削除します。

function clearRangesSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  // このコードは、チャートの既存のフォーマットを維持しながら、
  // 新しい範囲のみを使用するようにチャートを更新します。
  var chart = sheet.getCharts()[0];
  var newChart = chart
      .modify()
      .clearRanges()
      .addRange(sheet.getRange("A1:A5"))
      .addRange(sheet.getRange("B1:B5"))
      .build();
  sheet.updateChart(newChart);
}

Return
EmbeddedChartBuilder - 連鎖用ビルダー。

データページング有効設定1[enablePaging(ページング有効化有無)]

enablePaging(enablePaging)
データのページングを有効にするかどうかを設定します。

デフォルトの動作はページングが無効です。ページングが有効な場合、デフォルトのページサイズは10です。

Return
EmbeddedTableChartBuilder - 連鎖用ビルダー。

データページング有効設定2[enablePaging(ページサイズ)]

enablePaging(pageSize)
ページングを有効にし、各ページの行数を設定します。

デフォルトのページサイズは10です。

function enablePaging2Sample() {
  // テーブルチャートビルダーを作成し、ページサイズ5のページングを有効にします。
  var builder = Charts.newTableChart();
  builder.enablePaging(5);
}

Return
EmbeddedTableChartBuilder - 連鎖用ビルダー。

データページング有効設定3[enablePaging(ページサイズ, 最初のページ)]

enablePaging(pageSize, startPage)
ページングを有効にし、各ページの行数と表示する最初のテーブルページを設定します（ページ番号は0から始まります）。

デフォルトのページサイズは10、デフォルトの開始ページは0です。

function enablePaging3Sample() {
  // テーブルチャートビルダーを作成し、ページサイズ5で
  // ページングを有効にし、最初にページ2を表示します。
  var builder = Charts.newTableChart();
  builder.enablePaging(5, 2);
}

Return
EmbeddedTableChartBuilder - 連鎖用ビルダー。

テーブル列順序逆設定[enableRtlTable(列順序逆有無)]

enableRtlTable(rtlEnabled)
テーブルの列の順序を逆にすることにより、右から左に記述する言語（アラビア語やヘブライ語など）の基本的なサポートを追加します。列0は右端の列で、最後の列は左端の列です。

これは、基になるデータの列インデックスには影響せず、表示の順序にのみ影響します。このオプションを使用しても、テーブルの視覚化では完全な双方向(BiDi)言語表示はサポートされません。ページオプションを使用してページングを有効にした場合、または必要なテーブルサイズよりも小さい高さと幅のオプションを指定したためにテーブルにスクロールバーがある場合、このオプションは無視されます。デフォルトの動作は、RTLサポートが無効になっています。

Return
EmbeddedTableChartBuilder - 連鎖用ビルダー。

列ソート設定[enableSorting(列ソート有無)]

enableSorting(enableSorting)
ユーザーが列見出しをクリックしたときに列をソートするかどうかを設定します。

並べ替えが有効になっている場合、ユーザーが列ヘッダーをクリックすると、行が自動的に並べ替えられます。デフォルトの動作はソートが有効です。

Return
EmbeddedTableChartBuilder - 連鎖用ビルダー。

チャートタイプ取得[getChartType()]

getChartType()
現在のチャートタイプを返します。

Return
ChartType - チャートタイプ

チャート位置取得[getContainer()]

getContainer()
チャートContainerInfoを返します。これは、チャートがシート上のどこに表示されるかをカプセル化します。

function getContainerSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var chartBuilder = sheet.newChart()
      .setChartType(Charts.ChartType.BAR)
      .addRange(sheet.getRange("A1:B8"))
      .setPosition(5, 5, 0, 0);

  // このメソッドは、Chart＃getContainerInfo()とまったく同じデータを返します
  var containerInfo = chartBuilder.getContainer();

  // setPosition()で使用した値を記録します
  Logger.log("Anchor Column: %s\r\nAnchor Row %s\r\nOffset X %s\r\nOffset Y %s",
            containerInfo.getAnchorColumn(),
            containerInfo.getAnchorRow(),
            containerInfo.getOffsetX(),
            containerInfo.getOffsetY());
}

Return
ContainerInfo - チャートコンテナーの位置を含むオブジェクト。

チャート範囲リスト取得[getRanges()]

getRanges()
このチャートに現在データを提供している範囲のリストのコピーを返します。このリストを変更するには、addRange(range)およびremoveRange(range)を使用します。

function getRangesSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var chartBuilder = sheet.newChart()
      .setChartType(Charts.ChartType.BAR)
      .addRange(sheet.getRange("A1:B8"))
      .setPosition(5, 5, 0, 0);

  var ranges = chartBuilder.getRanges();

  // このグラフのデータソースとして1つの範囲しかないため、
  // 「A1：B8」をログに記録します
  for (var i in ranges) {
    var range = ranges[i];
    Logger.log(range.getA1Notation());
  }
}

Return
Range[] - 作成されるデータソースのチャートとして機能する範囲の配列

チャート範囲削除[removeRange(範囲)]

removeRange(range)
このビルダーが変更するチャートから指定された範囲を削除します。範囲がこのチャートにない場合、エラーをスローしません。

削除される範囲は、addRange(range)で追加された範囲と一致する必要があります。それ以外の場合、チャートは変更されません。このメソッドを使用して、範囲から値を部分的に削除することはできません。

function removeRangeSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var firstRange = sheet.getRange("A1:B5");
  var secondRange = sheet.getRange("A6:B8");

  var chartBuilder = sheet.newChart()
      .setChartType(Charts.ChartType.BAR)
      .addRange(firstRange)
      // この範囲は異なる色でレンダリングされます
      .addRange(secondRange)
      .setPosition(5, 5, 0, 0);

  // これらの2つの形式のいずれかを使用できますが、
  // 範囲はaddRange()を介して追加された範囲と一致する必要があります。
  // 一致しない場合は削除されず、例外はスローされません。
  chartBuilder.removeRange(firstRange);
  chartBuilder.removeRange(sheet.getRange("A6:B8"));

  var chart = chartBuilder.build();

  sheet.insertChart(chart);
}

Return
EmbeddedChartBuilder - このビルダー、チェーン用

ドメイン軸描画反転[reverseCategories()]

reverseCategories()
ドメイン軸のシリーズの描画を反転します。垂直範囲グラフ（折れ線グラフ、面グラフ、縦棒グラフなど）の場合、これは水平軸が右から左に描画されることを意味します。水平範囲グラフ（棒グラフなど）の場合、これは垂直軸が上から下に描画されることを意味します。円グラフの場合、これはスライスが反時計回りに描かれることを意味します。

function reverseCategoriesSample() {
  // 円グラフビルダーを作成し、反時計回りにスライスの描画を設定します。
  var builder = Charts.newPieChart();
  builder.reverseCategories();
}

Return
EmbeddedAreaChartBuilder[Bar/Column/Combo/Histogram/Line/Pie] - 連鎖用ビルダー。

水平軸反転[reverseDirection()]

reverseDirection()
バーが水平軸に沿って成長する方向を逆にします。デフォルトでは、値は左から右に増加します。このメソッドを呼び出すと、右から左に成長します。

Return
EmbeddedBarChartBuilder - 連鎖用ビルダー。

チャート3次元設定[set3D()]

set3D()
チャートを3次元に設定します。

Return
EmbeddedPieChartBuilder - This builder, useful for chaining.

チャート背景色設定[setBackgroundColor(スタイルシート値)]

setBackgroundColor(cssValue)
チャートの背景色を設定します。

function setBackgroundColorSample() {
  // 折れ線グラフビルダーを作成し、背景色をグレーに設定します
  var builder = Charts.newLineChart();
  builder.setBackgroundColor("gray");
}

Return
EmbeddedAreaChartBuilder[Bar/Column/Combo/Histogram/Line/Pie/Scatter] - 連鎖用ビルダー。

チャートタイプ設定[setChartType(チャートタイプ)]

setChartType(type)
チャートのタイプを変更します。現在、すべての埋め込みグラフタイプがサポートされているわけではありません。 ChartTypeを参照してください。

function setChartTypeSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var range = sheet.getRange("A1:B5");
  var chart = sheet.newChart()
      .setChartType(Charts.ChartType.BAR)
      .addRange(range)
      .setPosition(5, 5, 0, 0)
      .build();

  sheet.insertChart(chart);
}

Return
EmbeddedChartBuilder - このビルダー、チェーン用

チャート線色設定[setColors(スタイルシート値)]

setColors(cssValues)
チャートの線の色を設定します。

function setColorsSample() {
  // 折れ線グラフビルダーを作成し、最初の2本の線を
  // それぞれ緑と赤で描画するように設定します。
  var builder = Charts.newLineChart();
  builder.setColors(["green", "red"]);
}

Return
EmbeddedAreaChartBuilder[Bar/Column/Combo/Histogram/Line/Pie/Scatter] - 連鎖用ビルダー。

チャート曲線スタイル設定[setCurveStyle(曲線スタイル)]

setCurveStyle(style)
チャートの曲線に使用するスタイルを設定します。許可される曲線スタイルについては、CurveStyleを参照してください。

function setCurveStyleSample() {
  // 折れ線グラフビルダーを作成し、グラフ内の線を湾曲させます。
  var builder = Charts.newLineChart();
  builder.setCurveStyle(Charts.CurveStyle.SMOOTH)
}

Return
EmbeddedLineChartBuilder - 連鎖用ビルダー。

データテーブル最初の行番号設定[setFirstRowNumber(行番号)]

setFirstRowNumber(number)
データテーブルの最初の行の行番号を設定します。

最初の行のデフォルトの行番号は1です。

function setFirstRowNumberSample() {
  // テーブルチャートビルダーを作成し、最初の行を2に設定します。
  var builder = Charts.newTableChart();
  builder.setFirstRowNumber(2);
}

Return
EmbeddedTableChartBuilder - 連鎖用ビルダー。

チャート行列非表示方法設定[setHiddenDimensionStrategy(方法)]

setHiddenDimensionStrategy(strategy)
非表示の行と列に使用する方法を設定します。デフォルトはIGNORE_ROWSです。

function setHiddenDimensionStrategySample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var range = sheet.getRange("A1:B5");
  var chart = sheet.newChart()
      .setChartType(Charts.ChartType.BAR)
      .addRange(range)
      .setHiddenDimensionStrategy(Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS)
      .setPosition(5, 5, 0, 0)
      .build();

  sheet.insertChart(chart);
}

Return
EmbeddedChartBuilder - このビルダー、チェーン用

テーブル昇順ソート列設定[setInitialSortingAscending(ソート列)]

setInitialSortingAscending(column)
テーブルを最初にソート（昇順）する列のインデックスを設定します。

列は昇順でソートされ、それを示す小さな矢印でマークされます。

function setInitialSortingAscendingSample() {
  // テーブルチャートビルダーを作成し、2番目の列（昇順）で並べ替えます。
  var builder = Charts.newTableChart();
  builder.setInitialSortingAscending(2);
}

Return
EmbeddedTableChartBuilder - 連鎖用ビルダー。

テーブル降順ソート列設定[setInitialSortingDescending(ソート列)]

setInitialSortingDescending(column)
テーブルを最初にソート（降順）する列のインデックスを設定します。

列は降順でソートされ、それを示す小さな矢印でマークされます。

function setInitialSortingDescendingSample() {
  // テーブルチャートビルダーを作成し、2番目の列（降順）で並べ替えます。
  var builder = Charts.newTableChart();
  builder.setInitialSortingDescending(2);
}

Return
EmbeddedTableChartBuilder - 連鎖用ビルダー。

チャート凡例位置設定[setLegendPosition(位置)]

setLegendPosition(position)
チャートに対する凡例の位置を設定します。デフォルトでは、凡例はありません。

function setLegendPositionSample() {
  // 折れ線グラフビルダーを作成し、凡例の位置を右に設定します。
  var builder = Charts.newLineChart();
  builder.setLegendPosition(Charts.Position.RIGHT);
}

Return
EmbeddedAreaChartBuilder[Bar/Column/Combo/Histogram/Line/Pie/Scatter] - 連鎖用ビルダー。

チャート凡例テキストスタイル設定[setLegendTextStyle(テキストスタイル)]

setLegendTextStyle(textStyle)
グラフの凡例のテキストスタイルを設定します。

function setLegendTextStyleSample() {
  // 折れ線グラフビルダーを作成し、青色の26ポイントの凡例用に設定します。
  var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
  var style = textStyleBuilder.build();
  var builder = Charts.newLineChart();
  builder.setLegendTextStyle(style);
}

Return
EmbeddedAreaChartBuilder[Bar/Column/Combo/Histogram/Line/Pie/Scatter] - 連鎖用ビルダー。

チャートマージ方法設定[setMergeStrategy(マージ方法)]

setMergeStrategy(mergeStrategy)
複数の範囲が存在する場合に使用するマージ方法を設定します。 MERGE_ROWSの場合、行はマージされます。 MERGE_COLUMNSの場合、列はマージされます。デフォルトはMERGE_COLUMNSです。

function setMergeStrategySample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var range = sheet.getRange("A1:B10");
  var range2 = sheet.getRange("C:C10");
  var chart = sheet.newChart()
      .setChartType(Charts.ChartType.BAR)
      .addRange(range)
      .addRange(range2)
      .setMergeStrategy(Charts.ChartMergeStrategy.MERGE_ROWS)
      .setPosition(5, 5, 0, 0)
      .build();

  sheet.insertChart(chart);
}

Return
EmbeddedChartBuilder - 連鎖用ビルダー。

チャートヘッダー行列数[setNumHeaders(ヘッダー)]

setNumHeaders(headers)
ヘッダーとして処理される範囲の行または列の数を設定します。

function setNumHeadersSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var range = sheet.getRange("A1:B5");
  var chart = sheet.newChart()
      .setChartType(Charts.ChartType.BAR)
      .addRange(range)
      .setNumHeaders(1)
      .setPosition(5, 5, 0, 0)
      .build();

  sheet.insertChart(chart);
}

Return
EmbeddedChartBuilder - このビルダー、チェーン用

チャートオプション設定[setOption(オプション, 値)]

setOption(option, value)
このチャートの詳細オプションを設定します。使用可能なオプションのリストについては、Charts API Chart Galleryでチャートタイプを検索してください。たとえば、面グラフのオプションは次のとおりです。

このメソッドは、指定したオプションがこのチャートタイプに有効であるか、値が正しい形式/構造であるかどうかを検証しません。

この例は、アニメーションの継続時間を1秒に変更し、凡例を設定する方法を示しています。

function setOptionSample() {
  var builder = Charts.newLineChart();
  builder.setOption('title', 'Earnings projections');
  builder.setOption('animation.duration', 1000);
  builder.setOption('legend', {position: 'top', textStyle: {color: 'blue', fontSize: 16}});
}

Return
EmbeddedChartBuilder - このビルダー、チェーン用

ライン内ポイントスタイル設定[setPointStyle(スタイル)]

setPointStyle(style)
ライン内のポイントのスタイルを設定します。デフォルトでは、ポイントには特定のスタイルはなく、線のみが表示されます。

function setPointStyleSample() {
  // 折れ線グラフビルダーを作成し、大きなポイントスタイルを設定します。
  var builder = Charts.newLineChart();
  builder.setPointStyle(Charts.PointStyle.LARGE);
}

Return
EmbeddedAreaChartBuilder[Line/Scatter] - 連鎖用ビルダー。

チャート表示位置設定[setPosition(行位置, 列位置, オフセットX, オフセットY)]

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)
シート上のチャートの表示位置を変更して、位置を設定します。 anchorRowPosとanchorColPosには1のインデックスが付けられます。

function setPositionSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var range = sheet.getRange("A1:B5");
  var chart = sheet.newChart()
      .setChartType(Charts.ChartType.BAR)
      .addRange(range)
      .setPosition(5, 5, 0, 0)
      .build();

  sheet.insertChart(chart);
}

Return
EmbeddedChartBuilder - このビルダー、チェーン用

チャート範囲設定[setRange(開始, 終了)]

setRange(start, end)
チャートの範囲を設定します。

データポイントが範囲外にある場合、範囲はそれらのデータポイントを含むように拡張されます。

Return
EmbeddedAreaChartBuilder[Bar/Column/Combo/Histogram/Line] - 連鎖用ビルダー。

積み上げ設定[setStacked()]

setStacked()
積み上げ行を使用します。つまり、行とバーの値は積み上げられます（累積されます）。デフォルトでは、スタッキングはありません。

Return
EmbeddedAreaChartBuilder[Bar/Column/Combo/Histogram] - 連鎖用ビルダー。

チャートタイトル設定[setTitle(チャートタイトル)]

setTitle(chartTitle)
チャートのタイトルを設定します。タイトルはチャートの中央に表示されます。

function setTitleSample() {
  // 折れ線グラフビルダーを作成し、「My Line Chart」のタイトルを作成します。
  var builder = Charts.newLineChart();
  builder.setTitle('My Line Chart')
}

Return
EmbeddedAreaChartBuilder[Bar/Column/Combo/Histogram/Line/Pie/Scatter] - 連鎖用ビルダー。

チャートタイトルテキストスタイル設定[setTitleTextStyle(テキストスタイル)]

setTitleTextStyle(textStyle)
チャートタイトルのテキストスタイルを設定します。

function setTitleTextStyleSample() {
  // 折れ線グラフビルダーを作成し、青色の26ポイントのタイトルに設定します。
  var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
  var style = textStyleBuilder.build();
  var builder = Charts.newLineChart();
  builder.setTitleTextStyle(style);
}

Return
EmbeddedAreaChartBuilder[Bar/Column/Combo/Histogram/Line/Pie/Scatter] - 連鎖用ビルダー。

チャートデータ行列転置設定[setTransposeRowsAndColumns(転置)]

setTransposeRowsAndColumns(transpose)
チャートの行と列を転置するかどうかを設定します。 trueに設定すると、行と列が切り替わります。デフォルトはfalseです。

function setTransposeRowsAndColumnsSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var range = sheet.getRange("A1:B5");
  var chart = sheet.newChart()
      .setChartType(Charts.ChartType.BAR)
      .addRange(range)
      .setTransposeRowsAndColumns(true)
      .setPosition(5, 5, 0, 0)
      .build();

  sheet.insertChart(chart);
}

Return
EmbeddedChartBuilder - このビルダー、チェーン用

水平軸対数目盛設定[setXAxisLogScale()]

setXAxisLogScale()
水平軸を対数目盛にします（すべての値が正である必要があります）。

Return
EmbeddedScatterChartBuilder - 連鎖用ビルダー。

水平軸範囲設定[setXAxisRange(開始, 終了)]

setXAxisRange(start, end)
チャートの水平軸の範囲を設定します。

データポイントが範囲外にある場合、範囲はそれらのデータポイントを含むように拡張されます。

function setXAxisRangeSample() {
  // 散布図ビルダーを作成し、X軸の範囲を0～100に設定します。
  var builder = Charts.newTableChart();
  builder.setXAxisRange(0, 100);
}

Return
EmbeddedScatterChartBuilder - This builder, useful for chaining.

水平軸テキストスタイル設定[setXAxisTextStyle(テキストスタイル)]

setXAxisTextStyle(textStyle)
水平軸のテキストスタイルを設定します。

function setXAxisTextStyleSample() {
  // 折れ線グラフビルダーを作成し、X軸のテキストスタイルを青の18ポイントフォントに設定します。
  var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
  var builder = Charts.newLineChart();
  builder.setXAxisTextStyle(textStyle);
}

Return
EmbeddedAreaChartBuilder[Bar/Column/Combo/Histogram/Line/Scatter] - 連鎖用ビルダー。

水平軸タイトル設定[setXAxisTitle(タイトル)]

setXAxisTitle(title)
水平軸にタイトルを追加します。タイトルは中央に配置され、軸の値ラベルの下に表示されます。

function setXAxisTitleSample() {
  // 折れ線グラフビルダーを作成し、X軸のタイトルを設定します。
  var builder = Charts.newLineChart();
  //builder.setTitle('X-axis Title')
  builder.setXAxisTitle('X-axis Title')
}

Return
EmbeddedAreaChartBuilder[Bar/Column/Combo/Histogram/Line/Scatter] - 連鎖用ビルダー。

水平軸タイトルテキストスタイル設定[setXAxisTitleTextStyle(テキストスタイル)]

setXAxisTitleTextStyle(textStyle)
水平軸のタイトルテキストスタイルを設定します。

function setXAxisTitleTextStyleSample() {
  // 折れ線グラフビルダーを作成し、X軸のタイトルテキストスタイルを青の18ポイントフォントに設定します。
  var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
  var builder = Charts.newLineChart();
  builder.setXAxisTitleTextStyle(textStyle);
}

Return
EmbeddedAreaChartBuilder[Bar/Column/Combo/Histogram/Line/Scatter] - 連鎖用ビルダー。

垂直軸対数目盛設定[setYAxisLogScale()]

setYAxisLogScale()
縦軸を対数目盛にします（すべての値が正である必要があります）。

Return
EmbeddedScatterChartBuilder - 連鎖用ビルダー。

垂直軸範囲設定[setYAxisRange(開始, 終了)]

setYAxisRange(start, end)
チャートの垂直軸の範囲を設定します。データポイントが範囲外にある場合、範囲はそれらのデータポイントを含むように拡張されます。

function setYAxisRangeSample() {
  // 散布図ビルダーを作成し、Y軸の範囲を0～100に設定します。
  var builder = Charts.newTableChart();
  builder.setYAxisRange(0, 100);
}

Return
EmbeddedScatterChartBuilder - 連鎖用ビルダー。

垂直軸テキストスタイル設定[setYAxisTextStyle(テキストスタイル)]

setYAxisTextStyle(textStyle)
垂直軸のテキストスタイルを設定します。

function setYAxisTextStyleSample() {
  // 折れ線グラフビルダーを作成し、Y軸のテキストスタイルを青の18ポイントフォントに設定します。
  var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
  var builder = Charts.newLineChart();
  builder.setYAxisTextStyle(textStyle);
}

Return
EmbeddedAreaChartBuilder[Bar/Column/Combo/Histogram/Line/Scatter] - 連鎖用ビルダー。

垂直軸タイトル設定[setYAxisTitle(タイトル)]

setYAxisTitle(title)
垂直軸にタイトルを追加します。タイトルは中央に配置され、値ラベルの左側に表示されます。

function setYAxisTitleSample() {
  // 折れ線グラフビルダーを作成し、Y軸のタイトルを設定します。
  var builder = Charts.newLineChart();
  builder.setYAxisTitle('Y-axis Title')
}

Return
EmbeddedAreaChartBuilder[Bar/Column/Combo/Histogram/Line/Scatter] - 連鎖用ビルダー。

垂直軸タイトルテキストスタイル設定[setYAxisTitleTextStyle(テキストスタイル)]

setYAxisTitleTextStyle(textStyle)
垂直軸のタイトルのテキストスタイルを設定します。

function setYAxisTitleTextStyleSample() {
  // 折れ線グラフビルダーを作成し、Y軸のタイトルテキストスタイルを青の18ポイントフォントに設定します。
  var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
  var builder = Charts.newLineChart();
  builder.setYAxisTitleTextStyle(textStyle);
}

Return
EmbeddedAreaChartBuilder[Bar/Column/Combo/Histogram/Line/Scatter] - 連鎖用ビルダー。

テーブル最初の列の行番号表示設定[showRowNumberColumn(表示行番号)]

showRowNumberColumn(showRowNumber)
テーブルの最初の列として行番号を表示するかどうかを設定します。

デフォルトの動作では、行番号は表示されません。

Return
EmbeddedTableChartBuilder - 連鎖用ビルダー。

テーブルチャート交互の色スタイル設定[useAlternatingRowStyle(交互の色有無)]

useAlternatingRowStyle(alternate)
交互の色スタイルをテーブルチャートの奇数行と偶数行に割り当てるかどうかを設定します。

デフォルトの動作は、交互の色スタイルを持つ行です。

Return
EmbeddedTableChartBuilder - 連鎖用ビルダー。

範囲軸対数目盛設定[useLogScale()]

useLogScale()
範囲軸を対数目盛にします（すべての値が正である必要があります）。範囲軸は、垂直チャート（線、面、または列など）の垂直軸と、水平チャート（バーなど）の水平軸です。

Return
EmbeddedAreaChartBuilder[Bar/Column/Combo/Histogram/Line] - 連鎖用ビルダー。

最後に

GASすべてのチャート機能のまとめをご紹介させていただきました。

必要に応じて、有益な情報でさらに更新していきたいと思います。

プログラミングスキルを向上させるためには、本を読むだけでは脳にインプットされませんね。

実際に手を動かしてアウトプットしまくるのが一番の近道だと思います。

実際にサンプルソースをコピーして実行した結果がどうなるかを体験してみてください。

自分なりのアレンジを加えたり、なぜエラーになるのかを考え、何度も試行錯誤して問題を解決しまくり、着実に理解しながらスキルを向上させていきましょう。

GASはExcelVBAとはかなり違いますが、ベースとなっているJavaScriptは覚えて損はないプログラミング言語なのでショートカットキーなどと組み合わせてぜひ活用してみてください。

Googleスプレッドシート全ショートカットキー一覧はこちら↓↓↓

Googleスプレッドシートの全ショートカット集｜プルダウンメニューまで完全網羅

表計算ソフトとして、まだまだExcelのシェア率は高いですが、GoogleスプレッドシートにはExcelにはない超強力な関数があったり、Excelとは違って常に最新版を無料で使用できます。なにより、インターネットを使ったオンライン上での活用...

caymezon.com

2019.03.16

ショートカットキー一覧にもGASメソッドを載せています。どの操作からどのメソッドが呼ばれるのかイメージしてください。

The post 【GAS】スプレッドシートのすべてのチャート機能まとめ【サンプルソース付】 first appeared on CayTech Lab.