December 2, 2020 update:
  • The Poly website (poly.google.com) and Poly API will be shut down on June 30, 2021. Uploading of new assets will be disabled two months earlier, on April 30, 2021.
  • Previously uploaded assets will remain available and can be downloaded from poly.google.com until June 30, 2021.

Method: users.assets.list

Lists assets authored by the given user. Only the value 'me', representing the currently-authenticated user, is supported. May include assets with an access level of PRIVATE or UNLISTED and assets which are All Rights Reserved for the currently-authenticated user.

HTTP request

GET https://poly.googleapis.com/v1/{name=users/*}/assets

The URL uses Google API HTTP annotation syntax.

Path parameters

Parameters
name

string

A valid user id. Currently, only the special value 'me', representing the currently-authenticated user is supported. To use 'me', you must pass an OAuth token with the request.

Query parameters

Parameters
format

string

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

visibility

enum(VisibilityRestriction)

The visibility of the assets to be returned. Defaults to VISIBILITY_UNSPECIFIED which returns all assets.

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 
{
  "userAssets": [
    {
      object(UserAsset)
    }
  ],
  "nextPageToken": string,
  "totalSize": number
}
Fields
userAssets[]

object(UserAsset)

A list of UserAssets matching 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.

VisibilityRestriction

Possible values for the visibility filter.

Enums
VISIBILITY_UNSPECIFIED No visibility specified. Returns all assets.
PUBLISHED Returns only published assets.
PRIVATE Returns only private assets.

UserAsset

Data about the user's asset.

JSON representation 
{
  "asset": {
    object(Asset)
  }
}
Fields
asset

object(Asset)

An Asset.