Method: users.getProfile

מקבל את פרופיל Gmail של המשתמש הנוכחי.

בקשת HTTP

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

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
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.