fix(serviceusage): update the API

#### serviceusage:v1beta1 The following keys were changed: - schemas.Documentation.properties.summary.description - schemas.DocumentationRule.properties.description.description - schemas.DocumentationRule.properties.selector.description - schemas.GoogleApiService.properties.enums.description - schemas.GoogleApiService.properties.title.description - schemas.GoogleApiService.properties.types.description - schemas.Page.properties.content.description #### serviceusage:v1 The following keys were changed: - schemas.Documentation.properties.summary.description - schemas.DocumentationRule.properties.description.description - schemas.DocumentationRule.properties.selector.description - schemas.GoogleApiService.properties.enums.description - schemas.GoogleApiService.properties.title.description - schemas.GoogleApiService.properties.types.description - schemas.Page.properties.content.description
googleapis · Jul 10, 2021 · 653aa00 · 653aa00
1 parent b95673a
commit 653aa00
Show file tree

Hide file tree

Showing 4 changed files with 30 additions and 30 deletions.
diff --git a/discovery/serviceusage-v1.json b/discovery/serviceusage-v1.json
@@ -426,7 +426,7 @@
       }
     }
   },
-  "revision": "20210525",
+  "revision": "20210707",
   "rootUrl": "https://serviceusage.googleapis.com/",
   "schemas": {
     "AdminQuotaPolicy": {
@@ -985,7 +985,7 @@
           "type": "string"
         },
         "summary": {
-          "description": "A short summary of what the service does. Can only be provided by plain text.",
+          "description": "A short description of what the service does. The summary must be plain text. It becomes the overview of the service displayed in Google Cloud Console. NOTE: This field is equivalent to the standard field `description`.",
           "type": "string"
         }
       },
@@ -1000,11 +1000,11 @@
           "type": "string"
         },
         "description": {
-          "description": "Description of the selected API(s).",
+          "description": "The description is the comment in front of the selected proto element, such as a message, a method, a 'service' definition, or a field.",
           "type": "string"
         },
         "selector": {
-          "description": "The selector is a comma-separated list of patterns. Each pattern is a qualified name of the element which may end in \"*\", indicating a wildcard. Wildcards are only allowed at the end and for a whole component of the qualified name, i.e. \"foo.*\" is ok, but not \"foo.b*\" or \"foo.*.bar\". A wildcard will match one or more components. To specify a default for all applicable elements, the whole pattern \"*\" is used.",
+          "description": "The selector is a comma-separated list of patterns for any element such as a method, a field, an enum value. Each pattern is a qualified name of the element which may end in \"*\", indicating a wildcard. Wildcards are only allowed at the end and for a whole component of the qualified name, i.e. \"foo.*\" is ok, but not \"foo.b*\" or \"foo.*.bar\". A wildcard will match one or more components. To specify a default for all applicable elements, the whole pattern \"*\" is used.",
           "type": "string"
         }
       },
@@ -1318,7 +1318,7 @@
           "type": "array"
         },
         "enums": {
-          "description": "A list of all enum types included in this API service. Enums referenced directly or indirectly by the `apis` are automatically included. Enums which are not referenced but shall be included should be listed here by name. Example: enums: - name: google.someapi.v1.SomeEnum",
+          "description": "A list of all enum types included in this API service. Enums referenced directly or indirectly by the `apis` are automatically included. Enums which are not referenced but shall be included should be listed here by name by the configuration author. Example: enums: - name: google.someapi.v1.SomeEnum",
           "items": {
             "$ref": "Enum"
           },
@@ -1389,11 +1389,11 @@
           "type": "array"
         },
         "title": {
-          "description": "The product title for this service.",
+          "description": "The product title for this service, it is the name displayed in Google Cloud Console.",
           "type": "string"
         },
         "types": {
-          "description": "A list of all proto message types included in this API service. Types referenced directly or indirectly by the `apis` are automatically included. Messages which are not referenced but shall be included, such as types used by the `google.protobuf.Any` type, should be listed here by name. Example: types: - name: google.protobuf.Int32",
+          "description": "A list of all proto message types included in this API service. Types referenced directly or indirectly by the `apis` are automatically included. Messages which are not referenced but shall be included, such as types used by the `google.protobuf.Any` type, should be listed here by name by the configuration author. Example: types: - name: google.protobuf.Int32",
           "items": {
             "$ref": "Type"
           },
@@ -2229,7 +2229,7 @@
       "id": "Page",
       "properties": {
         "content": {
-          "description": "The Markdown content of the page. You can use (== include {path} ==) to include content from a Markdown file.",
+          "description": "The Markdown content of the page. You can use (== include {path} ==) to include content from a Markdown file. The content can be used to produce the documentation page such as HTML format page.",
           "type": "string"
         },
         "name": {

diff --git a/discovery/serviceusage-v1beta1.json b/discovery/serviceusage-v1beta1.json
@@ -959,7 +959,7 @@
       }
     }
   },
