feat(discovery): update the api

#### discovery:v1

The following keys were added:
- schemas.JsonSchema.properties.deprecated.type (Total Keys: 1)
- schemas.RestMethod.properties.apiVersion.type (Total Keys: 1)
- schemas.RestMethod.properties.deprecated.type (Total Keys: 1)
- schemas.RestResource.properties.deprecated.type (Total Keys: 1)

Author: yoshi-automation

docs/dyn/discovery_v1.apis.html

@@ -117,6 +117,14 @@ <h3>Method Details</h3>
   &quot;description&quot;: &quot;A String&quot;, # The description of this API.
   &quot;discoveryVersion&quot;: &quot;v1&quot;, # Indicate the version of the Discovery API used to generate this doc.
   &quot;documentationLink&quot;: &quot;A String&quot;, # A link to human readable documentation for the API.
+  &quot;endpoints&quot;: [ # A list of location-based endpoint objects for this API. Each object contains the endpoint URL, location, description and deprecation status.
+    { # A single endpoint object
+      &quot;deprecated&quot;: True or False, # Whether this endpoint is deprecated
+      &quot;description&quot;: &quot;A String&quot;, # A string describing the host designated by the URL
+      &quot;endpointUrl&quot;: &quot;A String&quot;, # The URL of the endpoint target host
+      &quot;location&quot;: &quot;A String&quot;, # The location of the endpoint
+    },
+  ],
   &quot;etag&quot;: &quot;A String&quot;, # The ETag for this response.
   &quot;exponentialBackoffDefault&quot;: True or False, # Enable exponential backoff for suitable methods in the generated clients.
   &quot;features&quot;: [ # A list of supported features for this API.
@@ -133,6 +141,8 @@ <h3>Method Details</h3>
   ],
   &quot;methods&quot;: { # API-level methods for this API.
     &quot;a_key&quot;: { # An individual method description.
+      &quot;apiVersion&quot;: &quot;A String&quot;, # The API Version of this method, as passed in via the `X-Goog-Api-Version` header or `$apiVersion` query parameter.
+      &quot;deprecated&quot;: True or False, # Whether this method is deprecated.
       &quot;description&quot;: &quot;A String&quot;, # Description of this method.
       &quot;etagRequired&quot;: True or False, # Whether this method requires an ETag to be specified. The ETag is sent as an HTTP If-Match or If-None-Match header.
       &quot;flatPath&quot;: &quot;A String&quot;, # The URI path of this REST method in (RFC 6570) format without level 2 features ({+var}). Supplementary to the path property.
@@ -167,10 +177,14 @@ <h3>Method Details</h3>
             ],
           },
           &quot;default&quot;: &quot;A String&quot;, # The default value of this property (if one exists).
+          &quot;deprecated&quot;: True or False, # Whether the parameter is deprecated.
           &quot;description&quot;: &quot;A String&quot;, # A description of this object.
           &quot;enum&quot;: [ # Values this parameter may take (if it is an enum).
             &quot;A String&quot;,
           ],
+          &quot;enumDeprecated&quot;: [ # The deprecation status for the enums. Each position maps to the corresponding value in the &quot;enum&quot; array.
+            True or False,
+          ],
           &quot;enumDescriptions&quot;: [ # The descriptions for the enums. Each position maps to the corresponding value in the &quot;enum&quot; array.
             &quot;A String&quot;,
           ],
@@ -230,10 +244,14 @@ <h3>Method Details</h3>
         ],
       },
       &quot;default&quot;: &quot;A String&quot;, # The default value of this property (if one exists).
+      &quot;deprecated&quot;: True or False, # Whether the parameter is deprecated.
       &quot;description&quot;: &quot;A String&quot;, # A description of this object.
       &quot;enum&quot;: [ # Values this parameter may take (if it is an enum).
         &quot;A String&quot;,
       ],
+      &quot;enumDeprecated&quot;: [ # The deprecation status for the enums. Each position maps to the corresponding value in the &quot;enum&quot; array.
+        True or False,
+      ],
       &quot;enumDescriptions&quot;: [ # The descriptions for the enums. Each position maps to the corresponding value in the &quot;enum&quot; array.
         &quot;A String&quot;,
       ],
