docs: update docs/dyn (#1096)
This PR was generated using Autosynth. :rainbow:
Synth log will be available here:
https://source.cloud.google.com/results/invocations/6f0f288a-a1e8-4b2d-a85f-00b1c6150185/targets
- [ ] To automatically regenerate this PR, check this box.
Source-Link: https://github.com/googleapis/synthtool/commit/39b7149da4026765385403632db3c6f63db96b2c
Source-Link: https://github.com/googleapis/synthtool/commit/9a7d9fbb7045c34c9d3d22c1ff766eeae51f04c9
Source-Link: https://github.com/googleapis/synthtool/commit/dc9903a8c30c3662b6098f0e4a97f221d67268b2
Source-Link: https://github.com/googleapis/synthtool/commit/7fcc405a579d5d53a726ff3da1b7c8c08f0f2d58
Source-Link: https://github.com/googleapis/synthtool/commit/d5fc0bcf9ea9789c5b0e3154a9e3b29e5cea6116
Source-Link: https://github.com/googleapis/synthtool/commit/e89175cf074dccc4babb4eca66ae913696e47a71
Source-Link: https://github.com/googleapis/synthtool/commit/7d652819519dfa24da9e14548232e4aaba71a11c
Source-Link: https://github.com/googleapis/synthtool/commit/7db8a6c5ffb12a6e4c2f799c18f00f7f3d60e279
Source-Link: https://github.com/googleapis/synthtool/commit/1f1148d3c7a7a52f0c98077f976bd9b3c948ee2b
Source-Link: https://github.com/googleapis/synthtool/commit/2c8aecedd55b0480fb4e123b6e07fa5b12953862
Source-Link: https://github.com/googleapis/synthtool/commit/3d3e94c4e02370f307a9a200b0c743c3d8d19f29
Source-Link: https://github.com/googleapis/synthtool/commit/c7824ea48ff6d4d42dfae0849aec8a85acd90bd9
Source-Link: https://github.com/googleapis/synthtool/commit/ba9918cd22874245b55734f57470c719b577e591
Source-Link: https://github.com/googleapis/synthtool/commit/b19b401571e77192f8dd38eab5fb2300a0de9324
Source-Link: https://github.com/googleapis/synthtool/commit/6542bd723403513626f61642fc02ddca528409aa
diff --git a/docs/dyn/poly_v1.assets.html b/docs/dyn/poly_v1.assets.html
index 85d9316..ba344d3 100644
--- a/docs/dyn/poly_v1.assets.html
+++ b/docs/dyn/poly_v1.assets.html
@@ -81,7 +81,7 @@
<code><a href="#get">get(name, x__xgafv=None)</a></code></p>
<p class="firstline">Returns detailed information about an asset given its name. PRIVATE assets are returned only if the currently authenticated user (via OAuth token) is the author of the asset.</p>
<p class="toc_element">
- <code><a href="#list">list(category=None, pageToken=None, format=None, keywords=None, pageSize=None, orderBy=None, curated=None, maxComplexity=None, x__xgafv=None)</a></code></p>
+ <code><a href="#list">list(curated=None, format=None, orderBy=None, pageToken=None, category=None, keywords=None, pageSize=None, maxComplexity=None, x__xgafv=None)</a></code></p>
<p class="firstline">Lists all public, remixable assets. These are assets with an access level of PUBLIC and published under the CC-By license.</p>
<p class="toc_element">
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -107,72 +107,72 @@
An object of the form:
{ # Represents and describes an asset in the Poly library. An asset is a 3D model or scene created using [Tilt Brush](//www.tiltbrush.com), [Blocks](//vr.google.com/blocks/), or any 3D program that produces a file that can be upload to Poly.
- "description": "A String", # The human-readable description, set by the asset's author.
- "createTime": "A String", # For published assets, the time when the asset was published. For unpublished assets, the time when the asset was created.
- "displayName": "A String", # The human-readable name, set by the asset's author.
"remixInfo": { # Info about the sources of this asset (i.e. assets that were remixed to create this asset). # The remix info for the asset.
"sourceAsset": [ # Resource ids for the sources of this remix, of the form: `assets/{ASSET_ID}`
"A String",
],
},
+ "license": "A String", # The license under which the author has made the asset available for use, if any.
+ "authorName": "A String", # The author's publicly visible name. Use this name when giving credit to the author. For more information, see [Licensing](/poly/discover/licensing).
"thumbnail": { # Represents a file in Poly, which can be a root, resource, or thumbnail file. # The thumbnail image for the asset.
- "url": "A String", # The URL where the file data can be retrieved.
"relativePath": "A String", # The path of the resource file relative to the root file. For root or thumbnail files, this is just the filename.
"contentType": "A String", # The MIME content-type, such as `image/png`. For more information, see [MIME types](//developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types).
+ "url": "A String", # The URL where the file data can be retrieved.
},
- "metadata": "A 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).
- "authorName": "A String", # The author's publicly visible name. Use this name when giving credit to the author. For more information, see [Licensing](/poly/discover/licensing).
- "visibility": "A String", # The visibility of the asset and who can access it.
"name": "A String", # The unique identifier for the asset in the form: `assets/{ASSET_ID}`.
- "license": "A String", # The license under which the author has made the asset available for use, if any.
- "formats": [ # A list of Formats where each format describes one representation of the asset.
- { # The same asset can be represented in different formats, for example, a [WaveFront .obj](//en.wikipedia.org/wiki/Wavefront_.obj_file) file with its corresponding .mtl file or a [Khronos glTF](//www.khronos.org/gltf) file with its corresponding .glb binary data. A format refers to a specific representation of an asset and contains all information needed to retrieve and describe this representation.
- "formatType": "A String", # A short string that identifies the format type of this representation. Possible values are: `FBX`, `GLTF`, `GLTF2`, `OBJ`, and `TILT`.
- "formatComplexity": { # Information on the complexity of this Format. # Complexity stats about this representation of the asset.
- "triangleCount": "A String", # The estimated number of triangles.
- "lodHint": 42, # A non-negative integer that represents the level of detail (LOD) of this format relative to other formats of the same asset with the same format_type. This hint allows you to sort formats from the most-detailed (0) to least-detailed (integers greater than 0).
- },
- "root": { # Represents a file in Poly, which can be a root, resource, or thumbnail file. # The root of the file hierarchy. This will always be populated. For some format_types - such as `TILT`, which are self-contained - this is all of the data. Other types - such as `OBJ` - often reference other data elements. These are contained in the resources field.
- "url": "A String", # The URL where the file data can be retrieved.
- "relativePath": "A String", # The path of the resource file relative to the root file. For root or thumbnail files, this is just the filename.
- "contentType": "A String", # The MIME content-type, such as `image/png`. For more information, see [MIME types](//developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types).
- },
- "resources": [ # A list of dependencies of the root element. May include, but is not limited to, materials, textures, and shader programs.
- { # Represents a file in Poly, which can be a root, resource, or thumbnail file.
- "url": "A String", # The URL where the file data can be retrieved.
- "relativePath": "A String", # The path of the resource file relative to the root file. For root or thumbnail files, this is just the filename.
- "contentType": "A String", # The MIME content-type, such as `image/png`. For more information, see [MIME types](//developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types).
- },
- ],
- },
- ],
+ "description": "A String", # The human-readable description, set by the asset's author.
+ "createTime": "A String", # For published assets, the time when the asset was published. For unpublished assets, the time when the asset was created.
+ "updateTime": "A String", # 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.
+ "isCurated": True or False, # Whether this asset has been curated by the Poly team.
+ "metadata": "A 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).
+ "displayName": "A String", # The human-readable name, set by the asset's author.
+ "visibility": "A String", # The visibility of the asset and who can access it.
"presentationParams": { # Hints for displaying the asset, based on information available when the asset was uploaded. # Hints for displaying the asset. Note that these parameters are not immutable; the author of an asset may change them post-publication.
"backgroundColor": "A String", # A background color which could be used for displaying the 3D asset in a 'thumbnail' or 'palette' style view. Authors have the option to set this background color when publishing or editing their asset. This is represented as a six-digit hexademical triplet specifying the RGB components of the background color, e.g. #FF0000 for Red.
"colorSpace": "A String", # The materials' diffuse/albedo color. This does not apply to vertex colors or texture maps.
"orientingRotation": { # A [Quaternion](//en.wikipedia.org/wiki/Quaternion). Please note: if in the response you see "w: 1" and nothing else this is the default value of [0, 0, 0, 1] where x,y, and z are 0. # A rotation that should be applied to the object root to make it upright. More precisely, this quaternion transforms from "object space" (the space in which the object is defined) to "presentation space", a coordinate system where +Y is up, +X is right, -Z is forward. For example, if the object is the Eiffel Tower, in its local coordinate system the object might be laid out such that the base of the tower is on the YZ plane and the tip of the tower is towards positive X. In this case this quaternion would specify a rotation (of 90 degrees about the Z axis) such that in the presentation space the base of the tower is aligned with the XZ plane, and the tip of the tower lies towards +Y. This rotation is unrelated to the object's pose in the web preview, which is just a camera position setting and is *not* reflected in this rotation. Please note: this is applicable only to the gLTF.
"y": 3.14, # The y component.
"w": 3.14, # The scalar component.
- "x": 3.14, # The x component.
"z": 3.14, # The z component.
+ "x": 3.14, # The x component.
},
},
- "isCurated": True or False, # Whether this asset has been curated by the Poly team.
- "updateTime": "A String", # 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.
+ "formats": [ # A list of Formats where each format describes one representation of the asset.
+ { # The same asset can be represented in different formats, for example, a [WaveFront .obj](//en.wikipedia.org/wiki/Wavefront_.obj_file) file with its corresponding .mtl file or a [Khronos glTF](//www.khronos.org/gltf) file with its corresponding .glb binary data. A format refers to a specific representation of an asset and contains all information needed to retrieve and describe this representation.
+ "root": { # Represents a file in Poly, which can be a root, resource, or thumbnail file. # The root of the file hierarchy. This will always be populated. For some format_types - such as `TILT`, which are self-contained - this is all of the data. Other types - such as `OBJ` - often reference other data elements. These are contained in the resources field.
+ "relativePath": "A String", # The path of the resource file relative to the root file. For root or thumbnail files, this is just the filename.
+ "contentType": "A String", # The MIME content-type, such as `image/png`. For more information, see [MIME types](//developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types).
+ "url": "A String", # The URL where the file data can be retrieved.
+ },
+ "formatType": "A String", # A short string that identifies the format type of this representation. Possible values are: `FBX`, `GLTF`, `GLTF2`, `OBJ`, and `TILT`.
+ "resources": [ # A list of dependencies of the root element. May include, but is not limited to, materials, textures, and shader programs.
+ { # Represents a file in Poly, which can be a root, resource, or thumbnail file.
+ "relativePath": "A String", # The path of the resource file relative to the root file. For root or thumbnail files, this is just the filename.
+ "contentType": "A String", # The MIME content-type, such as `image/png`. For more information, see [MIME types](//developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types).
+ "url": "A String", # The URL where the file data can be retrieved.
+ },
+ ],
+ "formatComplexity": { # Information on the complexity of this Format. # Complexity stats about this representation of the asset.
+ "triangleCount": "A String", # The estimated number of triangles.
+ "lodHint": 42, # A non-negative integer that represents the level of detail (LOD) of this format relative to other formats of the same asset with the same format_type. This hint allows you to sort formats from the most-detailed (0) to least-detailed (integers greater than 0).
+ },
+ },
+ ],
}</pre>
</div>
<div class="method">
- <code class="details" id="list">list(category=None, pageToken=None, format=None, keywords=None, pageSize=None, orderBy=None, curated=None, maxComplexity=None, x__xgafv=None)</code>
+ <code class="details" id="list">list(curated=None, format=None, orderBy=None, pageToken=None, category=None, keywords=None, pageSize=None, maxComplexity=None, x__xgafv=None)</code>
<pre>Lists all public, remixable assets. These are assets with an access level of PUBLIC and published under the CC-By license.
Args:
- category: string, Filter assets based on the specified category. Supported values are: `animals`, `architecture`, `art`, `food`, `nature`, `objects`, `people`, `scenes`, `technology`, and `transport`.
- 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 next_page_token.
+ curated: boolean, Return only assets that have been curated by the Poly team.
format: string, Return only assets with the matching format. Acceptable values are: `BLOCKS`, `FBX`, `GLTF`, `GLTF2`, `OBJ`, `TILT`.
+ 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 next_page_token.
+ category: string, Filter assets based on the specified category. Supported values are: `animals`, `architecture`, `art`, `food`, `nature`, `objects`, `people`, `scenes`, `technology`, and `transport`.
keywords: string, One or more search terms to be matched against all text that Poly has indexed for assets, which includes display_name, description, and tags. Multiple keywords should be separated by spaces.
pageSize: integer, 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.
- curated: boolean, Return only assets that have been curated by the Poly team.
maxComplexity: string, Returns assets that are of the specified complexity or less. Defaults to COMPLEX. For example, a request for MEDIUM assets also includes SIMPLE assets.
Allowed values
COMPLEXITY_UNSPECIFIED - No complexity specified. This is equivalent to omitting the filter.
@@ -192,57 +192,57 @@
"nextPageToken": "A 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 page_token.
"assets": [ # A list of assets that match the criteria specified in the request.
{ # Represents and describes an asset in the Poly library. An asset is a 3D model or scene created using [Tilt Brush](//www.tiltbrush.com), [Blocks](//vr.google.com/blocks/), or any 3D program that produces a file that can be upload to Poly.
- "description": "A String", # The human-readable description, set by the asset's author.
- "createTime": "A String", # For published assets, the time when the asset was published. For unpublished assets, the time when the asset was created.
- "displayName": "A String", # The human-readable name, set by the asset's author.
"remixInfo": { # Info about the sources of this asset (i.e. assets that were remixed to create this asset). # The remix info for the asset.
"sourceAsset": [ # Resource ids for the sources of this remix, of the form: `assets/{ASSET_ID}`
"A String",
],
},
+ "license": "A String", # The license under which the author has made the asset available for use, if any.
+ "authorName": "A String", # The author's publicly visible name. Use this name when giving credit to the author. For more information, see [Licensing](/poly/discover/licensing).
"thumbnail": { # Represents a file in Poly, which can be a root, resource, or thumbnail file. # The thumbnail image for the asset.
- "url": "A String", # The URL where the file data can be retrieved.
"relativePath": "A String", # The path of the resource file relative to the root file. For root or thumbnail files, this is just the filename.
"contentType": "A String", # The MIME content-type, such as `image/png`. For more information, see [MIME types](//developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types).
+ "url": "A String", # The URL where the file data can be retrieved.
},
- "metadata": "A 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).
- "authorName": "A String", # The author's publicly visible name. Use this name when giving credit to the author. For more information, see [Licensing](/poly/discover/licensing).
- "visibility": "A String", # The visibility of the asset and who can access it.
"name": "A String", # The unique identifier for the asset in the form: `assets/{ASSET_ID}`.
- "license": "A String", # The license under which the author has made the asset available for use, if any.
- "formats": [ # A list of Formats where each format describes one representation of the asset.
- { # The same asset can be represented in different formats, for example, a [WaveFront .obj](//en.wikipedia.org/wiki/Wavefront_.obj_file) file with its corresponding .mtl file or a [Khronos glTF](//www.khronos.org/gltf) file with its corresponding .glb binary data. A format refers to a specific representation of an asset and contains all information needed to retrieve and describe this representation.
- "formatType": "A String", # A short string that identifies the format type of this representation. Possible values are: `FBX`, `GLTF`, `GLTF2`, `OBJ`, and `TILT`.
- "formatComplexity": { # Information on the complexity of this Format. # Complexity stats about this representation of the asset.
- "triangleCount": "A String", # The estimated number of triangles.
- "lodHint": 42, # A non-negative integer that represents the level of detail (LOD) of this format relative to other formats of the same asset with the same format_type. This hint allows you to sort formats from the most-detailed (0) to least-detailed (integers greater than 0).
- },
- "root": { # Represents a file in Poly, which can be a root, resource, or thumbnail file. # The root of the file hierarchy. This will always be populated. For some format_types - such as `TILT`, which are self-contained - this is all of the data. Other types - such as `OBJ` - often reference other data elements. These are contained in the resources field.
- "url": "A String", # The URL where the file data can be retrieved.
- "relativePath": "A String", # The path of the resource file relative to the root file. For root or thumbnail files, this is just the filename.
- "contentType": "A String", # The MIME content-type, such as `image/png`. For more information, see [MIME types](//developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types).
- },
- "resources": [ # A list of dependencies of the root element. May include, but is not limited to, materials, textures, and shader programs.
- { # Represents a file in Poly, which can be a root, resource, or thumbnail file.
- "url": "A String", # The URL where the file data can be retrieved.
- "relativePath": "A String", # The path of the resource file relative to the root file. For root or thumbnail files, this is just the filename.
- "contentType": "A String", # The MIME content-type, such as `image/png`. For more information, see [MIME types](//developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types).
- },
- ],
- },
- ],
+ "description": "A String", # The human-readable description, set by the asset's author.
+ "createTime": "A String", # For published assets, the time when the asset was published. For unpublished assets, the time when the asset was created.
+ "updateTime": "A String", # 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.
+ "isCurated": True or False, # Whether this asset has been curated by the Poly team.
+ "metadata": "A 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).
+ "displayName": "A String", # The human-readable name, set by the asset's author.
+ "visibility": "A String", # The visibility of the asset and who can access it.
"presentationParams": { # Hints for displaying the asset, based on information available when the asset was uploaded. # Hints for displaying the asset. Note that these parameters are not immutable; the author of an asset may change them post-publication.
"backgroundColor": "A String", # A background color which could be used for displaying the 3D asset in a 'thumbnail' or 'palette' style view. Authors have the option to set this background color when publishing or editing their asset. This is represented as a six-digit hexademical triplet specifying the RGB components of the background color, e.g. #FF0000 for Red.
"colorSpace": "A String", # The materials' diffuse/albedo color. This does not apply to vertex colors or texture maps.
"orientingRotation": { # A [Quaternion](//en.wikipedia.org/wiki/Quaternion). Please note: if in the response you see "w: 1" and nothing else this is the default value of [0, 0, 0, 1] where x,y, and z are 0. # A rotation that should be applied to the object root to make it upright. More precisely, this quaternion transforms from "object space" (the space in which the object is defined) to "presentation space", a coordinate system where +Y is up, +X is right, -Z is forward. For example, if the object is the Eiffel Tower, in its local coordinate system the object might be laid out such that the base of the tower is on the YZ plane and the tip of the tower is towards positive X. In this case this quaternion would specify a rotation (of 90 degrees about the Z axis) such that in the presentation space the base of the tower is aligned with the XZ plane, and the tip of the tower lies towards +Y. This rotation is unrelated to the object's pose in the web preview, which is just a camera position setting and is *not* reflected in this rotation. Please note: this is applicable only to the gLTF.
"y": 3.14, # The y component.
"w": 3.14, # The scalar component.
- "x": 3.14, # The x component.
"z": 3.14, # The z component.
+ "x": 3.14, # The x component.
},
},
- "isCurated": True or False, # Whether this asset has been curated by the Poly team.
- "updateTime": "A String", # 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.
+ "formats": [ # A list of Formats where each format describes one representation of the asset.
+ { # The same asset can be represented in different formats, for example, a [WaveFront .obj](//en.wikipedia.org/wiki/Wavefront_.obj_file) file with its corresponding .mtl file or a [Khronos glTF](//www.khronos.org/gltf) file with its corresponding .glb binary data. A format refers to a specific representation of an asset and contains all information needed to retrieve and describe this representation.
+ "root": { # Represents a file in Poly, which can be a root, resource, or thumbnail file. # The root of the file hierarchy. This will always be populated. For some format_types - such as `TILT`, which are self-contained - this is all of the data. Other types - such as `OBJ` - often reference other data elements. These are contained in the resources field.
+ "relativePath": "A String", # The path of the resource file relative to the root file. For root or thumbnail files, this is just the filename.
+ "contentType": "A String", # The MIME content-type, such as `image/png`. For more information, see [MIME types](//developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types).
+ "url": "A String", # The URL where the file data can be retrieved.
+ },
+ "formatType": "A String", # A short string that identifies the format type of this representation. Possible values are: `FBX`, `GLTF`, `GLTF2`, `OBJ`, and `TILT`.
+ "resources": [ # A list of dependencies of the root element. May include, but is not limited to, materials, textures, and shader programs.
+ { # Represents a file in Poly, which can be a root, resource, or thumbnail file.
+ "relativePath": "A String", # The path of the resource file relative to the root file. For root or thumbnail files, this is just the filename.
+ "contentType": "A String", # The MIME content-type, such as `image/png`. For more information, see [MIME types](//developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types).
+ "url": "A String", # The URL where the file data can be retrieved.
+ },
+ ],
+ "formatComplexity": { # Information on the complexity of this Format. # Complexity stats about this representation of the asset.
+ "triangleCount": "A String", # The estimated number of triangles.
+ "lodHint": 42, # A non-negative integer that represents the level of detail (LOD) of this format relative to other formats of the same asset with the same format_type. This hint allows you to sort formats from the most-detailed (0) to least-detailed (integers greater than 0).
+ },
+ },
+ ],
},
],
}</pre>