-  "revision": "20210525",
+  "revision": "20210707",
   "rootUrl": "https://serviceusage.googleapis.com/",
   "schemas": {
     "AdminQuotaPolicy": {
@@ -1550,7 +1550,7 @@
           "type": "string"
         },
         "summary": {
-          "description": "A short summary of what the service does. Can only be provided by plain text.",
+          "description": "A short description of what the service does. The summary must be plain text. It becomes the overview of the service displayed in Google Cloud Console. NOTE: This field is equivalent to the standard field `description`.",
           "type": "string"
         }
       },
@@ -1565,11 +1565,11 @@
           "type": "string"
         },
         "description": {
-          "description": "Description of the selected API(s).",
+          "description": "The description is the comment in front of the selected proto element, such as a message, a method, a 'service' definition, or a field.",
           "type": "string"
         },
         "selector": {
-          "description": "The selector is a comma-separated list of patterns. Each pattern is a qualified name of the element which may end in \"*\", indicating a wildcard. Wildcards are only allowed at the end and for a whole component of the qualified name, i.e. \"foo.*\" is ok, but not \"foo.b*\" or \"foo.*.bar\". A wildcard will match one or more components. To specify a default for all applicable elements, the whole pattern \"*\" is used.",
+          "description": "The selector is a comma-separated list of patterns for any element such as a method, a field, an enum value. Each pattern is a qualified name of the element which may end in \"*\", indicating a wildcard. Wildcards are only allowed at the end and for a whole component of the qualified name, i.e. \"foo.*\" is ok, but not \"foo.b*\" or \"foo.*.bar\". A wildcard will match one or more components. To specify a default for all applicable elements, the whole pattern \"*\" is used.",
           "type": "string"
         }
       },
