feat(homegraph): update the api

yoshi-automation · yoshi-automation · commit ad97f76a5e38 · 2021-03-28T13:27:12.000Z
#### homegraph:v1

The following keys were deleted:
- resources.devices.methods.requestLink (Total Keys: 8)
- schemas.RequestLinkRequest (Total Keys: 10)
diff --git a/docs/dyn/homegraph_v1.devices.html b/docs/dyn/homegraph_v1.devices.html
@@ -83,9 +83,6 @@ <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#reportStateAndNotification">reportStateAndNotification(body=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Reports device state and optionally sends device notifications. Called by your smart home Action when the state of a third-party device changes or you need to send a notification about the device. See [Implement Report State](https://developers.google.com/assistant/smarthome/develop/report-state) for more information. This method updates the device state according to its declared [traits](https://developers.google.com/assistant/smarthome/concepts/devices-traits). Publishing a new state value outside of these traits will result in an `INVALID_ARGUMENT` error response. The third-party user's identity is passed in via the `agent_user_id` (see ReportStateAndNotificationRequest). This request must be authorized using service account credentials from your Actions console project.</p>
-<p class="toc_element">
-  <code><a href="#requestLink">requestLink(body=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Sends an account linking suggestion to users associated with any potential Cast devices detected by third-party devices. This request must be authorized using service account credentials from your Actions console project.</p>
 <p class="toc_element">
   <code><a href="#requestSync">requestSync(body=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Requests Google to send an `action.devices.SYNC` [intent](https://developers.google.com/assistant/smarthome/reference/intent/sync) to your smart home Action to update device metadata for the given user. The third-party user's identity is passed via the `agent_user_id` (see RequestSyncDevicesRequest). This request must be authorized using service account credentials from your Actions console project.</p>
@@ -153,7 +150,7 @@ <h3>Method Details</h3>
 { # Request type for the [`ReportStateAndNotification`](#google.home.graph.v1.HomeGraphApiService.ReportStateAndNotification) call. It may include states, notifications, or both. States and notifications are defined per `device_id` (for example, &quot;123&quot; and &quot;456&quot; in the following example). # Example ```json { &quot;requestId&quot;: &quot;ff36a3cc-ec34-11e6-b1a0-64510650abcf&quot;, &quot;agentUserId&quot;: &quot;1234&quot;, &quot;payload&quot;: { &quot;devices&quot;: { &quot;states&quot;: { &quot;123&quot;: { &quot;on&quot;: true }, &quot;456&quot;: { &quot;on&quot;: true, &quot;brightness&quot;: 10 } }, } } } ```
   &quot;agentUserId&quot;: &quot;A String&quot;, # Required. Third-party user ID.
   &quot;eventId&quot;: &quot;A String&quot;, # Unique identifier per event (for example, a doorbell press).
-  &quot;followUpToken&quot;: &quot;A String&quot;, # Token to maintain state in the follow up notification response. Deprecated. See the [notifications guide](https://developers.google.com/assistant/smarthome/develop/notifications) for details on implementing follow up notifications.
+  &quot;followUpToken&quot;: &quot;A String&quot;, # Deprecated.
   &quot;payload&quot;: { # Payload containing the state and notification information for devices. # Required. State of devices to update and notification metadata for devices.
     &quot;devices&quot;: { # The states and notifications specific to a device. # The devices for updating state and sending notifications.
       &quot;notifications&quot;: { # Notifications metadata for devices. See the **Device NOTIFICATIONS** section of the individual trait [reference guides](https://developers.google.com/assistant/smarthome/traits).
@@ -180,36 +177,6 @@ <h3>Method Details</h3>
 }</pre>
 </div>
 
-<div class="method">
-    <code class="details" id="requestLink">requestLink(body=None, x__xgafv=None)</code>
-  <pre>Sends an account linking suggestion to users associated with any potential Cast devices detected by third-party devices. This request must be authorized using service account credentials from your Actions console project.
-
-Args:
-  body: object, The request body.
-    The object takes the form of:
-
-{ # Request type for the [`RequestLink`](#google.home.graph.v1.HomeGraphApiService.RequestLink) call.
-  &quot;payload&quot;: { # Payload containing potential devices detected and when they were detected. # Required. ID(s) and detection time of potential Cast devices.
-    &quot;detectionTime&quot;: &quot;A String&quot;, # Required. Time at which devices represented in `potential_cast_device_ids` were detected.
-    &quot;potentialCastDeviceIds&quot;: [ # Required. List of device IDs detected that may potentially be for Cast devices.
-      &quot;A String&quot;,
-    ],
-  },
-  &quot;requestId&quot;: &quot;A String&quot;, # Required. Request ID used for debugging.
-}
-
-  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>
-
 <div class="method">
     <code class="details" id="requestSync">requestSync(body=None, x__xgafv=None)</code>
   <pre>Requests Google to send an `action.devices.SYNC` [intent](https://developers.google.com/assistant/smarthome/reference/intent/sync) to your smart home Action to update device metadata for the given user. The third-party user&#x27;s identity is passed via the `agent_user_id` (see RequestSyncDevicesRequest). This request must be authorized using service account credentials from your Actions console project.
diff --git a/googleapiclient/discovery_cache/documents/homegraph.v1.json b/googleapiclient/discovery_cache/documents/homegraph.v1.json
@@ -3,7 +3,7 @@
         "oauth2": {
             "scopes": {
                 "https://www.googleapis.com/auth/homegraph": {
-                    "description": "New Service: https://www.googleapis.com/auth/homegraph"
+                    "description": "Private Service: https://www.googleapis.com/auth/homegraph"
                 }
             }
         }
@@ -177,24 +177,6 @@
                         "https://www.googleapis.com/auth/homegraph"
                     ]
                 },
-                "requestLink": {
-                    "description": "Sends an account linking suggestion to users associated with any potential Cast devices detected by third-party devices. This request must be authorized using service account credentials from your Actions console project.",
-                    "flatPath": "v1/devices:requestLink",
-                    "httpMethod": "POST",
-                    "id": "homegraph.devices.requestLink",
-                    "parameterOrder": [],
-                    "parameters": {},
-                    "path": "v1/devices:requestLink",
-                    "request": {
-                        "$ref": "RequestLinkRequest"
-                    },
-                    "response": {
-                        "$ref": "Empty"
-                    },
-                    "scopes": [
-                        "https://www.googleapis.com/auth/homegraph"
-                    ]
-                },
                 "requestSync": {
                     "description": "Requests Google to send an `action.devices.SYNC` [intent](https://developers.google.com/assistant/smarthome/reference/intent/sync) to your smart home Action to update device metadata for the given user. The third-party user's identity is passed via the `agent_user_id` (see RequestSyncDevicesRequest). This request must be authorized using service account credentials from your Actions console project.",
                     "flatPath": "v1/devices:requestSync",
@@ -234,7 +216,7 @@
             }
         }
     },
-    "revision": "20210226",
+    "revision": "20210318",
     "rootUrl": "https://homegraph.googleapis.com/",
     "schemas": {
         "AgentDeviceId": {
@@ -520,7 +502,7 @@
                     "type": "string"
                 },
                 "followUpToken": {
-                    "description": "Token to maintain state in the follow up notification response. Deprecated. See the [notifications guide](https://developers.google.com/assistant/smarthome/develop/notifications) for details on implementing follow up notifications.",
+                    "description": "Deprecated.",
                     "type": "string"
                 },
                 "payload": {
@@ -545,40 +527,6 @@
             },
             "type": "object"
         },
-        "RequestLinkRequest": {
-            "description": "Request type for the [`RequestLink`](#google.home.graph.v1.HomeGraphApiService.RequestLink) call.",
-            "id": "RequestLinkRequest",
-            "properties": {
-                "payload": {
-                    "$ref": "RequestLinkRequestPayload",
-                    "description": "Required. ID(s) and detection time of potential Cast devices."
-                },
-                "requestId": {
-                    "description": "Required. Request ID used for debugging.",
-                    "type": "string"
-                }
-            },
-            "type": "object"
-        },
-        "RequestLinkRequestPayload": {
-            "description": "Payload containing potential devices detected and when they were detected.",
-            "id": "RequestLinkRequestPayload",
-            "properties": {
-                "detectionTime": {
-                    "description": "Required. Time at which devices represented in `potential_cast_device_ids` were detected.",
-                    "format": "google-datetime",
-                    "type": "string"
-                },
-                "potentialCastDeviceIds": {
-                    "description": "Required. List of device IDs detected that may potentially be for Cast devices.",
-                    "items": {
-                        "type": "string"
-                    },
-                    "type": "array"
-                }
-            },
-            "type": "object"
-        },
         "RequestSyncDevicesRequest": {
             "description": "Request type for the [`RequestSyncDevices`](#google.home.graph.v1.HomeGraphApiService.RequestSyncDevices) call.",
             "id": "RequestSyncDevicesRequest",
