Gmail Service

Gmail

このサービスでは、メールの送信、下書きの作成、ラベルの管理、メッセージとスレッドのマーク付け、その他さまざまな Gmail アカウント管理タスクを実行できます。メールの送信のみを許可するシンプルなサービスである Mail Service もご覧ください。

クラス

名前概要
GmailAppGmail のスレッド、メッセージ、ラベルへのアクセスを提供します。
GmailAttachmentGmail からの添付ファイル。
GmailDraftユーザーの Gmail アカウントでユーザーが作成した下書きメッセージ。
GmailLabelユーザーの Gmail アカウントでユーザーが作成したラベル。
GmailMessageユーザーの Gmail アカウント内のメッセージ。
GmailThreadユーザーの Gmail アカウント内のスレッド。

GmailApp

メソッド

メソッド戻り値の型概要
createDraft(recipient, subject, body)GmailDraftメール メッセージの下書きを作成します。
createDraft(recipient, subject, body, options)GmailDraft省略可能な引数を使用して、メール メッセージの下書きを作成します。
createLabel(name)GmailLabel指定された名前の新しいユーザーラベルを作成します。
deleteLabel(label)GmailApp指定されたラベルを削除します。
getAliases()String[]Gmail でこのアカウントのエイリアスとして設定されているメールのリストを取得します。
getDraft(draftId)GmailDraftID でメール メッセージの下書きを取得します。
getDraftMessages()GmailMessage[]すべての下書きメッセージを取得します。
getDrafts()GmailDraft[]すべての Gmail 下書きメールを取得します。
getInboxThreads()GmailThread[]ラベルに関係なく、受信トレイのすべてのスレッドを取得します。
getInboxThreads(start, max)GmailThread[]ラベルに関係なく、受信トレイのスレッドの範囲を取得します。
getInboxUnreadCount()Integer受信トレイ内の未読スレッドの数を取得します。
getMessageById(id)GmailMessageID でメッセージを取得します。
getMessagesForThread(thread)GmailMessage[]指定されたスレッド内のすべてのメッセージを取得します。
getMessagesForThreads(threads)GmailMessage[][]指定されたスレッド内のすべてのメッセージを取得します。
getPriorityInboxThreads()GmailThread[]ラベルに関係なく、優先受信トレイのすべてのスレッドを取得します。
getPriorityInboxThreads(start, max)GmailThread[]ラベルに関係なく、優先トレイのスレッドの範囲を取得します。
getPriorityInboxUnreadCount()Integer優先トレイ内の未読スレッドの数を取得します。
getSpamThreads()GmailThread[]ラベルに関係なく、すべてのスパム スレッドを取得します。
getSpamThreads(start, max)GmailThread[]ラベルに関係なく、スパム スレッドの範囲を取得します。
getSpamUnreadCount()Integer迷惑メールの未読スレッドの数を取得します。
getStarredThreads()GmailThread[]ラベルに関係なく、スター付きのすべてのスレッドを取得します。
getStarredThreads(start, max)GmailThread[]ラベルに関係なく、スター付きスレッドの範囲を取得します。
getStarredUnreadCount()Integerスター付きの未読スレッドの数を取得します。
getThreadById(id)GmailThreadID でスレッドを取得します。
getTrashThreads()GmailThread[]ラベルに関係なく、すべてのゴミ箱スレッドを取得します。
getTrashThreads(start, max)GmailThread[]ラベルに関係なく、ゴミ箱内のスレッドの範囲を取得します。
getUserLabelByName(name)GmailLabelラベル名で指定されたラベルを取得します。
getUserLabels()GmailLabel[]ユーザーが作成したラベルのリストを取得します。
markMessageRead(message)GmailAppこのメッセージを既読にし、メッセージを強制的に更新します。
markMessageUnread(message)GmailAppこのメッセージを未読としてマークし、メッセージを強制的に更新します。
markMessagesRead(messages)GmailAppこれらのメッセージを既読にし、メッセージを強制的に更新します。
markMessagesUnread(messages)GmailAppこれらのメッセージを未読としてマークし、メッセージを強制的に更新します。
markThreadImportant(thread)GmailAppこのスレッドを重要としてマークし、スレッドを強制的に更新します。
markThreadRead(thread)GmailAppこのスレッドを既読にし、スレッドを強制的に更新します。
markThreadUnimportant(thread)GmailAppこのスレッドを重要でないとマークし、スレッドを強制的に更新します。
markThreadUnread(thread)GmailAppこのスレッドを未読としてマークし、スレッドを強制的に更新します。
markThreadsImportant(threads)GmailAppこれらのスレッドを重要としてマークし、スレッドを強制的に更新します。
markThreadsRead(threads)GmailAppこれらのスレッドを既読にし、スレッドを強制的に更新します。
markThreadsUnimportant(threads)GmailAppこれらのスレッドを重要でないとマークし、スレッドの更新を強制します。
markThreadsUnread(threads)GmailAppこれらのスレッドを未読としてマークし、スレッドを強制的に更新します。
moveMessageToTrash(message)GmailAppメールをゴミ箱に移動し、メールを強制的に更新します。
moveMessagesToTrash(messages)GmailApp指定されたメッセージをゴミ箱に移動し、メッセージの更新を強制します。
moveThreadToArchive(thread)GmailAppこのスレッドをアーカイブに移動し、スレッドを強制的に更新します。
moveThreadToInbox(thread)GmailAppこのスレッドを受信トレイに移動し、スレッドを強制的に更新します。
moveThreadToSpam(thread)GmailAppこのスレッドをスパムに移動し、スレッドを強制的に更新します。
moveThreadToTrash(thread)GmailAppこのスレッドをゴミ箱に移動し、スレッドを強制的に更新します。
moveThreadsToArchive(threads)GmailAppこれらのスレッドをアーカイブに移動し、スレッドを強制的に更新します。
moveThreadsToInbox(threads)GmailAppこれらのスレッドを受信トレイに移動し、スレッドを強制的に更新します。
moveThreadsToSpam(threads)GmailAppこれらのスレッドを迷惑メールに移動し、スレッドを強制的に更新します。
moveThreadsToTrash(threads)GmailAppこれらのスレッドをゴミ箱に移動し、スレッドの更新を強制します。
refreshMessage(message)GmailAppGmail からメッセージと関連する状態を再読み込みします(ラベルや既読状態などが変更された場合に便利です)。
refreshMessages(messages)GmailAppGmail からメッセージと関連する状態を再読み込みします(ラベルや既読状態などが変更された場合に便利です)。
refreshThread(thread)GmailAppGmail からスレッドと関連する状態を再読み込みします(ラベルや既読状態などが変更された場合に便利です)。
refreshThreads(threads)GmailAppGmail からスレッドと関連する状態を再読み込みします(ラベルや既読状態などが変更された場合に便利です)。
search(query)GmailThread[]指定されたクエリで Gmail を検索します。
search(query, start, max)GmailThread[]指定されたクエリで Gmail を検索します。
sendEmail(recipient, subject, body)GmailAppメール メッセージを送信します。
sendEmail(recipient, subject, body, options)GmailApp省略可能な引数を使用してメール メッセージを送信します。
setCurrentMessageAccessToken(accessToken)voidスクリプトが現在の GmailMessage プロパティにアクセスできるようにする現在のメッセージ アクセス トークンを設定します。
starMessage(message)GmailAppこのメッセージにスターを付け、メッセージを強制的に更新します。
starMessages(messages)GmailAppこれらのメッセージにスターを追加し、メッセージを強制的に更新します。
unstarMessage(message)GmailAppこのメッセージからスターを外し、メッセージを強制的に更新します。
unstarMessages(messages)GmailAppこれらのメッセージからスターを削除し、メッセージを強制的に更新します。

