Method: assets.list

Lists all public, remixable assets. These are assets with an access level of PUBLIC and published under the CC-By license.

HTTP request

GET https://poly.googleapis.com/v1/assets

The URL uses Google API HTTP annotation syntax.

Query parameters

Parameters
keywords

string

One or more search terms to be matched against all text that Poly has indexed for assets, which includes displayName, description, and tags. Multiple keywords should be separated by spaces.

curated

boolean

Return only assets that have been curated by the Poly team.

category

string

Filter assets based on the specified category. Supported values are: animals, architecture, art, food, nature, objects, people, scenes, technology, and transport.

maxComplexity

enum(Complexity)

Returns assets that are of the specified complexity or less. Defaults to COMPLEX. For example, a request for MEDIUM assets also includes SIMPLE assets.

format

string

Return only assets with the matching format. Acceptable values are: BLOCKS, FBX, GLTF, GLTF2, OBJ, TILT.

pageSize

number

The maximum number of assets to be returned. This value must be between 1 and 100. Defaults to 20.

orderBy

string

Specifies an ordering for assets. Acceptable values are: BEST, NEWEST, OLDEST. Defaults to BEST, which ranks assets based on a combination of popularity and other features.

pageToken

string

Specifies a continuation token from a previous search whose results were split into multiple pages. To get the next page, submit the same request specifying the value from nextPageToken.

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

A response message from a request to list.

JSON representation
{
  "assets": [
    {
      object(Asset)
    }
  ],
  "nextPageToken": string,
  "totalSize": number
}
Fields
assets[]

object(Asset)

A list of assets that match the criteria specified in the request.

nextPageToken

string

The continuation token for retrieving the next page. If empty, indicates that there are no more pages. To get the next page, submit the same request specifying this value as the pageToken.

totalSize

number

The total number of assets in the list, without pagination.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/vrassetdata.readonly

For more information, see the OAuth 2.0 Overview.

Complexity

Possible values for the maxComplexity filter. An asset's complexity is defined as some combination of triangle count and material/shader cost. Complex assets might not be appropriate for complexity-sensitive applications (e.g. displaying many assets on phone hardware).

Enums
COMPLEXITY_UNSPECIFIED No complexity specified. This is equivalent to omitting the filter.
COMPLEX Highly-complex.
MEDIUM Averagely-complex.
SIMPLE Simple.