| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 1 | <html><body> |
| 2 | <style> |
| 3 | |
| 4 | body, h1, h2, h3, div, span, p, pre, a { |
| 5 | margin: 0; |
| 6 | padding: 0; |
| 7 | border: 0; |
| 8 | font-weight: inherit; |
| 9 | font-style: inherit; |
| 10 | font-size: 100%; |
| 11 | font-family: inherit; |
| 12 | vertical-align: baseline; |
| 13 | } |
| 14 | |
| 15 | body { |
| 16 | font-size: 13px; |
| 17 | padding: 1em; |
| 18 | } |
| 19 | |
| 20 | h1 { |
| 21 | font-size: 26px; |
| 22 | margin-bottom: 1em; |
| 23 | } |
| 24 | |
| 25 | h2 { |
| 26 | font-size: 24px; |
| 27 | margin-bottom: 1em; |
| 28 | } |
| 29 | |
| 30 | h3 { |
| 31 | font-size: 20px; |
| 32 | margin-bottom: 1em; |
| 33 | margin-top: 1em; |
| 34 | } |
| 35 | |
| 36 | pre, code { |
| 37 | line-height: 1.5; |
| 38 | font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace; |
| 39 | } |
| 40 | |
| 41 | pre { |
| 42 | margin-top: 0.5em; |
| 43 | } |
| 44 | |
| 45 | h1, h2, h3, p { |
| 46 | font-family: Arial, sans serif; |
| 47 | } |
| 48 | |
| 49 | h1, h2, h3 { |
| 50 | border-bottom: solid #CCC 1px; |
| 51 | } |
| 52 | |
| 53 | .toc_element { |
| 54 | margin-top: 0.5em; |
| 55 | } |
| 56 | |
| 57 | .firstline { |
| 58 | margin-left: 2 em; |
| 59 | } |
| 60 | |
| 61 | .method { |
| 62 | margin-top: 1em; |
| 63 | border: solid 1px #CCC; |
| 64 | padding: 1em; |
| 65 | background: #EEE; |
| 66 | } |
| 67 | |
| 68 | .details { |
| 69 | font-weight: bold; |
| 70 | font-size: 14px; |
| 71 | } |
| 72 | |
| 73 | </style> |
| 74 | |
| 75 | <h1><a href="poly_v1.html">Poly API</a> . <a href="poly_v1.assets.html">assets</a></h1> |
| 76 | <h2>Instance Methods</h2> |
| 77 | <p class="toc_element"> |
| 78 | <code><a href="#get">get(name, x__xgafv=None)</a></code></p> |
| 79 | <p class="firstline">Returns detailed information about an asset given its name.</p> |
| 80 | <p class="toc_element"> |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame^] | 81 | <code><a href="#list">list(maxComplexity=None, orderBy=None, curated=None, format=None, pageToken=None, category=None, pageSize=None, keywords=None, x__xgafv=None)</a></code></p> |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 82 | <p class="firstline">Lists all public, remixable assets. These are assets with an access level</p> |
| 83 | <p class="toc_element"> |
| 84 | <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p> |
| 85 | <p class="firstline">Retrieves the next page of results.</p> |
| 86 | <h3>Method Details</h3> |
| 87 | <div class="method"> |
| 88 | <code class="details" id="get">get(name, x__xgafv=None)</code> |
| 89 | <pre>Returns detailed information about an asset given its name. |
| 90 | PRIVATE assets are returned only if |
| 91 | the currently authenticated user (via OAuth token) is the author of the |
| 92 | asset. |
| 93 | |
| 94 | Args: |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame^] | 95 | name: string, Required. An asset's name in the form `assets/{ASSET_ID}`. (required) |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 96 | x__xgafv: string, V1 error format. |
| 97 | Allowed values |
| 98 | 1 - v1 error format |
| 99 | 2 - v2 error format |
| 100 | |
| 101 | Returns: |
| 102 | An object of the form: |
| 103 | |
| 104 | { # Represents and describes an asset in the Poly library. An asset is a 3D model |
| 105 | # or scene created using [Tilt Brush](//www.tiltbrush.com), |
| 106 | # [Blocks](//vr.google.com/blocks/), or any 3D program that produces a file |
| 107 | # that can be upload to Poly. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame^] | 108 | "displayName": "A String", # The human-readable name, set by the asset's author. |
| 109 | "updateTime": "A String", # The time when the asset was last modified. For published assets, whose |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 110 | # contents are immutable, the update time changes only when metadata |
| 111 | # properties, such as visibility, are updated. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame^] | 112 | "thumbnail": { # Represents a file in Poly, which can be a root, # The thumbnail image for the asset. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 113 | # resource, or thumbnail file. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame^] | 114 | "relativePath": "A String", # The path of the resource file relative to the |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 115 | # root file. For root or thumbnail files, |
| 116 | # this is just the filename. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame^] | 117 | "contentType": "A String", # The MIME content-type, such as `image/png`. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 118 | # For more information, see |
| 119 | # [MIME |
| 120 | # types](//developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types). |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame^] | 121 | "url": "A String", # The URL where the file data can be retrieved. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 122 | }, |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame^] | 123 | "remixInfo": { # Info about the sources of this asset (i.e. assets that were remixed to # The remix info for the asset. |
| 124 | # create this asset). |
| 125 | "sourceAsset": [ # Resource ids for the sources of this remix, of the form: |
| 126 | # `assets/{ASSET_ID}` |
| 127 | "A String", |
| 128 | ], |
| 129 | }, |
| 130 | "visibility": "A String", # The visibility of the asset and who can access it. |
| 131 | "name": "A String", # The unique identifier for the asset in the form: |
| 132 | # `assets/{ASSET_ID}`. |
| 133 | "isCurated": True or False, # Whether this asset has been curated by the Poly team. |
| 134 | "description": "A String", # The human-readable description, set by the asset's author. |
| 135 | "metadata": "A String", # Application-defined opaque metadata for this asset. This field is only |
| 136 | # returned when querying for the signed-in user's own assets, not for public |
| 137 | # assets. This string is limited to 1K chars. It is up to the creator of |
| 138 | # the asset to define the format for this string (for example, JSON). |
| 139 | "createTime": "A String", # For published assets, the time when the asset was published. |
| 140 | # For unpublished assets, the time when the asset was created. |
| 141 | "formats": [ # A list of Formats where each |
| 142 | # format describes one representation of the asset. |
| 143 | { # The same asset can be represented in different formats, for example, |
| 144 | # a [WaveFront .obj](//en.wikipedia.org/wiki/Wavefront_.obj_file) file with its |
| 145 | # corresponding .mtl file or a [Khronos glTF](//www.khronos.org/gltf) file |
| 146 | # with its corresponding .glb binary data. A format refers to a specific |
| 147 | # representation of an asset and contains all information needed to |
| 148 | # retrieve and describe this representation. |
| 149 | "resources": [ # A list of dependencies of the root element. May include, but is not |
| 150 | # limited to, materials, textures, and shader programs. |
| 151 | { # Represents a file in Poly, which can be a root, |
| 152 | # resource, or thumbnail file. |
| 153 | "relativePath": "A String", # The path of the resource file relative to the |
| 154 | # root file. For root or thumbnail files, |
| 155 | # this is just the filename. |
| 156 | "contentType": "A String", # The MIME content-type, such as `image/png`. |
| 157 | # For more information, see |
| 158 | # [MIME |
| 159 | # types](//developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types). |
| 160 | "url": "A String", # The URL where the file data can be retrieved. |
| 161 | }, |
| 162 | ], |
| 163 | "formatType": "A String", # A short string that identifies the format type of this representation. |
| 164 | # Possible values are: `FBX`, `GLTF`, `GLTF2`, `OBJ`, and `TILT`. |
| 165 | "root": { # Represents a file in Poly, which can be a root, # The root of the file hierarchy. This will always be populated. |
| 166 | # For some format_types - such as `TILT`, which are |
| 167 | # self-contained - this is all of the data. |
| 168 | # |
| 169 | # Other types - such as `OBJ` - often reference other data elements. |
| 170 | # These are contained in the resources field. |
| 171 | # resource, or thumbnail file. |
| 172 | "relativePath": "A String", # The path of the resource file relative to the |
| 173 | # root file. For root or thumbnail files, |
| 174 | # this is just the filename. |
| 175 | "contentType": "A String", # The MIME content-type, such as `image/png`. |
| 176 | # For more information, see |
| 177 | # [MIME |
| 178 | # types](//developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types). |
| 179 | "url": "A String", # The URL where the file data can be retrieved. |
| 180 | }, |
| 181 | "formatComplexity": { # Information on the complexity of this Format. # Complexity stats about this representation of the asset. |
| 182 | "triangleCount": "A String", # The estimated number of triangles. |
| 183 | "lodHint": 42, # A non-negative integer that represents the level of detail (LOD) of this |
| 184 | # format relative to other formats of the same asset with the same |
| 185 | # format_type. |
| 186 | # This hint allows you to sort formats from the most-detailed (0) to |
| 187 | # least-detailed (integers greater than 0). |
| 188 | }, |
| 189 | }, |
| 190 | ], |
| 191 | "presentationParams": { # Hints for displaying the asset, based on information available when the asset # Hints for displaying the asset. Note that these parameters are not |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 192 | # immutable; the author of an asset may change them post-publication. |
| 193 | # was uploaded. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame^] | 194 | "colorSpace": "A String", # The materials' diffuse/albedo color. This does not apply to vertex colors |
| 195 | # or texture maps. |
| 196 | "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. |
| 197 | # More precisely, this quaternion transforms from "object space" (the space |
| 198 | # in which the object is defined) to "presentation space", a coordinate |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 199 | # system where +Y is up, +X is right, -Z is forward. For example, if |
| 200 | # the object is the Eiffel Tower, in its local coordinate system the |
| 201 | # object might be laid out such that the base of the tower is on the |
| 202 | # YZ plane and the tip of the tower is towards positive X. In this case |
| 203 | # this quaternion would specify a rotation (of 90 degrees about the Z |
| 204 | # axis) such that in the presentation space the base of the tower is |
| 205 | # aligned with the XZ plane, and the tip of the tower lies towards +Y. |
| 206 | # |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame^] | 207 | # This rotation is unrelated to the object's pose in the web preview, |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 208 | # which is just a camera position setting and is *not* reflected in this |
| 209 | # rotation. |
| 210 | # |
| 211 | # Please note: this is applicable only to the gLTF. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame^] | 212 | # response you see "w: 1" and nothing else this is the default value of |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 213 | # [0, 0, 0, 1] where x,y, and z are 0. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame^] | 214 | "z": 3.14, # The z component. |
| 215 | "x": 3.14, # The x component. |
| 216 | "w": 3.14, # The scalar component. |
| 217 | "y": 3.14, # The y component. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 218 | }, |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame^] | 219 | "backgroundColor": "A String", # A background color which could be used for displaying the 3D asset in a |
| 220 | # 'thumbnail' or 'palette' style view. Authors have the option to set this |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 221 | # background color when publishing or editing their asset. |
| 222 | # |
| 223 | # This is represented as a six-digit hexademical triplet specifying the |
| 224 | # RGB components of the background color, e.g. #FF0000 for Red. |
| 225 | }, |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame^] | 226 | "license": "A String", # The license under which the author has made the asset available |
| 227 | # for use, if any. |
| 228 | "authorName": "A String", # The author's publicly visible name. Use this name when giving credit to the |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 229 | # author. For more information, see [Licensing](/poly/discover/licensing). |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 230 | }</pre> |
| 231 | </div> |
| 232 | |
| 233 | <div class="method"> |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame^] | 234 | <code class="details" id="list">list(maxComplexity=None, orderBy=None, curated=None, format=None, pageToken=None, category=None, pageSize=None, keywords=None, x__xgafv=None)</code> |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 235 | <pre>Lists all public, remixable assets. These are assets with an access level |
| 236 | of PUBLIC and published under the |
| 237 | CC-By license. |
| 238 | |
| 239 | Args: |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 240 | maxComplexity: string, Returns assets that are of the specified complexity or less. Defaults to |
| 241 | COMPLEX. For example, a request for |
| 242 | MEDIUM assets also includes |
| 243 | SIMPLE assets. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame^] | 244 | orderBy: string, Specifies an ordering for assets. Acceptable values are: |
| 245 | `BEST`, `NEWEST`, `OLDEST`. Defaults to `BEST`, which ranks assets |
| 246 | based on a combination of popularity and other features. |
| 247 | curated: boolean, Return only assets that have been curated by the Poly team. |
| 248 | format: string, Return only assets with the matching format. Acceptable values are: |
| 249 | `BLOCKS`, `FBX`, `GLTF`, `GLTF2`, `OBJ`, `TILT`. |
| 250 | pageToken: string, Specifies a continuation token from a previous search whose results were |
| 251 | split into multiple pages. To get the next page, submit the same request |
| 252 | specifying the value from |
| 253 | next_page_token. |
| 254 | category: string, Filter assets based on the specified category. Supported values are: |
| 255 | `animals`, `architecture`, `art`, `food`, `nature`, `objects`, `people`, |
| 256 | `scenes`, `technology`, and `transport`. |
| 257 | pageSize: integer, The maximum number of assets to be returned. This value must be between `1` |
| 258 | and `100`. Defaults to `20`. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 259 | keywords: string, One or more search terms to be matched against all text that Poly has |
| 260 | indexed for assets, which includes display_name, |
| 261 | description, and tags. Multiple keywords should be |
| 262 | separated by spaces. |
| 263 | x__xgafv: string, V1 error format. |
| 264 | Allowed values |
| 265 | 1 - v1 error format |
| 266 | 2 - v2 error format |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 267 | |
| 268 | Returns: |
| 269 | An object of the form: |
| 270 | |
| 271 | { # A response message from a request to list. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame^] | 272 | "nextPageToken": "A String", # The continuation token for retrieving the next page. If empty, |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 273 | # indicates that there are no more pages. To get the next page, submit the |
| 274 | # same request specifying this value as the |
| 275 | # page_token. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame^] | 276 | "assets": [ # A list of assets that match the criteria specified in the request. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 277 | { # Represents and describes an asset in the Poly library. An asset is a 3D model |
| 278 | # or scene created using [Tilt Brush](//www.tiltbrush.com), |
| 279 | # [Blocks](//vr.google.com/blocks/), or any 3D program that produces a file |
| 280 | # that can be upload to Poly. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame^] | 281 | "displayName": "A String", # The human-readable name, set by the asset's author. |
| 282 | "updateTime": "A String", # The time when the asset was last modified. For published assets, whose |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 283 | # contents are immutable, the update time changes only when metadata |
| 284 | # properties, such as visibility, are updated. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame^] | 285 | "thumbnail": { # Represents a file in Poly, which can be a root, # The thumbnail image for the asset. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 286 | # resource, or thumbnail file. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame^] | 287 | "relativePath": "A String", # The path of the resource file relative to the |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 288 | # root file. For root or thumbnail files, |
| 289 | # this is just the filename. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame^] | 290 | "contentType": "A String", # The MIME content-type, such as `image/png`. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 291 | # For more information, see |
| 292 | # [MIME |
| 293 | # types](//developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types). |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame^] | 294 | "url": "A String", # The URL where the file data can be retrieved. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 295 | }, |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame^] | 296 | "remixInfo": { # Info about the sources of this asset (i.e. assets that were remixed to # The remix info for the asset. |
| 297 | # create this asset). |
| 298 | "sourceAsset": [ # Resource ids for the sources of this remix, of the form: |
| 299 | # `assets/{ASSET_ID}` |
| 300 | "A String", |
| 301 | ], |
| 302 | }, |
| 303 | "visibility": "A String", # The visibility of the asset and who can access it. |
| 304 | "name": "A String", # The unique identifier for the asset in the form: |
| 305 | # `assets/{ASSET_ID}`. |
| 306 | "isCurated": True or False, # Whether this asset has been curated by the Poly team. |
| 307 | "description": "A String", # The human-readable description, set by the asset's author. |
| 308 | "metadata": "A String", # Application-defined opaque metadata for this asset. This field is only |
| 309 | # returned when querying for the signed-in user's own assets, not for public |
| 310 | # assets. This string is limited to 1K chars. It is up to the creator of |
| 311 | # the asset to define the format for this string (for example, JSON). |
| 312 | "createTime": "A String", # For published assets, the time when the asset was published. |
| 313 | # For unpublished assets, the time when the asset was created. |
| 314 | "formats": [ # A list of Formats where each |
| 315 | # format describes one representation of the asset. |
| 316 | { # The same asset can be represented in different formats, for example, |
| 317 | # a [WaveFront .obj](//en.wikipedia.org/wiki/Wavefront_.obj_file) file with its |
| 318 | # corresponding .mtl file or a [Khronos glTF](//www.khronos.org/gltf) file |
| 319 | # with its corresponding .glb binary data. A format refers to a specific |
| 320 | # representation of an asset and contains all information needed to |
| 321 | # retrieve and describe this representation. |
| 322 | "resources": [ # A list of dependencies of the root element. May include, but is not |
| 323 | # limited to, materials, textures, and shader programs. |
| 324 | { # Represents a file in Poly, which can be a root, |
| 325 | # resource, or thumbnail file. |
| 326 | "relativePath": "A String", # The path of the resource file relative to the |
| 327 | # root file. For root or thumbnail files, |
| 328 | # this is just the filename. |
| 329 | "contentType": "A String", # The MIME content-type, such as `image/png`. |
| 330 | # For more information, see |
| 331 | # [MIME |
| 332 | # types](//developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types). |
| 333 | "url": "A String", # The URL where the file data can be retrieved. |
| 334 | }, |
| 335 | ], |
| 336 | "formatType": "A String", # A short string that identifies the format type of this representation. |
| 337 | # Possible values are: `FBX`, `GLTF`, `GLTF2`, `OBJ`, and `TILT`. |
| 338 | "root": { # Represents a file in Poly, which can be a root, # The root of the file hierarchy. This will always be populated. |
| 339 | # For some format_types - such as `TILT`, which are |
| 340 | # self-contained - this is all of the data. |
| 341 | # |
| 342 | # Other types - such as `OBJ` - often reference other data elements. |
| 343 | # These are contained in the resources field. |
| 344 | # resource, or thumbnail file. |
| 345 | "relativePath": "A String", # The path of the resource file relative to the |
| 346 | # root file. For root or thumbnail files, |
| 347 | # this is just the filename. |
| 348 | "contentType": "A String", # The MIME content-type, such as `image/png`. |
| 349 | # For more information, see |
| 350 | # [MIME |
| 351 | # types](//developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types). |
| 352 | "url": "A String", # The URL where the file data can be retrieved. |
| 353 | }, |
| 354 | "formatComplexity": { # Information on the complexity of this Format. # Complexity stats about this representation of the asset. |
| 355 | "triangleCount": "A String", # The estimated number of triangles. |
| 356 | "lodHint": 42, # A non-negative integer that represents the level of detail (LOD) of this |
| 357 | # format relative to other formats of the same asset with the same |
| 358 | # format_type. |
| 359 | # This hint allows you to sort formats from the most-detailed (0) to |
| 360 | # least-detailed (integers greater than 0). |
| 361 | }, |
| 362 | }, |
| 363 | ], |
| 364 | "presentationParams": { # Hints for displaying the asset, based on information available when the asset # Hints for displaying the asset. Note that these parameters are not |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 365 | # immutable; the author of an asset may change them post-publication. |
| 366 | # was uploaded. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame^] | 367 | "colorSpace": "A String", # The materials' diffuse/albedo color. This does not apply to vertex colors |
| 368 | # or texture maps. |
| 369 | "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. |
| 370 | # More precisely, this quaternion transforms from "object space" (the space |
| 371 | # in which the object is defined) to "presentation space", a coordinate |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 372 | # system where +Y is up, +X is right, -Z is forward. For example, if |
| 373 | # the object is the Eiffel Tower, in its local coordinate system the |
| 374 | # object might be laid out such that the base of the tower is on the |
| 375 | # YZ plane and the tip of the tower is towards positive X. In this case |
| 376 | # this quaternion would specify a rotation (of 90 degrees about the Z |
| 377 | # axis) such that in the presentation space the base of the tower is |
| 378 | # aligned with the XZ plane, and the tip of the tower lies towards +Y. |
| 379 | # |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame^] | 380 | # This rotation is unrelated to the object's pose in the web preview, |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 381 | # which is just a camera position setting and is *not* reflected in this |
| 382 | # rotation. |
| 383 | # |
| 384 | # Please note: this is applicable only to the gLTF. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame^] | 385 | # response you see "w: 1" and nothing else this is the default value of |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 386 | # [0, 0, 0, 1] where x,y, and z are 0. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame^] | 387 | "z": 3.14, # The z component. |
| 388 | "x": 3.14, # The x component. |
| 389 | "w": 3.14, # The scalar component. |
| 390 | "y": 3.14, # The y component. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 391 | }, |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame^] | 392 | "backgroundColor": "A String", # A background color which could be used for displaying the 3D asset in a |
| 393 | # 'thumbnail' or 'palette' style view. Authors have the option to set this |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 394 | # background color when publishing or editing their asset. |
| 395 | # |
| 396 | # This is represented as a six-digit hexademical triplet specifying the |
| 397 | # RGB components of the background color, e.g. #FF0000 for Red. |
| 398 | }, |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame^] | 399 | "license": "A String", # The license under which the author has made the asset available |
| 400 | # for use, if any. |
| 401 | "authorName": "A String", # The author's publicly visible name. Use this name when giving credit to the |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 402 | # author. For more information, see [Licensing](/poly/discover/licensing). |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 403 | }, |
| 404 | ], |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame^] | 405 | "totalSize": 42, # The total number of assets in the list, without pagination. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 406 | }</pre> |
| 407 | </div> |
| 408 | |
| 409 | <div class="method"> |
| 410 | <code class="details" id="list_next">list_next(previous_request, previous_response)</code> |
| 411 | <pre>Retrieves the next page of results. |
| 412 | |
| 413 | Args: |
| 414 | previous_request: The request for the previous page. (required) |
| 415 | previous_response: The response from the request for the previous page. (required) |
| 416 | |
| 417 | Returns: |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame^] | 418 | A request object that you can call 'execute()' on to request the next |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 419 | page. Returns None if there are no more items in the collection. |
| 420 | </pre> |
| 421 | </div> |
| 422 | |
| 423 | </body></html> |