Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / google-api-python-client / e4e4b403f89a92d0f2d0661bf47d5ccd490d7bbd / . / docs / dyn / books_v1.layers.annotationData.html
blob: 04f51f124817f0c884e961828cc7bb3e6bd8c153 [file] [log] [blame]
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]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="books_v1.html">Books API</a> . <a href="books_v1.layers.html">layers</a> . <a href="books_v1.layers.annotationData.html">annotationData</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700[diff] [blame]78 <code><a href="#close">close()</a></code></p>
79<p class="firstline">Close httplib2 connections.</p>
80<p class="toc_element">
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800[diff] [blame]81 <code><a href="#get">get(volumeId, layerId, annotationDataId, contentVersion, h=None, locale=None, w=None, allowWebDefinitions=None, scale=None, source=None, x__xgafv=None)</a></code></p>
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]82<p class="firstline">Gets the annotation data.</p>
83<p class="toc_element">
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800[diff] [blame]84 <code><a href="#list">list(volumeId, layerId, contentVersion, updatedMax=None, annotationDataId=None, locale=None, w=None, scale=None, source=None, h=None, maxResults=None, updatedMin=None, pageToken=None, x__xgafv=None)</a></code></p>
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]85<p class="firstline">Gets the annotation data for a volume and layer.</p>
86<p class="toc_element">
87 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
88<p class="firstline">Retrieves the next page of results.</p>
89<h3>Method Details</h3>
90<div class="method">
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700[diff] [blame]91 <code class="details" id="close">close()</code>
92 <pre>Close httplib2 connections.</pre>
93</div>
94
95<div class="method">
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800[diff] [blame]96 <code class="details" id="get">get(volumeId, layerId, annotationDataId, contentVersion, h=None, locale=None, w=None, allowWebDefinitions=None, scale=None, source=None, x__xgafv=None)</code>
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]97 <pre>Gets the annotation data.
98
99Args:
100 volumeId: string, The volume to retrieve annotations for. (required)
101 layerId: string, The ID for the layer to get the annotations. (required)
102 annotationDataId: string, The ID of the annotation data to retrieve. (required)
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700[diff] [blame]103 contentVersion: string, The content version for the volume you are trying to retrieve. (required)
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700[diff] [blame]104 h: integer, The requested pixel height for any images. If height is provided width must also be provided.
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800[diff] [blame]105 locale: string, The locale information for the data. ISO-639-1 language and ISO-3166-1 country code. Ex: &#x27;en_US&#x27;.
106 w: integer, The requested pixel width for any images. If width is provided height must also be provided.
107 allowWebDefinitions: boolean, For the dictionary layer. Whether or not to allow web definitions.
108 scale: integer, The requested scale for the image.
109 source: string, String to identify the originator of this request.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]110 x__xgafv: string, V1 error format.
111 Allowed values
112 1 - v1 error format
113 2 - v2 error format
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]114
115Returns:
116 An object of the form:
117
118 {
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800[diff] [blame]119 &quot;volumeId&quot;: &quot;A String&quot;, # The volume id for this data. *
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800[diff] [blame]120 &quot;updated&quot;: &quot;A String&quot;, # Timestamp for the last time this data was updated. (RFC 3339 UTC date-time format).
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]121 &quot;data&quot;: { # JSON encoded data for this dictionary annotation data. Emitted with name &#x27;data&#x27; in JSON output. Either this or geo_data will be populated.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]122 &quot;dict&quot;: {
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800[diff] [blame]123 &quot;source&quot;: { # The source, url and attribution for this dictionary data.
124 &quot;attribution&quot;: &quot;A String&quot;,
125 &quot;url&quot;: &quot;A String&quot;,
126 },
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]127 &quot;words&quot;: [
128 {
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800[diff] [blame]129 &quot;source&quot;: { # The words with different meanings but not related words, e.g. &quot;go&quot; (game) and &quot;go&quot; (verb).
130 &quot;attribution&quot;: &quot;A String&quot;,
131 &quot;url&quot;: &quot;A String&quot;,
132 },
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700[diff] [blame]133 &quot;senses&quot;: [
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]134 {
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700[diff] [blame]135 &quot;source&quot;: {
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800[diff] [blame]136 &quot;url&quot;: &quot;A String&quot;,
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800[diff] [blame]137 &quot;attribution&quot;: &quot;A String&quot;,
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700[diff] [blame]138 },
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800[diff] [blame]139 &quot;definitions&quot;: [
140 {
141 &quot;examples&quot;: [
142 {
143 &quot;text&quot;: &quot;A String&quot;,
144 &quot;source&quot;: {
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800[diff] [blame]145 &quot;url&quot;: &quot;A String&quot;,
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800[diff] [blame]146 &quot;attribution&quot;: &quot;A String&quot;,
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800[diff] [blame]147 },
148 },
149 ],
150 &quot;definition&quot;: &quot;A String&quot;,
151 },
152 ],
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800[diff] [blame]153 &quot;pronunciationUrl&quot;: &quot;A String&quot;,
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800[diff] [blame]154 &quot;syllabification&quot;: &quot;A String&quot;,
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800[diff] [blame]155 &quot;conjugations&quot;: [
156 {
157 &quot;value&quot;: &quot;A String&quot;,
158 &quot;type&quot;: &quot;A String&quot;,
159 },
160 ],
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800[diff] [blame]161 &quot;partOfSpeech&quot;: &quot;A String&quot;,
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800[diff] [blame]162 &quot;pronunciation&quot;: &quot;A String&quot;,
163 &quot;synonyms&quot;: [
164 {
165 &quot;text&quot;: &quot;A String&quot;,
166 &quot;source&quot;: {
167 &quot;url&quot;: &quot;A String&quot;,
168 &quot;attribution&quot;: &quot;A String&quot;,
169 },
170 },
171 ],
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800[diff] [blame]172 },
173 ],
174 &quot;derivatives&quot;: [
175 {
176 &quot;text&quot;: &quot;A String&quot;,
177 &quot;source&quot;: {
178 &quot;attribution&quot;: &quot;A String&quot;,
179 &quot;url&quot;: &quot;A String&quot;,
180 },
181 },
182 ],
183 &quot;examples&quot;: [
184 {
185 &quot;text&quot;: &quot;A String&quot;,
186 &quot;source&quot;: {
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800[diff] [blame]187 &quot;attribution&quot;: &quot;A String&quot;,
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800[diff] [blame]188 &quot;url&quot;: &quot;A String&quot;,
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800[diff] [blame]189 },
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800[diff] [blame]190 },
191 ],
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]192 },
193 ],
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]194 },
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800[diff] [blame]195 &quot;common&quot;: {
196 &quot;title&quot;: &quot;A String&quot;, # The display title and localized canonical name to use when searching for this entity on Google search.
197 },
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800[diff] [blame]198 &quot;kind&quot;: &quot;A String&quot;,
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]199 },
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800[diff] [blame]200 &quot;selfLink&quot;: &quot;A String&quot;, # URL for this resource. *
201 &quot;layerId&quot;: &quot;A String&quot;, # The Layer id for this data. *
202 &quot;encodedData&quot;: &quot;A String&quot;, # Base64 encoded data for this annotation data.
203 &quot;id&quot;: &quot;A String&quot;, # Unique id for this annotation data.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800[diff] [blame]204 &quot;kind&quot;: &quot;A String&quot;, # Resource Type
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800[diff] [blame]205 &quot;annotationType&quot;: &quot;A String&quot;, # The type of annotation this data is for.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]206 }</pre>
207</div>
208
209<div class="method">
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800[diff] [blame]210 <code class="details" id="list">list(volumeId, layerId, contentVersion, updatedMax=None, annotationDataId=None, locale=None, w=None, scale=None, source=None, h=None, maxResults=None, updatedMin=None, pageToken=None, x__xgafv=None)</code>
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]211 <pre>Gets the annotation data for a volume and layer.
212
213Args:
214 volumeId: string, The volume to retrieve annotation data for. (required)
215 layerId: string, The ID for the layer to get the annotation data. (required)
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700[diff] [blame]216 contentVersion: string, The content version for the requested volume. (required)
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800[diff] [blame]217 updatedMax: string, RFC 3339 timestamp to restrict to items updated prior to this timestamp (exclusive).
218 annotationDataId: string, The list of Annotation Data Ids to retrieve. Pagination is ignored if this is set. (repeated)
219 locale: string, The locale information for the data. ISO-639-1 language and ISO-3166-1 country code. Ex: &#x27;en_US&#x27;.
220 w: integer, The requested pixel width for any images. If width is provided height must also be provided.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800[diff] [blame]221 scale: integer, The requested scale for the image.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800[diff] [blame]222 source: string, String to identify the originator of this request.
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800[diff] [blame]223 h: integer, The requested pixel height for any images. If height is provided width must also be provided.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800[diff] [blame]224 maxResults: integer, Maximum number of results to return
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800[diff] [blame]225 updatedMin: string, RFC 3339 timestamp to restrict to items updated since this timestamp (inclusive).
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800[diff] [blame]226 pageToken: string, The value of the nextToken from the previous page.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]227 x__xgafv: string, V1 error format.
228 Allowed values
229 1 - v1 error format
230 2 - v2 error format
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]231
232Returns:
233 An object of the form:
234
235 {
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800[diff] [blame]236 &quot;totalItems&quot;: 42, # The total number of volume annotations found.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]237 &quot;kind&quot;: &quot;A String&quot;, # Resource type
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]238 &quot;items&quot;: [ # A list of Annotation Data.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]239 {
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800[diff] [blame]240 &quot;annotationType&quot;: &quot;A String&quot;, # The type of annotation this data is for.
241 &quot;volumeId&quot;: &quot;A String&quot;, # The volume id for this data. *
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]242 &quot;data&quot;: { # JSON encoded data for this geo annotation data. Emitted with name &#x27;data&#x27; in JSON output. Either this or dict_data will be populated.
243 &quot;geo&quot;: {
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800[diff] [blame]244 &quot;viewport&quot;: { # The viewport for showing this location. This is a latitude, longitude rectangle.
245 &quot;lo&quot;: {
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800[diff] [blame]246 &quot;latitude&quot;: 3.14,
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800[diff] [blame]247 &quot;longitude&quot;: 3.14,
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800[diff] [blame]248 },
249 &quot;hi&quot;: {
250 &quot;longitude&quot;: 3.14,
251 &quot;latitude&quot;: 3.14,
252 },
253 },
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800[diff] [blame]254 &quot;longitude&quot;: 3.14, # The longitude of the location.
255 &quot;zoom&quot;: 42, # The Zoom level to use for the map. Zoom levels between 0 (the lowest zoom level, in which the entire world can be seen on one map) to 21+ (down to individual buildings). See: https: //developers.google.com/maps/documentation/staticmaps/#Zoomlevels
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700[diff] [blame]256 &quot;boundary&quot;: [ # The boundary of the location as a set of loops containing pairs of latitude, longitude coordinates.
257 &quot;A String&quot;,
258 ],
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800[diff] [blame]259 &quot;cachePolicy&quot;: &quot;A String&quot;, # The cache policy active for this data. EX: UNRESTRICTED, RESTRICTED, NEVER
260 &quot;latitude&quot;: 3.14, # The latitude of the location.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800[diff] [blame]261 &quot;countryCode&quot;: &quot;A String&quot;, # The country code of the location.
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800[diff] [blame]262 &quot;mapType&quot;: &quot;A String&quot;, # The type of map that should be used for this location. EX: HYBRID, ROADMAP, SATELLITE, TERRAIN
263 },
264 &quot;common&quot;: {
265 &quot;previewImageUrl&quot;: &quot;A String&quot;, # The URL for the preview image information.
266 &quot;lang&quot;: &quot;A String&quot;, # The language of the information url and description.
267 &quot;snippetUrl&quot;: &quot;A String&quot;, # The URL for information for this location. Ex: wikipedia link.
268 &quot;title&quot;: &quot;A String&quot;, # The display title and localized canonical name to use when searching for this entity on Google search.
269 &quot;snippet&quot;: &quot;A String&quot;, # The description for this location.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]270 },
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700[diff] [blame]271 &quot;kind&quot;: &quot;A String&quot;,
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]272 },
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800[diff] [blame]273 &quot;kind&quot;: &quot;A String&quot;, # Resource Type
274 &quot;id&quot;: &quot;A String&quot;, # Unique id for this annotation data.
275 &quot;selfLink&quot;: &quot;A String&quot;, # URL for this resource. *
276 &quot;encodedData&quot;: &quot;A String&quot;, # Base64 encoded data for this annotation data.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700[diff] [blame]277 &quot;layerId&quot;: &quot;A String&quot;, # The Layer id for this data. *
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800[diff] [blame]278 &quot;updated&quot;: &quot;A String&quot;, # Timestamp for the last time this data was updated. (RFC 3339 UTC date-time format).
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]279 },
280 ],
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800[diff] [blame]281 &quot;nextPageToken&quot;: &quot;A String&quot;, # Token to pass in for pagination for the next page. This will not be present if this request does not have more results.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]282 }</pre>
283</div>
284
285<div class="method">
286 <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
287 <pre>Retrieves the next page of results.
288
289Args:
290 previous_request: The request for the previous page. (required)
291 previous_response: The response from the request for the previous page. (required)
292
293Returns:
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]294 A request object that you can call &#x27;execute()&#x27; on to request the next
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]295 page. Returns None if there are no more items in the collection.
296 </pre>
297</div>
298
299</body></html>