| <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> |