You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
356 lines
18 KiB
356 lines
18 KiB
<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="mirror_v1.html">Google Mirror API</a> . <a href="mirror_v1.subscriptions.html">subscriptions</a></h1>
|
|
<h2>Instance Methods</h2>
|
|
<p class="toc_element">
|
|
<code><a href="#delete">delete(id)</a></code></p>
|
|
<p class="firstline">Deletes a subscription.</p>
|
|
<p class="toc_element">
|
|
<code><a href="#insert">insert(body)</a></code></p>
|
|
<p class="firstline">Creates a new subscription.</p>
|
|
<p class="toc_element">
|
|
<code><a href="#list">list()</a></code></p>
|
|
<p class="firstline">Retrieves a list of subscriptions for the authenticated user and service.</p>
|
|
<p class="toc_element">
|
|
<code><a href="#update">update(id, body)</a></code></p>
|
|
<p class="firstline">Updates an existing subscription in place.</p>
|
|
<h3>Method Details</h3>
|
|
<div class="method">
|
|
<code class="details" id="delete">delete(id)</code>
|
|
<pre>Deletes a subscription.
|
|
|
|
Args:
|
|
id: string, The ID of the subscription. (required)
|
|
</pre>
|
|
</div>
|
|
|
|
<div class="method">
|
|
<code class="details" id="insert">insert(body)</code>
|
|
<pre>Creates a new subscription.
|
|
|
|
Args:
|
|
body: object, The request body. (required)
|
|
The object takes the form of:
|
|
|
|
{ # A subscription to events on a collection.
|
|
"kind": "mirror#subscription", # The type of resource. This is always mirror#subscription.
|
|
"notification": { # A notification delivered by the API. # Container object for notifications. This is not populated in the Subscription resource.
|
|
"itemId": "A String", # The ID of the item that generated the notification.
|
|
"collection": "A String", # The collection that generated the notification.
|
|
"verifyToken": "A String", # The secret verify token provided by the service when it subscribed for notifications.
|
|
"userToken": "A String", # The user token provided by the service when it subscribed for notifications.
|
|
"userActions": [ # A list of actions taken by the user that triggered the notification.
|
|
{ # Represents an action taken by the user that triggered a notification.
|
|
"type": "A String", # The type of action. The value of this can be:
|
|
# - SHARE - the user shared an item.
|
|
# - REPLY - the user replied to an item.
|
|
# - REPLY_ALL - the user replied to all recipients of an item.
|
|
# - CUSTOM - the user selected a custom menu item on the timeline item.
|
|
# - DELETE - the user deleted the item.
|
|
# - PIN - the user pinned the item.
|
|
# - UNPIN - the user unpinned the item.
|
|
# - LAUNCH - the user initiated a voice command. In the future, additional types may be added. UserActions with unrecognized types should be ignored.
|
|
"payload": "A String", # An optional payload for the action.
|
|
#
|
|
# For actions of type CUSTOM, this is the ID of the custom menu item that was selected.
|
|
},
|
|
],
|
|
"operation": "A String", # The type of operation that generated the notification.
|
|
},
|
|
"updated": "A String", # The time at which this subscription was last modified, formatted according to RFC 3339.
|
|
"collection": "A String", # The collection to subscribe to. Allowed values are:
|
|
# - timeline - Changes in the timeline including insertion, deletion, and updates.
|
|
# - locations - Location updates.
|
|
# - settings - Settings updates.
|
|
"verifyToken": "A String", # A secret token sent to the subscriber in notifications so that it can verify that the notification was generated by Google.
|
|
"userToken": "A String", # An opaque token sent to the subscriber in notifications so that it can determine the ID of the user.
|
|
"operation": [ # A list of operations that should be subscribed to. An empty list indicates that all operations on the collection should be subscribed to. Allowed values are:
|
|
# - UPDATE - The item has been updated.
|
|
# - INSERT - A new item has been inserted.
|
|
# - DELETE - The item has been deleted.
|
|
# - MENU_ACTION - A custom menu item has been triggered by the user.
|
|
"A String",
|
|
],
|
|
"id": "A String", # The ID of the subscription.
|
|
"callbackUrl": "A String", # The URL where notifications should be delivered (must start with https://).
|
|
}
|
|
|
|
|
|
Returns:
|
|
An object of the form:
|
|
|
|
{ # A subscription to events on a collection.
|
|
"kind": "mirror#subscription", # The type of resource. This is always mirror#subscription.
|
|
"notification": { # A notification delivered by the API. # Container object for notifications. This is not populated in the Subscription resource.
|
|
"itemId": "A String", # The ID of the item that generated the notification.
|
|
"collection": "A String", # The collection that generated the notification.
|
|
"verifyToken": "A String", # The secret verify token provided by the service when it subscribed for notifications.
|
|
"userToken": "A String", # The user token provided by the service when it subscribed for notifications.
|
|
"userActions": [ # A list of actions taken by the user that triggered the notification.
|
|
{ # Represents an action taken by the user that triggered a notification.
|
|
"type": "A String", # The type of action. The value of this can be:
|
|
# - SHARE - the user shared an item.
|
|
# - REPLY - the user replied to an item.
|
|
# - REPLY_ALL - the user replied to all recipients of an item.
|
|
# - CUSTOM - the user selected a custom menu item on the timeline item.
|
|
# - DELETE - the user deleted the item.
|
|
# - PIN - the user pinned the item.
|
|
# - UNPIN - the user unpinned the item.
|
|
# - LAUNCH - the user initiated a voice command. In the future, additional types may be added. UserActions with unrecognized types should be ignored.
|
|
"payload": "A String", # An optional payload for the action.
|
|
#
|
|
# For actions of type CUSTOM, this is the ID of the custom menu item that was selected.
|
|
},
|
|
],
|
|
"operation": "A String", # The type of operation that generated the notification.
|
|
},
|
|
"updated": "A String", # The time at which this subscription was last modified, formatted according to RFC 3339.
|
|
"collection": "A String", # The collection to subscribe to. Allowed values are:
|
|
# - timeline - Changes in the timeline including insertion, deletion, and updates.
|
|
# - locations - Location updates.
|
|
# - settings - Settings updates.
|
|
"verifyToken": "A String", # A secret token sent to the subscriber in notifications so that it can verify that the notification was generated by Google.
|
|
"userToken": "A String", # An opaque token sent to the subscriber in notifications so that it can determine the ID of the user.
|
|
"operation": [ # A list of operations that should be subscribed to. An empty list indicates that all operations on the collection should be subscribed to. Allowed values are:
|
|
# - UPDATE - The item has been updated.
|
|
# - INSERT - A new item has been inserted.
|
|
# - DELETE - The item has been deleted.
|
|
# - MENU_ACTION - A custom menu item has been triggered by the user.
|
|
"A String",
|
|
],
|
|
"id": "A String", # The ID of the subscription.
|
|
"callbackUrl": "A String", # The URL where notifications should be delivered (must start with https://).
|
|
}</pre>
|
|
</div>
|
|
|
|
<div class="method">
|
|
<code class="details" id="list">list()</code>
|
|
<pre>Retrieves a list of subscriptions for the authenticated user and service.
|
|
|
|
Args:
|
|
|
|
Returns:
|
|
An object of the form:
|
|
|
|
{ # A list of Subscriptions. This is the response from the server to GET requests on the subscription collection.
|
|
"items": [ # The list of subscriptions.
|
|
{ # A subscription to events on a collection.
|
|
"kind": "mirror#subscription", # The type of resource. This is always mirror#subscription.
|
|
"notification": { # A notification delivered by the API. # Container object for notifications. This is not populated in the Subscription resource.
|
|
"itemId": "A String", # The ID of the item that generated the notification.
|
|
"collection": "A String", # The collection that generated the notification.
|
|
"verifyToken": "A String", # The secret verify token provided by the service when it subscribed for notifications.
|
|
"userToken": "A String", # The user token provided by the service when it subscribed for notifications.
|
|
"userActions": [ # A list of actions taken by the user that triggered the notification.
|
|
{ # Represents an action taken by the user that triggered a notification.
|
|
"type": "A String", # The type of action. The value of this can be:
|
|
# - SHARE - the user shared an item.
|
|
# - REPLY - the user replied to an item.
|
|
# - REPLY_ALL - the user replied to all recipients of an item.
|
|
# - CUSTOM - the user selected a custom menu item on the timeline item.
|
|
# - DELETE - the user deleted the item.
|
|
# - PIN - the user pinned the item.
|
|
# - UNPIN - the user unpinned the item.
|
|
# - LAUNCH - the user initiated a voice command. In the future, additional types may be added. UserActions with unrecognized types should be ignored.
|
|
"payload": "A String", # An optional payload for the action.
|
|
#
|
|
# For actions of type CUSTOM, this is the ID of the custom menu item that was selected.
|
|
},
|
|
],
|
|
"operation": "A String", # The type of operation that generated the notification.
|
|
},
|
|
"updated": "A String", # The time at which this subscription was last modified, formatted according to RFC 3339.
|
|
"collection": "A String", # The collection to subscribe to. Allowed values are:
|
|
# - timeline - Changes in the timeline including insertion, deletion, and updates.
|
|
# - locations - Location updates.
|
|
# - settings - Settings updates.
|
|
"verifyToken": "A String", # A secret token sent to the subscriber in notifications so that it can verify that the notification was generated by Google.
|
|
"userToken": "A String", # An opaque token sent to the subscriber in notifications so that it can determine the ID of the user.
|
|
"operation": [ # A list of operations that should be subscribed to. An empty list indicates that all operations on the collection should be subscribed to. Allowed values are:
|
|
# - UPDATE - The item has been updated.
|
|
# - INSERT - A new item has been inserted.
|
|
# - DELETE - The item has been deleted.
|
|
# - MENU_ACTION - A custom menu item has been triggered by the user.
|
|
"A String",
|
|
],
|
|
"id": "A String", # The ID of the subscription.
|
|
"callbackUrl": "A String", # The URL where notifications should be delivered (must start with https://).
|
|
},
|
|
],
|
|
"kind": "mirror#subscriptionsList", # The type of resource. This is always mirror#subscriptionsList.
|
|
}</pre>
|
|
</div>
|
|
|
|
<div class="method">
|
|
<code class="details" id="update">update(id, body)</code>
|
|
<pre>Updates an existing subscription in place.
|
|
|
|
Args:
|
|
id: string, The ID of the subscription. (required)
|
|
body: object, The request body. (required)
|
|
The object takes the form of:
|
|
|
|
{ # A subscription to events on a collection.
|
|
"kind": "mirror#subscription", # The type of resource. This is always mirror#subscription.
|
|
"notification": { # A notification delivered by the API. # Container object for notifications. This is not populated in the Subscription resource.
|
|
"itemId": "A String", # The ID of the item that generated the notification.
|
|
"collection": "A String", # The collection that generated the notification.
|
|
"verifyToken": "A String", # The secret verify token provided by the service when it subscribed for notifications.
|
|
"userToken": "A String", # The user token provided by the service when it subscribed for notifications.
|
|
"userActions": [ # A list of actions taken by the user that triggered the notification.
|
|
{ # Represents an action taken by the user that triggered a notification.
|
|
"type": "A String", # The type of action. The value of this can be:
|
|
# - SHARE - the user shared an item.
|
|
# - REPLY - the user replied to an item.
|
|
# - REPLY_ALL - the user replied to all recipients of an item.
|
|
# - CUSTOM - the user selected a custom menu item on the timeline item.
|
|
# - DELETE - the user deleted the item.
|
|
# - PIN - the user pinned the item.
|
|
# - UNPIN - the user unpinned the item.
|
|
# - LAUNCH - the user initiated a voice command. In the future, additional types may be added. UserActions with unrecognized types should be ignored.
|
|
"payload": "A String", # An optional payload for the action.
|
|
#
|
|
# For actions of type CUSTOM, this is the ID of the custom menu item that was selected.
|
|
},
|
|
],
|
|
"operation": "A String", # The type of operation that generated the notification.
|
|
},
|
|
"updated": "A String", # The time at which this subscription was last modified, formatted according to RFC 3339.
|
|
"collection": "A String", # The collection to subscribe to. Allowed values are:
|
|
# - timeline - Changes in the timeline including insertion, deletion, and updates.
|
|
# - locations - Location updates.
|
|
# - settings - Settings updates.
|
|
"verifyToken": "A String", # A secret token sent to the subscriber in notifications so that it can verify that the notification was generated by Google.
|
|
"userToken": "A String", # An opaque token sent to the subscriber in notifications so that it can determine the ID of the user.
|
|
"operation": [ # A list of operations that should be subscribed to. An empty list indicates that all operations on the collection should be subscribed to. Allowed values are:
|
|
# - UPDATE - The item has been updated.
|
|
# - INSERT - A new item has been inserted.
|
|
# - DELETE - The item has been deleted.
|
|
# - MENU_ACTION - A custom menu item has been triggered by the user.
|
|
"A String",
|
|
],
|
|
"id": "A String", # The ID of the subscription.
|
|
"callbackUrl": "A String", # The URL where notifications should be delivered (must start with https://).
|
|
}
|
|
|
|
|
|
Returns:
|
|
An object of the form:
|
|
|
|
{ # A subscription to events on a collection.
|
|
"kind": "mirror#subscription", # The type of resource. This is always mirror#subscription.
|
|
"notification": { # A notification delivered by the API. # Container object for notifications. This is not populated in the Subscription resource.
|
|
"itemId": "A String", # The ID of the item that generated the notification.
|
|
"collection": "A String", # The collection that generated the notification.
|
|
"verifyToken": "A String", # The secret verify token provided by the service when it subscribed for notifications.
|
|
"userToken": "A String", # The user token provided by the service when it subscribed for notifications.
|
|
"userActions": [ # A list of actions taken by the user that triggered the notification.
|
|
{ # Represents an action taken by the user that triggered a notification.
|
|
"type": "A String", # The type of action. The value of this can be:
|
|
# - SHARE - the user shared an item.
|
|
# - REPLY - the user replied to an item.
|
|
# - REPLY_ALL - the user replied to all recipients of an item.
|
|
# - CUSTOM - the user selected a custom menu item on the timeline item.
|
|
# - DELETE - the user deleted the item.
|
|
# - PIN - the user pinned the item.
|
|
# - UNPIN - the user unpinned the item.
|
|
# - LAUNCH - the user initiated a voice command. In the future, additional types may be added. UserActions with unrecognized types should be ignored.
|
|
"payload": "A String", # An optional payload for the action.
|
|
#
|
|
# For actions of type CUSTOM, this is the ID of the custom menu item that was selected.
|
|
},
|
|
],
|
|
"operation": "A String", # The type of operation that generated the notification.
|
|
},
|
|
"updated": "A String", # The time at which this subscription was last modified, formatted according to RFC 3339.
|
|
"collection": "A String", # The collection to subscribe to. Allowed values are:
|
|
# - timeline - Changes in the timeline including insertion, deletion, and updates.
|
|
# - locations - Location updates.
|
|
# - settings - Settings updates.
|
|
"verifyToken": "A String", # A secret token sent to the subscriber in notifications so that it can verify that the notification was generated by Google.
|
|
"userToken": "A String", # An opaque token sent to the subscriber in notifications so that it can determine the ID of the user.
|
|
"operation": [ # A list of operations that should be subscribed to. An empty list indicates that all operations on the collection should be subscribed to. Allowed values are:
|
|
# - UPDATE - The item has been updated.
|
|
# - INSERT - A new item has been inserted.
|
|
# - DELETE - The item has been deleted.
|
|
# - MENU_ACTION - A custom menu item has been triggered by the user.
|
|
"A String",
|
|
],
|
|
"id": "A String", # The ID of the subscription.
|
|
"callbackUrl": "A String", # The URL where notifications should be delivered (must start with https://).
|
|
}</pre>
|
|
</div>
|
|
|
|
</body></html> |