GmailAttachment

メソッド

メソッド戻り値の型概要
copyBlob()Blobこの blob のコピーを返します。
getAs(contentType)Blobこのオブジェクト内のデータを、指定されたコンテンツ タイプに変換された blob として返します。
getBytes()Byte[]この blob に保存されているデータを取得します。
getContentType()Stringこの blob のバイトのコンテンツ タイプを取得します。
getDataAsString()Stringこの blob のデータを UTF-8 エンコードの文字列として取得します。
getDataAsString(charset)Stringこの blob のデータを指定されたエンコードで文字列として取得します。
getHash()Stringこの添付ファイルの SHA1 コンテンツ ハッシュを取得します。
getName()Stringこの blob の名前を取得します。
getSize()Integerこの添付ファイルのサイズを取得します。
isGoogleType()Booleanこの BLOB が Google Workspace ファイル(スプレッドシート、ドキュメントなど)であるかどうかを返します。
setBytes(data)Blobこの blob に保存されているデータを設定します。
setContentType(contentType)Blobこの blob のバイトのコンテンツ タイプを設定します。
setContentTypeFromExtension()Blobファイル拡張子に基づいて、この Blob のバイトのコンテンツ タイプを設定します。
setDataFromString(string)BlobUTF-8 エンコードの文字列からこの blob のデータを設定します。
setDataFromString(string, charset)Blob指定されたエンコードの文字列からこの BLOB のデータを設定します。
setName(name)Blobこの BLOB の名前を設定します。

