fix(datacatalog): update the API

#### datacatalog:v1beta1 The following keys were changed: - schemas.GoogleCloudDatacatalogV1ReconcileTagsMetadata.description - schemas.GoogleCloudDatacatalogV1ReconcileTagsMetadata.properties.errors.description - schemas.GoogleCloudDatacatalogV1ReconcileTagsResponse.description - schemas.GoogleCloudDatacatalogV1beta1SearchCatalogRequestScope.properties.includeGcpPublicDatasets.description - schemas.GoogleCloudDatacatalogV1beta1TagTemplate.description - schemas.GoogleCloudDatacatalogV1beta1Taxonomy.properties.service.description - schemas.GoogleCloudDatacatalogV1beta1TaxonomyService.properties.name.description #### datacatalog:v1 The following keys were changed: - resources.projects.resources.locations.resources.entryGroups.resources.entries.methods.import.description - resources.projects.resources.locations.resources.entryGroups.resources.entries.resources.tags.methods.reconcile.description - schemas.GoogleCloudDatacatalogV1ReconcileTagsMetadata.description - schemas.GoogleCloudDatacatalogV1ReconcileTagsMetadata.properties.errors.description - schemas.GoogleCloudDatacatalogV1ReconcileTagsRequest.properties.forceDeleteMissing.description - schemas.GoogleCloudDatacatalogV1ReconcileTagsRequest.properties.tagTemplate.description - schemas.GoogleCloudDatacatalogV1ReconcileTagsRequest.properties.tags.description - schemas.GoogleCloudDatacatalogV1ReconcileTagsResponse.description - schemas.GoogleCloudDatacatalogV1SearchCatalogRequestScope.properties.includeGcpPublicDatasets.description - schemas.GoogleCloudDatacatalogV1TagTemplate.description - schemas.GoogleCloudDatacatalogV1Taxonomy.properties.service.description - schemas.GoogleCloudDatacatalogV1TaxonomyService.properties.name.description
googleapis · Feb 10, 2023 · f8337b1 · f8337b1
1 parent bb19b0d
commit f8337b1
Show file tree

Hide file tree

Showing 4 changed files with 40 additions and 40 deletions.
diff --git a/discovery/datacatalog-v1.json b/discovery/datacatalog-v1.json
@@ -532,7 +532,7 @@
                       ]
                     },
                     "import": {
-                      "description": "Imports entries from some source (e.g. dump in a Cloud Storage bucket) to the Data Catalog. Dump here is a snapshot of the third-party system state, that needs to be ingested in the Data Catalog. Import of entries is a sync operation that reconciles state of the third-party system and Data Catalog. ImportEntries is a long-running operation done in the background, so this method returns long-running operation resource. The resource can be queried with Operations.GetOperation which contains metadata and response.",
+                      "description": "Imports entries from a source, such as data previously dumped into a Cloud Storage bucket, into Data Catalog. `ImportEntries` accepts source data snapshots of third-party system state. Import of entries is a sync operation that reconciles the state of the third-party system with Data Catalog. `ImportEntries` returns a long-running operation resource that can be queried with Operations.GetOperation to return ImportEntriesMetadata and an ImportEntriesResponse message.",
                       "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/entryGroups/{entryGroupsId}/entries:import",
                       "httpMethod": "POST",
                       "id": "datacatalog.projects.locations.entryGroups.entries.import",
@@ -903,7 +903,7 @@
                           ]
                         },
                         "reconcile": {
-                          "description": "Reconciles tags created with a given tag template on a given Entry. Reconciliation is an operation that given a list of tags creates or updates them on the entry. Additionally, the operation is also able to delete tags not mentioned in the tag list. It can be achieved by setting force_delete_missing parameter. Reconciliation is a long-running operation done in the background, so this method returns long-running operation resource. The resource can be queried with Operations.GetOperation which contains metadata and response.",
+                          "description": "`ReconcileTags` creates or updates a list of tags on the entry. If the ReconcileTagsRequest.force_delete_missing parameter is set, the operation deletes tags not included in the input tag list. `ReconcileTags` returns a long-running operation resource that can be queried with Operations.GetOperation to return ReconcileTagsMetadata and a ReconcileTagsResponse message.",
                           "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/entryGroups/{entryGroupsId}/entries/{entriesId}/tags:reconcile",
                           "httpMethod": "POST",
                           "id": "datacatalog.projects.locations.entryGroups.entries.tags.reconcile",
@@ -2134,7 +2134,7 @@
       }
     }
   },
