Method: users.history.list

Mencantumkan histori semua perubahan ke kotak surat tertentu. Hasil histori ditampilkan dalam urutan kronologis (meningkatkan historyId).

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
userId

string

Alamat email pengguna. Nilai khusus me dapat digunakan untuk menunjukkan pengguna terautentikasi.

Parameter kueri

Parameter
maxResults

integer (uint32 format)

Jumlah maksimum catatan histori untuk ditampilkan. Kolom ini ditetapkan secara default ke 100. Nilai maksimum yang diizinkan untuk kolom ini adalah 500.

pageToken

string

Token halaman untuk mengambil halaman hasil tertentu dalam daftar.

startHistoryId

string

Wajib. Menampilkan catatan histori setelah startHistoryId yang ditentukan. startHistoryId yang diberikan harus diperoleh dari historyId pesan, rangkaian pesan, atau respons list sebelumnya. ID histori meningkat secara kronologis, tetapi tidak berurutan dengan celah acak di antara ID yang valid. Memberikan startHistoryId yang tidak valid atau tidak berlaku lagi biasanya akan menampilkan kode error HTTP 404. historyId biasanya valid setidaknya selama seminggu, tetapi dalam beberapa situasi yang jarang terjadi mungkin valid hanya selama beberapa jam. Jika Anda menerima respons error HTTP 404, aplikasi Anda harus melakukan sinkronisasi penuh. Jika Anda tidak menerima nextPageToken dalam respons, tidak ada update yang dapat diambil dan Anda dapat menyimpan historyId yang ditampilkan untuk permintaan mendatang.

labelId

string

Hanya tampilkan pesan dengan label yang cocok dengan ID.

historyTypes[]

enum (HistoryType)

Jenis histori yang akan ditampilkan oleh fungsi

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON
{
  "history": [
    {
      object (History)
    }
  ],
  "nextPageToken": string,
  "historyId": string
}
Kolom
history[]

object (History)

Daftar catatan histori. Setiap messages yang terdapat dalam respons biasanya hanya akan memiliki kolom id dan threadId yang terisi.

nextPageToken

string

Token halaman untuk mengambil halaman hasil berikutnya dalam daftar.

historyId

string

ID catatan histori kotak surat saat ini.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • 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

Untuk informasi selengkapnya, lihat Panduan otorisasi.

HistoryType

Enum
messageAdded
messageDeleted
labelAdded
labelRemoved

Histori

Kumpulan data perubahan kotak surat pengguna. Setiap perubahan histori dapat memengaruhi beberapa pesan dengan beberapa cara.

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

string

ID urutan kotak surat.

messages[]

object (Message)

Daftar pesan yang diubah dalam catatan histori ini. Kolom untuk jenis perubahan tertentu, seperti messagesAdded dapat menduplikasi pesan di kolom ini. Sebaiknya gunakan kolom jenis perubahan yang spesifik, bukan ini.

messagesAdded[]

object (MessageAdded)

Pesan ditambahkan ke kotak surat dalam catatan histori ini.

messagesDeleted[]

object (MessageDeleted)

Pesan dihapus (tidak Dibuang) dari kotak surat dalam catatan histori ini.

labelsAdded[]

object (LabelAdded)

Label ditambahkan ke pesan dalam catatan histori ini.

labelsRemoved[]

object (LabelRemoved)

Label dihapus dari pesan dalam catatan histori ini.

MessageAdded

Representasi JSON
{
  "message": {
    object (Message)
  }
}
Kolom
message

object (Message)

MessageDeleted

Representasi JSON
{
  "message": {
    object (Message)
  }
}
Kolom
message

object (Message)

LabelAdded

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

object (Message)

labelIds[]

string

ID label ditambahkan ke pesan.

LabelRemoved

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

object (Message)

labelIds[]

string

ID label dihapus dari pesan.