GmailDraft

メソッド

メソッド戻り値の型概要
deleteDraft()voidこの下書きメッセージを削除します。
getId()Stringこの下書きメッセージの ID を取得します。
getMessage()GmailMessageこの下書きを表す GmailMessage を返します。
getMessageId()Stringこの下書きを表す GmailMessage の ID を返します。
send()GmailMessageこの下書きメール メッセージを送信します。
update(recipient, subject, body)GmailDraftこの下書きメッセージの内容を置き換えます。
update(recipient, subject, body, options)GmailDraft省略可能な引数を使用して、この下書きメッセージの内容を置き換えます。

GmailLabel

メソッド

メソッド戻り値の型概要
addToThread(thread)GmailLabel指定されたスレッドにこのラベルを追加し、スレッドを強制的に更新します(GmailThread.refresh())。
addToThreads(threads)GmailLabel指定されたスレッドにこのラベルを追加し、スレッドを強制的に更新します。
deleteLabel()voidこのラベルを削除します。
getId()Stringこのラベルの ID を取得します。
getName()Stringこのラベルの名前を取得します。
getThreads()GmailThread[]このラベルでマークされたスレッドを取得します。
getThreads(start, max)GmailThread[]このラベルが付けられたスレッドの範囲を取得します。
getUnreadCount()Integerこのラベルが付けられた未読のスレッドの数を取得します。
removeFromThread(thread)GmailLabel指定されたスレッドからこのラベルを削除し、スレッドを強制的に更新します。
removeFromThreads(threads)GmailLabel指定されたスレッドからこのラベルを削除し、スレッドを強制的に更新します。

GmailMessage

メソッド

メソッド戻り値の型概要
createDraftReply(body)GmailDraft返信先アドレスを使用して、このメッセージの送信者に返信する下書きメッセージを作成します。
createDraftReply(body, options)GmailDraft返信先アドレスを使用してこのメッセージの送信者に返信する下書きメッセージを作成します。省略可能な引数があります。
createDraftReplyAll(body)GmailDraft返信先アドレスとこのメッセージのすべての受信者を使用して、送信者に返信する下書きメッセージを作成します。
createDraftReplyAll(body, options)GmailDraft返信先アドレスとすべての受信者を使用して、このメッセージの送信者に返信する下書きメッセージを作成します。省略可能な引数を使用できます。
forward(recipient)GmailMessageこのメッセージを新しい受信者に転送します。
forward(recipient, options)GmailMessageこのメッセージを新しい受信者に転送します(省略可能な引数を使用)。
getAttachments()GmailAttachment[]このメッセージのすべての添付ファイルを取得します。
getAttachments(options)GmailAttachment[]このメッセージのすべての添付ファイルを取得します。
getBcc()Stringこのメッセージの Bcc に追加された受信者のカンマ区切りリストを取得します。
getBody()Stringこのメッセージの本文の HTML コンテンツを取得します。
getCc()Stringこのメッセージの Cc に追加された受信者のカンマ区切りリストを取得します。
getDate()Dateこのメッセージの日時を取得します。
getFrom()Stringこのメッセージの送信者を取得します。
getHeader(name)Stringヘッダー名が指定された RFC 2822 ヘッダーの値を取得します。
getId()Stringこのメッセージの ID を取得します。
getPlainBody()StringHTML 形式なしでこのメッセージの本文のコンテンツを取得します。
getRawContent()Stringこのメッセージの未加工のコンテンツを取得します。
getReplyTo()Stringこのメッセージの返信先アドレス(通常は送信者)を取得します。
getSubject()Stringこのメッセージの件名を取得します。
getThread()GmailThreadこのメッセージを含むスレッドを取得します。
getTo()Stringこのメッセージの受信者をカンマ区切りで取得します。
isDraft()Booleanこのメッセージが下書きかどうかを取得します。
isInChats()Booleanこのメッセージがチャットかどうかを取得します。
isInInbox()Booleanこのメッセージが受信トレイにあるかどうかを取得します。
isInPriorityInbox()Booleanこのメッセージが優先受信トレイにある場合は true を返し、それ以外の場合は false を返します。
isInTrash()Booleanこのメッセージがゴミ箱にあるかどうかを取得します。
isStarred()Booleanこのメッセージにスターが付いているかどうかを取得します。
isUnread()Booleanこのメッセージが未読かどうかを取得します。
markRead()GmailMessageメールが既読になります。
markUnread()GmailMessageメールを未読としてマークします。
moveToTrash()GmailMessageメールをゴミ箱に移動します。
refresh()GmailMessageこのメッセージと関連する状態を Gmail から再読み込みします(ラベルや既読状態などが変更された場合に便利です)。
reply(body)GmailMessage返信先アドレスを使用して、このメッセージの送信者に返信します。
reply(body, options)GmailMessage返信先アドレスを使用して、このメッセージの送信者に返信します(引数は省略可)。
replyAll(body)GmailMessage返信先アドレスとこのメッセージのすべての受信者を使用して、送信者に返信します。
replyAll(body, options)GmailMessage返信先アドレスとすべての受信者を使用して、このメッセージの送信者に返信します(引数は省略可)。
star()GmailMessageメッセージにスターを付けます。
unstar()GmailMessageメッセージのスターを外します。

