- בקשת HTTP
- פרמטרים של נתיב
- פרמטרים של שאילתה
- גוף הבקשה
- גוף התשובה
- היקפי הרשאות
- HistoryType
- היסטוריה
- MessageAdded
- MessageDeleted
- LabelAdded
- LabelRemoved
- רוצים לנסות?
רשימת ההיסטוריה של כל השינויים בתיבת הדואר הנתונה. תוצאות ההיסטוריה מוחזרות בסדר כרונולוגי (עולה historyId
).
בקשת HTTP
GET https://gmail.googleapis.com/gmail/v1/users/{userId}/history
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
userId |
זוהי כתובת האימייל של המשתמש. ניתן להשתמש בערך המיוחד |
פרמטרים של שאילתה
פרמטרים | |
---|---|
maxResults |
המספר המקסימלי של רשומות היסטוריה להחזרה. ערך ברירת המחדל של שדה זה הוא 100. הערך המקסימלי המותר בשדה הזה הוא 500. |
pageToken |
אסימון דף לאחזור דף מסוים של תוצאות ברשימה. |
startHistoryId |
חובה. הפונקציה מחזירה את רשומות ההיסטוריה אחרי |
labelId |
מחזירים רק הודעות עם תווית שתואמת למזהה. |
historyTypes[] |
סוגי היסטוריה שהפונקציה מחזירה |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התגובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
ייצוג JSON |
---|
{
"history": [
{
object ( |
שדות | |
---|---|
history[] |
רשימה של רשומות היסטוריה. כל |
nextPageToken |
אסימון דף לאחזור דף התוצאות הבא ברשימה. |
historyId |
מזהה תיעוד ההיסטוריה הנוכחי של תיבת הדואר. |
היקפי הרשאות
כדי להשתמש בתכונה הזו יש צורך באחד מההיקפים הבאים של OAuth:
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
למידע נוסף, ניתן לעיין במדריך ההרשאות.
HistoryType
טיפוסים בני מנייה (enums) | |
---|---|
messageAdded |
|
messageDeleted |
|
labelAdded |
|
labelRemoved |
היסטוריה
רשומה שכוללת שינוי בתיבת הדואר של המשתמש. כל שינוי בהיסטוריה עשוי להשפיע על הודעות מרובות במספר דרכים.
ייצוג JSON |
---|
{ "id": string, "messages": [ { object ( |
שדות | |
---|---|
id |
מזהה הרצף של תיבת הדואר. |
messages[] |
רשימת ההודעות שונתה ברשומת ההיסטוריה הזו. השדות של סוגי שינויים ספציפיים, כמו |
messagesAdded[] |
הודעות שנוספו לתיבת הדואר ברשומת ההיסטוריה הזו. |
messagesDeleted[] |
הודעות שנמחקו (לא הועברו לאשפה) מתיבת הדואר ברשומת ההיסטוריה הזו. |
labelsAdded[] |
תוויות שנוספו להודעות ברשומת ההיסטוריה הזו. |
labelsRemoved[] |
תוויות הוסרו מהודעות ברשומת ההיסטוריה הזו. |
MessageAdded
ייצוג JSON |
---|
{
"message": {
object ( |
שדות | |
---|---|
message |
|
MessageDeleted
ייצוג JSON |
---|
{
"message": {
object ( |
שדות | |
---|---|
message |
|
LabelAdded
ייצוג JSON |
---|
{
"message": {
object ( |
שדות | |
---|---|
message |
|
labelIds[] |
מזהי התוויות נוספו להודעה. |
LabelRemoved
ייצוג JSON |
---|
{
"message": {
object ( |
שדות | |
---|---|
message |
|
labelIds[] |
מזהי התוויות הוסרו מההודעה. |