حداکثر تعداد سابقه برای بازگشت. این فیلد به طور پیش فرض 100 است. حداکثر مقدار مجاز برای این فیلد 500 است.
pageToken
string
نشانه صفحه برای بازیابی صفحه خاصی از نتایج در لیست.
startHistoryId
string
مورد نیاز. سوابق تاریخ را بعد از startHistoryId مشخص شده برمی گرداند. startHistoryId ارائه شده باید از historyId یک پیام، رشته یا پاسخ list قبلی بدست آید. شناسههای تاریخچه به صورت زمانی افزایش مییابند، اما با شکافهای تصادفی بین شناسههای معتبر مجاور نیستند. ارائه یک startHistoryId نامعتبر یا قدیمی معمولاً کد خطای HTTP 404 را برمیگرداند. یک historyId معمولاً حداقل برای یک هفته معتبر است، اما در برخی شرایط نادر ممکن است فقط برای چند ساعت معتبر باشد. اگر پاسخ خطای HTTP 404 را دریافت کردید، برنامه شما باید همگام سازی کامل را انجام دهد. اگر nextPageToken در پاسخ دریافت نکردید، هیچ بهروزرسانی برای بازیابی وجود ندارد و میتوانید historyId برگشتی را برای درخواست آینده ذخیره کنید.
labelId
string
فقط پیامهایی را با برچسب منطبق با شناسه بازگردانید.
فهرست پیامهای تغییر یافته در این سابقه سابقه. فیلدهای مربوط به انواع تغییرات خاص، مانند messagesAdded ، ممکن است پیامهای موجود در این قسمت را تکرار کنند. توصیه می کنیم به جای این از فیلدهای نوع تغییر خاص استفاده کنید.
تاریخ آخرین بهروزرسانی 2024-11-14 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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-11-14 بهوقت ساعت هماهنگ جهانی."],[[["Lists the history of all changes to a given mailbox, including message additions, deletions, and label changes, ordered chronologically by `historyId`."],["Allows filtering by history types, labels, and a starting history ID for incremental updates."],["Provides pagination with `nextPageToken` to retrieve large result sets."],["Requires authorization with specific Gmail scopes for access."],["Returns history records with details of changes, such as messages added, deleted, and labels added or removed."]]],["This documentation details how to retrieve a mailbox's history of changes using a `GET` request to `https://gmail.googleapis.com/gmail/v1/users/{userId}/history`. Key actions include specifying the user with `userId`, defining query parameters like `maxResults`, `pageToken`, `startHistoryId`, `labelId` and `historyTypes`. The response contains `history` records with changes. These changes can be adding or removing a message or label to the user's mailbox. The user can get the `historyId` of the current mailbox state and use it in the next request.\n"]]