• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1<html><body>
2<style>
3
4body, 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
15body {
16  font-size: 13px;
17  padding: 1em;
18}
19
20h1 {
21  font-size: 26px;
22  margin-bottom: 1em;
23}
24
25h2 {
26  font-size: 24px;
27  margin-bottom: 1em;
28}
29
30h3 {
31  font-size: 20px;
32  margin-bottom: 1em;
33  margin-top: 1em;
34}
35
36pre, code {
37  line-height: 1.5;
38  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42  margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46  font-family: Arial, sans serif;
47}
48
49h1, 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.users.html">users</a> . <a href="poly_v1.users.likedassets.html">likedassets</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78  <code><a href="#list">list(name, orderBy=None, pageSize=None, format=None, pageToken=None, x__xgafv=None)</a></code></p>
79<p class="firstline">Lists assets that the user has liked. Only the value 'me', representing</p>
80<p class="toc_element">
81  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
82<p class="firstline">Retrieves the next page of results.</p>
83<h3>Method Details</h3>
84<div class="method">
85    <code class="details" id="list">list(name, orderBy=None, pageSize=None, format=None, pageToken=None, x__xgafv=None)</code>
86  <pre>Lists assets that the user has liked. Only the value 'me', representing
87the currently-authenticated user, is supported. May include assets with an
88access level of UNLISTED.
89
90Args:
91  name: string, A valid user id. Currently, only the special value 'me', representing the
92currently-authenticated user is supported. To use 'me', you must pass
93an OAuth token with the request. (required)
94  orderBy: string, Specifies an ordering for assets. Acceptable values are:
95`BEST`, `NEWEST`, `OLDEST`, 'LIKED_TIME'. Defaults to `LIKED_TIME`, which
96ranks assets based on how recently they were liked.
97  pageSize: integer, The maximum number of assets to be returned. This value must be between `1`
98and `100`. Defaults to `20`.
99  format: string, Return only assets with the matching format. Acceptable values are:
100`BLOCKS`, `FBX`, `GLTF`, `GLTF2`, `OBJ`, `TILT`.
101  pageToken: string, Specifies a continuation token from a previous search whose results were
102split into multiple pages. To get the next page, submit the same request
103specifying the value from
104next_page_token.
105  x__xgafv: string, V1 error format.
106    Allowed values
107      1 - v1 error format
108      2 - v2 error format
109
110Returns:
111  An object of the form:
112
113    { # A response message from a request to list.
114    "nextPageToken": "A String", # The continuation token for retrieving the next page. If empty,
115        # indicates that there are no more pages. To get the next page, submit the
116        # same request specifying this value as the
117        # page_token.
118    "totalSize": 42, # The total number of assets in the list, without pagination.
119    "assets": [ # A list of assets that match the criteria specified in the request.
120      { # Represents and describes an asset in the Poly library. An asset is a 3D model
121          # or scene created using [Tilt Brush](//www.tiltbrush.com),
122          # [Blocks](//vr.google.com/blocks/), or any 3D program that produces a file
123          # that can be upload to Poly.
124        "updateTime": "A String", # The time when the asset was last modified. For published assets, whose
125            # contents are immutable, the update time changes only when metadata
126            # properties, such as visibility, are updated.
127        "displayName": "A String", # The human-readable name, set by the asset's author.
128        "description": "A String", # The human-readable description, set by the asset's author.
129        "license": "A String", # The license under which the author has made the asset available
130            # for use, if any.
131        "visibility": "A String", # The visibility of the asset and who can access it.
132        "thumbnail": { # Represents a file in Poly, which can be a root, # The thumbnail image for the asset.
133            # resource, or thumbnail file.
134          "url": "A String", # The URL where the file data can be retrieved.
135          "relativePath": "A String", # The path of the resource file relative to the
136              # root file. For root or thumbnail files,
137              # this is just the filename.
138          "contentType": "A String", # The MIME content-type, such as `image/png`.
139              # For more information, see
140              # [MIME
141              # types](//developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types).
142        },
143        "presentationParams": { # Hints for displaying the asset, based on information available when the asset # Hints for displaying the asset. Note that these parameters are not
144            # immutable; the author of an asset may change them post-publication.
145            # was uploaded.
146          "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.
147              # More precisely, this quaternion transforms from "object space" (the space
148              # in which the object is defined) to "presentation space", a coordinate
149              # system where +Y is up, +X is right, -Z is forward. For example, if
150              # the object is the Eiffel Tower, in its local coordinate system the
151              # object might be laid out such that the base of the tower is on the
152              # YZ plane and the tip of the tower is towards positive X. In this case
153              # this quaternion would specify a rotation (of 90 degrees about the Z
154              # axis) such that in the presentation space the base of the tower is
155              # aligned with the XZ plane, and the tip of the tower lies towards +Y.
156              #
157              # This rotation is unrelated to the object's pose in the web preview,
158              # which is just a camera position setting and is *not* reflected in this
159              # rotation.
160              #
161              # Please note: this is applicable only to the gLTF.
162              # response you see "w: 1" and nothing else this is the default value of
163              # [0, 0, 0, 1] where x,y, and z are 0.
164            "y": 3.14, # The y component.
165            "x": 3.14, # The x component.
166            "z": 3.14, # The z component.
167            "w": 3.14, # The scalar component.
168          },
169          "colorSpace": "A String", # The materials' diffuse/albedo color. This does not apply to vertex colors
170              # or texture maps.
171          "backgroundColor": "A String", # A background color which could be used for displaying the 3D asset in a
172              # 'thumbnail' or 'palette' style view. Authors have the option to set this
173              # background color when publishing or editing their asset.
174              #
175              # This is represented as a six-digit hexademical triplet specifying the
176              # RGB components of the background color, e.g. #FF0000 for Red.
177        },
178        "authorName": "A String", # The author's publicly visible name. Use this name when giving credit to the
179            # author. For more information, see [Licensing](/poly/discover/licensing).
180        "isCurated": True or False, # Whether this asset has been curated by the Poly team.
181        "formats": [ # A list of Formats where each
182            # format describes one representation of the asset.
183          { # The same asset can be represented in different formats, for example,
184              # a [WaveFront .obj](//en.wikipedia.org/wiki/Wavefront_.obj_file) file with its
185              # corresponding .mtl file or a [Khronos glTF](//www.khronos.org/gltf) file
186              # with its corresponding .glb binary data. A format refers to a specific
187              # representation of an asset and contains all information needed to
188              # retrieve and describe this representation.
189            "formatType": "A String", # A short string that identifies the format type of this representation.
190                # Possible values are: `FBX`, `GLTF`, `GLTF2`, `OBJ`, and `TILT`.
191            "root": { # Represents a file in Poly, which can be a root, # The root of the file hierarchy. This will always be populated.
192                # For some format_types - such as `TILT`, which are
193                # self-contained - this is all of the data.
194                #
195                # Other types - such as `OBJ` - often reference other data elements.
196                # These are contained in the resources field.
197                # resource, or thumbnail file.
198              "url": "A String", # The URL where the file data can be retrieved.
199              "relativePath": "A String", # The path of the resource file relative to the
200                  # root file. For root or thumbnail files,
201                  # this is just the filename.
202              "contentType": "A String", # The MIME content-type, such as `image/png`.
203                  # For more information, see
204                  # [MIME
205                  # types](//developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types).
206            },
207            "formatComplexity": { # Information on the complexity of this Format. # Complexity stats about this representation of the asset.
208              "triangleCount": "A String", # The estimated number of triangles.
209              "lodHint": 42, # A non-negative integer that represents the level of detail (LOD) of this
210                  # format relative to other formats of the same asset with the same
211                  # format_type.
212                  # This hint allows you to sort formats from the most-detailed (0) to
213                  # least-detailed (integers greater than 0).
214            },
215            "resources": [ # A list of dependencies of the root element. May include, but is not
216                # limited to, materials, textures, and shader programs.
217              { # Represents a file in Poly, which can be a root,
218                  # resource, or thumbnail file.
219                "url": "A String", # The URL where the file data can be retrieved.
220                "relativePath": "A String", # The path of the resource file relative to the
221                    # root file. For root or thumbnail files,
222                    # this is just the filename.
223                "contentType": "A String", # The MIME content-type, such as `image/png`.
224                    # For more information, see
225                    # [MIME
226                    # types](//developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types).
227              },
228            ],
229          },
230        ],
231        "metadata": "A String", # Application-defined opaque metadata for this asset. This field is only
232            # returned when querying for the signed-in user's own assets, not for public
233            # assets. This string is limited to 1K chars. It is up to the creator of
234            # the asset to define the format for this string (for example, JSON).
235        "createTime": "A String", # For published assets, the time when the asset was published.
236            # For unpublished assets, the time when the asset was created.
237        "remixInfo": { # Info about the sources of this asset (i.e. assets that were remixed to # The remix info for the asset.
238            # create this asset).
239          "sourceAsset": [ # Resource ids for the sources of this remix, of the form:
240              # `assets/{ASSET_ID}`
241            "A String",
242          ],
243        },
244        "name": "A String", # The unique identifier for the asset in the form:
245            # `assets/{ASSET_ID}`.
246      },
247    ],
248  }</pre>
249</div>
250
251<div class="method">
252    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
253  <pre>Retrieves the next page of results.
254
255Args:
256  previous_request: The request for the previous page. (required)
257  previous_response: The response from the request for the previous page. (required)
258
259Returns:
260  A request object that you can call 'execute()' on to request the next
261  page. Returns None if there are no more items in the collection.
262    </pre>
263</div>
264
265</body></html>