ارسال بازخورد
Method: users.history.list
با مجموعهها، منظم بمانید
ذخیره و دستهبندی محتوا براساس اولویتهای شما.
تاریخچه همه تغییرات در صندوق پستی داده شده را فهرست می کند. نتایج تاریخچه به ترتیب زمانی برگردانده می شوند (افزایش historyId
).
درخواست HTTP GET https://gmail.googleapis.com/gmail/v1/users/{userId}/history
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر پارامترها userId
string
آدرس ایمیل کاربر. مقدار ویژه me
می تواند برای نشان دادن کاربر تأیید شده استفاده شود.
پارامترهای پرس و جو پارامترها maxResults
integer ( uint32 format)
حداکثر تعداد سابقه برای بازگشت. این فیلد به طور پیش فرض 100 است. حداکثر مقدار مجاز برای این فیلد 500 است.
pageToken
string
نشانه صفحه برای بازیابی صفحه خاصی از نتایج در لیست.
startHistoryId
string
مورد نیاز. سوابق تاریخ را بعد از startHistoryId
مشخص شده برمی گرداند. startHistoryId
ارائه شده باید از historyId
یک پیام، رشته یا پاسخ list
قبلی بدست آید. شناسههای تاریخچه به صورت زمانی افزایش مییابند، اما با شکافهای تصادفی بین شناسههای معتبر مجاور نیستند. ارائه یک startHistoryId
نامعتبر یا قدیمی معمولاً کد خطای HTTP 404
را برمیگرداند. یک historyId
معمولاً حداقل برای یک هفته معتبر است، اما در برخی شرایط نادر ممکن است فقط برای چند ساعت معتبر باشد. اگر پاسخ خطای HTTP 404
را دریافت کردید، برنامه شما باید همگام سازی کامل را انجام دهد. اگر nextPageToken
در پاسخ دریافت نکردید، هیچ بهروزرسانی برای بازیابی وجود ندارد و میتوانید historyId
برگشتی را برای درخواست آینده ذخیره کنید.
labelId
string
فقط پیامهایی را با برچسب منطبق با شناسه بازگردانید.
historyTypes[]
enum ( HistoryType
)
انواع تاریخچه که باید توسط تابع برگردانده شوند
درخواست بدن بدنه درخواست باید خالی باشد.
بدن پاسخگو در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON
{
"history" : [
{
object (History
)
}
] ,
"nextPageToken" : string ,
"historyId" : string
}
فیلدها history[]
object ( History
)
فهرست سوابق تاریخ messages
موجود در پاسخ معمولاً فقط دارای فیلدهای id
و threadId
هستند.
nextPageToken
string
نشانه صفحه برای بازیابی صفحه بعدی نتایج در لیست.
historyId
string
شناسه سابقه سابقه فعلی صندوق پست.
محدوده مجوز به یکی از حوزه های 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
تاریخچه سابقه تغییر در صندوق پستی کاربر. هر تغییر تاریخچه ممکن است چندین پیام را به طرق مختلف تحت تأثیر قرار دهد.
فیلدها id
string
شناسه دنباله صندوق پستی.
messages[]
object ( Message
)
فهرست پیامهای تغییر یافته در این سابقه سابقه. فیلدهای مربوط به انواع تغییرات خاص، مانند messagesAdded
، ممکن است پیامهای موجود در این قسمت را تکرار کنند. توصیه می کنیم به جای این از فیلدهای نوع تغییر خاص استفاده کنید.
messagesAdded[]
object ( MessageAdded
)
پیامهایی که در این سابقه سابقه به صندوق پست اضافه شدهاند.
messagesDeleted[]
object ( MessageDeleted
)
پیامهایی که در این سابقه سابقه از صندوق پستی حذف شدهاند (حذف نشدهاند).
labelsAdded[]
object ( LabelAdded
)
برچسبهایی به پیامهای موجود در این سابقه سابقه اضافه شده است.
labelsRemoved[]
object ( LabelRemoved
)
برچسبهای حذف شده از پیامهای موجود در این سابقه سابقه.
پیام اضافه شد نمایندگی JSON
{
"message" : {
object (Message
)
}
}
پیام حذف شد نمایندگی JSON
{
"message" : {
object (Message
)
}
}
LabelAdded نمایندگی JSON
{
"message" : {
object (Message
)
} ,
"labelIds" : [
string
]
}
فیلدها message
object ( Message
)
labelIds[]
string
شناسههای برچسب به پیام اضافه شدند.
برچسب حذف شد نمایندگی JSON
{
"message" : {
object (Message
)
} ,
"labelIds" : [
string
]
}
فیلدها message
object ( Message
)
labelIds[]
string
شناسههای برچسب از پیام حذف شدند.
ارسال بازخورد
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2024-09-18 بهوقت ساعت هماهنگ جهانی.
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"اطلاعاتی که نیاز دارم وجود ندارد"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"بیشازحد پیچیده/ مراحل بسیار زیاد"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"قدیمی"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"مشکل ترجمه"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"مشکل کد / نمونهها"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"غیره"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"درک آسان"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"مشکلم را برطرف کرد"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"غیره"
}]
میخواهید موارد بیشتری را با ما درمیان بگذارید؟
{"lastModified": "\u062a\u0627\u0631\u06cc\u062e \u0622\u062e\u0631\u06cc\u0646 \u0628\u0647\u200c\u0631\u0648\u0632\u0631\u0633\u0627\u0646\u06cc 2024-09-18 \u0628\u0647\u200c\u0648\u0642\u062a \u0633\u0627\u0639\u062a \u0647\u0645\u0627\u0647\u0646\u06af \u062c\u0647\u0627\u0646\u06cc."}
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2024-09-18 بهوقت ساعت هماهنگ جهانی."]]