Gets the current user's Gmail profile.
HTTP request
GET https://gmail.googleapis.com/gmail/v1/users/{userId}/profile
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters | |
|---|---|
userId
|
The user's email address. The special value |
Request body
The request body must be empty.
Response body
Profile for a Gmail user.
If successful, the response body contains data with the following structure:
| JSON representation |
|---|
{ "emailAddress" : string , "messagesTotal" : integer , "threadsTotal" : integer , "historyId" : string } |
| Fields | |
|---|---|
emailAddress
|
The user's email address. |
threadsTotal
|
The total number of threads in the mailbox. |
historyId
|
The ID of the mailbox's current history record. |
Authorization scopes
Requires one of the following OAuth scopes:
-
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
For more information, see the Authorization guide .

