ارسال بازخورد
Method: users.messages.list
با مجموعهها، منظم بمانید
ذخیره و دستهبندی محتوا براساس اولویتهای شما.
پیام های موجود در صندوق پستی کاربر را فهرست می کند.
درخواست HTTP GET https://gmail.googleapis.com/gmail/v1/users/{userId}/messages
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر پارامترها userId
string
آدرس ایمیل کاربر. مقدار ویژه me
می تواند برای نشان دادن کاربر تأیید شده استفاده شود.
پارامترهای پرس و جو پارامترها maxResults
integer ( uint32 format)
حداکثر تعداد پیام برای بازگشت. این فیلد به طور پیش فرض 100 است. حداکثر مقدار مجاز برای این فیلد 500 است.
pageToken
string
نشانه صفحه برای بازیابی صفحه خاصی از نتایج در لیست.
q
string
فقط پیام های منطبق با درخواست مشخص شده را برگردانید. از همان فرمت پرس و جو مانند جعبه جستجوی Gmail پشتیبانی می کند. برای مثال، "from:someuser@example.com rfc822msgid:<somemsgid@example.com> is:unread"
. هنگام دسترسی به api با استفاده از دامنه gmail.metadata نمی توان از پارامتر استفاده کرد.
labelIds[]
string
فقط پیام هایی را با برچسب هایی برگردانید که با همه شناسه های برچسب مشخص شده مطابقت داشته باشند. پیامهای موجود در یک رشته ممکن است دارای برچسبهایی باشند که پیامهای دیگر در همان رشته دارای برچسبهایی نیستند. برای کسب اطلاعات بیشتر، به مدیریت برچسبها روی پیامها و رشتهها مراجعه کنید.
includeSpamTrash
boolean
پیامهای SPAM
و TRASH
را در نتایج قرار دهید.
درخواست بدن بدنه درخواست باید خالی باشد.
بدن پاسخگو در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON
{
"messages" : [
{
object (Message
)
}
] ,
"nextPageToken" : string ,
"resultSizeEstimate" : integer
}
فیلدها messages[]
object ( Message
)
لیست پیام ها توجه داشته باشید که هر منبع پیام فقط شامل یک id
و یک threadId
. جزئیات پیام اضافی را می توان با استفاده از روش messages.get واکشی کرد.
nextPageToken
string
رمز برای بازیابی صفحه بعدی نتایج در لیست.
resultSizeEstimate
integer ( uint32 format)
تعداد کل نتایج تخمینی
محدوده مجوز به یکی از حوزه های 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
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.
ارسال بازخورد
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز 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 بهوقت ساعت هماهنگ جهانی."]]