Method: users.drafts.list

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

HTTP リクエスト

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

この 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" です。
includeSpamTrash

boolean

SPAM と TRASH の下書きを結果に含める。

リクエスト本文

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

レスポンスの本文

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

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

object (Draft)

下書きのリスト。各 Draft リソースの 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.compose
  • https://www.googleapis.com/auth/gmail.readonly

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