Method: users.getProfile

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

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
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

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