v1

latestOpenAPI 3.0.42026-08-068161,1253.1 MB

Avatars

Thumbnails

Users

Generate User Thumbnail

Generates and returns the URL for the user's avatar thumbnail.

get/cloud/v2/users/{user_id}:generateThumbnail

Path parameters

user_idstring required

The user ID.

Query parameters

sizeinteger

Size of the generated thumbnail. The generated thumbnail will have size * size dimension.

Currently supported values: 48, 50, 60, 75, 100, 110, 150, 180, 352, 420, 720 Default is 420.

format'FORMAT_UNSPECIFIED' | 'PNG' | 'JPEG' enum

Example:FORMAT_UNSPECIFIED

Specify the format of the generated thumbnail. Default is PNG.

Possible values:

Value	Description
FORMAT_UNSPECIFIED	Default UserThumbnail Format -- set to png
PNG	Generate thumbnail in .png format
JPEG	Generate thumbnail in .jpg format

shape'SHAPE_UNSPECIFIED' | 'ROUND' | 'SQUARE' enum

Example:SHAPE_UNSPECIFIED

Specify the shape of the thumbnail. Default is ROUND (circular).

Possible values:

Value	Description
SHAPE_UNSPECIFIED	Default UserThumbnail Shape -- set to round
ROUND	Generate thumbnail as a circle.
SQUARE	Generate thumbnail as a rectangle.

Response

pathstring

The server-assigned path, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the path should be a resource path ending with operations/{unique_id}.

doneboolean

If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.

Example response

{
  "done": true
}