@@ -1883,7 +1883,7 @@
           "type": "array"
         },
         "enums": {
-          "description": "A list of all enum types included in this API service. Enums referenced directly or indirectly by the `apis` are automatically included. Enums which are not referenced but shall be included should be listed here by name. Example: enums: - name: google.someapi.v1.SomeEnum",
+          "description": "A list of all enum types included in this API service. Enums referenced directly or indirectly by the `apis` are automatically included. Enums which are not referenced but shall be included should be listed here by name by the configuration author. Example: enums: - name: google.someapi.v1.SomeEnum",
           "items": {
             "$ref": "Enum"
           },
@@ -1954,11 +1954,11 @@
           "type": "array"
         },
         "title": {
-          "description": "The product title for this service.",
+          "description": "The product title for this service, it is the name displayed in Google Cloud Console.",
           "type": "string"
         },
         "types": {
-          "description": "A list of all proto message types included in this API service. Types referenced directly or indirectly by the `apis` are automatically included. Messages which are not referenced but shall be included, such as types used by the `google.protobuf.Any` type, should be listed here by name. Example: types: - name: google.protobuf.Int32",
+          "description": "A list of all proto message types included in this API service. Types referenced directly or indirectly by the `apis` are automatically included. Messages which are not referenced but shall be included, such as types used by the `google.protobuf.Any` type, should be listed here by name by the configuration author. Example: types: - name: google.protobuf.Int32",
           "items": {
             "$ref": "Type"
           },
@@ -2926,7 +2926,7 @@
       "id": "Page",
       "properties": {
         "content": {
-          "description": "The Markdown content of the page. You can use (== include {path} ==) to include content from a Markdown file.",
+          "description": "The Markdown content of the page. You can use (== include {path} ==) to include content from a Markdown file. The content can be used to produce the documentation page such as HTML format page.",
           "type": "string"
         },
         "name": {

diff --git a/src/apis/serviceusage/v1.ts b/src/apis/serviceusage/v1.ts
@@ -520,7 +520,7 @@ export namespace serviceusage_v1 {
      */
     serviceRootUrl?: string | null;
     /**
-     * A short summary of what the service does. Can only be provided by plain text.
+     * A short description of what the service does. The summary must be plain text. It becomes the overview of the service displayed in Google Cloud Console. NOTE: This field is equivalent to the standard field `description`.
      */
     summary?: string | null;
   }
@@ -533,11 +533,11 @@ export namespace serviceusage_v1 {
      */
     deprecationDescription?: string | null;
     /**
-     * Description of the selected API(s).
+     * The description is the comment in front of the selected proto element, such as a message, a method, a 'service' definition, or a field.
      */
     description?: string | null;
     /**
-     * The selector is a comma-separated list of patterns. Each pattern is a qualified name of the element which may end in "*", indicating a wildcard. Wildcards are only allowed at the end and for a whole component of the qualified name, i.e. "foo.*" is ok, but not "foo.b*" or "foo.*.bar". A wildcard will match one or more components. To specify a default for all applicable elements, the whole pattern "*" is used.
+     * The selector is a comma-separated list of patterns for any element such as a method, a field, an enum value. Each pattern is a qualified name of the element which may end in "*", indicating a wildcard. Wildcards are only allowed at the end and for a whole component of the qualified name, i.e. "foo.*" is ok, but not "foo.b*" or "foo.*.bar". A wildcard will match one or more components. To specify a default for all applicable elements, the whole pattern "*" is used.
      */
     selector?: string | null;
   }
@@ -737,7 +737,7 @@ export namespace serviceusage_v1 {
      */
     endpoints?: Schema$Endpoint[];
     /**
-     * A list of all enum types included in this API service. Enums referenced directly or indirectly by the `apis` are automatically included. Enums which are not referenced but shall be included should be listed here by name. Example: enums: - name: google.someapi.v1.SomeEnum
+     * A list of all enum types included in this API service. Enums referenced directly or indirectly by the `apis` are automatically included. Enums which are not referenced but shall be included should be listed here by name by the configuration author. Example: enums: - name: google.someapi.v1.SomeEnum
      */
     enums?: Schema$Enum[];
     /**
@@ -793,11 +793,11 @@ export namespace serviceusage_v1 {
      */
     systemTypes?: Schema$Type[];
     /**
-     * The product title for this service.
+     * The product title for this service, it is the name displayed in Google Cloud Console.
      */
     title?: string | null;
     /**
-     * A list of all proto message types included in this API service. Types referenced directly or indirectly by the `apis` are automatically included. Messages which are not referenced but shall be included, such as types used by the `google.protobuf.Any` type, should be listed here by name. Example: types: - name: google.protobuf.Int32
+     * A list of all proto message types included in this API service. Types referenced directly or indirectly by the `apis` are automatically included. Messages which are not referenced but shall be included, such as types used by the `google.protobuf.Any` type, should be listed here by name by the configuration author. Example: types: - name: google.protobuf.Int32
      */
     types?: Schema$Type[];
     /**
@@ -1351,7 +1351,7 @@ export namespace serviceusage_v1 {
    */
   export interface Schema$Page {
     /**
-     * The Markdown content of the page. You can use (== include {path\} ==) to include content from a Markdown file.
+     * The Markdown content of the page. You can use (== include {path\} ==) to include content from a Markdown file. The content can be used to produce the documentation page such as HTML format page.
      */
     content?: string | null;
     /**

diff --git a/src/apis/serviceusage/v1beta1.ts b/src/apis/serviceusage/v1beta1.ts
@@ -556,7 +556,7 @@ export namespace serviceusage_v1beta1 {
      */
     serviceRootUrl?: string | null;
     /**
-     * A short summary of what the service does. Can only be provided by plain text.
+     * A short description of what the service does. The summary must be plain text. It becomes the overview of the service displayed in Google Cloud Console. NOTE: This field is equivalent to the standard field `description`.
      */
     summary?: string | null;
   }
@@ -569,11 +569,11 @@ export namespace serviceusage_v1beta1 {
      */
     deprecationDescription?: string | null;
     /**
-     * Description of the selected API(s).
+     * The description is the comment in front of the selected proto element, such as a message, a method, a 'service' definition, or a field.
      */
     description?: string | null;
     /**
-     * The selector is a comma-separated list of patterns. Each pattern is a qualified name of the element which may end in "*", indicating a wildcard. Wildcards are only allowed at the end and for a whole component of the qualified name, i.e. "foo.*" is ok, but not "foo.b*" or "foo.*.bar". A wildcard will match one or more components. To specify a default for all applicable elements, the whole pattern "*" is used.
+     * The selector is a comma-separated list of patterns for any element such as a method, a field, an enum value. Each pattern is a qualified name of the element which may end in "*", indicating a wildcard. Wildcards are only allowed at the end and for a whole component of the qualified name, i.e. "foo.*" is ok, but not "foo.b*" or "foo.*.bar". A wildcard will match one or more components. To specify a default for all applicable elements, the whole pattern "*" is used.
      */
     selector?: string | null;
   }
@@ -773,7 +773,7 @@ export namespace serviceusage_v1beta1 {
      */
     endpoints?: Schema$Endpoint[];
     /**
-     * A list of all enum types included in this API service. Enums referenced directly or indirectly by the `apis` are automatically included. Enums which are not referenced but shall be included should be listed here by name. Example: enums: - name: google.someapi.v1.SomeEnum
+     * A list of all enum types included in this API service. Enums referenced directly or indirectly by the `apis` are automatically included. Enums which are not referenced but shall be included should be listed here by name by the configuration author. Example: enums: - name: google.someapi.v1.SomeEnum
      */
     enums?: Schema$Enum[];
     /**
@@ -829,11 +829,11 @@ export namespace serviceusage_v1beta1 {
      */
     systemTypes?: Schema$Type[];
     /**
-     * The product title for this service.
+     * The product title for this service, it is the name displayed in Google Cloud Console.
      */
     title?: string | null;
     /**
-     * A list of all proto message types included in this API service. Types referenced directly or indirectly by the `apis` are automatically included. Messages which are not referenced but shall be included, such as types used by the `google.protobuf.Any` type, should be listed here by name. Example: types: - name: google.protobuf.Int32
+     * A list of all proto message types included in this API service. Types referenced directly or indirectly by the `apis` are automatically included. Messages which are not referenced but shall be included, such as types used by the `google.protobuf.Any` type, should be listed here by name by the configuration author. Example: types: - name: google.protobuf.Int32
      */
     types?: Schema$Type[];
     /**
@@ -1469,7 +1469,7 @@ export namespace serviceusage_v1beta1 {
    */
   export interface Schema$Page {
     /**
-     * The Markdown content of the page. You can use (== include {path\} ==) to include content from a Markdown file.
+     * The Markdown content of the page. You can use (== include {path\} ==) to include content from a Markdown file. The content can be used to produce the documentation page such as HTML format page.
      */
     content?: string | null;
     /**