Method: users.getProfile
نمایه جیمیل کاربر فعلی را دریافت می کند.
درخواست HTTP
GET https://gmail.googleapis.com/gmail/v1/users/{userId}/profile
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها |
---|
userId | string آدرس ایمیل کاربر. مقدار ویژه me می تواند برای نشان دادن کاربر تأیید شده استفاده شود. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
نمایه یک کاربر جیمیل.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"emailAddress": string,
"messagesTotal": integer,
"threadsTotal": integer,
"historyId": string
} |
فیلدها |
---|
emailAddress | string آدرس ایمیل کاربر. |
messagesTotal | integer تعداد کل پیام های موجود در صندوق پست. |
threadsTotal | integer تعداد کل رشته های موجود در صندوق پست. |
historyId | string شناسه سابقه سابقه فعلی صندوق پست. |
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://mail.google.com/
-
https://www.googleapis.com/auth/gmail.modify
-
https://www.googleapis.com/auth/gmail.compose
-
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-11-14 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2024-11-14 بهوقت ساعت هماهنگ جهانی."],[[["Retrieves the Gmail profile of the current user, including email address, total messages, total threads, and history ID."],["Uses a GET request to the URL `https://gmail.googleapis.com/gmail/v1/users/{userId}/profile`, where `{userId}` can be the user's email address or `me` for the authenticated user."],["Requires authorization with specific OAuth scopes, such as `https://mail.google.com/` or `https://www.googleapis.com/auth/gmail.readonly`."],["The response body contains a JSON object representing the user's profile with fields like `emailAddress`, `messagesTotal`, `threadsTotal`, and `historyId`."],["The request body must be empty."]]],[]]