blob: b51af84e2009623fe0c3e28abe8238714594e667 [file] [log] [blame]
<html><body>
<style>
body, h1, h2, h3, div, span, p, pre, a {
margin: 0;
padding: 0;
border: 0;
font-weight: inherit;
font-style: inherit;
font-size: 100%;
font-family: inherit;
vertical-align: baseline;
}
body {
font-size: 13px;
padding: 1em;
}
h1 {
font-size: 26px;
margin-bottom: 1em;
}
h2 {
font-size: 24px;
margin-bottom: 1em;
}
h3 {
font-size: 20px;
margin-bottom: 1em;
margin-top: 1em;
}
pre, code {
line-height: 1.5;
font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
}
pre {
margin-top: 0.5em;
}
h1, h2, h3, p {
font-family: Arial, sans serif;
}
h1, h2, h3 {
border-bottom: solid #CCC 1px;
}
.toc_element {
margin-top: 0.5em;
}
.firstline {
margin-left: 2 em;
}
.method {
margin-top: 1em;
border: solid 1px #CCC;
padding: 1em;
background: #EEE;
}
.details {
font-weight: bold;
font-size: 14px;
}
</style>
<h1><a href="books_v1.html">Books API</a> . <a href="books_v1.mylibrary.html">mylibrary</a> . <a href="books_v1.mylibrary.readingpositions.html">readingpositions</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
<code><a href="#get">get(volumeId, source=None, contentVersion=None, x__xgafv=None)</a></code></p>
<p class="firstline">Retrieves my reading position information for a volume.</p>
<p class="toc_element">
<code><a href="#setPosition">setPosition(volumeId, position=None, contentVersion=None, timestamp=None, action=None, deviceCookie=None, source=None, x__xgafv=None)</a></code></p>
<p class="firstline">Sets my reading position information for a volume.</p>
<h3>Method Details</h3>
<div class="method">
<code class="details" id="get">get(volumeId, source=None, contentVersion=None, x__xgafv=None)</code>
<pre>Retrieves my reading position information for a volume.
Args:
volumeId: string, ID of volume for which to retrieve a reading position. (required)
source: string, String to identify the originator of this request.
contentVersion: string, Volume content version for which this reading position is requested.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{
&quot;gbImagePosition&quot;: &quot;A String&quot;, # Position in a volume for image-based content.
&quot;epubCfiPosition&quot;: &quot;A String&quot;, # Position in an EPUB as a CFI.
&quot;volumeId&quot;: &quot;A String&quot;, # Volume id associated with this reading position.
&quot;gbTextPosition&quot;: &quot;A String&quot;, # Position in a volume for text-based content.
&quot;pdfPosition&quot;: &quot;A String&quot;, # Position in a PDF file.
&quot;updated&quot;: &quot;A String&quot;, # Timestamp when this reading position was last updated (formatted UTC timestamp with millisecond resolution).
&quot;kind&quot;: &quot;A String&quot;, # Resource type for a reading position.
}</pre>
</div>
<div class="method">
<code class="details" id="setPosition">setPosition(volumeId, position=None, contentVersion=None, timestamp=None, action=None, deviceCookie=None, source=None, x__xgafv=None)</code>
<pre>Sets my reading position information for a volume.
Args:
volumeId: string, ID of volume for which to update the reading position. (required)
position: string, Position string for the new volume reading position.
contentVersion: string, Volume content version for which this reading position applies.
timestamp: string, RFC 3339 UTC format timestamp associated with this reading position.
action: string, Action that caused this reading position to be set.
Allowed values
ACTION_UNDEFINED -
bookmark - User chose bookmark within volume.
chapter - User selected chapter from list.
next-page - Next page event.
prev-page - Previous page event.
scroll - User navigated to page.
search - User chose search results within volume.
deviceCookie: string, Random persistent device cookie optional on set position.
source: string, String to identify the originator of this request.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.
}</pre>
</div>
</body></html>