- HTTP isteği
- Yol parametreleri
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- HistoryType
- Geçmiş
- MessageAdded
- MessageDeleted
- LabelAdded
- LabelRemoved
- Deneyin.
Belirli bir posta kutusundaki tüm değişikliklerin geçmişini listeler. Geçmiş sonuçları kronolojik sırada (historyId
artarak) 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 |
Sayfa jetonu 'nu kullanın. |
startHistoryId |
Zorunlu. Belirtilen |
labelId |
Yalnızca kimlikle eşleşen 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 herhangi bir |
nextPageToken |
Sayfa jetonu 'nu kullanın. |
historyId |
Posta kutusunun mevcut 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ılavuzuna göz atın.
HistoryType
Sıralamalar | |
---|---|
messageAdded |
|
messageDeleted |
|
labelAdded |
|
labelRemoved |
İzledikleriniz
Kullanıcının posta kutusunda yapılan değişikliklerin kaydı. Her geçmiş değişikliği, birden fazla mesajı farklı şekilde 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 ait alanlar (ör. |
messagesAdded[] |
İletiler bu geçmiş kaydında posta kutusuna eklendi. |
messagesDeleted[] |
Bu geçmiş kaydında posta kutusundan silinen (Çöp Kutusuna gönderilmeyen) iletiler. |
labelsAdded[] |
Bu geçmiş kaydındaki iletilere etiketler eklendi. |
labelsRemoved[] |
Bu geçmiş kaydındaki iletilerden kaldırılan etiketler. |
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ı. |