@@ -265,8 +283,11 @@ <h3>Method Details</h3>
   &quot;protocol&quot;: &quot;rest&quot;, # The protocol described by this document.
   &quot;resources&quot;: { # The resources in this API.
     &quot;a_key&quot;: { # An individual resource description. Contains methods and sub-resources related to this resource.
+      &quot;deprecated&quot;: True or False, # Whether this resource is deprecated.
       &quot;methods&quot;: { # Methods on this resource.
         &quot;a_key&quot;: { # Description for any methods on this resource.
+          &quot;apiVersion&quot;: &quot;A String&quot;, # The API Version of this method, as passed in via the `X-Goog-Api-Version` header or `$apiVersion` query parameter.
+          &quot;deprecated&quot;: True or False, # Whether this method is deprecated.
           &quot;description&quot;: &quot;A String&quot;, # Description of this method.
           &quot;etagRequired&quot;: True or False, # Whether this method requires an ETag to be specified. The ETag is sent as an HTTP If-Match or If-None-Match header.
           &quot;flatPath&quot;: &quot;A String&quot;, # The URI path of this REST method in (RFC 6570) format without level 2 features ({+var}). Supplementary to the path property.
@@ -301,10 +322,14 @@ <h3>Method Details</h3>
                 ],
               },
               &quot;default&quot;: &quot;A String&quot;, # The default value of this property (if one exists).
+              &quot;deprecated&quot;: True or False, # Whether the parameter is deprecated.
               &quot;description&quot;: &quot;A String&quot;, # A description of this object.
               &quot;enum&quot;: [ # Values this parameter may take (if it is an enum).
                 &quot;A String&quot;,
               ],
+              &quot;enumDeprecated&quot;: [ # The deprecation status for the enums. Each position maps to the corresponding value in the &quot;enum&quot; array.
+                True or False,
+              ],
               &quot;enumDescriptions&quot;: [ # The descriptions for the enums. Each position maps to the corresponding value in the &quot;enum&quot; array.
                 &quot;A String&quot;,
               ],
@@ -367,10 +392,14 @@ <h3>Method Details</h3>
         ],
       },
       &quot;default&quot;: &quot;A String&quot;, # The default value of this property (if one exists).
+      &quot;deprecated&quot;: True or False, # Whether the parameter is deprecated.
       &quot;description&quot;: &quot;A String&quot;, # A description of this object.
       &quot;enum&quot;: [ # Values this parameter may take (if it is an enum).
         &quot;A String&quot;,
       ],
+      &quot;enumDeprecated&quot;: [ # The deprecation status for the enums. Each position maps to the corresponding value in the &quot;enum&quot; array.
+        True or False,
+      ],
       &quot;enumDescriptions&quot;: [ # The descriptions for the enums. Each position maps to the corresponding value in the &quot;enum&quot; array.
         &quot;A String&quot;,
       ],

googleapiclient/discovery_cache/documents/discovery.v1.json

@@ -234,6 +234,10 @@
 "description": "The default value of this property (if one exists).",
 "type": "string"
 },
+"deprecated": {
+"description": "Whether the parameter is deprecated.",
+"type": "boolean"
+},
 "description": {
 "description": "A description of this object.",
 "type": "string"
@@ -245,6 +249,13 @@
 },
 "type": "array"
 },
+"enumDeprecated": {
+"description": "The deprecation status for the enums. Each position maps to the corresponding value in the \"enum\" array.",
+"items": {
+"type": "boolean"
+},
+"type": "array"
+},
 "enumDescriptions": {
 "description": "The descriptions for the enums. Each position maps to the corresponding value in the \"enum\" array.",
 "items": {
@@ -390,6 +401,32 @@
 "description": "A link to human readable documentation for the API.",
 "type": "string"
 },
+"endpoints": {
+"description": "A list of location-based endpoint objects for this API. Each object contains the endpoint URL, location, description and deprecation status.",
+"items": {
+"description": "A single endpoint object",
+"properties": {
+"deprecated": {
+"description": "Whether this endpoint is deprecated",
+"type": "boolean"
+},
+"description": {
+"description": "A string describing the host designated by the URL",
+"type": "string"
+},
+"endpointUrl": {
+"description": "The URL of the endpoint target host",
+"type": "string"
+},
+"location": {
+"description": "The location of the endpoint",
+"type": "string"
+}
+},
+"type": "object"
+},
+"type": "array"
+},
 "etag": {
 "description": "The ETag for this response.",
 "readOnly": true,
@@ -518,6 +555,14 @@
 "RestMethod": {
 "id": "RestMethod",
 "properties": {
+"apiVersion": {
+"description": "The API Version of this method, as passed in via the `X-Goog-Api-Version` header or `$apiVersion` query parameter.",
+"type": "string"
+},
+"deprecated": {
+"description": "Whether this method is deprecated.",
+"type": "boolean"
+},
 "description": {
 "description": "Description of this method.",
 "type": "string"
@@ -663,6 +708,10 @@
 "RestResource": {
 "id": "RestResource",
 "properties": {
+"deprecated": {
+"description": "Whether this resource is deprecated.",
+"type": "boolean"
+},
 "methods": {
 "additionalProperties": {
 "$ref": "RestMethod",