Method: users.history.list

string

ユーザーのメールアドレス。特別な値 me を使用して、認証済みユーザーを示すことができます。

integer (uint32 format)

返される履歴レコードの最大数。このフィールドのデフォルトは 100 です。このフィールドに指定できる最大値は 500 です。

string

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

string

必須。指定された startHistoryId の後の履歴レコードを返します。指定された startHistoryId は、メッセージ、スレッド、または前の list レスポンスの historyId から取得する必要があります。履歴 ID は時系列で増加しますが、有効な ID 間にランダムなギャップが生じることはありません。無効または古くなった startHistoryId を指定すると、通常は HTTP 404 エラーコードが返されます。historyId は通常、少なくとも 1 週間有効ですが、まれに数時間のみ有効な場合もあります。HTTP 404 エラー レスポンスが返された場合は、アプリケーションで完全同期を実行する必要があります。レスポンスに nextPageToken がない場合は、取得するアップデートはなく、返された historyId を今後のリクエストのために保存できます。

string

ラベルが ID と一致するメールのみを返します。

enum (HistoryType)

関数によって返される履歴の型

{
  "id": string,
  "messages": [
    {
      object (Message)
    }
  ],
  "messagesAdded": [
    {
      object (MessageAdded)
    }
  ],
  "messagesDeleted": [
    {
      object (MessageDeleted)
    }
  ],
  "labelsAdded": [
    {
      object (LabelAdded)
    }
  ],
  "labelsRemoved": [
    {
      object (LabelRemoved)
    }
  ]
}

string

メールボックス シーケンス ID。

object (Message)

この履歴レコードで変更されたメッセージのリスト。特定の変更タイプのフィールド（messagesAdded など）では、このフィールドのメッセージが重複することがあります。このフィールドの代わりに、特定の変更タイプのフィールドを使用することをおすすめします。

object (MessageAdded)

この履歴レコードのメールボックスに追加されたメッセージ。

object (MessageDeleted)

この履歴レコードのメールボックスから削除されたメッセージ（ゴミ箱にあるメッセージではありません）。

object (LabelAdded)

この履歴レコードのメッセージに追加されたラベル。

object (LabelRemoved)

この履歴レコードのメッセージから削除されたラベル。

{
  "message": {
    object (Message)
  }
}

object (Message)

{
  "message": {
    object (Message)
  }
}

object (Message)

{
  "message": {
    object (Message)
  },
  "labelIds": [
    string
  ]
}

object (Message)

string

メッセージに追加されたラベル ID。

{
  "message": {
    object (Message)
  },
  "labelIds": [
    string
  ]
}

object (Message)

string

メッセージからラベル ID を削除しました。