- HTTP isteği
- Yol parametreleri
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- HistoryType
- Tarih
- MessageAdded
- MessageDeleted
- LabelAdded
- LabelRemoved
- Deneyin.
Belirtilen posta kutusunda yapılan tüm değişikliklerin geçmişini listeler. Geçmiş sonuçları kronolojik sırada (artan historyId
) döndürülür.
HTTP isteği
GET https://gmail.googleapis.com/gmail/v1/users/{userId}/history
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
userId |
Kullanıcının e-posta adresi. |
Sorgu parametreleri
Parametreler | |
---|---|
maxResults |
Döndürülecek maksimum geçmiş kaydı sayısı. Bu alanın varsayılan değeri 100'dür. Bu alan için izin verilen maksimum değer 500'dür. |
pageToken |
Listedeki belirli bir sonuç sayfasını almak için sayfa jetonu. |
startHistoryId |
Zorunlu. Belirtilen |
labelId |
Yalnızca kimlikle eşleşen bir etikete sahip iletileri döndür. |
historyTypes[] |
İşlev tarafından döndürülecek geçmiş türleri |
İstek içeriği
İstek metni boş olmalıdır.
Yanıt gövdesi
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{
"history": [
{
object ( |
Alanlar | |
---|---|
history[] |
Geçmiş kayıtlarının listesi. Yanıtta yer alan |
nextPageToken |
Listedeki sonuçların sonraki sayfasını almak için sayfa jetonu. |
historyId |
Posta kutusunun şu anki geçmiş kaydının kimliği. |
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
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
Daha fazla bilgi için Yetkilendirme kılavuzunu inceleyin.
HistoryType
Sıralamalar | |
---|---|
messageAdded |
|
messageDeleted |
|
labelAdded |
|
labelRemoved |
Geçmiş
Kullanıcının posta kutusunda yapılan bir değişikliğin kaydı. Geçmişteki her değişiklik birden fazla mesajı çeşitli şekillerde etkileyebilir.
JSON gösterimi |
---|
{ "id": string, "messages": [ { object ( |
Alanlar | |
---|---|
id |
Posta kutusu sıra kimliği. |
messages[] |
Bu geçmiş kaydında değiştirilen mesajların listesi. Belirli değişiklik türlerine (ör. |
messagesAdded[] |
İletiler, bu geçmiş kaydındaki posta kutusuna eklendi. |
messagesDeleted[] |
İletiler, bu geçmiş kaydındaki posta kutusundan silindi (Çöp Kutusu'na gönderilmedi). |
labelsAdded[] |
Bu geçmiş kaydındaki iletilere etiketler eklendi. |
labelsRemoved[] |
Etiketler, bu geçmiş kaydındaki iletilerden kaldırıldı. |
MessageAdded
JSON gösterimi |
---|
{
"message": {
object ( |
Alanlar | |
---|---|
message |
|
MessageDeleted
JSON gösterimi |
---|
{
"message": {
object ( |
Alanlar | |
---|---|
message |
|
LabelAdded
JSON gösterimi |
---|
{
"message": {
object ( |
Alanlar | |
---|---|
message |
|
labelIds[] |
İletiye eklenen etiket kimlikleri. |
LabelRemoved
JSON gösterimi |
---|
{
"message": {
object ( |
Alanlar | |
---|---|
message |
|
labelIds[] |
Etiket kimlikleri iletiden kaldırıldı. |