Method: users.messages.list

ユーザーのメールボックス内のメールを一覧表示します。

HTTP リクエスト

GET https://gmail.googleapis.com/gmail/v1/users/{userId}/messages

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
userId

string

ユーザーのメールアドレスです。認証されたユーザーを示すには、特別な値 me を使用できます。

クエリ パラメータ

パラメータ
maxResults

integer (uint32 format)

返されるメッセージの最大数。このフィールドのデフォルトは 100 です。このフィールドに許可される最大値は 500 です。
pageToken

string

リスト内の特定のページの結果を取得するためのページトークン。
q

string

指定されたクエリに一致するメッセージのみを返します。Gmail の検索ボックスと同じクエリ形式をサポートしています。たとえば、"from:someuser@example.com rfc822msgid:<somemsgid@example.com> is:unread".gmail.metadata スコープを使用して API にアクセスする場合、パラメータは使用できません。
labelIds[]

string

指定されたすべてのラベル ID に一致するラベルが付いたメッセージのみを返します。スレッド内のメッセージには、同じスレッド内の他のメッセージにはないラベルが付いている場合があります。詳細については、メッセージとスレッドのラベルを管理するをご覧ください。
includeSpamTrash

boolean

SPAM と TRASH のメッセージを結果に含めます。

リクエストの本文

リクエストの本文は空にする必要があります。

レスポンスの本文

成功すると、レスポンスの本文に次の構造のデータが含まれます。

JSON 表現 
{
  "messages": [
    {
      object (Message)
    }
  ],
  "nextPageToken": string,
  "resultSizeEstimate": integer
}
フィールド
messages[]

object (Message)

メッセージのリスト。各メッセージ リソースには id と threadId のみが含まれます。メッセージの詳細は、messages.get メソッドを使用して取得できます。
nextPageToken

string

リスト内の次のページの結果を取得するためのトークン。
resultSizeEstimate

integer (uint32 format)

推定される結果の合計数。

認可スコープ

以下のいずれかの OAuth スコープが必要です。

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.readonly
  • https://www.googleapis.com/auth/gmail.metadata

詳しくは、認可ガイドをご覧ください。