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

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.