gmail.users.labels.list

GET {{baseUrl}}/gmail/v1/users/:userId/labels?$.xgafv=<string>&access_token=<string>&alt=<string>&callback=<string>&fields=<string>&key=<string>&oauth_token=<string>&prettyPrint=<boolean>&quotaUser=<string>&upload_protocol=<string>&uploadType=<string>

Lists all labels in the user's mailbox.

Request Params

KeyDatatypeRequiredDescription
$.xgafvstringV1 error format.
access_tokenstringOAuth access token.
altstringData format for response.
callbackstringJSONP
fieldsstringSelector specifying which fields to include in a partial response.
keystringAPI key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
oauth_tokenstringOAuth 2.0 token for the current user.
prettyPrintstringReturns response with indentations and line breaks.
quotaUserstringAvailable to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
upload_protocolstringUpload protocol for media (e.g. "raw", "multipart").
uploadTypestringLegacy upload protocol for media (e.g. "media", "multipart").

RESPONSES

status: OK

{&quot;labels&quot;:[{&quot;color&quot;:{&quot;backgroundColor&quot;:&quot;proident ex&quot;,&quot;textColor&quot;:&quot;dolor consequat&quot;},&quot;id&quot;:&quot;mollit nulla&quot;,&quot;labelListVisibility&quot;:&quot;labelShow&quot;,&quot;messageListVisibility&quot;:&quot;hide&quot;,&quot;messagesTotal&quot;:-23275177,&quot;messagesUnread&quot;:-17621138,&quot;name&quot;:&quot;aliquip in non adipisicing eiusmod&quot;,&quot;threadsTotal&quot;:-88136780,&quot;threadsUnread&quot;:7144716,&quot;type&quot;:&quot;user&quot;},{&quot;color&quot;:{&quot;backgroundColor&quot;:&quot;aliqua fugiat labore Ut&quot;,&quot;textColor&quot;:&quot;est cillum voluptate culpa&quot;},&quot;id&quot;:&quot;incididunt laborum nostrud&quot;,&quot;labelListVisibility&quot;:&quot;labelHide&quot;,&quot;messageListVisibility&quot;:&quot;show&quot;,&quot;messagesTotal&quot;:-50116616,&quot;messagesUnread&quot;:54809636,&quot;name&quot;:&quot;in Ut&quot;,&quot;threadsTotal&quot;:82213471,&quot;threadsUnread&quot;:95204107,&quot;type&quot;:&quot;user&quot;}]}