Blame - docs/dyn/poly_v1.users.assets.html - platform/external/python/google-api-python-client

2019-06-14 16:50:42 -0700

[diff] [blame]

136

# immutable; the author of an asset may change them post-publication.

137

# was uploaded.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

138

"orientingRotation": { # A [Quaternion](//en.wikipedia.org/wiki/Quaternion). Please note: if in the # A rotation that should be applied to the object root to make it upright.

139

# More precisely, this quaternion transforms from "object space" (the space

140

# in which the object is defined) to "presentation space", a coordinate

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

141

# system where +Y is up, +X is right, -Z is forward. For example, if

142

# the object is the Eiffel Tower, in its local coordinate system the

143

# object might be laid out such that the base of the tower is on the

144

# YZ plane and the tip of the tower is towards positive X. In this case

145

# this quaternion would specify a rotation (of 90 degrees about the Z

146

# axis) such that in the presentation space the base of the tower is

147

# aligned with the XZ plane, and the tip of the tower lies towards +Y.

148

#

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

149

# This rotation is unrelated to the object's pose in the web preview,

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

150

# which is just a camera position setting and is *not* reflected in this

151

# rotation.

152

#

153

# Please note: this is applicable only to the gLTF.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

154

# response you see "w: 1" and nothing else this is the default value of

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

155

# [0, 0, 0, 1] where x,y, and z are 0.

Bu Sun Kim

4ed7d3f

2020-05-27 12:20:54 -0700

[diff] [blame]

156

"z": 3.14, # The z component.

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

157

"y": 3.14, # The y component.

158

"w": 3.14, # The scalar component.

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame^]

159

"x": 3.14, # The x component.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

160

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

161

"backgroundColor": "A String", # A background color which could be used for displaying the 3D asset in a

162

# 'thumbnail' or 'palette' style view. Authors have the option to set this

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

163

# background color when publishing or editing their asset.

164

#

165

# This is represented as a six-digit hexademical triplet specifying the

166

# RGB components of the background color, e.g. #FF0000 for Red.

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

167

"colorSpace": "A String", # The materials' diffuse/albedo color. This does not apply to vertex colors

168

# or texture maps.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

169

},

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame^]

170

"isCurated": True or False, # Whether this asset has been curated by the Poly team.

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

171

"metadata": "A String", # Application-defined opaque metadata for this asset. This field is only

172

# returned when querying for the signed-in user's own assets, not for public

173

# assets. This string is limited to 1K chars. It is up to the creator of

174

# the asset to define the format for this string (for example, JSON).

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

175

"name": "A String", # The unique identifier for the asset in the form:

176

# `assets/{ASSET_ID}`.

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame^]

177

"remixInfo": { # Info about the sources of this asset (i.e. assets that were remixed to # The remix info for the asset.

178

# create this asset).

179

"sourceAsset": [ # Resource ids for the sources of this remix, of the form:

180

# `assets/{ASSET_ID}`

181

"A String",

182

],

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

183

},

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame^]

184

"authorName": "A String", # The author's publicly visible name. Use this name when giving credit to the

185

# author. For more information, see [Licensing](/poly/discover/licensing).

186

"license": "A String", # The license under which the author has made the asset available

187

# for use, if any.

188

"createTime": "A String", # For published assets, the time when the asset was published.

189

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

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

190

"formats": [ # A list of Formats where each

191

# format describes one representation of the asset.

192

{ # The same asset can be represented in different formats, for example,

193

# a [WaveFront .obj](//en.wikipedia.org/wiki/Wavefront_.obj_file) file with its

194

# corresponding .mtl file or a [Khronos glTF](//www.khronos.org/gltf) file

195

# with its corresponding .glb binary data. A format refers to a specific

196

# representation of an asset and contains all information needed to

197

# retrieve and describe this representation.

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame^]

198

"formatComplexity": { # Information on the complexity of this Format. # Complexity stats about this representation of the asset.

199

"triangleCount": "A String", # The estimated number of triangles.

200

"lodHint": 42, # A non-negative integer that represents the level of detail (LOD) of this

201

# format relative to other formats of the same asset with the same

202

# format_type.

203

# This hint allows you to sort formats from the most-detailed (0) to

204

# least-detailed (integers greater than 0).

205

},

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

206

"resources": [ # A list of dependencies of the root element. May include, but is not

207

# limited to, materials, textures, and shader programs.

208

{ # Represents a file in Poly, which can be a root,

209

# resource, or thumbnail file.

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

210

"relativePath": "A String", # The path of the resource file relative to the

211

# root file. For root or thumbnail files,

212

# this is just the filename.

213

"contentType": "A String", # The MIME content-type, such as `image/png`.

214

# For more information, see

215

# [MIME

216

# types](//developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types).

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame^]

217

"url": "A String", # The URL where the file data can be retrieved.

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

218

},

219

],

220

"root": { # Represents a file in Poly, which can be a root, # The root of the file hierarchy. This will always be populated.

221

# For some format_types - such as `TILT`, which are

222

# self-contained - this is all of the data.

223

#

224

# Other types - such as `OBJ` - often reference other data elements.

225

# These are contained in the resources field.

226

# resource, or thumbnail file.

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

227

"relativePath": "A String", # The path of the resource file relative to the

228

# root file. For root or thumbnail files,

229

# this is just the filename.

230

"contentType": "A String", # The MIME content-type, such as `image/png`.

231

# For more information, see

232

# [MIME

233

# types](//developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types).

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame^]

234

"url": "A String", # The URL where the file data can be retrieved.

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

235

},

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame^]

236

"formatType": "A String", # A short string that identifies the format type of this representation.

237

# Possible values are: `FBX`, `GLTF`, `GLTF2`, `OBJ`, and `TILT`.

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

238

},

239

],

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame^]

240

"visibility": "A String", # The visibility of the asset and who can access it.

241

"updateTime": "A String", # The time when the asset was last modified. For published assets, whose

242

# contents are immutable, the update time changes only when metadata

243

# properties, such as visibility, are updated.

244

"thumbnail": { # Represents a file in Poly, which can be a root, # The thumbnail image for the asset.

245

# resource, or thumbnail file.

246

"relativePath": "A String", # The path of the resource file relative to the

247

# root file. For root or thumbnail files,

248

# this is just the filename.

249

"contentType": "A String", # The MIME content-type, such as `image/png`.

250

# For more information, see

251

# [MIME

252

# types](//developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types).

253

"url": "A String", # The URL where the file data can be retrieved.

254

},

255

"description": "A String", # The human-readable description, set by the asset's author.

256

"displayName": "A String", # The human-readable name, set by the asset's author.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

257

},

258

},

259

],

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

260

"nextPageToken": "A String", # The continuation token for retrieving the next page. If empty,

261

# indicates that there are no more pages. To get the next page, submit the

262

# same request specifying this value as the

263

# page_token.

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame^]

264

"totalSize": 42, # The total number of assets in the list, without pagination.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

}</pre>

</div>

<code class="details" id="list_next">list_next(previous_request, previous_response)</code>

270

<pre>Retrieves the next page of results.

271

272

Args:

273

previous_request: The request for the previous page. (required)

274

previous_response: The response from the request for the previous page. (required)

275

276

Returns:

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

277

A request object that you can call 'execute()' on to request the next

Bu Sun Kim