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

لمزيد من المعلومات، راجِع دليل التفويض.