diff --git a/dataplex/apiv1/data_scan_client.go b/dataplex/apiv1/data_scan_client.go index 9a76e99ffe17..f9af9497b170 100644 --- a/dataplex/apiv1/data_scan_client.go +++ b/dataplex/apiv1/data_scan_client.go @@ -115,6 +115,10 @@ type internalDataScanClient interface { // DataScanClient is a client for interacting with Cloud Dataplex API. // Methods, except Close, may be called concurrently. However, fields must not be modified concurrently with method calls. +// +// DataScanService manages DataScan resources which can be configured to run +// various types of data scanning workload and generate enriched metadata (e.g. +// Data Profile, Data Quality) for the data source. type DataScanClient struct { // The internal transport-dependent client. internalClient internalDataScanClient @@ -151,7 +155,7 @@ func (c *DataScanClient) Connection() *grpc.ClientConn { return c.internalClient.Connection() } -// CreateDataScan creates a dataScan resource. +// CreateDataScan creates a DataScan resource. func (c *DataScanClient) CreateDataScan(ctx context.Context, req *dataplexpb.CreateDataScanRequest, opts ...gax.CallOption) (*CreateDataScanOperation, error) { return c.internalClient.CreateDataScan(ctx, req, opts...) } @@ -162,7 +166,7 @@ func (c *DataScanClient) CreateDataScanOperation(name string) *CreateDataScanOpe return c.internalClient.CreateDataScanOperation(name) } -// UpdateDataScan update the dataScan resource. +// UpdateDataScan updates a DataScan resource. func (c *DataScanClient) UpdateDataScan(ctx context.Context, req *dataplexpb.UpdateDataScanRequest, opts ...gax.CallOption) (*UpdateDataScanOperation, error) { return c.internalClient.UpdateDataScan(ctx, req, opts...) } @@ -173,7 +177,7 @@ func (c *DataScanClient) UpdateDataScanOperation(name string) *UpdateDataScanOpe return c.internalClient.UpdateDataScanOperation(name) } -// DeleteDataScan delete the dataScan resource. +// DeleteDataScan deletes a DataScan resource. func (c *DataScanClient) DeleteDataScan(ctx context.Context, req *dataplexpb.DeleteDataScanRequest, opts ...gax.CallOption) (*DeleteDataScanOperation, error) { return c.internalClient.DeleteDataScan(ctx, req, opts...) } @@ -184,27 +188,27 @@ func (c *DataScanClient) DeleteDataScanOperation(name string) *DeleteDataScanOpe return c.internalClient.DeleteDataScanOperation(name) } -// GetDataScan get dataScan resource. +// GetDataScan gets a DataScan resource. func (c *DataScanClient) GetDataScan(ctx context.Context, req *dataplexpb.GetDataScanRequest, opts ...gax.CallOption) (*dataplexpb.DataScan, error) { return c.internalClient.GetDataScan(ctx, req, opts...) } -// ListDataScans lists dataScans. +// ListDataScans lists DataScans. func (c *DataScanClient) ListDataScans(ctx context.Context, req *dataplexpb.ListDataScansRequest, opts ...gax.CallOption) *DataScanIterator { return c.internalClient.ListDataScans(ctx, req, opts...) } -// RunDataScan run an on demand execution of a DataScan. +// RunDataScan runs an on-demand execution of a DataScan func (c *DataScanClient) RunDataScan(ctx context.Context, req *dataplexpb.RunDataScanRequest, opts ...gax.CallOption) (*dataplexpb.RunDataScanResponse, error) { return c.internalClient.RunDataScan(ctx, req, opts...) } -// GetDataScanJob get DataScanJob resource. +// GetDataScanJob gets a DataScanJob resource. func (c *DataScanClient) GetDataScanJob(ctx context.Context, req *dataplexpb.GetDataScanJobRequest, opts ...gax.CallOption) (*dataplexpb.DataScanJob, error) { return c.internalClient.GetDataScanJob(ctx, req, opts...) } -// ListDataScanJobs lists DataScanJobs under the given dataScan. +// ListDataScanJobs lists DataScanJobs under the given DataScan. func (c *DataScanClient) ListDataScanJobs(ctx context.Context, req *dataplexpb.ListDataScanJobsRequest, opts ...gax.CallOption) *DataScanJobIterator { return c.internalClient.ListDataScanJobs(ctx, req, opts...) } @@ -270,6 +274,10 @@ type dataScanGRPCClient struct { // NewDataScanClient creates a new data scan service client based on gRPC. // The returned client must be Closed when it is done being used to clean up its underlying connections. +// +// DataScanService manages DataScan resources which can be configured to run +// various types of data scanning workload and generate enriched metadata (e.g. +// Data Profile, Data Quality) for the data source. func NewDataScanClient(ctx context.Context, opts ...option.ClientOption) (*DataScanClient, error) { clientOpts := defaultDataScanGRPCClientOptions() if newDataScanClientHook != nil { diff --git a/dataplex/apiv1/dataplexpb/datascans.pb.go b/dataplex/apiv1/dataplexpb/datascans.pb.go index 0d45a3d0cd4c..e864b1e8f79d 100644 --- a/dataplex/apiv1/dataplexpb/datascans.pb.go +++ b/dataplex/apiv1/dataplexpb/datascans.pb.go @@ -47,11 +47,11 @@ const ( type DataScanType int32 const ( - // The DataScan Type is unspecified. + // The DataScan type is unspecified. DataScanType_DATA_SCAN_TYPE_UNSPECIFIED DataScanType = 0 - // Data Quality Scan. + // Data Quality scan. DataScanType_DATA_QUALITY DataScanType = 1 - // Data Profile Scan. + // Data Profile scan. DataScanType_DATA_PROFILE DataScanType = 2 ) @@ -96,13 +96,13 @@ func (DataScanType) EnumDescriptor() ([]byte, []int) { return file_google_cloud_dataplex_v1_datascans_proto_rawDescGZIP(), []int{0} } -// DataScan views for getting a partial dataScan. +// DataScan view options. type GetDataScanRequest_DataScanView int32 const ( // The API will default to the `BASIC` view. GetDataScanRequest_DATA_SCAN_VIEW_UNSPECIFIED GetDataScanRequest_DataScanView = 0 - // Basic view that does not include spec and result. + // Basic view that does not include *spec* and *result*. GetDataScanRequest_BASIC GetDataScanRequest_DataScanView = 1 // Include everything. GetDataScanRequest_FULL GetDataScanRequest_DataScanView = 10 @@ -149,13 +149,13 @@ func (GetDataScanRequest_DataScanView) EnumDescriptor() ([]byte, []int) { return file_google_cloud_dataplex_v1_datascans_proto_rawDescGZIP(), []int{3, 0} } -// DataScanJob views for getting a partial dataScanJob. +// DataScanJob view options. type GetDataScanJobRequest_DataScanJobView int32 const ( // The API will default to the `BASIC` view. GetDataScanJobRequest_DATA_SCAN_JOB_VIEW_UNSPECIFIED GetDataScanJobRequest_DataScanJobView = 0 - // Basic view that does not include spec and result. + // Basic view that does not include *spec* and *result*. GetDataScanJobRequest_BASIC GetDataScanJobRequest_DataScanJobView = 1 // Include everything. GetDataScanJobRequest_FULL GetDataScanJobRequest_DataScanJobView = 10 @@ -278,13 +278,14 @@ type CreateDataScanRequest struct { unknownFields protoimpl.UnknownFields // Required. The resource name of the parent location: - // projects/{project}/locations/{location_id} - // where `{project}` refers to a project_id or project_number and + // `projects/{project}/locations/{location_id}` + // where `project` refers to a *project_id* or *project_number* and // `location_id` refers to a GCP region. Parent string `protobuf:"bytes,1,opt,name=parent,proto3" json:"parent,omitempty"` // Required. DataScan resource. DataScan *DataScan `protobuf:"bytes,2,opt,name=data_scan,json=dataScan,proto3" json:"data_scan,omitempty"` // Required. DataScan identifier. + // // * Must contain only lowercase letters, numbers and hyphens. // * Must start with a letter. // * Must end with a number or a letter. @@ -352,7 +353,8 @@ type UpdateDataScanRequest struct { sizeCache protoimpl.SizeCache unknownFields protoimpl.UnknownFields - // Required. Update description. + // Required. DataScan resource to be updated. + // // Only fields specified in `update_mask` are updated. DataScan *DataScan `protobuf:"bytes,1,opt,name=data_scan,json=dataScan,proto3" json:"data_scan,omitempty"` // Required. Mask of fields to update. @@ -412,8 +414,8 @@ type DeleteDataScanRequest struct { unknownFields protoimpl.UnknownFields // Required. The resource name of the dataScan: - // projects/{project}/locations/{location_id}/dataScans/{data_scan_id} - // where `{project}` refers to a project_id or project_number and + // `projects/{project}/locations/{location_id}/dataScans/{data_scan_id}` + // where `project` refers to a *project_id* or *project_number* and // `location_id` refers to a GCP region. Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"` } @@ -464,12 +466,11 @@ type GetDataScanRequest struct { unknownFields protoimpl.UnknownFields // Required. The resource name of the dataScan: - // projects/{project}/locations/{location_id}/dataScans/{data_scan_id} - // where `{project}` refers to a project_id or project_number and + // `projects/{project}/locations/{location_id}/dataScans/{data_scan_id}` + // where `project` refers to a *project_id* or *project_number* and // `location_id` refers to a GCP region. Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"` - // Optional. Used to select the subset of DataScan information to return. - // Defaults to `BASIC`. + // Optional. Select the DataScan view to return. Defaults to `BASIC`. View GetDataScanRequest_DataScanView `protobuf:"varint,2,opt,name=view,proto3,enum=google.cloud.dataplex.v1.GetDataScanRequest_DataScanView" json:"view,omitempty"` } @@ -525,8 +526,9 @@ type ListDataScansRequest struct { sizeCache protoimpl.SizeCache unknownFields protoimpl.UnknownFields - // Required. projects/{project}/locations/{location_id} - // where `{project}` refers to a project_id or project_number and + // Required. The resource name of the parent location: + // `projects/{project}/locations/{location_id}` + // where `project` refers to a *project_id* or *project_number* and // `location_id` refers to a GCP region. Parent string `protobuf:"bytes,1,opt,name=parent,proto3" json:"parent,omitempty"` // Optional. Maximum number of dataScans to return. The service may return @@ -540,7 +542,7 @@ type ListDataScansRequest struct { PageToken string `protobuf:"bytes,3,opt,name=page_token,json=pageToken,proto3" json:"page_token,omitempty"` // Optional. Filter request. Filter string `protobuf:"bytes,4,opt,name=filter,proto3" json:"filter,omitempty"` - // Optional. Order by fields (name or create_time) for the result. + // Optional. Order by fields (`name` or `create_time`) for the result. // If not specified, the ordering is undefined. OrderBy string `protobuf:"bytes,5,opt,name=order_by,json=orderBy,proto3" json:"order_by,omitempty"` } @@ -618,7 +620,7 @@ type ListDataScansResponse struct { sizeCache protoimpl.SizeCache unknownFields protoimpl.UnknownFields - // DataScans (metadata only) under the given parent location. + // DataScans (`BASIC` view only) under the given parent location. DataScans []*DataScan `protobuf:"bytes,1,rep,name=data_scans,json=dataScans,proto3" json:"data_scans,omitempty"` // Token to retrieve the next page of results, or empty if there are no more // results in the list. @@ -687,10 +689,11 @@ type RunDataScanRequest struct { unknownFields protoimpl.UnknownFields // Required. The resource name of the DataScan: - // projects/{project}/locations/{location_id}/dataScans/{data_scan_id}. - // where `{project}` refers to a project_id or project_number and + // `projects/{project}/locations/{location_id}/dataScans/{data_scan_id}`. + // where `project` refers to a *project_id* or *project_number* and // `location_id` refers to a GCP region. - // Only on-demand DataScans are allowed. + // + // Only **OnDemand** data scans are allowed. Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"` } @@ -739,7 +742,7 @@ type RunDataScanResponse struct { sizeCache protoimpl.SizeCache unknownFields protoimpl.UnknownFields - // DataScanJob created by RunDataScan API. + // DataScanJob created by RunDataScan request. Job *DataScanJob `protobuf:"bytes,1,opt,name=job,proto3" json:"job,omitempty"` } @@ -789,12 +792,11 @@ type GetDataScanJobRequest struct { unknownFields protoimpl.UnknownFields // Required. The resource name of the DataScanJob: - // projects/{project}/locations/{location_id}/dataScans/{data_scan_id}/dataScanJobs/{data_scan_job_id} - // where `{project}` refers to a project_id or project_number and + // `projects/{project}/locations/{location_id}/dataScans/{data_scan_id}/dataScanJobs/{data_scan_job_id}` + // where `project` refers to a *project_id* or *project_number* and // `location_id` refers to a GCP region. Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"` - // Optional. Used to select the subset of DataScan information to return. - // Defaults to `BASIC`. + // Optional. Select the DataScanJob view to return. Defaults to `BASIC`. View GetDataScanJobRequest_DataScanJobView `protobuf:"varint,2,opt,name=view,proto3,enum=google.cloud.dataplex.v1.GetDataScanJobRequest_DataScanJobView" json:"view,omitempty"` } @@ -851,8 +853,8 @@ type ListDataScanJobsRequest struct { unknownFields protoimpl.UnknownFields // Required. The resource name of the parent environment: - // projects/{project}/locations/{location_id}/dataScans/{data_scan_id} - // where `{project}` refers to a project_id or project_number and + // `projects/{project}/locations/{location_id}/dataScans/{data_scan_id}` + // where `project` refers to a *project_id* or *project_number* and // `location_id` refers to a GCP region. Parent string `protobuf:"bytes,1,opt,name=parent,proto3" json:"parent,omitempty"` // Optional. Maximum number of DataScanJobs to return. The service may return @@ -926,7 +928,7 @@ type ListDataScanJobsResponse struct { sizeCache protoimpl.SizeCache unknownFields protoimpl.UnknownFields - // DataScanJobs (metadata only) under a given dataScan. + // DataScanJobs (`BASIC` view only) under a given dataScan. DataScanJobs []*DataScanJob `protobuf:"bytes,1,rep,name=data_scan_jobs,json=dataScanJobs,proto3" json:"data_scan_jobs,omitempty"` // Token to retrieve the next page of results, or empty if there are no more // results in the list. @@ -995,17 +997,19 @@ type DataScan struct { unknownFields protoimpl.UnknownFields // Output only. The relative resource name of the scan, of the form: - // projects/{project}/locations/{location_id}/dataScans/{datascan_id}. - // where `{project}` refers to a project_id or project_number and + // `projects/{project}/locations/{location_id}/dataScans/{datascan_id}`, + // where `project` refers to a *project_id* or *project_number* and // `location_id` refers to a GCP region. Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"` // Output only. System generated globally unique ID for the scan. This ID will // be different if the scan is deleted and re-created with the same name. Uid string `protobuf:"bytes,2,opt,name=uid,proto3" json:"uid,omitempty"` // Optional. Description of the scan. + // // * Must be between 1-1024 characters. Description string `protobuf:"bytes,3,opt,name=description,proto3" json:"description,omitempty"` // Optional. User friendly display name. + // // * Must be between 1-256 characters. DisplayName string `protobuf:"bytes,4,opt,name=display_name,json=displayName,proto3" json:"display_name,omitempty"` // Optional. User-defined labels for the scan. @@ -1019,7 +1023,8 @@ type DataScan struct { // Required. The data source for DataScan. Data *DataSource `protobuf:"bytes,9,opt,name=data,proto3" json:"data,omitempty"` // Optional. DataScan execution settings. - // If not specified, the fields under it will use their default values. + // + // If not specified, the fields in it will use their default values. ExecutionSpec *DataScan_ExecutionSpec `protobuf:"bytes,10,opt,name=execution_spec,json=executionSpec,proto3" json:"execution_spec,omitempty"` // Output only. Status of the data scan execution. ExecutionStatus *DataScan_ExecutionStatus `protobuf:"bytes,11,opt,name=execution_status,json=executionStatus,proto3" json:"execution_status,omitempty"` @@ -1237,15 +1242,15 @@ func (*DataScan_DataQualityResult) isDataScan_Result() {} func (*DataScan_DataProfileResult) isDataScan_Result() {} -// A DataScanJob represents an instance of a data scan. +// A DataScanJob represents an instance of DataScan execution. type DataScanJob struct { state protoimpl.MessageState sizeCache protoimpl.SizeCache unknownFields protoimpl.UnknownFields // Output only. The relative resource name of the DataScanJob, of the form: - // projects/{project}/locations/{location_id}/dataScans/{datascan_id}/jobs/{job_id}. - // where `{project}` refers to a project_id or project_number and + // `projects/{project}/locations/{location_id}/dataScans/{datascan_id}/jobs/{job_id}`, + // where `project` refers to a *project_id* or *project_number* and // `location_id` refers to a GCP region. Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"` // Output only. System generated globally unique ID for the DataScanJob. @@ -1442,12 +1447,15 @@ type DataScan_ExecutionSpec struct { unknownFields protoimpl.UnknownFields // Optional. Spec related to how often and when a scan should be triggered. - // If not specified, the default is OnDemand, which means the scan will not - // run until the user calls RunDataScan API. + // + // If not specified, the default is `OnDemand`, which means the scan will + // not run until the user calls `RunDataScan` API. Trigger *Trigger `protobuf:"bytes,1,opt,name=trigger,proto3" json:"trigger,omitempty"` - // If not specified, run a data scan on all data in the table. - // The incremental is immutable, which means once the field is set, - // it cannot be unset, and vice versa. + // Spec related to incremental scan of the data + // + // When an option is selected for incremental scan, it cannot be unset or + // changed. If not specified, a data scan will run for all data in the + // table. // // Types that are assignable to Incremental: // @@ -1513,8 +1521,10 @@ type isDataScan_ExecutionSpec_Incremental interface { } type DataScan_ExecutionSpec_Field struct { - // Immutable. The unnested field (Date or Timestamp) that contains values - // that monotonically increase over time. + // Immutable. The unnested field (of type *Date* or *Timestamp*) that + // contains values which monotonically increase over time. + // + // If not specified, a data scan will run for all data in the table. Field string `protobuf:"bytes,100,opt,name=field,proto3,oneof"` } @@ -2343,21 +2353,21 @@ const _ = grpc.SupportPackageIsVersion6 // // For semantics around ctx use and closing/ending streaming RPCs, please refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream. type DataScanServiceClient interface { - // Creates a dataScan resource. + // Creates a DataScan resource. CreateDataScan(ctx context.Context, in *CreateDataScanRequest, opts ...grpc.CallOption) (*longrunning.Operation, error) - // Update the dataScan resource. + // Updates a DataScan resource. UpdateDataScan(ctx context.Context, in *UpdateDataScanRequest, opts ...grpc.CallOption) (*longrunning.Operation, error) - // Delete the dataScan resource. + // Deletes a DataScan resource. DeleteDataScan(ctx context.Context, in *DeleteDataScanRequest, opts ...grpc.CallOption) (*longrunning.Operation, error) - // Get dataScan resource. + // Gets a DataScan resource. GetDataScan(ctx context.Context, in *GetDataScanRequest, opts ...grpc.CallOption) (*DataScan, error) - // Lists dataScans. + // Lists DataScans. ListDataScans(ctx context.Context, in *ListDataScansRequest, opts ...grpc.CallOption) (*ListDataScansResponse, error) - // Run an on demand execution of a DataScan. + // Runs an on-demand execution of a DataScan RunDataScan(ctx context.Context, in *RunDataScanRequest, opts ...grpc.CallOption) (*RunDataScanResponse, error) - // Get DataScanJob resource. + // Gets a DataScanJob resource. GetDataScanJob(ctx context.Context, in *GetDataScanJobRequest, opts ...grpc.CallOption) (*DataScanJob, error) - // Lists DataScanJobs under the given dataScan. + // Lists DataScanJobs under the given DataScan. ListDataScanJobs(ctx context.Context, in *ListDataScanJobsRequest, opts ...grpc.CallOption) (*ListDataScanJobsResponse, error) } @@ -2443,21 +2453,21 @@ func (c *dataScanServiceClient) ListDataScanJobs(ctx context.Context, in *ListDa // DataScanServiceServer is the server API for DataScanService service. type DataScanServiceServer interface { - // Creates a dataScan resource. + // Creates a DataScan resource. CreateDataScan(context.Context, *CreateDataScanRequest) (*longrunning.Operation, error) - // Update the dataScan resource. + // Updates a DataScan resource. UpdateDataScan(context.Context, *UpdateDataScanRequest) (*longrunning.Operation, error) - // Delete the dataScan resource. + // Deletes a DataScan resource. DeleteDataScan(context.Context, *DeleteDataScanRequest) (*longrunning.Operation, error) - // Get dataScan resource. + // Gets a DataScan resource. GetDataScan(context.Context, *GetDataScanRequest) (*DataScan, error) - // Lists dataScans. + // Lists DataScans. ListDataScans(context.Context, *ListDataScansRequest) (*ListDataScansResponse, error) - // Run an on demand execution of a DataScan. + // Runs an on-demand execution of a DataScan RunDataScan(context.Context, *RunDataScanRequest) (*RunDataScanResponse, error) - // Get DataScanJob resource. + // Gets a DataScanJob resource. GetDataScanJob(context.Context, *GetDataScanJobRequest) (*DataScanJob, error) - // Lists DataScanJobs under the given dataScan. + // Lists DataScanJobs under the given DataScan. ListDataScanJobs(context.Context, *ListDataScanJobsRequest) (*ListDataScanJobsResponse, error) } diff --git a/internal/generated/snippets/certificatemanager/apiv1/snippet_metadata.google.cloud.certificatemanager.v1.json b/internal/generated/snippets/certificatemanager/apiv1/snippet_metadata.google.cloud.certificatemanager.v1.json index 91e1fa116b04..9235e012e7af 100644 --- a/internal/generated/snippets/certificatemanager/apiv1/snippet_metadata.google.cloud.certificatemanager.v1.json +++ b/internal/generated/snippets/certificatemanager/apiv1/snippet_metadata.google.cloud.certificatemanager.v1.json @@ -1,7 +1,7 @@ { "clientLibrary": { "name": "cloud.google.com/go/certificatemanager/apiv1", - "version": "1.1.0", + "version": "1.2.0", "language": "GO", "apis": [ { diff --git a/internal/generated/snippets/dataplex/apiv1/snippet_metadata.google.cloud.dataplex.v1.json b/internal/generated/snippets/dataplex/apiv1/snippet_metadata.google.cloud.dataplex.v1.json index 549a27b2a129..b19ebdd857a3 100644 --- a/internal/generated/snippets/dataplex/apiv1/snippet_metadata.google.cloud.dataplex.v1.json +++ b/internal/generated/snippets/dataplex/apiv1/snippet_metadata.google.cloud.dataplex.v1.json @@ -2445,7 +2445,7 @@ { "regionTag": "dataplex_v1_generated_DataScanService_CreateDataScan_sync", "title": "dataplex CreateDataScan Sample", - "description": "CreateDataScan creates a dataScan resource.", + "description": "CreateDataScan creates a DataScan resource.", "file": "DataScanClient/CreateDataScan/main.go", "language": "GO", "clientMethod": { @@ -2491,7 +2491,7 @@ { "regionTag": "dataplex_v1_generated_DataScanService_DeleteDataScan_sync", "title": "dataplex DeleteDataScan Sample", - "description": "DeleteDataScan delete the dataScan resource.", + "description": "DeleteDataScan deletes a DataScan resource.", "file": "DataScanClient/DeleteDataScan/main.go", "language": "GO", "clientMethod": { @@ -2582,7 +2582,7 @@ { "regionTag": "dataplex_v1_generated_DataScanService_GetDataScan_sync", "title": "dataplex GetDataScan Sample", - "description": "GetDataScan get dataScan resource.", + "description": "GetDataScan gets a DataScan resource.", "file": "DataScanClient/GetDataScan/main.go", "language": "GO", "clientMethod": { @@ -2628,7 +2628,7 @@ { "regionTag": "dataplex_v1_generated_DataScanService_GetDataScanJob_sync", "title": "dataplex GetDataScanJob Sample", - "description": "GetDataScanJob get DataScanJob resource.", + "description": "GetDataScanJob gets a DataScanJob resource.", "file": "DataScanClient/GetDataScanJob/main.go", "language": "GO", "clientMethod": { @@ -2766,7 +2766,7 @@ { "regionTag": "dataplex_v1_generated_DataScanService_ListDataScanJobs_sync", "title": "dataplex ListDataScanJobs Sample", - "description": "ListDataScanJobs lists DataScanJobs under the given dataScan.", + "description": "ListDataScanJobs lists DataScanJobs under the given DataScan.", "file": "DataScanClient/ListDataScanJobs/main.go", "language": "GO", "clientMethod": { @@ -2812,7 +2812,7 @@ { "regionTag": "dataplex_v1_generated_DataScanService_ListDataScans_sync", "title": "dataplex ListDataScans Sample", - "description": "ListDataScans lists dataScans.", + "description": "ListDataScans lists DataScans.", "file": "DataScanClient/ListDataScans/main.go", "language": "GO", "clientMethod": { @@ -2950,7 +2950,7 @@ { "regionTag": "dataplex_v1_generated_DataScanService_RunDataScan_sync", "title": "dataplex RunDataScan Sample", - "description": "RunDataScan run an on demand execution of a DataScan.", + "description": "RunDataScan runs an on-demand execution of a DataScan", "file": "DataScanClient/RunDataScan/main.go", "language": "GO", "clientMethod": { @@ -2996,7 +2996,7 @@ { "regionTag": "dataplex_v1_generated_DataScanService_UpdateDataScan_sync", "title": "dataplex UpdateDataScan Sample", - "description": "UpdateDataScan update the dataScan resource.", + "description": "UpdateDataScan updates a DataScan resource.", "file": "DataScanClient/UpdateDataScan/main.go", "language": "GO", "clientMethod": { diff --git a/internal/generated/snippets/documentai/apiv1/snippet_metadata.google.cloud.documentai.v1.json b/internal/generated/snippets/documentai/apiv1/snippet_metadata.google.cloud.documentai.v1.json index 7dbb80f29413..f7e49582cd80 100644 --- a/internal/generated/snippets/documentai/apiv1/snippet_metadata.google.cloud.documentai.v1.json +++ b/internal/generated/snippets/documentai/apiv1/snippet_metadata.google.cloud.documentai.v1.json @@ -1,7 +1,7 @@ { "clientLibrary": { "name": "cloud.google.com/go/documentai/apiv1", - "version": "1.6.0", + "version": "1.7.0", "language": "GO", "apis": [ { diff --git a/internal/generated/snippets/documentai/apiv1beta3/snippet_metadata.google.cloud.documentai.v1beta3.json b/internal/generated/snippets/documentai/apiv1beta3/snippet_metadata.google.cloud.documentai.v1beta3.json index 8620a621f285..b611247e3e90 100644 --- a/internal/generated/snippets/documentai/apiv1beta3/snippet_metadata.google.cloud.documentai.v1beta3.json +++ b/internal/generated/snippets/documentai/apiv1beta3/snippet_metadata.google.cloud.documentai.v1beta3.json @@ -1,7 +1,7 @@ { "clientLibrary": { "name": "cloud.google.com/go/documentai/apiv1beta3", - "version": "1.6.0", + "version": "1.7.0", "language": "GO", "apis": [ { diff --git a/internal/generated/snippets/networkconnectivity/apiv1/snippet_metadata.google.cloud.networkconnectivity.v1.json b/internal/generated/snippets/networkconnectivity/apiv1/snippet_metadata.google.cloud.networkconnectivity.v1.json index 4fd846c2de25..617def1a6113 100644 --- a/internal/generated/snippets/networkconnectivity/apiv1/snippet_metadata.google.cloud.networkconnectivity.v1.json +++ b/internal/generated/snippets/networkconnectivity/apiv1/snippet_metadata.google.cloud.networkconnectivity.v1.json @@ -1,7 +1,7 @@ { "clientLibrary": { "name": "cloud.google.com/go/networkconnectivity/apiv1", - "version": "1.9.0", + "version": "1.10.0", "language": "GO", "apis": [ { diff --git a/internal/generated/snippets/networkconnectivity/apiv1alpha1/snippet_metadata.google.cloud.networkconnectivity.v1alpha1.json b/internal/generated/snippets/networkconnectivity/apiv1alpha1/snippet_metadata.google.cloud.networkconnectivity.v1alpha1.json index 6f7a273abf74..679c2770857f 100644 --- a/internal/generated/snippets/networkconnectivity/apiv1alpha1/snippet_metadata.google.cloud.networkconnectivity.v1alpha1.json +++ b/internal/generated/snippets/networkconnectivity/apiv1alpha1/snippet_metadata.google.cloud.networkconnectivity.v1alpha1.json @@ -1,7 +1,7 @@ { "clientLibrary": { "name": "cloud.google.com/go/networkconnectivity/apiv1alpha1", - "version": "1.9.0", + "version": "1.10.0", "language": "GO", "apis": [ { diff --git a/speech/apiv1/speechpb/cloud_speech_adaptation.pb.go b/speech/apiv1/speechpb/cloud_speech_adaptation.pb.go index 04b8d60b87ea..1fb444a2fba0 100644 --- a/speech/apiv1/speechpb/cloud_speech_adaptation.pb.go +++ b/speech/apiv1/speechpb/cloud_speech_adaptation.pb.go @@ -48,7 +48,8 @@ type CreatePhraseSetRequest struct { sizeCache protoimpl.SizeCache unknownFields protoimpl.UnknownFields - // Required. The parent resource where this phrase set will be created. Format: + // Required. The parent resource where this phrase set will be created. + // Format: // // `projects/{project}/locations/{location}/phraseSets` // @@ -445,7 +446,8 @@ type CreateCustomClassRequest struct { sizeCache protoimpl.SizeCache unknownFields protoimpl.UnknownFields - // Required. The parent resource where this custom class will be created. Format: + // Required. The parent resource where this custom class will be created. + // Format: // // `projects/{project}/locations/{location}/customClasses` // diff --git a/speech/apiv1/speechpb/resource.pb.go b/speech/apiv1/speechpb/resource.pb.go index e03645896485..9d439bd0a0c5 100644 --- a/speech/apiv1/speechpb/resource.pb.go +++ b/speech/apiv1/speechpb/resource.pb.go @@ -124,8 +124,8 @@ type PhraseSet struct { // enabled, so negative boost will simply be ignored. Though `boost` can // accept a wide range of positive values, most use cases are best served with // values between 0 (exclusive) and 20. We recommend using a binary search - // approach to finding the optimal value for your use case. Speech recognition - // will skip PhraseSets with a boost value of 0. + // approach to finding the optimal value for your use case as well as adding + // phrases both with and without boost to your requests. Boost float32 `protobuf:"fixed32,4,opt,name=boost,proto3" json:"boost,omitempty"` } @@ -337,8 +337,8 @@ func (x *CustomClass_ClassItem) GetValue() string { // Speech-to-Text supports three locations: `global`, `us` (US North America), // and `eu` (Europe). If you are calling the `speech.googleapis.com` // endpoint, use the `global` location. To specify a region, use a -// [regional endpoint](/speech-to-text/docs/endpoints) with matching `us` or -// `eu` location value. +// [regional endpoint](https://cloud.google.com/speech-to-text/docs/endpoints) +// with matching `us` or `eu` location value. type PhraseSet_Phrase struct { state protoimpl.MessageState sizeCache protoimpl.SizeCache @@ -353,8 +353,8 @@ type PhraseSet_Phrase struct { // boost will simply be ignored. Though `boost` can accept a wide range of // positive values, most use cases are best served // with values between 0 and 20. We recommend using a binary search approach - // to finding the optimal value for your use case. Speech recognition - // will skip PhraseSets with a boost value of 0. + // to finding the optimal value for your use case as well as adding + // phrases both with and without boost to your requests. Boost float32 `protobuf:"fixed32,2,opt,name=boost,proto3" json:"boost,omitempty"` } diff --git a/speech/apiv1p1beta1/speechpb/cloud_speech_adaptation.pb.go b/speech/apiv1p1beta1/speechpb/cloud_speech_adaptation.pb.go index 1cbbd6b7924a..c666d0878860 100644 --- a/speech/apiv1p1beta1/speechpb/cloud_speech_adaptation.pb.go +++ b/speech/apiv1p1beta1/speechpb/cloud_speech_adaptation.pb.go @@ -48,7 +48,8 @@ type CreatePhraseSetRequest struct { sizeCache protoimpl.SizeCache unknownFields protoimpl.UnknownFields - // Required. The parent resource where this phrase set will be created. Format: + // Required. The parent resource where this phrase set will be created. + // Format: // // `projects/{project}/locations/{location}/phraseSets` // @@ -445,7 +446,8 @@ type CreateCustomClassRequest struct { sizeCache protoimpl.SizeCache unknownFields protoimpl.UnknownFields - // Required. The parent resource where this custom class will be created. Format: + // Required. The parent resource where this custom class will be created. + // Format: // // `projects/{project}/locations/{location}/customClasses` // diff --git a/speech/apiv1p1beta1/speechpb/resource.pb.go b/speech/apiv1p1beta1/speechpb/resource.pb.go index d4967fe50f88..b05736d79a03 100644 --- a/speech/apiv1p1beta1/speechpb/resource.pb.go +++ b/speech/apiv1p1beta1/speechpb/resource.pb.go @@ -392,8 +392,8 @@ func (x *CustomClass_ClassItem) GetValue() string { // Speech-to-Text supports three locations: `global`, `us` (US North America), // and `eu` (Europe). If you are calling the `speech.googleapis.com` // endpoint, use the `global` location. To specify a region, use a -// [regional endpoint](/speech-to-text/docs/endpoints) with matching `us` or -// `eu` location value. +// [regional endpoint](https://cloud.google.com/speech-to-text/docs/endpoints) +// with matching `us` or `eu` location value. type PhraseSet_Phrase struct { state protoimpl.MessageState sizeCache protoimpl.SizeCache