Method: users.getProfile

الحصول على الملف الشخصي للمستخدم الحالي في Gmail

طلب HTTP

GET https://gmail.googleapis.com/gmail/v1/users/{userId}/profile

يستخدم عنوان URL بنية gRPC Transcode.

معلّمات المسار

المعلّمات
userId

string

عنوان البريد الإلكتروني للمستخدم يمكن استخدام القيمة الخاصة me للإشارة إلى المستخدم الذي تمت المصادقة عليه.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

الملف الشخصي لمستخدم Gmail

تمثيل 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

لمزيد من المعلومات، اطّلِع على دليل التفويض.