From e239d24bdd3ff94cfc759da3e58fbf6a377af015 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Thu, 1 Oct 2020 17:24:29 -0700 Subject: [PATCH] fix!: remove WALKING and CYCLING from v4 commute methods (#37) These methods are not available on the public v4 API. --- .kokoro/samples/python3.8/common.cfg | 12 +- google/cloud/talent_v4/proto/common.proto | 188 ++++++------------ google/cloud/talent_v4/proto/company.proto | 13 +- .../talent_v4/proto/company_service.proto | 33 +-- .../talent_v4/proto/completion_service.proto | 43 ++-- google/cloud/talent_v4/proto/event.proto | 31 +-- .../cloud/talent_v4/proto/event_service.proto | 8 +- google/cloud/talent_v4/proto/filters.proto | 96 ++++----- google/cloud/talent_v4/proto/histogram.proto | 8 +- google/cloud/talent_v4/proto/job.proto | 150 ++++++-------- google/cloud/talent_v4/proto/tenant.proto | 5 +- .../talent_v4/proto/tenant_service.proto | 17 +- google/cloud/talent_v4/types/common.py | 2 - google/cloud/talent_v4/types/tenant.py | 1 - synth.metadata | 12 +- synth.py | 6 - 16 files changed, 240 insertions(+), 385 deletions(-) diff --git a/.kokoro/samples/python3.8/common.cfg b/.kokoro/samples/python3.8/common.cfg index 998d2cb7..a85aacf0 100644 --- a/.kokoro/samples/python3.8/common.cfg +++ b/.kokoro/samples/python3.8/common.cfg @@ -13,6 +13,12 @@ env_vars: { value: "py-3.8" } +# Declare build specific Cloud project. +env_vars: { + key: "BUILD_SPECIFIC_GCLOUD_PROJECT" + value: "python-docs-samples-tests-py38" +} + env_vars: { key: "TRAMPOLINE_BUILD_FILE" value: "github/python-talent/.kokoro/test-samples.sh" @@ -24,12 +30,6 @@ env_vars: { value: "gcr.io/cloud-devrel-kokoro-resources/python-samples-testing-docker" } -# Declare build specific Cloud project. -env_vars: { - key: "BUILD_SPECIFIC_GCLOUD_PROJECT" - value: "python-docs-samples-tests-py38" -} - # Download secrets for samples gfile_resources: "/bigstore/cloud-devrel-kokoro-resources/python-docs-samples" diff --git a/google/cloud/talent_v4/proto/common.proto b/google/cloud/talent_v4/proto/common.proto index a7daca9e..d187a17f 100644 --- a/google/cloud/talent_v4/proto/common.proto +++ b/google/cloud/talent_v4/proto/common.proto @@ -16,13 +16,13 @@ syntax = "proto3"; package google.cloud.talent.v4; -import "google/api/annotations.proto"; import "google/api/field_behavior.proto"; import "google/protobuf/timestamp.proto"; import "google/protobuf/wrappers.proto"; import "google/type/latlng.proto"; import "google/type/money.proto"; import "google/type/postal_address.proto"; +import "google/api/annotations.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4;talent"; option java_multiple_files = true; @@ -186,8 +186,7 @@ enum EmploymentType { // The job is offered as a contracted position with the understanding // that it's converted into a full-time position at the end of the // contract. Jobs of this type are also returned by a search for - // [EmploymentType.CONTRACTOR][google.cloud.talent.v4.EmploymentType.CONTRACTOR] - // jobs. + // [EmploymentType.CONTRACTOR][google.cloud.talent.v4.EmploymentType.CONTRACTOR] jobs. CONTRACT_TO_HIRE = 4; // The job is offered as a temporary employment opportunity, usually @@ -347,10 +346,9 @@ enum PostingRegion { POSTING_REGION_UNSPECIFIED = 0; // In addition to exact location matching, job posting is returned when the - // [LocationFilter][google.cloud.talent.v4.LocationFilter] in the search query - // is in the same administrative area as the returned job posting. For - // example, if a `ADMINISTRATIVE_AREA` job is posted in "CA, USA", it's - // returned if [LocationFilter][google.cloud.talent.v4.LocationFilter] has + // [LocationFilter][google.cloud.talent.v4.LocationFilter] in the search query is in the same administrative area + // as the returned job posting. For example, if a `ADMINISTRATIVE_AREA` job + // is posted in "CA, USA", it's returned if [LocationFilter][google.cloud.talent.v4.LocationFilter] has // "Mountain View". // // Administrative area refers to top-level administrative subdivision of this @@ -359,11 +357,9 @@ enum PostingRegion { ADMINISTRATIVE_AREA = 1; // In addition to exact location matching, job is returned when - // [LocationFilter][google.cloud.talent.v4.LocationFilter] in search query is - // in the same country as this job. For example, if a `NATION_WIDE` job is - // posted in "USA", it's returned if - // [LocationFilter][google.cloud.talent.v4.LocationFilter] has 'Mountain - // View'. + // [LocationFilter][google.cloud.talent.v4.LocationFilter] in search query is in the same country as this job. + // For example, if a `NATION_WIDE` job is posted in "USA", it's + // returned if [LocationFilter][google.cloud.talent.v4.LocationFilter] has 'Mountain View'. NATION = 2; // Job allows employees to work remotely (telecommute). @@ -419,12 +415,6 @@ enum CommuteMethod { // Commute time is calculated based on public transit including bus, metro, // subway, and so on. TRANSIT = 2; - - // Commute time is calculated based on walking time. - WALKING = 3; - - // Commute time is calculated based on biking time. - CYCLING = 4; } // A resource that represents a location with full geographic information. @@ -470,11 +460,9 @@ message Location { } // The type of a location, which corresponds to the address lines field of - // [google.type.PostalAddress][google.type.PostalAddress]. For example, - // "Downtown, Atlanta, GA, USA" has a type of - // [LocationType.NEIGHBORHOOD][google.cloud.talent.v4.Location.LocationType.NEIGHBORHOOD], - // and "Kansas City, KS, USA" has a type of - // [LocationType.LOCALITY][google.cloud.talent.v4.Location.LocationType.LOCALITY]. + // [google.type.PostalAddress][google.type.PostalAddress]. For example, "Downtown, Atlanta, GA, USA" + // has a type of [LocationType.NEIGHBORHOOD][google.cloud.talent.v4.Location.LocationType.NEIGHBORHOOD], and "Kansas City, KS, USA" + // has a type of [LocationType.LOCALITY][google.cloud.talent.v4.Location.LocationType.LOCALITY]. LocationType location_type = 1; // Postal address of the location that includes human readable information, @@ -488,9 +476,10 @@ message Location { // Radius in miles of the job location. This value is derived from the // location bounding box in which a circle with the specified radius - // centered from [google.type.LatLng][google.type.LatLng] covers the area - // associated with the job location. For example, currently, "Mountain View, - // CA, USA" has a radius of 6.17 miles. + // centered from [google.type.LatLng][google.type.LatLng] covers the area associated with the + // job location. + // For example, currently, "Mountain View, CA, USA" has a radius of + // 6.17 miles. double radius_miles = 4; } @@ -498,9 +487,7 @@ message Location { // conducting the job search. This information is used to improve the // performance of the service. message RequestMetadata { - // Required if - // [allow_missing_ids][google.cloud.talent.v4.RequestMetadata.allow_missing_ids] - // is unset or `false`. + // Required if [allow_missing_ids][google.cloud.talent.v4.RequestMetadata.allow_missing_ids] is unset or `false`. // // The client-defined scope or source of the service call, which typically // is the domain on @@ -517,9 +504,7 @@ message RequestMetadata { // The maximum number of allowed characters is 255. string domain = 1; - // Required if - // [allow_missing_ids][google.cloud.talent.v4.RequestMetadata.allow_missing_ids] - // is unset or `false`. + // Required if [allow_missing_ids][google.cloud.talent.v4.RequestMetadata.allow_missing_ids] is unset or `false`. // // A unique session identification string. A session is defined as the // duration of an end user's interaction with the service over a certain @@ -533,9 +518,7 @@ message RequestMetadata { // The maximum number of allowed characters is 255. string session_id = 2; - // Required if - // [allow_missing_ids][google.cloud.talent.v4.RequestMetadata.allow_missing_ids] - // is unset or `false`. + // Required if [allow_missing_ids][google.cloud.talent.v4.RequestMetadata.allow_missing_ids] is unset or `false`. // // A unique user identification string, as determined by the client. // To have the strongest positive impact on search quality @@ -549,15 +532,10 @@ message RequestMetadata { // The maximum number of allowed characters is 255. string user_id = 3; - // Only set when any of - // [domain][google.cloud.talent.v4.RequestMetadata.domain], - // [session_id][google.cloud.talent.v4.RequestMetadata.session_id] and - // [user_id][google.cloud.talent.v4.RequestMetadata.user_id] isn't available - // for some reason. It is highly recommended not to set this field and provide - // accurate [domain][google.cloud.talent.v4.RequestMetadata.domain], - // [session_id][google.cloud.talent.v4.RequestMetadata.session_id] and - // [user_id][google.cloud.talent.v4.RequestMetadata.user_id] for the best - // service experience. + // Only set when any of [domain][google.cloud.talent.v4.RequestMetadata.domain], [session_id][google.cloud.talent.v4.RequestMetadata.session_id] and [user_id][google.cloud.talent.v4.RequestMetadata.user_id] isn't + // available for some reason. It is highly recommended not to set this field + // and provide accurate [domain][google.cloud.talent.v4.RequestMetadata.domain], [session_id][google.cloud.talent.v4.RequestMetadata.session_id] and [user_id][google.cloud.talent.v4.RequestMetadata.user_id] for the + // best service experience. bool allow_missing_ids = 4; // The type of device used by the job seeker at the time of the call to the @@ -613,10 +591,7 @@ message DeviceInfo { // Custom attribute values that are either filterable or non-filterable. message CustomAttribute { - // Exactly one of - // [string_values][google.cloud.talent.v4.CustomAttribute.string_values] or - // [long_values][google.cloud.talent.v4.CustomAttribute.long_values] must be - // specified. + // Exactly one of [string_values][google.cloud.talent.v4.CustomAttribute.string_values] or [long_values][google.cloud.talent.v4.CustomAttribute.long_values] must be specified. // // This field is used to perform a string match (`CASE_SENSITIVE_MATCH` or // `CASE_INSENSITIVE_MATCH`) search. @@ -628,22 +603,16 @@ message CustomAttribute { // Empty string isn't allowed. repeated string string_values = 1; - // Exactly one of - // [string_values][google.cloud.talent.v4.CustomAttribute.string_values] or - // [long_values][google.cloud.talent.v4.CustomAttribute.long_values] must be - // specified. + // Exactly one of [string_values][google.cloud.talent.v4.CustomAttribute.string_values] or [long_values][google.cloud.talent.v4.CustomAttribute.long_values] must be specified. // // This field is used to perform number range search. // (`EQ`, `GT`, `GE`, `LE`, `LT`) over filterable `long_value`. // - // Currently at most 1 - // [long_values][google.cloud.talent.v4.CustomAttribute.long_values] is - // supported. + // Currently at most 1 [long_values][google.cloud.talent.v4.CustomAttribute.long_values] is supported. repeated int64 long_values = 2; // If the `filterable` flag is true, the custom field values may be used for - // custom attribute filters - // [JobQuery.custom_attribute_filter][google.cloud.talent.v4.JobQuery.custom_attribute_filter]. + // custom attribute filters [JobQuery.custom_attribute_filter][google.cloud.talent.v4.JobQuery.custom_attribute_filter]. // If false, these values may not be used for custom attribute filters. // // Default is false. @@ -681,29 +650,19 @@ message CompensationInfo { // as base pay, bonus, or other compensation type. // // Annualization: One compensation entry can be annualized if - // - it contains valid - // [amount][google.cloud.talent.v4.CompensationInfo.CompensationEntry.amount] - // or - // [range][google.cloud.talent.v4.CompensationInfo.CompensationEntry.range]. - // - and its - // [expected_units_per_year][google.cloud.talent.v4.CompensationInfo.CompensationEntry.expected_units_per_year] - // is set or can be derived. Its annualized range is determined as - // ([amount][google.cloud.talent.v4.CompensationInfo.CompensationEntry.amount] - // or - // [range][google.cloud.talent.v4.CompensationInfo.CompensationEntry.range]) - // times + // - it contains valid [amount][google.cloud.talent.v4.CompensationInfo.CompensationEntry.amount] or [range][google.cloud.talent.v4.CompensationInfo.CompensationEntry.range]. + // - and its [expected_units_per_year][google.cloud.talent.v4.CompensationInfo.CompensationEntry.expected_units_per_year] is set or can be derived. + // Its annualized range is determined as ([amount][google.cloud.talent.v4.CompensationInfo.CompensationEntry.amount] or [range][google.cloud.talent.v4.CompensationInfo.CompensationEntry.range]) times // [expected_units_per_year][google.cloud.talent.v4.CompensationInfo.CompensationEntry.expected_units_per_year]. message CompensationEntry { // Compensation type. // - // Default is - // [CompensationType.COMPENSATION_TYPE_UNSPECIFIED][google.cloud.talent.v4.CompensationInfo.CompensationType.COMPENSATION_TYPE_UNSPECIFIED]. + // Default is [CompensationType.COMPENSATION_TYPE_UNSPECIFIED][google.cloud.talent.v4.CompensationInfo.CompensationType.COMPENSATION_TYPE_UNSPECIFIED]. CompensationType type = 1; // Frequency of the specified amount. // - // Default is - // [CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED][google.cloud.talent.v4.CompensationInfo.CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED]. + // Default is [CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED][google.cloud.talent.v4.CompensationInfo.CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED]. CompensationUnit unit = 2; // Compensation amount. It could be a fixed amount or a floating range. @@ -721,10 +680,8 @@ message CompensationInfo { string description = 5; // Expected number of units paid each year. If not specified, when - // [Job.employment_types][google.cloud.talent.v4.Job.employment_types] is - // FULLTIME, a default value is inferred based on - // [unit][google.cloud.talent.v4.CompensationInfo.CompensationEntry.unit]. - // Default values: + // [Job.employment_types][google.cloud.talent.v4.Job.employment_types] is FULLTIME, a default value is inferred + // based on [unit][google.cloud.talent.v4.CompensationInfo.CompensationEntry.unit]. Default values: // - HOURLY: 2080 // - DAILY: 260 // - WEEKLY: 52 @@ -750,30 +707,19 @@ message CompensationInfo { // The type of compensation. // // For compensation amounts specified in non-monetary amounts, - // describe the compensation scheme in the - // [CompensationEntry.description][google.cloud.talent.v4.CompensationInfo.CompensationEntry.description]. + // describe the compensation scheme in the [CompensationEntry.description][google.cloud.talent.v4.CompensationInfo.CompensationEntry.description]. // // For example, tipping format is described in - // [CompensationEntry.description][google.cloud.talent.v4.CompensationInfo.CompensationEntry.description] - // (for example, "expect 15-20% tips based on customer bill.") and an estimate - // of the tips provided in - // [CompensationEntry.amount][google.cloud.talent.v4.CompensationInfo.CompensationEntry.amount] - // or - // [CompensationEntry.range][google.cloud.talent.v4.CompensationInfo.CompensationEntry.range] - // ($10 per hour). + // [CompensationEntry.description][google.cloud.talent.v4.CompensationInfo.CompensationEntry.description] (for example, "expect 15-20% tips based + // on customer bill.") and an estimate of the tips provided in + // [CompensationEntry.amount][google.cloud.talent.v4.CompensationInfo.CompensationEntry.amount] or [CompensationEntry.range][google.cloud.talent.v4.CompensationInfo.CompensationEntry.range] ($10 per hour). // - // For example, equity is described in - // [CompensationEntry.description][google.cloud.talent.v4.CompensationInfo.CompensationEntry.description] + // For example, equity is described in [CompensationEntry.description][google.cloud.talent.v4.CompensationInfo.CompensationEntry.description] // (for example, "1% - 2% equity vesting over 4 years, 1 year cliff") and - // value estimated in - // [CompensationEntry.amount][google.cloud.talent.v4.CompensationInfo.CompensationEntry.amount] - // or - // [CompensationEntry.range][google.cloud.talent.v4.CompensationInfo.CompensationEntry.range]. - // If no value estimate is possible, units are - // [CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED][google.cloud.talent.v4.CompensationInfo.CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED] - // and then further clarified in - // [CompensationEntry.description][google.cloud.talent.v4.CompensationInfo.CompensationEntry.description] - // field. + // value estimated in [CompensationEntry.amount][google.cloud.talent.v4.CompensationInfo.CompensationEntry.amount] or + // [CompensationEntry.range][google.cloud.talent.v4.CompensationInfo.CompensationEntry.range]. If no value estimate is possible, units are + // [CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED][google.cloud.talent.v4.CompensationInfo.CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED] and then further + // clarified in [CompensationEntry.description][google.cloud.talent.v4.CompensationInfo.CompensationEntry.description] field. enum CompensationType { // Default value. COMPENSATION_TYPE_UNSPECIFIED = 0; @@ -836,38 +782,27 @@ message CompensationInfo { // Job compensation information. // // At most one entry can be of type - // [CompensationInfo.CompensationType.BASE][google.cloud.talent.v4.CompensationInfo.CompensationType.BASE], - // which is referred as **base compensation entry** for the job. + // [CompensationInfo.CompensationType.BASE][google.cloud.talent.v4.CompensationInfo.CompensationType.BASE], which is + // referred as **base compensation entry** for the job. repeated CompensationEntry entries = 1; - // Output only. Annualized base compensation range. Computed as base - // compensation entry's - // [CompensationEntry.amount][google.cloud.talent.v4.CompensationInfo.CompensationEntry.amount] - // times + // Output only. Annualized base compensation range. Computed as base compensation entry's + // [CompensationEntry.amount][google.cloud.talent.v4.CompensationInfo.CompensationEntry.amount] times // [CompensationEntry.expected_units_per_year][google.cloud.talent.v4.CompensationInfo.CompensationEntry.expected_units_per_year]. // - // See - // [CompensationEntry][google.cloud.talent.v4.CompensationInfo.CompensationEntry] - // for explanation on compensation annualization. - CompensationRange annualized_base_compensation_range = 2 - [(google.api.field_behavior) = OUTPUT_ONLY]; - - // Output only. Annualized total compensation range. Computed as all - // compensation entries' - // [CompensationEntry.amount][google.cloud.talent.v4.CompensationInfo.CompensationEntry.amount] - // times + // See [CompensationEntry][google.cloud.talent.v4.CompensationInfo.CompensationEntry] for explanation on compensation annualization. + CompensationRange annualized_base_compensation_range = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Annualized total compensation range. Computed as all compensation entries' + // [CompensationEntry.amount][google.cloud.talent.v4.CompensationInfo.CompensationEntry.amount] times // [CompensationEntry.expected_units_per_year][google.cloud.talent.v4.CompensationInfo.CompensationEntry.expected_units_per_year]. // - // See - // [CompensationEntry][google.cloud.talent.v4.CompensationInfo.CompensationEntry] - // for explanation on compensation annualization. - CompensationRange annualized_total_compensation_range = 3 - [(google.api.field_behavior) = OUTPUT_ONLY]; + // See [CompensationEntry][google.cloud.talent.v4.CompensationInfo.CompensationEntry] for explanation on compensation annualization. + CompensationRange annualized_total_compensation_range = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Metadata used for long running operations returned by CTS batch APIs. -// It's used to replace -// [google.longrunning.Operation.metadata][google.longrunning.Operation.metadata]. +// It's used to replace [google.longrunning.Operation.metadata][google.longrunning.Operation.metadata]. message BatchOperationMetadata { enum State { // Default value. @@ -887,14 +822,12 @@ message BatchOperationMetadata { FAILED = 4; // The batch operation is in the process of cancelling after - // [google.longrunning.Operations.CancelOperation][google.longrunning.Operations.CancelOperation] - // is called. + // [google.longrunning.Operations.CancelOperation][google.longrunning.Operations.CancelOperation] is called. CANCELLING = 5; // The batch operation is done after - // [google.longrunning.Operations.CancelOperation][google.longrunning.Operations.CancelOperation] - // is called. Any items processed before cancelling are returned in the - // response. + // [google.longrunning.Operations.CancelOperation][google.longrunning.Operations.CancelOperation] is called. Any items + // processed before cancelling are returned in the response. CANCELLED = 6; } @@ -917,12 +850,11 @@ message BatchOperationMetadata { google.protobuf.Timestamp create_time = 6; // The time when the batch operation status is updated. The metadata and the - // [update_time][google.cloud.talent.v4.BatchOperationMetadata.update_time] is - // refreshed every minute otherwise cached data is returned. + // [update_time][google.cloud.talent.v4.BatchOperationMetadata.update_time] is refreshed every minute otherwise cached data is + // returned. google.protobuf.Timestamp update_time = 7; // The time when the batch operation is finished and - // [google.longrunning.Operation.done][google.longrunning.Operation.done] is - // set to `true`. + // [google.longrunning.Operation.done][google.longrunning.Operation.done] is set to `true`. google.protobuf.Timestamp end_time = 8; } diff --git a/google/cloud/talent_v4/proto/company.proto b/google/cloud/talent_v4/proto/company.proto index 5c1de8f2..c6b61a2c 100644 --- a/google/cloud/talent_v4/proto/company.proto +++ b/google/cloud/talent_v4/proto/company.proto @@ -16,10 +16,10 @@ syntax = "proto3"; package google.cloud.talent.v4; -import "google/api/annotations.proto"; import "google/api/field_behavior.proto"; import "google/api/resource.proto"; import "google/cloud/talent/v4/common.proto"; +import "google/api/annotations.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4;talent"; option java_multiple_files = true; @@ -39,8 +39,7 @@ message Company { // Derived details about the company. message DerivedInfo { // A structured headquarters location of the company, resolved from - // [Company.headquarters_address][google.cloud.talent.v4.Company.headquarters_address] - // if provided. + // [Company.headquarters_address][google.cloud.talent.v4.Company.headquarters_address] if provided. Location headquarters_location = 1; } @@ -69,8 +68,7 @@ message Company { // The street address of the company's main headquarters, which may be // different from the job location. The service attempts // to geolocate the provided address, and populates a more specific - // location wherever possible in - // [DerivedInfo.headquarters_location][google.cloud.talent.v4.Company.DerivedInfo.headquarters_location]. + // location wherever possible in [DerivedInfo.headquarters_location][google.cloud.talent.v4.Company.DerivedInfo.headquarters_location]. string headquarters_address = 5; // Set to true if it is the hiring agency that post jobs for other @@ -99,9 +97,8 @@ message Company { // A URI that hosts the employer's company logo. string image_uri = 10; - // A list of keys of filterable - // [Job.custom_attributes][google.cloud.talent.v4.Job.custom_attributes], - // whose corresponding `string_values` are used in keyword searches. Jobs with + // A list of keys of filterable [Job.custom_attributes][google.cloud.talent.v4.Job.custom_attributes], whose + // corresponding `string_values` are used in keyword searches. Jobs with // `string_values` under these specified field keys are returned if any // of the values match the search keyword. Custom field values with // parenthesis, brackets and special symbols are not searchable as-is, diff --git a/google/cloud/talent_v4/proto/company_service.proto b/google/cloud/talent_v4/proto/company_service.proto index 78bba7cc..54ee4800 100644 --- a/google/cloud/talent_v4/proto/company_service.proto +++ b/google/cloud/talent_v4/proto/company_service.proto @@ -90,7 +90,9 @@ message CreateCompanyRequest { // "projects/foo/tenants/bar". string parent = 1 [ (google.api.field_behavior) = REQUIRED, - (google.api.resource_reference) = { type: "jobs.googleapis.com/Tenant" } + (google.api.resource_reference) = { + type: "jobs.googleapis.com/Tenant" + } ]; // Required. The company to be created. @@ -106,26 +108,24 @@ message GetCompanyRequest { // example, "projects/api-test-project/tenants/foo/companies/bar". string name = 1 [ (google.api.field_behavior) = REQUIRED, - (google.api.resource_reference) = { type: "jobs.googleapis.com/Company" } + (google.api.resource_reference) = { + type: "jobs.googleapis.com/Company" + } ]; } // Request for updating a specified company. message UpdateCompanyRequest { - // Required. The company resource to replace the current resource in the - // system. + // Required. The company resource to replace the current resource in the system. Company company = 1 [(google.api.field_behavior) = REQUIRED]; // Strongly recommended for the best service experience. // - // If [update_mask][google.cloud.talent.v4.UpdateCompanyRequest.update_mask] - // is provided, only the specified fields in - // [company][google.cloud.talent.v4.UpdateCompanyRequest.company] are updated. - // Otherwise all the fields are updated. + // If [update_mask][google.cloud.talent.v4.UpdateCompanyRequest.update_mask] is provided, only the specified fields in + // [company][google.cloud.talent.v4.UpdateCompanyRequest.company] are updated. Otherwise all the fields are updated. // // A field mask to specify the company fields to be updated. Only - // top level fields of [Company][google.cloud.talent.v4.Company] are - // supported. + // top level fields of [Company][google.cloud.talent.v4.Company] are supported. google.protobuf.FieldMask update_mask = 2; } @@ -138,7 +138,9 @@ message DeleteCompanyRequest { // example, "projects/foo/tenants/bar/companies/baz". string name = 1 [ (google.api.field_behavior) = REQUIRED, - (google.api.resource_reference) = { type: "jobs.googleapis.com/Company" } + (google.api.resource_reference) = { + type: "jobs.googleapis.com/Company" + } ]; } @@ -150,7 +152,9 @@ message ListCompaniesRequest { // "projects/foo/tenants/bar". string parent = 1 [ (google.api.field_behavior) = REQUIRED, - (google.api.resource_reference) = { type: "jobs.googleapis.com/Tenant" } + (google.api.resource_reference) = { + type: "jobs.googleapis.com/Tenant" + } ]; // The starting indicator from which to return results. @@ -164,9 +168,8 @@ message ListCompaniesRequest { // // Defaults to false. // - // If true, at most - // [page_size][google.cloud.talent.v4.ListCompaniesRequest.page_size] of - // companies are fetched, among which only those with open jobs are returned. + // If true, at most [page_size][google.cloud.talent.v4.ListCompaniesRequest.page_size] of companies are fetched, among which + // only those with open jobs are returned. bool require_open_jobs = 4; } diff --git a/google/cloud/talent_v4/proto/completion_service.proto b/google/cloud/talent_v4/proto/completion_service.proto index e910d580..73af1e87 100644 --- a/google/cloud/talent_v4/proto/completion_service.proto +++ b/google/cloud/talent_v4/proto/completion_service.proto @@ -17,10 +17,10 @@ syntax = "proto3"; package google.cloud.talent.v4; import "google/api/annotations.proto"; -import "google/api/client.proto"; import "google/api/field_behavior.proto"; import "google/api/resource.proto"; import "google/cloud/talent/v4/common.proto"; +import "google/api/client.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4;talent"; option java_multiple_files = true; @@ -66,31 +66,22 @@ message CompleteQueryRequest { // Suggest job titles for jobs autocomplete. // - // For - // [CompletionType.JOB_TITLE][google.cloud.talent.v4.CompleteQueryRequest.CompletionType.JOB_TITLE] - // type, only open jobs with the same - // [language_codes][google.cloud.talent.v4.CompleteQueryRequest.language_codes] - // are returned. + // For [CompletionType.JOB_TITLE][google.cloud.talent.v4.CompleteQueryRequest.CompletionType.JOB_TITLE] type, only open jobs with the same + // [language_codes][google.cloud.talent.v4.CompleteQueryRequest.language_codes] are returned. JOB_TITLE = 1; // Suggest company names for jobs autocomplete. // - // For - // [CompletionType.COMPANY_NAME][google.cloud.talent.v4.CompleteQueryRequest.CompletionType.COMPANY_NAME] - // type, only companies having open jobs with the same - // [language_codes][google.cloud.talent.v4.CompleteQueryRequest.language_codes] - // are returned. + // For [CompletionType.COMPANY_NAME][google.cloud.talent.v4.CompleteQueryRequest.CompletionType.COMPANY_NAME] type, + // only companies having open jobs with the same [language_codes][google.cloud.talent.v4.CompleteQueryRequest.language_codes] are + // returned. COMPANY_NAME = 2; // Suggest both job titles and company names for jobs autocomplete. // - // For - // [CompletionType.COMBINED][google.cloud.talent.v4.CompleteQueryRequest.CompletionType.COMBINED] - // type, only open jobs with the same - // [language_codes][google.cloud.talent.v4.CompleteQueryRequest.language_codes] - // or companies having open jobs with the same - // [language_codes][google.cloud.talent.v4.CompleteQueryRequest.language_codes] - // are returned. + // For [CompletionType.COMBINED][google.cloud.talent.v4.CompleteQueryRequest.CompletionType.COMBINED] type, only open jobs with the same + // [language_codes][google.cloud.talent.v4.CompleteQueryRequest.language_codes] or companies having open jobs with the same + // [language_codes][google.cloud.talent.v4.CompleteQueryRequest.language_codes] are returned. COMBINED = 3; } @@ -100,7 +91,9 @@ message CompleteQueryRequest { // "projects/foo/tenants/bar". string tenant = 1 [ (google.api.field_behavior) = REQUIRED, - (google.api.resource_reference) = { type: "jobs.googleapis.com/Tenant" } + (google.api.resource_reference) = { + type: "jobs.googleapis.com/Tenant" + } ]; // Required. The query used to generate suggestions. @@ -126,16 +119,14 @@ message CompleteQueryRequest { // The format is // "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}", for // example, "projects/foo/tenants/bar/companies/baz". - string company = 5 [ - (google.api.resource_reference) = { type: "jobs.googleapis.com/Company" } - ]; + string company = 5 [(google.api.resource_reference) = { + type: "jobs.googleapis.com/Company" + }]; - // The scope of the completion. The defaults is - // [CompletionScope.PUBLIC][google.cloud.talent.v4.CompleteQueryRequest.CompletionScope.PUBLIC]. + // The scope of the completion. The defaults is [CompletionScope.PUBLIC][google.cloud.talent.v4.CompleteQueryRequest.CompletionScope.PUBLIC]. CompletionScope scope = 6; - // The completion topic. The default is - // [CompletionType.COMBINED][google.cloud.talent.v4.CompleteQueryRequest.CompletionType.COMBINED]. + // The completion topic. The default is [CompletionType.COMBINED][google.cloud.talent.v4.CompleteQueryRequest.CompletionType.COMBINED]. CompletionType type = 7; } diff --git a/google/cloud/talent_v4/proto/event.proto b/google/cloud/talent_v4/proto/event.proto index 862a4b9a..874228e1 100644 --- a/google/cloud/talent_v4/proto/event.proto +++ b/google/cloud/talent_v4/proto/event.proto @@ -16,9 +16,9 @@ syntax = "proto3"; package google.cloud.talent.v4; -import "google/api/annotations.proto"; import "google/api/field_behavior.proto"; import "google/protobuf/timestamp.proto"; +import "google/api/annotations.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4;talent"; option java_multiple_files = true; @@ -42,8 +42,7 @@ message ClientEvent { string event_id = 2 [(google.api.field_behavior) = REQUIRED]; // Required. The timestamp of the event. - google.protobuf.Timestamp create_time = 4 - [(google.api.field_behavior) = REQUIRED]; + google.protobuf.Timestamp create_time = 4 [(google.api.field_behavior) = REQUIRED]; // Required. // @@ -98,9 +97,7 @@ message JobEvent { // submitted an application for a job with a single click without // entering information. If a job seeker performs this action, send only // this event to the service. Do not also send - // [JobEventType.APPLICATION_START][google.cloud.talent.v4.JobEvent.JobEventType.APPLICATION_START] - // or - // [JobEventType.APPLICATION_FINISH][google.cloud.talent.v4.JobEvent.JobEventType.APPLICATION_FINISH] + // [JobEventType.APPLICATION_START][google.cloud.talent.v4.JobEvent.JobEventType.APPLICATION_START] or [JobEventType.APPLICATION_FINISH][google.cloud.talent.v4.JobEvent.JobEventType.APPLICATION_FINISH] // events. APPLICATION_QUICK_SUBMISSION = 6; @@ -120,11 +117,8 @@ message JobEvent { // (without viewing the details of the job posting), and is redirected // to a different website to complete the application. If a candidate // performs this action, send only this event to the service. Do not also - // send - // [JobEventType.APPLICATION_START][google.cloud.talent.v4.JobEvent.JobEventType.APPLICATION_START], - // [JobEventType.APPLICATION_FINISH][google.cloud.talent.v4.JobEvent.JobEventType.APPLICATION_FINISH] - // or [JobEventType.VIEW][google.cloud.talent.v4.JobEvent.JobEventType.VIEW] - // events. + // send [JobEventType.APPLICATION_START][google.cloud.talent.v4.JobEvent.JobEventType.APPLICATION_START], + // [JobEventType.APPLICATION_FINISH][google.cloud.talent.v4.JobEvent.JobEventType.APPLICATION_FINISH] or [JobEventType.VIEW][google.cloud.talent.v4.JobEvent.JobEventType.VIEW] events. APPLICATION_REDIRECT_FROM_SEARCH = 9; // This event should be used when a company submits an application @@ -161,17 +155,14 @@ message JobEvent { INTERVIEW_GRANTED = 15; } - // Required. The type of the event (see - // [JobEventType][google.cloud.talent.v4.JobEvent.JobEventType]). + // Required. The type of the event (see [JobEventType][google.cloud.talent.v4.JobEvent.JobEventType]). JobEventType type = 1 [(google.api.field_behavior) = REQUIRED]; - // Required. The [job name(s)][google.cloud.talent.v4.Job.name] associated - // with this event. For example, if this is an - // [impression][google.cloud.talent.v4.JobEvent.JobEventType.IMPRESSION] - // event, this field contains the identifiers of all jobs shown to the job - // seeker. If this was a - // [view][google.cloud.talent.v4.JobEvent.JobEventType.VIEW] event, this field - // contains the identifier of the viewed job. + // Required. The [job name(s)][google.cloud.talent.v4.Job.name] associated with this event. + // For example, if this is an [impression][google.cloud.talent.v4.JobEvent.JobEventType.IMPRESSION] event, + // this field contains the identifiers of all jobs shown to the job seeker. + // If this was a [view][google.cloud.talent.v4.JobEvent.JobEventType.VIEW] event, this field contains the + // identifier of the viewed job. // // The format is // "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}", for diff --git a/google/cloud/talent_v4/proto/event_service.proto b/google/cloud/talent_v4/proto/event_service.proto index 7cd25f11..0f181367 100644 --- a/google/cloud/talent_v4/proto/event_service.proto +++ b/google/cloud/talent_v4/proto/event_service.proto @@ -59,10 +59,12 @@ message CreateClientEventRequest { // "projects/foo/tenants/bar". string parent = 1 [ (google.api.field_behavior) = REQUIRED, - (google.api.resource_reference) = { type: "jobs.googleapis.com/Tenant" } + (google.api.resource_reference) = { + type: "jobs.googleapis.com/Tenant" + } ]; - // Required. Events issued when end user interacts with customer's application - // that uses Cloud Talent Solution. + // Required. Events issued when end user interacts with customer's application that + // uses Cloud Talent Solution. ClientEvent client_event = 2 [(google.api.field_behavior) = REQUIRED]; } diff --git a/google/cloud/talent_v4/proto/filters.proto b/google/cloud/talent_v4/proto/filters.proto index fb3ffc4f..a0063cab 100644 --- a/google/cloud/talent_v4/proto/filters.proto +++ b/google/cloud/talent_v4/proto/filters.proto @@ -16,12 +16,12 @@ syntax = "proto3"; package google.cloud.talent.v4; -import "google/api/annotations.proto"; import "google/api/field_behavior.proto"; import "google/cloud/talent/v4/common.proto"; import "google/protobuf/duration.proto"; import "google/type/latlng.proto"; import "google/type/timeofday.proto"; +import "google/api/annotations.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4;talent"; option java_multiple_files = true; @@ -37,8 +37,8 @@ message JobQuery { // The maximum number of allowed characters is 255. string query = 1; - // The language code of [query][google.cloud.talent.v4.JobQuery.query]. For - // example, "en-US". This field helps to better interpret the query. + // The language code of [query][google.cloud.talent.v4.JobQuery.query]. For example, "en-US". This field helps to + // better interpret the query. // // If a value isn't specified, the query language code is automatically // detected, which may not be accurate. @@ -64,16 +64,15 @@ message JobQuery { repeated string companies = 2; // The location filter specifies geo-regions containing the jobs to - // search against. See [LocationFilter][google.cloud.talent.v4.LocationFilter] - // for more information. + // search against. See [LocationFilter][google.cloud.talent.v4.LocationFilter] for more information. // // If a location value isn't specified, jobs fitting the other search // criteria are retrieved regardless of where they're located. // // If multiple values are specified, jobs are retrieved from any of the // specified locations. If different values are specified for the - // [LocationFilter.distance_in_miles][google.cloud.talent.v4.LocationFilter.distance_in_miles] - // parameter, the maximum provided distance is used for all locations. + // [LocationFilter.distance_in_miles][google.cloud.talent.v4.LocationFilter.distance_in_miles] parameter, the maximum provided + // distance is used for all locations. // // At most 5 location filters are allowed. repeated LocationFilter location_filters = 3; @@ -90,17 +89,14 @@ message JobQuery { // Allows filtering jobs by commute time with different travel methods (for // example, driving or public transit). // - // Note: This only works when you specify a - // [CommuteMethod][google.cloud.talent.v4.CommuteMethod]. In this case, - // [location_filters][google.cloud.talent.v4.JobQuery.location_filters] is - // ignored. + // Note: This only works when you specify a [CommuteMethod][google.cloud.talent.v4.CommuteMethod]. In this case, + // [location_filters][google.cloud.talent.v4.JobQuery.location_filters] is ignored. // // Currently we don't support sorting by commute time. CommuteFilter commute_filter = 5; - // This filter specifies the exact company - // [Company.display_name][google.cloud.talent.v4.Company.display_name] of the - // jobs to search against. + // This filter specifies the exact company [Company.display_name][google.cloud.talent.v4.Company.display_name] + // of the jobs to search against. // // If a value isn't specified, jobs within the search results are // associated with any company. @@ -112,15 +108,14 @@ message JobQuery { repeated string company_display_names = 6; // This search filter is applied only to - // [Job.compensation_info][google.cloud.talent.v4.Job.compensation_info]. For - // example, if the filter is specified as "Hourly job with per-hour - // compensation > $15", only jobs meeting these criteria are searched. If a - // filter isn't defined, all open jobs are searched. + // [Job.compensation_info][google.cloud.talent.v4.Job.compensation_info]. For example, if the filter is specified + // as "Hourly job with per-hour compensation > $15", only jobs meeting + // these criteria are searched. If a filter isn't defined, all open jobs + // are searched. CompensationFilter compensation_filter = 7; // This filter specifies a structured syntax to match against the - // [Job.custom_attributes][google.cloud.talent.v4.Job.custom_attributes] - // marked as `filterable`. + // [Job.custom_attributes][google.cloud.talent.v4.Job.custom_attributes] marked as `filterable`. // // The syntax for this expression is a subset of SQL syntax. // @@ -151,8 +146,7 @@ message JobQuery { bool disable_spell_check = 9; // The employment type filter specifies the employment type of jobs to - // search against, such as - // [EmploymentType.FULL_TIME][google.cloud.talent.v4.EmploymentType.FULL_TIME]. + // search against, such as [EmploymentType.FULL_TIME][google.cloud.talent.v4.EmploymentType.FULL_TIME]. // // If a value isn't specified, jobs in the search results includes any // employment type. @@ -227,15 +221,12 @@ message LocationFilter { // Allows the client to return jobs without a // set location, specifically, telecommuting jobs (telecommuting is considered // by the service as a special location. - // [Job.posting_region][google.cloud.talent.v4.Job.posting_region] indicates - // if a job permits telecommuting. If this field is set to - // [TelecommutePreference.TELECOMMUTE_ALLOWED][google.cloud.talent.v4.LocationFilter.TelecommutePreference.TELECOMMUTE_ALLOWED], - // telecommuting jobs are searched, and - // [address][google.cloud.talent.v4.LocationFilter.address] and - // [lat_lng][google.cloud.talent.v4.LocationFilter.lat_lng] are ignored. If - // not set or set to - // [TelecommutePreference.TELECOMMUTE_EXCLUDED][google.cloud.talent.v4.LocationFilter.TelecommutePreference.TELECOMMUTE_EXCLUDED], - // telecommute job are not searched. + // [Job.posting_region][google.cloud.talent.v4.Job.posting_region] indicates if a job permits telecommuting. + // If this field is set to [TelecommutePreference.TELECOMMUTE_ALLOWED][google.cloud.talent.v4.LocationFilter.TelecommutePreference.TELECOMMUTE_ALLOWED], + // telecommuting jobs are searched, and [address][google.cloud.talent.v4.LocationFilter.address] and [lat_lng][google.cloud.talent.v4.LocationFilter.lat_lng] are + // ignored. If not set or set to + // [TelecommutePreference.TELECOMMUTE_EXCLUDED][google.cloud.talent.v4.LocationFilter.TelecommutePreference.TELECOMMUTE_EXCLUDED], telecommute job are not + // searched. // // This filter can be used by itself to search exclusively for telecommuting // jobs, or it can be combined with another location @@ -257,40 +248,32 @@ message CompensationFilter { // Filter by `base compensation entry's` unit. A job is a match if and // only if the job contains a base CompensationEntry and the base - // CompensationEntry's unit matches provided - // [units][google.cloud.talent.v4.CompensationFilter.units]. Populate one or - // more [units][google.cloud.talent.v4.CompensationFilter.units]. + // CompensationEntry's unit matches provided [units][google.cloud.talent.v4.CompensationFilter.units]. + // Populate one or more [units][google.cloud.talent.v4.CompensationFilter.units]. // - // See - // [CompensationInfo.CompensationEntry][google.cloud.talent.v4.CompensationInfo.CompensationEntry] - // for definition of base compensation entry. + // See [CompensationInfo.CompensationEntry][google.cloud.talent.v4.CompensationInfo.CompensationEntry] for definition of + // base compensation entry. UNIT_ONLY = 1; // Filter by `base compensation entry's` unit and amount / range. A job // is a match if and only if the job contains a base CompensationEntry, and // the base entry's unit matches provided - // [CompensationUnit][google.cloud.talent.v4.CompensationInfo.CompensationUnit] - // and amount or range overlaps with provided + // [CompensationUnit][google.cloud.talent.v4.CompensationInfo.CompensationUnit] and + // amount or range overlaps with provided // [CompensationRange][google.cloud.talent.v4.CompensationInfo.CompensationRange]. // - // See - // [CompensationInfo.CompensationEntry][google.cloud.talent.v4.CompensationInfo.CompensationEntry] - // for definition of base compensation entry. + // See [CompensationInfo.CompensationEntry][google.cloud.talent.v4.CompensationInfo.CompensationEntry] for definition of + // base compensation entry. // - // Set exactly one [units][google.cloud.talent.v4.CompensationFilter.units] - // and populate [range][google.cloud.talent.v4.CompensationFilter.range]. + // Set exactly one [units][google.cloud.talent.v4.CompensationFilter.units] and populate [range][google.cloud.talent.v4.CompensationFilter.range]. UNIT_AND_AMOUNT = 2; // Filter by annualized base compensation amount and `base compensation - // entry's` unit. Populate - // [range][google.cloud.talent.v4.CompensationFilter.range] and zero or more - // [units][google.cloud.talent.v4.CompensationFilter.units]. + // entry's` unit. Populate [range][google.cloud.talent.v4.CompensationFilter.range] and zero or more [units][google.cloud.talent.v4.CompensationFilter.units]. ANNUALIZED_BASE_AMOUNT = 3; // Filter by annualized total compensation amount and `base compensation - // entry's` unit . Populate - // [range][google.cloud.talent.v4.CompensationFilter.range] and zero or more - // [units][google.cloud.talent.v4.CompensationFilter.units]. + // entry's` unit . Populate [range][google.cloud.talent.v4.CompensationFilter.range] and zero or more [units][google.cloud.talent.v4.CompensationFilter.units]. ANNUALIZED_TOTAL_AMOUNT = 4; } @@ -299,8 +282,7 @@ message CompensationFilter { // Required. Specify desired `base compensation entry's` // [CompensationInfo.CompensationUnit][google.cloud.talent.v4.CompensationInfo.CompensationUnit]. - repeated CompensationInfo.CompensationUnit units = 2 - [(google.api.field_behavior) = REQUIRED]; + repeated CompensationInfo.CompensationUnit units = 2 [(google.api.field_behavior) = REQUIRED]; // Compensation range. CompensationInfo.CompensationRange range = 3; @@ -329,13 +311,11 @@ message CommuteFilter { // Required. The latitude and longitude of the location to calculate the // commute time from. - google.type.LatLng start_coordinates = 2 - [(google.api.field_behavior) = REQUIRED]; + google.type.LatLng start_coordinates = 2 [(google.api.field_behavior) = REQUIRED]; - // Required. The maximum travel time in seconds. The maximum allowed value is - // `3600s` (one hour). Format is `123s`. - google.protobuf.Duration travel_duration = 3 - [(google.api.field_behavior) = REQUIRED]; + // Required. The maximum travel time in seconds. The maximum allowed value is `3600s` + // (one hour). Format is `123s`. + google.protobuf.Duration travel_duration = 3 [(google.api.field_behavior) = REQUIRED]; // If `true`, jobs without street level addresses may also be returned. // For city level addresses, the city center is used. For state and coarser diff --git a/google/cloud/talent_v4/proto/histogram.proto b/google/cloud/talent_v4/proto/histogram.proto index f58ac1c0..df4fbbb4 100644 --- a/google/cloud/talent_v4/proto/histogram.proto +++ b/google/cloud/talent_v4/proto/histogram.proto @@ -29,15 +29,11 @@ message HistogramQuery { // An expression specifies a histogram request against matching jobs for // searches. // - // See - // [SearchJobsRequest.histogram_queries][google.cloud.talent.v4.SearchJobsRequest.histogram_queries] - // for details about syntax. + // See [SearchJobsRequest.histogram_queries][google.cloud.talent.v4.SearchJobsRequest.histogram_queries] for details about syntax. string histogram_query = 1; } -// Histogram result that matches -// [HistogramQuery][google.cloud.talent.v4.HistogramQuery] specified in -// searches. +// Histogram result that matches [HistogramQuery][google.cloud.talent.v4.HistogramQuery] specified in searches. message HistogramQueryResult { // Requested histogram expression. string histogram_query = 1; diff --git a/google/cloud/talent_v4/proto/job.proto b/google/cloud/talent_v4/proto/job.proto index 66242e10..4c24f430 100644 --- a/google/cloud/talent_v4/proto/job.proto +++ b/google/cloud/talent_v4/proto/job.proto @@ -16,11 +16,11 @@ syntax = "proto3"; package google.cloud.talent.v4; -import "google/api/annotations.proto"; import "google/api/field_behavior.proto"; import "google/api/resource.proto"; import "google/cloud/talent/v4/common.proto"; import "google/protobuf/timestamp.proto"; +import "google/api/annotations.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4;talent"; option java_multiple_files = true; @@ -29,9 +29,8 @@ option java_package = "com.google.cloud.talent.v4"; option objc_class_prefix = "CTS"; // A Job resource represents a job posting (also referred to as a "job listing" -// or "job requisition"). A job belongs to a -// [Company][google.cloud.talent.v4.Company], which is the hiring entity -// responsible for the job. +// or "job requisition"). A job belongs to a [Company][google.cloud.talent.v4.Company], which is the hiring +// entity responsible for the job. message Job { option (google.api.resource) = { type: "jobs.googleapis.com/Job" @@ -64,16 +63,13 @@ message Job { // Derived details about the job posting. message DerivedInfo { - // Structured locations of the job, resolved from - // [Job.addresses][google.cloud.talent.v4.Job.addresses]. + // Structured locations of the job, resolved from [Job.addresses][google.cloud.talent.v4.Job.addresses]. // - // [locations][google.cloud.talent.v4.Job.DerivedInfo.locations] are exactly - // matched to [Job.addresses][google.cloud.talent.v4.Job.addresses] in the - // same order. + // [locations][google.cloud.talent.v4.Job.DerivedInfo.locations] are exactly matched to [Job.addresses][google.cloud.talent.v4.Job.addresses] in the same + // order. repeated Location locations = 1; - // Job categories derived from [Job.title][google.cloud.talent.v4.Job.title] - // and [Job.description][google.cloud.talent.v4.Job.description]. + // Job categories derived from [Job.title][google.cloud.talent.v4.Job.title] and [Job.description][google.cloud.talent.v4.Job.description]. repeated JobCategory job_categories = 3; } @@ -94,8 +90,7 @@ message Job { // HTML tags in these fields may be stripped if sanitiazation isn't // disabled. // - // Defaults to - // [HtmlSanitization.SIMPLE_FORMATTING_ONLY][google.cloud.talent.v4.HtmlSanitization.SIMPLE_FORMATTING_ONLY]. + // Defaults to [HtmlSanitization.SIMPLE_FORMATTING_ONLY][google.cloud.talent.v4.HtmlSanitization.SIMPLE_FORMATTING_ONLY]. HtmlSanitization html_sanitization = 2; } @@ -109,8 +104,7 @@ message Job { // example, "projects/foo/tenants/bar/jobs/baz". // // Use of this field in job queries and API calls is preferred over the use of - // [requisition_id][google.cloud.talent.v4.Job.requisition_id] since this - // value is unique. + // [requisition_id][google.cloud.talent.v4.Job.requisition_id] since this value is unique. string name = 1; // Required. The resource name of the company listing the job. @@ -120,16 +114,16 @@ message Job { // example, "projects/foo/tenants/bar/companies/baz". string company = 2 [ (google.api.field_behavior) = REQUIRED, - (google.api.resource_reference) = { type: "jobs.googleapis.com/Company" } + (google.api.resource_reference) = { + type: "jobs.googleapis.com/Company" + } ]; - // Required. The requisition ID, also referred to as the posting ID, is - // assigned by the client to identify a job. This field is intended to be used - // by clients for client identification and tracking of postings. A job isn't - // allowed to be created if there is another job with the same - // [company][google.cloud.talent.v4.Job.name], - // [language_code][google.cloud.talent.v4.Job.language_code] and - // [requisition_id][google.cloud.talent.v4.Job.requisition_id]. + // Required. The requisition ID, also referred to as the posting ID, is assigned by the + // client to identify a job. This field is intended to be used by clients + // for client identification and tracking of postings. A job isn't allowed + // to be created if there is another job with the same [company][google.cloud.talent.v4.Job.name], + // [language_code][google.cloud.talent.v4.Job.language_code] and [requisition_id][google.cloud.talent.v4.Job.requisition_id]. // // The maximum number of allowed characters is 255. string requisition_id = 3 [(google.api.field_behavior) = REQUIRED]; @@ -139,12 +133,11 @@ message Job { // The maximum number of allowed characters is 500. string title = 4 [(google.api.field_behavior) = REQUIRED]; - // Required. The description of the job, which typically includes a - // multi-paragraph description of the company and related information. - // Separate fields are provided on the job object for - // [responsibilities][google.cloud.talent.v4.Job.responsibilities], - // [qualifications][google.cloud.talent.v4.Job.qualifications], and other job - // characteristics. Use of these separate job fields is recommended. + // Required. The description of the job, which typically includes a multi-paragraph + // description of the company and related information. Separate fields are + // provided on the job object for [responsibilities][google.cloud.talent.v4.Job.responsibilities], + // [qualifications][google.cloud.talent.v4.Job.qualifications], and other job characteristics. Use of + // these separate job fields is recommended. // // This field accepts and sanitizes HTML input, and also accepts // bold, italic, ordered list, and unordered list markup tags. @@ -161,16 +154,12 @@ message Job { // // At most 50 locations are allowed for best search performance. If a job has // more locations, it is suggested to split it into multiple jobs with unique - // [requisition_id][google.cloud.talent.v4.Job.requisition_id]s (e.g. 'ReqA' - // becomes 'ReqA-1', 'ReqA-2', and so on.) as multiple jobs with the same - // [company][google.cloud.talent.v4.Job.company], - // [language_code][google.cloud.talent.v4.Job.language_code] and - // [requisition_id][google.cloud.talent.v4.Job.requisition_id] are not - // allowed. If the original - // [requisition_id][google.cloud.talent.v4.Job.requisition_id] must be - // preserved, a custom field should be used for storage. It is also suggested - // to group the locations that close to each other in the same job for better - // search experience. + // [requisition_id][google.cloud.talent.v4.Job.requisition_id]s (e.g. 'ReqA' becomes 'ReqA-1', 'ReqA-2', and so on.) as + // multiple jobs with the same [company][google.cloud.talent.v4.Job.company], [language_code][google.cloud.talent.v4.Job.language_code] and + // [requisition_id][google.cloud.talent.v4.Job.requisition_id] are not allowed. If the original [requisition_id][google.cloud.talent.v4.Job.requisition_id] must + // be preserved, a custom field should be used for storage. It is also + // suggested to group the locations that close to each other in the same job + // for better search experience. // // The maximum number of allowed characters is 500. repeated string addresses = 6; @@ -227,11 +216,9 @@ message Job { // [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47){: // class="external" target="_blank" }. // - // If this field is unspecified and - // [Job.description][google.cloud.talent.v4.Job.description] is present, - // detected language code based on - // [Job.description][google.cloud.talent.v4.Job.description] is assigned, - // otherwise defaults to 'en_US'. + // If this field is unspecified and [Job.description][google.cloud.talent.v4.Job.description] is present, detected + // language code based on [Job.description][google.cloud.talent.v4.Job.description] is assigned, otherwise + // defaults to 'en_US'. string language_code = 15; // The experience level associated with the job, such as "Entry Level". @@ -248,8 +235,7 @@ message Job { // A description of the qualifications required to perform the // job. The use of this field is recommended - // as an alternative to using the more general - // [description][google.cloud.talent.v4.Job.description] field. + // as an alternative to using the more general [description][google.cloud.talent.v4.Job.description] field. // // This field accepts and sanitizes HTML input, and also accepts // bold, italic, ordered list, and unordered list markup tags. @@ -258,8 +244,8 @@ message Job { string qualifications = 18; // A description of job responsibilities. The use of this field is - // recommended as an alternative to using the more general - // [description][google.cloud.talent.v4.Job.description] field. + // recommended as an alternative to using the more general [description][google.cloud.talent.v4.Job.description] + // field. // // This field accepts and sanitizes HTML input, and also accepts // bold, italic, ordered list, and unordered list markup tags. @@ -267,24 +253,20 @@ message Job { // The maximum number of allowed characters is 10,000. string responsibilities = 19; - // The job [PostingRegion][google.cloud.talent.v4.PostingRegion] (for example, - // state, country) throughout which the job is available. If this field is - // set, a [LocationFilter][google.cloud.talent.v4.LocationFilter] in a search - // query within the job region finds this job posting if an exact location - // match isn't specified. If this field is set to - // [PostingRegion.NATION][google.cloud.talent.v4.PostingRegion.NATION] or - // [PostingRegion.ADMINISTRATIVE_AREA][google.cloud.talent.v4.PostingRegion.ADMINISTRATIVE_AREA], - // setting job [Job.addresses][google.cloud.talent.v4.Job.addresses] to the - // same location level as this field is strongly recommended. + // The job [PostingRegion][google.cloud.talent.v4.PostingRegion] (for example, state, country) throughout + // which the job is available. If this field is set, a [LocationFilter][google.cloud.talent.v4.LocationFilter] + // in a search query within the job region finds this job posting if an + // exact location match isn't specified. If this field is set to + // [PostingRegion.NATION][google.cloud.talent.v4.PostingRegion.NATION] or [PostingRegion.ADMINISTRATIVE_AREA][google.cloud.talent.v4.PostingRegion.ADMINISTRATIVE_AREA], + // setting job [Job.addresses][google.cloud.talent.v4.Job.addresses] to the same location level as this field + // is strongly recommended. PostingRegion posting_region = 20; // Deprecated. The job is only visible to the owner. // // The visibility of the job. // - // Defaults to - // [Visibility.ACCOUNT_ONLY][google.cloud.talent.v4.Visibility.ACCOUNT_ONLY] - // if not specified. + // Defaults to [Visibility.ACCOUNT_ONLY][google.cloud.talent.v4.Visibility.ACCOUNT_ONLY] if not specified. Visibility visibility = 21 [deprecated = true]; // The start timestamp of the job in UTC time zone. Typically this field @@ -304,17 +286,13 @@ message Job { // // The expiration timestamp of the job. After this timestamp, the // job is marked as expired, and it no longer appears in search results. The - // expired job can't be listed by the - // [ListJobs][google.cloud.talent.v4.JobService.ListJobs] API, but it can be - // retrieved with the [GetJob][google.cloud.talent.v4.JobService.GetJob] API - // or updated with the - // [UpdateJob][google.cloud.talent.v4.JobService.UpdateJob] API or deleted - // with the [DeleteJob][google.cloud.talent.v4.JobService.DeleteJob] API. An - // expired job can be updated and opened again by using a future expiration - // timestamp. Updating an expired job fails if there is another existing open - // job with same [company][google.cloud.talent.v4.Job.company], - // [language_code][google.cloud.talent.v4.Job.language_code] and - // [requisition_id][google.cloud.talent.v4.Job.requisition_id]. + // expired job can't be listed by the [ListJobs][google.cloud.talent.v4.JobService.ListJobs] API, + // but it can be retrieved with the [GetJob][google.cloud.talent.v4.JobService.GetJob] API or + // updated with the [UpdateJob][google.cloud.talent.v4.JobService.UpdateJob] API or deleted with + // the [DeleteJob][google.cloud.talent.v4.JobService.DeleteJob] API. An expired job can + // be updated and opened again by using a future expiration timestamp. + // Updating an expired job fails if there is another existing open job with + // same [company][google.cloud.talent.v4.Job.company], [language_code][google.cloud.talent.v4.Job.language_code] and [requisition_id][google.cloud.talent.v4.Job.requisition_id]. // // The expired jobs are retained in our system for 90 days. However, the // overall expired job count cannot exceed 3 times the maximum number of @@ -328,13 +306,12 @@ message Job { // If the timestamp is before the instant request is made, the job // is treated as expired immediately on creation. This kind of job can // not be updated. And when creating a job with past timestamp, the - // [posting_publish_time][google.cloud.talent.v4.Job.posting_publish_time] - // must be set before - // [posting_expire_time][google.cloud.talent.v4.Job.posting_expire_time]. The - // purpose of this feature is to allow other objects, such as [Application][], - // to refer a job that didn't exist in the system prior to becoming expired. - // If you want to modify a job that was expired on creation, delete it and - // create a new one. + // [posting_publish_time][google.cloud.talent.v4.Job.posting_publish_time] must be set before + // [posting_expire_time][google.cloud.talent.v4.Job.posting_expire_time]. The purpose of this feature is + // to allow other objects, such as [Application][], to refer a job + // that didn't exist in the system prior to becoming expired. If you + // want to modify a job that was expired on creation, + // delete it and create a new one. // // If this value isn't provided at the time of job creation or is invalid, // the job posting expires after 30 days from the job's creation time. For @@ -342,22 +319,17 @@ message Job { // unspecified expiration date, the job expires after 2017/01/31 13:00AM UTC. // // If this value isn't provided on job update, it depends on the field masks - // set by - // [UpdateJobRequest.update_mask][google.cloud.talent.v4.UpdateJobRequest.update_mask]. - // If the field masks include - // [job_end_time][google.cloud.talent.v4.Job.job_end_time], or the masks are - // empty meaning that every field is updated, the job posting expires after 30 - // days from the job's last update time. Otherwise the expiration date isn't - // updated. + // set by [UpdateJobRequest.update_mask][google.cloud.talent.v4.UpdateJobRequest.update_mask]. If the field masks include + // [job_end_time][google.cloud.talent.v4.Job.job_end_time], or the masks are empty meaning that every field is + // updated, the job posting expires after 30 days from the job's last + // update time. Otherwise the expiration date isn't updated. google.protobuf.Timestamp posting_expire_time = 25; // Output only. The timestamp when this job posting was created. - google.protobuf.Timestamp posting_create_time = 26 - [(google.api.field_behavior) = OUTPUT_ONLY]; + google.protobuf.Timestamp posting_create_time = 26 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The timestamp when this job posting was last updated. - google.protobuf.Timestamp posting_update_time = 27 - [(google.api.field_behavior) = OUTPUT_ONLY]; + google.protobuf.Timestamp posting_update_time = 27 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Display name of the company listing the job. string company_display_name = 28 [(google.api.field_behavior) = OUTPUT_ONLY]; diff --git a/google/cloud/talent_v4/proto/tenant.proto b/google/cloud/talent_v4/proto/tenant.proto index a21fc06a..bdfa832d 100644 --- a/google/cloud/talent_v4/proto/tenant.proto +++ b/google/cloud/talent_v4/proto/tenant.proto @@ -16,9 +16,9 @@ syntax = "proto3"; package google.cloud.talent.v4; -import "google/api/annotations.proto"; import "google/api/field_behavior.proto"; import "google/api/resource.proto"; +import "google/api/annotations.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4;talent"; option java_multiple_files = true; @@ -45,8 +45,7 @@ message Tenant { // "projects/foo/tenants/bar". string name = 1; - // Required. Client side tenant identifier, used to uniquely identify the - // tenant. + // Required. Client side tenant identifier, used to uniquely identify the tenant. // // The maximum number of allowed characters is 255. string external_id = 2 [(google.api.field_behavior) = REQUIRED]; diff --git a/google/cloud/talent_v4/proto/tenant_service.proto b/google/cloud/talent_v4/proto/tenant_service.proto index 8941ba7f..a82d094f 100644 --- a/google/cloud/talent_v4/proto/tenant_service.proto +++ b/google/cloud/talent_v4/proto/tenant_service.proto @@ -106,22 +106,21 @@ message GetTenantRequest { // "projects/foo/tenants/bar". string name = 1 [ (google.api.field_behavior) = REQUIRED, - (google.api.resource_reference) = { type: "jobs.googleapis.com/Tenant" } + (google.api.resource_reference) = { + type: "jobs.googleapis.com/Tenant" + } ]; } // Request for updating a specified tenant. message UpdateTenantRequest { - // Required. The tenant resource to replace the current resource in the - // system. + // Required. The tenant resource to replace the current resource in the system. Tenant tenant = 1 [(google.api.field_behavior) = REQUIRED]; // Strongly recommended for the best service experience. // - // If [update_mask][google.cloud.talent.v4.UpdateTenantRequest.update_mask] is - // provided, only the specified fields in - // [tenant][google.cloud.talent.v4.UpdateTenantRequest.tenant] are updated. - // Otherwise all the fields are updated. + // If [update_mask][google.cloud.talent.v4.UpdateTenantRequest.update_mask] is provided, only the specified fields in + // [tenant][google.cloud.talent.v4.UpdateTenantRequest.tenant] are updated. Otherwise all the fields are updated. // // A field mask to specify the tenant fields to be updated. Only // top level fields of [Tenant][google.cloud.talent.v4.Tenant] are supported. @@ -136,7 +135,9 @@ message DeleteTenantRequest { // "projects/foo/tenants/bar". string name = 1 [ (google.api.field_behavior) = REQUIRED, - (google.api.resource_reference) = { type: "jobs.googleapis.com/Tenant" } + (google.api.resource_reference) = { + type: "jobs.googleapis.com/Tenant" + } ]; } diff --git a/google/cloud/talent_v4/types/common.py b/google/cloud/talent_v4/types/common.py index e4041fc4..13b73611 100644 --- a/google/cloud/talent_v4/types/common.py +++ b/google/cloud/talent_v4/types/common.py @@ -200,8 +200,6 @@ class CommuteMethod(proto.Enum): COMMUTE_METHOD_UNSPECIFIED = 0 DRIVING = 1 TRANSIT = 2 - WALKING = 3 - CYCLING = 4 class TimestampRange(proto.Message): diff --git a/google/cloud/talent_v4/types/tenant.py b/google/cloud/talent_v4/types/tenant.py index 0299d6a3..f28d172f 100644 --- a/google/cloud/talent_v4/types/tenant.py +++ b/google/cloud/talent_v4/types/tenant.py @@ -39,7 +39,6 @@ class Tenant(proto.Message): external_id (str): Required. Client side tenant identifier, used to uniquely identify the tenant. - The maximum number of allowed characters is 255. """ diff --git a/synth.metadata b/synth.metadata index 498d930d..65544c71 100644 --- a/synth.metadata +++ b/synth.metadata @@ -3,30 +3,30 @@ { "git": { "name": ".", - "remote": "git@github.com:googleapis/python-talent.git", - "sha": "f68f48ed16aacd669bafc829b2c3a8d3744aa05e" + "remote": "git@github.com:googleapis/python-talent", + "sha": "9863142855ba1a3771a8e63c8a2a595f13ed1fe4" } }, { "git": { "name": "googleapis", "remote": "https://github.com/googleapis/googleapis.git", - "sha": "2987612c6aacc1857ee35468e7aeb1c393460799", - "internalRef": "333583499" + "sha": "7e837ae45f7b66519a36fd258fe72f08e71725d4", + "internalRef": "334927472" } }, { "git": { "name": "synthtool", "remote": "https://github.com/googleapis/synthtool.git", - "sha": "da29da32b3a988457b49ae290112b74f14b713cc" + "sha": "0762e8ee2ec21cdfc4d82020b985a104feb0453b" } }, { "git": { "name": "synthtool", "remote": "https://github.com/googleapis/synthtool.git", - "sha": "da29da32b3a988457b49ae290112b74f14b713cc" + "sha": "0762e8ee2ec21cdfc4d82020b985a104feb0453b" } } ], diff --git a/synth.py b/synth.py index 78cbbc9e..bc3d5083 100644 --- a/synth.py +++ b/synth.py @@ -42,12 +42,6 @@ "[a-zA-Z][a-zA-Z0-9\_]" ) -# Escape '_' in docstrings -s.replace( - "google/cloud/**/*_pb2.py", - """\_$""", - """\_""", -) # ---------------------------------------------------------------------------- # Add templated files # ----------------------------------------------------------------------------