GmailThread

メソッド

メソッド戻り値の型概要
addLabel(label)GmailThreadこのラベルをスレッドに追加します。
createDraftReply(body)GmailDraft返信先アドレスを使用して、このスレッドの最後のメッセージの送信者に返信する下書きメッセージを作成します。
createDraftReply(body, options)GmailDraftこのスレッドの最後のメッセージの送信者に返信する下書きメッセージを、返信先アドレスとオプションの引数を使用して作成します。
createDraftReplyAll(body)GmailDraftこのスレッドの最後のメッセージの送信者に返信する下書きメッセージを、返信先アドレスとこのメッセージのすべての受信者を使用して作成します。
createDraftReplyAll(body, options)GmailDraftこのスレッドの最後のメッセージの送信者に返信する下書きメッセージを、返信先アドレスとすべての受信者を使用して作成します。省略可能な引数も使用できます。
getFirstMessageSubject()Stringスレッド内の最初のメッセージの件名を取得します。
getId()Stringこのスレッドの ID を取得します。
getLabels()GmailLabel[]このスレッドのユーザー作成ラベルを返します。
getLastMessageDate()Dateこのスレッドの最新のメッセージの日付を取得します。
getMessageCount()Integerスレッド内のメッセージ数を返します。
getMessages()GmailMessage[]このスレッドのメッセージを取得します。
getPermalink()Stringこのスレッドのパーマリンクを取得します。
hasStarredMessages()Booleanスレッドにスター付きのメッセージがあるかどうかを返します。
isImportant()Booleanスレッドに重要マークが付いているかどうかを返します。
isInChats()Booleanスレッドにチャットのラベルが付いているかどうかを返します。
isInInbox()Booleanスレッドが受信トレイにあるかどうかを返します。
isInPriorityInbox()Booleanこのスレッドが優先受信トレイにある場合は true を返し、それ以外の場合は false を返します。
isInSpam()Booleanスレッドがスパムとしてマークされているかどうかを返します。
isInTrash()Booleanスレッドがゴミ箱にあるかどうかを返します。
isUnread()Booleanスレッドに未読のメッセージがあるかどうかを返します。
markImportant()GmailThreadこのスレッドに重要マークを付けます。
markRead()GmailThreadこのスレッドを既読にします。
markUnimportant()GmailThreadこのスレッドを重要でないとマークします。
markUnread()GmailThreadこのスレッドを未読にします。
moveToArchive()GmailThreadこのスレッドをアーカイブに移動します。
moveToInbox()GmailThreadこのスレッドを受信トレイに移動します。
moveToSpam()GmailThreadこのスレッドを迷惑メールに移動します。
moveToTrash()GmailThreadこのスレッドをゴミ箱に移動します。
refresh()GmailThreadこのスレッドと関連する状態を Gmail から再読み込みします(ラベルや既読状態などが変更された場合に便利です)。
removeLabel(label)GmailThreadスレッドからこのラベルを削除します。
reply(body)GmailThreadreplyTo アドレスを使用して、このスレッドの最後のメッセージの送信者に返信します。
reply(body, options)GmailThreadこのスレッドの最後のメッセージの送信者に、replyTo アドレスを使用して返信します(引数は省略可)。
replyAll(body)GmailThread送信者(replyTo アドレスを使用)と、このスレッドの最後のメッセージのすべての受信者に返信します。
replyAll(body, options)GmailThreadこのスレッドの最後のメッセージの送信者(replyTo アドレスを使用)とすべての受信者に、オプションの引数を指定して返信します。