blob: 6d114933feb8fe5c997962caf3cdbd95557dfc34 [file] [log] [blame]
Craig Citroe633be12015-03-02 13:40:36 -08001<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
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -070075<h1><a href="fitness_v1.html">Fitness API</a> . <a href="fitness_v1.users.html">users</a> . <a href="fitness_v1.users.sessions.html">sessions</a></h1>
Craig Citroe633be12015-03-02 13:40:36 -080076<h2>Instance Methods</h2>
77<p class="toc_element">
Dmitry Frenkel3e17f892020-10-06 16:46:05 -070078 <code><a href="#close">close()</a></code></p>
79<p class="firstline">Close httplib2 connections.</p>
80<p class="toc_element">
yoshi-code-bota8b35b92021-03-31 13:33:30 -070081 <code><a href="#delete">delete(userId, sessionId, x__xgafv=None)</a></code></p>
Craig Citroe633be12015-03-02 13:40:36 -080082<p class="firstline">Deletes a session specified by the given session ID.</p>
83<p class="toc_element">
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -080084 <code><a href="#list">list(userId, activityType=None, endTime=None, includeDeleted=None, pageToken=None, startTime=None, x__xgafv=None)</a></code></p>
Craig Citroe633be12015-03-02 13:40:36 -080085<p class="firstline">Lists sessions previously created.</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<p class="toc_element">
yoshi-code-bota8b35b92021-03-31 13:33:30 -070090 <code><a href="#update">update(userId, sessionId, body=None, x__xgafv=None)</a></code></p>
Craig Citroe633be12015-03-02 13:40:36 -080091<p class="firstline">Updates or insert a given session.</p>
92<h3>Method Details</h3>
93<div class="method">
Dmitry Frenkel3e17f892020-10-06 16:46:05 -070094 <code class="details" id="close">close()</code>
95 <pre>Close httplib2 connections.</pre>
96</div>
97
98<div class="method">
yoshi-code-bota8b35b92021-03-31 13:33:30 -070099 <code class="details" id="delete">delete(userId, sessionId, x__xgafv=None)</code>
Craig Citroe633be12015-03-02 13:40:36 -0800100 <pre>Deletes a session specified by the given session ID.
101
102Args:
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700103 userId: string, Delete a session for the person identified. Use me to indicate the authenticated user. Only me is supported at this time. (required)
Craig Citroe633be12015-03-02 13:40:36 -0800104 sessionId: string, The ID of the session to be deleted. (required)
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700105 x__xgafv: string, V1 error format.
106 Allowed values
107 1 - v1 error format
108 2 - v2 error format
Craig Citroe633be12015-03-02 13:40:36 -0800109</pre>
110</div>
111
112<div class="method">
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800113 <code class="details" id="list">list(userId, activityType=None, endTime=None, includeDeleted=None, pageToken=None, startTime=None, x__xgafv=None)</code>
Craig Citroe633be12015-03-02 13:40:36 -0800114 <pre>Lists sessions previously created.
115
116Args:
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700117 userId: string, List sessions for the person identified. Use me to indicate the authenticated user. Only me is supported at this time. (required)
Yoshi Automation Bot0bf565c2020-12-09 08:56:03 -0800118 activityType: integer, If non-empty, only sessions with these activity types should be returned. (repeated)
119 endTime: string, An RFC3339 timestamp. Only sessions ending between the start and end times will be included in the response. If this time is omitted but startTime is specified, all sessions from startTime to the end of time will be returned.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800120 includeDeleted: boolean, If true, and if both startTime and endTime are omitted, session deletions will be returned.
Yoshi Automation Bot0bf565c2020-12-09 08:56:03 -0800121 pageToken: string, The continuation token, which is used for incremental syncing. To get the next batch of changes, set this parameter to the value of nextPageToken from the previous response. The page token is ignored if either start or end time is specified. If none of start time, end time, and the page token is specified, sessions modified in the last 30 days are returned.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800122 startTime: string, An RFC3339 timestamp. Only sessions ending between the start and end times will be included in the response. If this time is omitted but endTime is specified, all sessions from the start of time up to endTime will be returned.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700123 x__xgafv: string, V1 error format.
124 Allowed values
125 1 - v1 error format
126 2 - v2 error format
Craig Citroe633be12015-03-02 13:40:36 -0800127
128Returns:
129 An object of the form:
130
131 {
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800132 &quot;deletedSession&quot;: [ # If includeDeleted is set to true in the request, and startTime and endTime are omitted, this will include sessions which were deleted since the last sync.
133 { # Sessions contain metadata, such as a user-friendly name and time interval information.
134 &quot;activeTimeMillis&quot;: &quot;A String&quot;, # Session active time. While start_time_millis and end_time_millis define the full session time, the active time can be shorter and specified by active_time_millis. If the inactive time during the session is known, it should also be inserted via a com.google.activity.segment data point with a STILL activity value
135 &quot;activityType&quot;: 42, # The type of activity this session represents.
136 &quot;application&quot;: { # The application that created the session.
137 &quot;detailsUrl&quot;: &quot;A String&quot;, # An optional URI that can be used to link back to the application.
138 &quot;name&quot;: &quot;A String&quot;, # The name of this application. This is required for REST clients, but we do not enforce uniqueness of this name. It is provided as a matter of convenience for other developers who would like to identify which REST created an Application or Data Source.
139 &quot;packageName&quot;: &quot;A String&quot;, # Package name for this application. This is used as a unique identifier when created by Android applications, but cannot be specified by REST clients. REST clients will have their developer project number reflected into the Data Source data stream IDs, instead of the packageName.
140 &quot;version&quot;: &quot;A String&quot;, # Version of the application. You should update this field whenever the application changes in a way that affects the computation of the data.
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800141 },
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800142 &quot;description&quot;: &quot;A String&quot;, # A description for this session.
143 &quot;endTimeMillis&quot;: &quot;A String&quot;, # An end time, in milliseconds since epoch, inclusive.
144 &quot;id&quot;: &quot;A String&quot;, # A client-generated identifier that is unique across all sessions owned by this particular user.
145 &quot;modifiedTimeMillis&quot;: &quot;A String&quot;, # A timestamp that indicates when the session was last modified.
146 &quot;name&quot;: &quot;A String&quot;, # A human readable name of the session.
147 &quot;startTimeMillis&quot;: &quot;A String&quot;, # A start time, in milliseconds since epoch, inclusive.
148 },
149 ],
150 &quot;hasMoreData&quot;: True or False, # Flag to indicate server has more data to transfer. DO NOT USE THIS FIELD. It is never populated in responses from the server.
151 &quot;nextPageToken&quot;: &quot;A String&quot;, # The sync token which is used to sync further changes. This will only be provided if both startTime and endTime are omitted from the request.
152 &quot;session&quot;: [ # Sessions with an end time that is between startTime and endTime of the request.
153 { # Sessions contain metadata, such as a user-friendly name and time interval information.
154 &quot;activeTimeMillis&quot;: &quot;A String&quot;, # Session active time. While start_time_millis and end_time_millis define the full session time, the active time can be shorter and specified by active_time_millis. If the inactive time during the session is known, it should also be inserted via a com.google.activity.segment data point with a STILL activity value
155 &quot;activityType&quot;: 42, # The type of activity this session represents.
156 &quot;application&quot;: { # The application that created the session.
157 &quot;detailsUrl&quot;: &quot;A String&quot;, # An optional URI that can be used to link back to the application.
158 &quot;name&quot;: &quot;A String&quot;, # The name of this application. This is required for REST clients, but we do not enforce uniqueness of this name. It is provided as a matter of convenience for other developers who would like to identify which REST created an Application or Data Source.
159 &quot;packageName&quot;: &quot;A String&quot;, # Package name for this application. This is used as a unique identifier when created by Android applications, but cannot be specified by REST clients. REST clients will have their developer project number reflected into the Data Source data stream IDs, instead of the packageName.
160 &quot;version&quot;: &quot;A String&quot;, # Version of the application. You should update this field whenever the application changes in a way that affects the computation of the data.
Yoshi Automation Bot0bf565c2020-12-09 08:56:03 -0800161 },
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800162 &quot;description&quot;: &quot;A String&quot;, # A description for this session.
163 &quot;endTimeMillis&quot;: &quot;A String&quot;, # An end time, in milliseconds since epoch, inclusive.
164 &quot;id&quot;: &quot;A String&quot;, # A client-generated identifier that is unique across all sessions owned by this particular user.
165 &quot;modifiedTimeMillis&quot;: &quot;A String&quot;, # A timestamp that indicates when the session was last modified.
166 &quot;name&quot;: &quot;A String&quot;, # A human readable name of the session.
167 &quot;startTimeMillis&quot;: &quot;A String&quot;, # A start time, in milliseconds since epoch, inclusive.
168 },
169 ],
170}</pre>
Craig Citroe633be12015-03-02 13:40:36 -0800171</div>
172
173<div class="method">
174 <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
175 <pre>Retrieves the next page of results.
176
177Args:
178 previous_request: The request for the previous page. (required)
179 previous_response: The response from the request for the previous page. (required)
180
181Returns:
Bu Sun Kim65020912020-05-20 12:08:20 -0700182 A request object that you can call &#x27;execute()&#x27; on to request the next
Craig Citroe633be12015-03-02 13:40:36 -0800183 page. Returns None if there are no more items in the collection.
184 </pre>
185</div>
186
187<div class="method">
yoshi-code-bota8b35b92021-03-31 13:33:30 -0700188 <code class="details" id="update">update(userId, sessionId, body=None, x__xgafv=None)</code>
Craig Citroe633be12015-03-02 13:40:36 -0800189 <pre>Updates or insert a given session.
190
191Args:
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700192 userId: string, Create sessions for the person identified. Use me to indicate the authenticated user. Only me is supported at this time. (required)
Craig Citroe633be12015-03-02 13:40:36 -0800193 sessionId: string, The ID of the session to be created. (required)
Dan O'Mearadd494642020-05-01 07:42:23 -0700194 body: object, The request body.
Craig Citroe633be12015-03-02 13:40:36 -0800195 The object takes the form of:
196
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700197{ # Sessions contain metadata, such as a user-friendly name and time interval information.
Yoshi Automation Bot0bf565c2020-12-09 08:56:03 -0800198 &quot;activeTimeMillis&quot;: &quot;A String&quot;, # Session active time. While start_time_millis and end_time_millis define the full session time, the active time can be shorter and specified by active_time_millis. If the inactive time during the session is known, it should also be inserted via a com.google.activity.segment data point with a STILL activity value
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800199 &quot;activityType&quot;: 42, # The type of activity this session represents.
200 &quot;application&quot;: { # The application that created the session.
201 &quot;detailsUrl&quot;: &quot;A String&quot;, # An optional URI that can be used to link back to the application.
202 &quot;name&quot;: &quot;A String&quot;, # The name of this application. This is required for REST clients, but we do not enforce uniqueness of this name. It is provided as a matter of convenience for other developers who would like to identify which REST created an Application or Data Source.
203 &quot;packageName&quot;: &quot;A String&quot;, # Package name for this application. This is used as a unique identifier when created by Android applications, but cannot be specified by REST clients. REST clients will have their developer project number reflected into the Data Source data stream IDs, instead of the packageName.
204 &quot;version&quot;: &quot;A String&quot;, # Version of the application. You should update this field whenever the application changes in a way that affects the computation of the data.
205 },
Yoshi Automation Bot0bf565c2020-12-09 08:56:03 -0800206 &quot;description&quot;: &quot;A String&quot;, # A description for this session.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800207 &quot;endTimeMillis&quot;: &quot;A String&quot;, # An end time, in milliseconds since epoch, inclusive.
Yoshi Automation Bot0bf565c2020-12-09 08:56:03 -0800208 &quot;id&quot;: &quot;A String&quot;, # A client-generated identifier that is unique across all sessions owned by this particular user.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800209 &quot;modifiedTimeMillis&quot;: &quot;A String&quot;, # A timestamp that indicates when the session was last modified.
210 &quot;name&quot;: &quot;A String&quot;, # A human readable name of the session.
211 &quot;startTimeMillis&quot;: &quot;A String&quot;, # A start time, in milliseconds since epoch, inclusive.
Craig Citroe633be12015-03-02 13:40:36 -0800212}
213
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700214 x__xgafv: string, V1 error format.
215 Allowed values
216 1 - v1 error format
217 2 - v2 error format
Craig Citroe633be12015-03-02 13:40:36 -0800218
219Returns:
220 An object of the form:
221
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700222 { # Sessions contain metadata, such as a user-friendly name and time interval information.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800223 &quot;activeTimeMillis&quot;: &quot;A String&quot;, # Session active time. While start_time_millis and end_time_millis define the full session time, the active time can be shorter and specified by active_time_millis. If the inactive time during the session is known, it should also be inserted via a com.google.activity.segment data point with a STILL activity value
224 &quot;activityType&quot;: 42, # The type of activity this session represents.
225 &quot;application&quot;: { # The application that created the session.
226 &quot;detailsUrl&quot;: &quot;A String&quot;, # An optional URI that can be used to link back to the application.
227 &quot;name&quot;: &quot;A String&quot;, # The name of this application. This is required for REST clients, but we do not enforce uniqueness of this name. It is provided as a matter of convenience for other developers who would like to identify which REST created an Application or Data Source.
228 &quot;packageName&quot;: &quot;A String&quot;, # Package name for this application. This is used as a unique identifier when created by Android applications, but cannot be specified by REST clients. REST clients will have their developer project number reflected into the Data Source data stream IDs, instead of the packageName.
229 &quot;version&quot;: &quot;A String&quot;, # Version of the application. You should update this field whenever the application changes in a way that affects the computation of the data.
230 },
231 &quot;description&quot;: &quot;A String&quot;, # A description for this session.
232 &quot;endTimeMillis&quot;: &quot;A String&quot;, # An end time, in milliseconds since epoch, inclusive.
233 &quot;id&quot;: &quot;A String&quot;, # A client-generated identifier that is unique across all sessions owned by this particular user.
234 &quot;modifiedTimeMillis&quot;: &quot;A String&quot;, # A timestamp that indicates when the session was last modified.
235 &quot;name&quot;: &quot;A String&quot;, # A human readable name of the session.
236 &quot;startTimeMillis&quot;: &quot;A String&quot;, # A start time, in milliseconds since epoch, inclusive.
237}</pre>
Craig Citroe633be12015-03-02 13:40:36 -0800238</div>
239
240</body></html>