-  "revision": "20230127",
+  "revision": "20230207",
   "rootUrl": "https://datacatalog.googleapis.com/",
   "schemas": {
     "Binding": {
@@ -3405,14 +3405,14 @@
       "type": "object"
     },
     "GoogleCloudDatacatalogV1ReconcileTagsMetadata": {
-      "description": "Metadata message for long-running operation returned by the ReconcileTags.",
+      "description": "Long-running operation metadata message returned by the ReconcileTags.",
       "id": "GoogleCloudDatacatalogV1ReconcileTagsMetadata",
       "properties": {
         "errors": {
           "additionalProperties": {
             "$ref": "Status"
           },
-          "description": "Map that maps name of each tagged column (or empty string in case of sole entry) to tagging operation status.",
+          "description": "Maps the name of each tagged column (or empty string for a sole entry) to tagging operation status.",
           "type": "object"
         },
         "state": {
@@ -3439,15 +3439,15 @@
       "id": "GoogleCloudDatacatalogV1ReconcileTagsRequest",
       "properties": {
         "forceDeleteMissing": {
-          "description": "If set to true deletes from the entry tags related to given tag template and not mentioned in the tags source. If set to false only creates and updates of the tags mentioned in the source will take place. Other tags in that entry using the same tag template will be retained instead of being deleted.",
+          "description": "If set to `true`, deletes entry tags related to a tag template not listed in the tags source from an entry. If set to `false`, unlisted tags are retained.",
           "type": "boolean"
         },
         "tagTemplate": {
-          "description": "Required. The name of the tag template, that will be used for reconciliation.",
+          "description": "Required. The name of the tag template, which is used for reconciliation.",
           "type": "string"
         },
         "tags": {
-          "description": "A list of tags to be applied on a given entry. Individual tags may specify tag template, but it must be the same as the one in the ReconcileTagsRequest. The sole entry and each of its columns must be mentioned at most once.",
+          "description": "A list of tags to apply to an entry. A tag can specify a tag template, which must be the template specified in the `ReconcileTagsRequest`. The sole entry and each of its columns must be mentioned at most once.",
           "items": {
             "$ref": "GoogleCloudDatacatalogV1Tag"
           },
@@ -3457,7 +3457,7 @@
       "type": "object"
     },
     "GoogleCloudDatacatalogV1ReconcileTagsResponse": {
-      "description": "Request message for long-running operation returned by the ReconcileTags.",
+      "description": "Long-running operation response message returned by ReconcileTags.",
       "id": "GoogleCloudDatacatalogV1ReconcileTagsResponse",
       "properties": {
         "createdTagsCount": {
@@ -3633,7 +3633,7 @@
       "id": "GoogleCloudDatacatalogV1SearchCatalogRequestScope",
       "properties": {
         "includeGcpPublicDatasets": {
-          "description": "If `true`, include Google Cloud Platform (GCP) public datasets in search results. By default, they are excluded. See [Google Cloud Public Datasets](/public-datasets) for more information.",
+          "description": "If `true`, include Google Cloud public datasets in search results. By default, they are excluded. See [Google Cloud Public Datasets](/public-datasets) for more information.",
           "type": "boolean"
         },
         "includeOrgIds": {
@@ -4006,7 +4006,7 @@
       "type": "object"
     },
     "GoogleCloudDatacatalogV1TagTemplate": {
-      "description": "A tag template defines a tag that can have one or more typed fields. The template is used to create tags that are attached to GCP resources. [Tag template roles] (https://cloud.google.com/iam/docs/understanding-roles#data-catalog-roles) provide permissions to create, edit, and use the template. For example, see the [TagTemplate User] (https://cloud.google.com/data-catalog/docs/how-to/template-user) role that includes a permission to use the tag template to tag resources.",
+      "description": "A tag template defines a tag that can have one or more typed fields. The template is used to create tags that are attached to Google Cloud resources. [Tag template roles] (https://cloud.google.com/iam/docs/understanding-roles#data-catalog-roles) provide permissions to create, edit, and use the template. For example, see the [TagTemplate User] (https://cloud.google.com/data-catalog/docs/how-to/template-user) role that includes a permission to use the tag template to tag resources.",
       "id": "GoogleCloudDatacatalogV1TagTemplate",
       "properties": {
         "displayName": {
@@ -4104,7 +4104,7 @@
         },
         "service": {
           "$ref": "GoogleCloudDatacatalogV1TaxonomyService",
-          "description": "Output only. Identity of the service which owns the Taxonomy. This field is only populated when the taxonomy is created by a GCP service. Currently only 'DATAPLEX' is supported.",
+          "description": "Output only. Identity of the service which owns the Taxonomy. This field is only populated when the taxonomy is created by a Google Cloud service. Currently only 'DATAPLEX' is supported.",
           "readOnly": true
         },
         "taxonomyTimestamps": {
@@ -4124,7 +4124,7 @@
           "type": "string"
         },
         "name": {
-          "description": "The GCP service name.",
+          "description": "The Google Cloud service name.",
           "enum": [
             "MANAGING_SYSTEM_UNSPECIFIED",
             "MANAGING_SYSTEM_DATAPLEX",

diff --git a/discovery/datacatalog-v1beta1.json b/discovery/datacatalog-v1beta1.json
@@ -1813,7 +1813,7 @@
       }
     }
   },
-  "revision": "20230127",
+  "revision": "20230207",
   "rootUrl": "https://datacatalog.googleapis.com/",
   "schemas": {
     "Binding": {
@@ -1940,14 +1940,14 @@
       "type": "object"
     },
     "GoogleCloudDatacatalogV1ReconcileTagsMetadata": {
-      "description": "Metadata message for long-running operation returned by the ReconcileTags.",
+      "description": "Long-running operation metadata message returned by the ReconcileTags.",
       "id": "GoogleCloudDatacatalogV1ReconcileTagsMetadata",
       "properties": {
         "errors": {
           "additionalProperties": {
             "$ref": "Status"
           },
-          "description": "Map that maps name of each tagged column (or empty string in case of sole entry) to tagging operation status.",
+          "description": "Maps the name of each tagged column (or empty string for a sole entry) to tagging operation status.",
           "type": "object"
         },
         "state": {
@@ -1970,7 +1970,7 @@
       "type": "object"
     },
     "GoogleCloudDatacatalogV1ReconcileTagsResponse": {
-      "description": "Request message for long-running operation returned by the ReconcileTags.",
+      "description": "Long-running operation response message returned by ReconcileTags.",
       "id": "GoogleCloudDatacatalogV1ReconcileTagsResponse",
       "properties": {
         "createdTagsCount": {
@@ -2529,7 +2529,7 @@
       "id": "GoogleCloudDatacatalogV1beta1SearchCatalogRequestScope",
       "properties": {
         "includeGcpPublicDatasets": {
-          "description": "If `true`, include Google Cloud Platform (GCP) public datasets in the search results. Info on GCP public datasets is available at https://cloud.google.com/public-datasets/. By default, GCP public datasets are excluded.",
+          "description": "If `true`, include Google Cloud public datasets in the search results. Info on Google Cloud public datasets is available at https://cloud.google.com/public-datasets/. By default, Google Cloud public datasets are excluded.",
           "type": "boolean"
         },
         "includeOrgIds": {
@@ -2802,7 +2802,7 @@
       "type": "object"
     },
     "GoogleCloudDatacatalogV1beta1TagTemplate": {
-      "description": "A tag template defines a tag, which can have one or more typed fields. The template is used to create and attach the tag to GCP resources. [Tag template roles](https://cloud.google.com/iam/docs/understanding-roles#data-catalog-roles) provide permissions to create, edit, and use the template. See, for example, the [TagTemplate User](https://cloud.google.com/data-catalog/docs/how-to/template-user) role, which includes permission to use the tag template to tag resources.",
+      "description": "A tag template defines a tag, which can have one or more typed fields. The template is used to create and attach the tag to Google Cloud resources. [Tag template roles](https://cloud.google.com/iam/docs/understanding-roles#data-catalog-roles) provide permissions to create, edit, and use the template. See, for example, the [TagTemplate User](https://cloud.google.com/data-catalog/docs/how-to/template-user) role, which includes permission to use the tag template to tag resources.",
       "id": "GoogleCloudDatacatalogV1beta1TagTemplate",
       "properties": {
         "displayName": {
@@ -2896,7 +2896,7 @@
         },
         "service": {
           "$ref": "GoogleCloudDatacatalogV1beta1TaxonomyService",
-          "description": "Output only. Identity of the service which owns the Taxonomy. This field is only populated when the taxonomy is created by a GCP service. Currently only 'DATAPLEX' is supported.",
+          "description": "Output only. Identity of the service which owns the Taxonomy. This field is only populated when the taxonomy is created by a Google Cloud service. Currently only 'DATAPLEX' is supported.",
           "readOnly": true
         },
         "taxonomyTimestamps": {
@@ -2916,7 +2916,7 @@
           "type": "string"
         },
         "name": {
-          "description": "The GCP service name.",
+          "description": "The Google Cloud service name.",
           "enum": [
             "MANAGING_SYSTEM_UNSPECIFIED",
             "MANAGING_SYSTEM_DATAPLEX",

diff --git a/src/apis/datacatalog/v1.ts b/src/apis/datacatalog/v1.ts
@@ -998,11 +998,11 @@ export namespace datacatalog_v1 {
     parentPolicyTag?: string | null;
   }
   /**
-   * Metadata message for long-running operation returned by the ReconcileTags.
+   * Long-running operation metadata message returned by the ReconcileTags.
    */
   export interface Schema$GoogleCloudDatacatalogV1ReconcileTagsMetadata {
     /**
-     * Map that maps name of each tagged column (or empty string in case of sole entry) to tagging operation status.
+     * Maps the name of each tagged column (or empty string for a sole entry) to tagging operation status.
      */
     errors?: {[key: string]: Schema$Status} | null;
     /**
@@ -1015,20 +1015,20 @@ export namespace datacatalog_v1 {
    */
   export interface Schema$GoogleCloudDatacatalogV1ReconcileTagsRequest {
     /**
-     * If set to true deletes from the entry tags related to given tag template and not mentioned in the tags source. If set to false only creates and updates of the tags mentioned in the source will take place. Other tags in that entry using the same tag template will be retained instead of being deleted.
+     * If set to `true`, deletes entry tags related to a tag template not listed in the tags source from an entry. If set to `false`, unlisted tags are retained.
      */
     forceDeleteMissing?: boolean | null;
     /**
-     * A list of tags to be applied on a given entry. Individual tags may specify tag template, but it must be the same as the one in the ReconcileTagsRequest. The sole entry and each of its columns must be mentioned at most once.
+     * A list of tags to apply to an entry. A tag can specify a tag template, which must be the template specified in the `ReconcileTagsRequest`. The sole entry and each of its columns must be mentioned at most once.
      */
     tags?: Schema$GoogleCloudDatacatalogV1Tag[];
     /**
-     * Required. The name of the tag template, that will be used for reconciliation.
+     * Required. The name of the tag template, which is used for reconciliation.
      */
     tagTemplate?: string | null;
   }
   /**
-   * Request message for long-running operation returned by the ReconcileTags.
+   * Long-running operation response message returned by ReconcileTags.
    */
   export interface Schema$GoogleCloudDatacatalogV1ReconcileTagsResponse {
     /**
@@ -1156,7 +1156,7 @@ export namespace datacatalog_v1 {
    */
   export interface Schema$GoogleCloudDatacatalogV1SearchCatalogRequestScope {
     /**
-     * If `true`, include Google Cloud Platform (GCP) public datasets in search results. By default, they are excluded. See [Google Cloud Public Datasets](/public-datasets) for more information.
+     * If `true`, include Google Cloud public datasets in search results. By default, they are excluded. See [Google Cloud Public Datasets](/public-datasets) for more information.
      */
     includeGcpPublicDatasets?: boolean | null;
     /**
@@ -1420,7 +1420,7 @@ export namespace datacatalog_v1 {
     displayName?: string | null;
   }
   /**
-   * A tag template defines a tag that can have one or more typed fields. The template is used to create tags that are attached to GCP resources. [Tag template roles] (https://cloud.google.com/iam/docs/understanding-roles#data-catalog-roles) provide permissions to create, edit, and use the template. For example, see the [TagTemplate User] (https://cloud.google.com/data-catalog/docs/how-to/template-user) role that includes a permission to use the tag template to tag resources.
+   * A tag template defines a tag that can have one or more typed fields. The template is used to create tags that are attached to Google Cloud resources. [Tag template roles] (https://cloud.google.com/iam/docs/understanding-roles#data-catalog-roles) provide permissions to create, edit, and use the template. For example, see the [TagTemplate User] (https://cloud.google.com/data-catalog/docs/how-to/template-user) role that includes a permission to use the tag template to tag resources.
    */
   export interface Schema$GoogleCloudDatacatalogV1TagTemplate {
     /**
@@ -1496,7 +1496,7 @@ export namespace datacatalog_v1 {
      */
     policyTagCount?: number | null;
     /**
-     * Output only. Identity of the service which owns the Taxonomy. This field is only populated when the taxonomy is created by a GCP service. Currently only 'DATAPLEX' is supported.
+     * Output only. Identity of the service which owns the Taxonomy. This field is only populated when the taxonomy is created by a Google Cloud service. Currently only 'DATAPLEX' is supported.
      */
     service?: Schema$GoogleCloudDatacatalogV1TaxonomyService;
     /**
@@ -1513,7 +1513,7 @@ export namespace datacatalog_v1 {
      */
     identity?: string | null;
     /**
-     * The GCP service name.
+     * The Google Cloud service name.
      */
     name?: string | null;
   }
@@ -3955,7 +3955,7 @@ export namespace datacatalog_v1 {
     }
 
     /**
-     * Imports entries from some source (e.g. dump in a Cloud Storage bucket) to the Data Catalog. Dump here is a snapshot of the third-party system state, that needs to be ingested in the Data Catalog. Import of entries is a sync operation that reconciles state of the third-party system and Data Catalog. ImportEntries is a long-running operation done in the background, so this method returns long-running operation resource. The resource can be queried with Operations.GetOperation which contains metadata and response.
+     * Imports entries from a source, such as data previously dumped into a Cloud Storage bucket, into Data Catalog. `ImportEntries` accepts source data snapshots of third-party system state. Import of entries is a sync operation that reconciles the state of the third-party system with Data Catalog. `ImportEntries` returns a long-running operation resource that can be queried with Operations.GetOperation to return ImportEntriesMetadata and an ImportEntriesResponse message.
      * @example
      * ```js
      * // Before running the sample:
@@ -5899,7 +5899,7 @@ export namespace datacatalog_v1 {
     }
 
     /**
-     * Reconciles tags created with a given tag template on a given Entry. Reconciliation is an operation that given a list of tags creates or updates them on the entry. Additionally, the operation is also able to delete tags not mentioned in the tag list. It can be achieved by setting force_delete_missing parameter. Reconciliation is a long-running operation done in the background, so this method returns long-running operation resource. The resource can be queried with Operations.GetOperation which contains metadata and response.
+     * `ReconcileTags` creates or updates a list of tags on the entry. If the ReconcileTagsRequest.force_delete_missing parameter is set, the operation deletes tags not included in the input tag list. `ReconcileTags` returns a long-running operation resource that can be queried with Operations.GetOperation to return ReconcileTagsMetadata and a ReconcileTagsResponse message.
      * @example
      * ```js
      * // Before running the sample: