REST Resource: users.assets

Resource: Asset

Represents and describes an asset in the Poly library. An asset is a 3D model or scene created using Tilt Brush, Blocks, or any 3D program that produces a file that can be upload to Poly.

JSON representation
{
  "name": string,
  "displayName": string,
  "authorName": string,
  "description": string,
  "createTime": string,
  "updateTime": string,
  "formats": [
    {
      object(Format)
    }
  ],
  "thumbnail": {
    object(File)
  },
  "license": enum(AssetLicense),
  "visibility": enum(Visibility),
  "isCurated": boolean,
  "presentationParams": {
    object(PresentationParams)
  },
  "metadata": string,
  "remixInfo": {
    object(RemixInfo)
  }
}
Fields
name

string

The unique identifier for the asset in the form: assets/{ASSET_ID}.

displayName

string

The human-readable name, set by the asset's author.

authorName

string

The author's publicly visible name. Use this name when giving credit to the author. For more information, see Licensing.

description

string

The human-readable description, set by the asset's author.

createTime

string (Timestamp format)

For published assets, the time when the asset was published. For unpublished assets, the time when the asset was created.

A timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds. Example: "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

The time when the asset was last modified. For published assets, whose contents are immutable, the update time changes only when metadata properties, such as visibility, are updated.

A timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds. Example: "2014-10-02T15:01:23.045123456Z".

formats[]

object(Format)

A list of Formats where each format describes one representation of the asset.

thumbnail

object(File)

The thumbnail image for the asset.

license

enum(AssetLicense)

The license under which the author has made the asset available for use, if any.

visibility

enum(Visibility)

The visibility of the asset and who can access it.

isCurated

boolean

Whether this asset has been curated by the Poly team.

presentationParams

object(PresentationParams)

Hints for displaying the asset. Note that these parameters are not immutable; the author of an asset may change them post-publication.

metadata

string

Application-defined opaque metadata for this asset. This field is only returned when querying for the signed-in user's own assets, not for public assets. This string is limited to 1K chars. It is up to the creator of the asset to define the format for this string (for example, JSON).

remixInfo

object(RemixInfo)

The remix info for the asset.

Methods

list

Lists assets authored by the given user.