diff options
author | Google APIs <noreply@google.com> | 2019-04-08 20:04:28 -0700 |
---|---|---|
committer | Copybara-Service <copybara-worker@google.com> | 2019-04-08 20:04:56 -0700 |
commit | 2c0815acf6b4d7269f9d2a90a07cbb59a40e70b8 (patch) | |
tree | a418607710007246d423df020fbf35c38180e689 | |
parent | 9a02c5acecb43f38fae4fa52c6420f21c335b888 (diff) | |
download | googleapis-2c0815acf6b4d7269f9d2a90a07cbb59a40e70b8.tar.gz |
Synchronize new proto/yaml changes.
PiperOrigin-RevId: 242591107
-rw-r--r-- | google/cloud/talent/v4beta1/application.proto | 16 | ||||
-rw-r--r-- | google/cloud/talent/v4beta1/application_service.proto | 16 | ||||
-rw-r--r-- | google/cloud/talent/v4beta1/common.proto | 137 | ||||
-rw-r--r-- | google/cloud/talent/v4beta1/company.proto | 10 | ||||
-rw-r--r-- | google/cloud/talent/v4beta1/company_service.proto | 27 | ||||
-rw-r--r-- | google/cloud/talent/v4beta1/completion_service.proto | 39 | ||||
-rw-r--r-- | google/cloud/talent/v4beta1/event.proto | 30 | ||||
-rw-r--r-- | google/cloud/talent/v4beta1/filters.proto | 208 | ||||
-rw-r--r-- | google/cloud/talent/v4beta1/histogram.proto | 9 | ||||
-rw-r--r-- | google/cloud/talent/v4beta1/job.proto | 122 | ||||
-rw-r--r-- | google/cloud/talent/v4beta1/job_service.proto | 215 | ||||
-rw-r--r-- | google/cloud/talent/v4beta1/profile.proto | 169 | ||||
-rw-r--r-- | google/cloud/talent/v4beta1/profile_service.proto | 54 | ||||
-rw-r--r-- | google/cloud/talent/v4beta1/tenant.proto | 6 | ||||
-rw-r--r-- | google/cloud/talent/v4beta1/tenant_service.proto | 10 |
15 files changed, 371 insertions, 697 deletions
diff --git a/google/cloud/talent/v4beta1/application.proto b/google/cloud/talent/v4beta1/application.proto index 6c594df93..330afe82d 100644 --- a/google/cloud/talent/v4beta1/application.proto +++ b/google/cloud/talent/v4beta1/application.proto @@ -17,12 +17,12 @@ syntax = "proto3"; package google.cloud.talent.v4beta1; -import "google/api/annotations.proto"; import "google/cloud/talent/v4beta1/common.proto"; import "google/cloud/talent/v4beta1/job.proto"; import "google/protobuf/timestamp.proto"; import "google/protobuf/wrappers.proto"; import "google/type/date.proto"; +import "google/api/annotations.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent"; option java_multiple_files = true; @@ -120,8 +120,8 @@ message Application { // Resource name of the job which the candidate applied for. // // The format is - // "projects/{project_id}/jobs/{job_id}", - // for example, "projects/api-test-project/jobs/bar". + // "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}", + // for example, "projects/api-test-project/tenants/foo/jobs/bar". string job = 4; // One of either a job or a company is required. @@ -129,8 +129,8 @@ message Application { // Resource name of the company which the candidate applied for. // // The format is - // "projects/{project_id}/companies/{company_id}", - // for example, "projects/api-test-project/companies/foo". + // "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}", + // for example, "projects/api-test-project/tenants/foo/companies/bar". string company = 5; // Optional. @@ -153,9 +153,9 @@ message Application { // Optional. // - // All interviews (screen, onsite, etc) conducted as part of this application - // (includes details such as user conducting the interview, timestamp, - // feedback, etc). + // All interviews (screen, onsite, and so on) conducted as part of this + // application (includes details such as user conducting the interview, + // timestamp, feedback, and so on). repeated Interview interviews = 16; // Optional. diff --git a/google/cloud/talent/v4beta1/application_service.proto b/google/cloud/talent/v4beta1/application_service.proto index 3bd91bf2a..4ff4a026f 100644 --- a/google/cloud/talent/v4beta1/application_service.proto +++ b/google/cloud/talent/v4beta1/application_service.proto @@ -56,16 +56,14 @@ service ApplicationService { } // Deletes specified application. - rpc DeleteApplication(DeleteApplicationRequest) - returns (google.protobuf.Empty) { + rpc DeleteApplication(DeleteApplicationRequest) returns (google.protobuf.Empty) { option (google.api.http) = { delete: "/v4beta1/{name=projects/*/tenants/*/profiles/*/applications/*}" }; } // Lists all applications associated with the profile. - rpc ListApplications(ListApplicationsRequest) - returns (ListApplicationsResponse) { + rpc ListApplications(ListApplicationsRequest) returns (ListApplicationsResponse) { option (google.api.http) = { get: "/v4beta1/{parent=projects/*/tenants/*/profiles/*}/applications" }; @@ -112,15 +110,11 @@ message UpdateApplicationRequest { // Optional but strongly recommended for the best service // experience. // - // If - // [update_mask][google.cloud.talent.v4beta1.UpdateApplicationRequest.update_mask] - // is provided, only the specified fields in - // [application][google.cloud.talent.v4beta1.UpdateApplicationRequest.application] - // are updated. Otherwise all the fields are updated. + // If [update_mask][google.cloud.talent.v4beta1.UpdateApplicationRequest.update_mask] is provided, only the specified fields in + // [application][google.cloud.talent.v4beta1.UpdateApplicationRequest.application] are updated. Otherwise all the fields are updated. // // A field mask to specify the application fields to be updated. Only - // top level fields of [Application][google.cloud.talent.v4beta1.Application] - // are supported. + // top level fields of [Application][google.cloud.talent.v4beta1.Application] are supported. google.protobuf.FieldMask update_mask = 2; } diff --git a/google/cloud/talent/v4beta1/common.proto b/google/cloud/talent/v4beta1/common.proto index 80a44513e..370438862 100644 --- a/google/cloud/talent/v4beta1/common.proto +++ b/google/cloud/talent/v4beta1/common.proto @@ -21,7 +21,6 @@ import "google/api/annotations.proto"; import "google/protobuf/timestamp.proto"; import "google/protobuf/wrappers.proto"; import "google/type/date.proto"; -import "google/type/dayofweek.proto"; import "google/type/latlng.proto"; import "google/type/money.proto"; import "google/type/postal_address.proto"; @@ -256,8 +255,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.v4beta1.EmploymentType.CONTRACTOR] - // jobs. + // [EmploymentType.CONTRACTOR][google.cloud.talent.v4beta1.EmploymentType.CONTRACTOR] jobs. CONTRACT_TO_HIRE = 4; // The job is offered as a temporary employment opportunity, usually @@ -417,11 +415,10 @@ enum PostingRegion { POSTING_REGION_UNSPECIFIED = 0; // In addition to exact location matching, job posting is returned when the - // [LocationFilter][google.cloud.talent.v4beta1.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.v4beta1.LocationFilter] - // has "Mountain View". + // [LocationFilter][google.cloud.talent.v4beta1.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.v4beta1.LocationFilter] has + // "Mountain View". // // Administrative area refers to top-level administrative subdivision of this // country. For example, US state, IT region, UK constituent nation and @@ -429,11 +426,9 @@ enum PostingRegion { ADMINISTRATIVE_AREA = 1; // In addition to exact location matching, job is returned when - // [LocationFilter][google.cloud.talent.v4beta1.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.v4beta1.LocationFilter] has 'Mountain - // View'. + // [LocationFilter][google.cloud.talent.v4beta1.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.v4beta1.LocationFilter] has 'Mountain View'. NATION = 2; // Job allows employees to work remotely (telecommute). @@ -500,7 +495,7 @@ enum CommuteMethod { DRIVING = 1; // Commute time is calculated based on public transit including bus, metro, - // subway, etc. + // subway, and so on. TRANSIT = 2; // Commute time is calculated based on walking time. @@ -516,9 +511,7 @@ enum CommuteMethod { // 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.v4beta1.RequestMetadata.allow_missing_ids] - // is unset or `false`. + // Required if [allow_missing_ids][google.cloud.talent.v4beta1.RequestMetadata.allow_missing_ids] is unset or `false`. // // The client-defined scope or source of the service call, which typically // is the domain on @@ -535,9 +528,7 @@ message RequestMetadata { // The maximum number of allowed characters is 255. string domain = 1; - // Required if - // [allow_missing_ids][google.cloud.talent.v4beta1.RequestMetadata.allow_missing_ids] - // is unset or `false`. + // Required if [allow_missing_ids][google.cloud.talent.v4beta1.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 @@ -551,9 +542,7 @@ message RequestMetadata { // The maximum number of allowed characters is 255. string session_id = 2; - // Required if - // [allow_missing_ids][google.cloud.talent.v4beta1.RequestMetadata.allow_missing_ids] - // is unset or `false`. + // Required if [allow_missing_ids][google.cloud.talent.v4beta1.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 @@ -569,16 +558,10 @@ message RequestMetadata { // Optional. // - // If set to `true`, - // [domain][google.cloud.talent.v4beta1.RequestMetadata.domain], - // [session_id][google.cloud.talent.v4beta1.RequestMetadata.session_id] and - // [user_id][google.cloud.talent.v4beta1.RequestMetadata.user_id] are - // optional. Only set when any of these fields isn't available for some - // reason. It is highly recommended not to set this field and provide accurate - // [domain][google.cloud.talent.v4beta1.RequestMetadata.domain], - // [session_id][google.cloud.talent.v4beta1.RequestMetadata.session_id] and - // [user_id][google.cloud.talent.v4beta1.RequestMetadata.user_id] for the best - // service experience. + // If set to `true`, [domain][google.cloud.talent.v4beta1.RequestMetadata.domain], [session_id][google.cloud.talent.v4beta1.RequestMetadata.session_id] and [user_id][google.cloud.talent.v4beta1.RequestMetadata.user_id] are optional. + // Only set when any of these fields isn't available for some reason. It + // is highly recommended not to set this field and provide accurate + // [domain][google.cloud.talent.v4beta1.RequestMetadata.domain], [session_id][google.cloud.talent.v4beta1.RequestMetadata.session_id] and [user_id][google.cloud.talent.v4beta1.RequestMetadata.user_id] for the best service experience. bool allow_missing_ids = 4; // Optional. @@ -642,10 +625,8 @@ message DeviceInfo { // Custom attribute values that are either filterable or non-filterable. message CustomAttribute { - // Optional but exactly one of - // [string_values][google.cloud.talent.v4beta1.CustomAttribute.string_values] - // or [long_values][google.cloud.talent.v4beta1.CustomAttribute.long_values] - // must be specified. + // Optional but exactly one of [string_values][google.cloud.talent.v4beta1.CustomAttribute.string_values] or [long_values][google.cloud.talent.v4beta1.CustomAttribute.long_values] must + // be specified. // // This field is used to perform a string match (`CASE_SENSITIVE_MATCH` or // `CASE_INSENSITIVE_MATCH`) search. @@ -657,17 +638,13 @@ message CustomAttribute { // Empty string isn't allowed. repeated string string_values = 1; - // Optional but exactly one of - // [string_values][google.cloud.talent.v4beta1.CustomAttribute.string_values] - // or [long_values][google.cloud.talent.v4beta1.CustomAttribute.long_values] - // must be specified. + // Optional but exactly one of [string_values][google.cloud.talent.v4beta1.CustomAttribute.string_values] or [long_values][google.cloud.talent.v4beta1.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.v4beta1.CustomAttribute.long_values] is - // supported. + // Currently at most 1 [long_values][google.cloud.talent.v4beta1.CustomAttribute.long_values] is supported. repeated int64 long_values = 2; // Optional. @@ -705,17 +682,9 @@ 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.v4beta1.CompensationInfo.CompensationEntry.amount] - // or - // [range][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.range]. - // - and its - // [expected_units_per_year][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.expected_units_per_year] - // is set or can be derived. Its annualized range is determined as - // ([amount][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.amount] - // or - // [range][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.range]) - // times + // - it contains valid [amount][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.amount] or [range][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.range]. + // - and its [expected_units_per_year][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.expected_units_per_year] is set or can be derived. + // Its annualized range is determined as ([amount][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.amount] or [range][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.range]) times // [expected_units_per_year][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.expected_units_per_year]. message CompensationEntry { // Optional. @@ -729,8 +698,7 @@ message CompensationInfo { // // Frequency of the specified amount. // - // Default is - // [CompensationUnit.OTHER_COMPENSATION_UNIT][google.cloud.talent.v4beta1.CompensationInfo.CompensationUnit.OTHER_COMPENSATION_UNIT]. + // Default is [CompensationUnit.OTHER_COMPENSATION_UNIT][google.cloud.talent.v4beta1.CompensationInfo.CompensationUnit.OTHER_COMPENSATION_UNIT]. CompensationUnit unit = 2; // Optional. @@ -758,10 +726,8 @@ message CompensationInfo { // Optional. // // Expected number of units paid each year. If not specified, when - // [Job.employment_types][google.cloud.talent.v4beta1.Job.employment_types] - // is FULLTIME, a default value is inferred based on - // [unit][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.unit]. - // Default values: + // [Job.employment_types][google.cloud.talent.v4beta1.Job.employment_types] is FULLTIME, a default value is inferred + // based on [unit][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.unit]. Default values: // - HOURLY: 2080 // - DAILY: 260 // - WEEKLY: 52 @@ -791,30 +757,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.v4beta1.CompensationInfo.CompensationEntry.description]. + // describe the compensation scheme in the [CompensationEntry.description][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.description]. // // For example, tipping format is described in - // [CompensationEntry.description][google.cloud.talent.v4beta1.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.v4beta1.CompensationInfo.CompensationEntry.amount] - // or - // [CompensationEntry.range][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.range] - // ($10 per hour). + // [CompensationEntry.description][google.cloud.talent.v4beta1.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.v4beta1.CompensationInfo.CompensationEntry.amount] or [CompensationEntry.range][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.range] ($10 per hour). // - // For example, equity is described in - // [CompensationEntry.description][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.description] + // For example, equity is described in [CompensationEntry.description][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.description] // (for example, "1% - 2% equity vesting over 4 years, 1 year cliff") and - // value estimated in - // [CompensationEntry.amount][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.amount] - // or - // [CompensationEntry.range][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.range]. - // If no value estimate is possible, units are - // [CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED][google.cloud.talent.v4beta1.CompensationInfo.CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED] - // and then further clarified in - // [CompensationEntry.description][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.description] - // field. + // value estimated in [CompensationEntry.amount][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.amount] or + // [CompensationEntry.range][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.range]. If no value estimate is possible, units are + // [CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED][google.cloud.talent.v4beta1.CompensationInfo.CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED] and then further + // clarified in [CompensationEntry.description][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.description] field. enum CompensationType { // Default value. COMPENSATION_TYPE_UNSPECIFIED = 0; @@ -879,26 +834,22 @@ message CompensationInfo { // Job compensation information. // // At most one entry can be of type - // [CompensationInfo.CompensationType.BASE][google.cloud.talent.v4beta1.CompensationInfo.CompensationType.BASE], - // which is referred as ** base compensation entry ** for the job. + // [CompensationInfo.CompensationType.BASE][google.cloud.talent.v4beta1.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.compensation][] times // [CompensationEntry.expected_units_per_year][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.expected_units_per_year]. // - // See - // [CompensationEntry][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry] - // for explanation on compensation annualization. + // See [CompensationEntry][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry] for explanation on compensation annualization. CompensationRange annualized_base_compensation_range = 2; // Output only. Annualized total compensation range. Computed as // all compensation entries' [CompensationEntry.compensation][] times // [CompensationEntry.expected_units_per_year][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.expected_units_per_year]. // - // See - // [CompensationEntry][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry] - // for explanation on compensation annualization. + // See [CompensationEntry][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry] for explanation on compensation annualization. CompensationRange annualized_total_compensation_range = 3; } @@ -965,11 +916,9 @@ message Skill { // Number of characters allowed is 100,000. string context = 4; - // Output only. Skill name snippet shows how the - // [display_name][google.cloud.talent.v4beta1.Skill.display_name] is related - // to a search query. It's empty if the - // [display_name][google.cloud.talent.v4beta1.Skill.display_name] isn't - // related to the search query. + // Output only. Skill name snippet shows how the [display_name][google.cloud.talent.v4beta1.Skill.display_name] is related + // to a search query. It's empty if the [display_name][google.cloud.talent.v4beta1.Skill.display_name] isn't related to the + // search query. string skill_name_snippet = 5; } diff --git a/google/cloud/talent/v4beta1/company.proto b/google/cloud/talent/v4beta1/company.proto index 9228a9246..199df88b3 100644 --- a/google/cloud/talent/v4beta1/company.proto +++ b/google/cloud/talent/v4beta1/company.proto @@ -17,8 +17,8 @@ syntax = "proto3"; package google.cloud.talent.v4beta1; -import "google/api/annotations.proto"; import "google/cloud/talent/v4beta1/common.proto"; +import "google/api/annotations.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent"; option java_multiple_files = true; @@ -73,8 +73,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.v4beta1.Company.DerivedInfo.headquarters_location]. + // location wherever possible in [DerivedInfo.headquarters_location][google.cloud.talent.v4beta1.Company.DerivedInfo.headquarters_location]. string headquarters_address = 5; // Optional. @@ -115,9 +114,8 @@ message Company { // Optional. // - // A list of keys of filterable - // [Job.custom_attributes][google.cloud.talent.v4beta1.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.v4beta1.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/v4beta1/company_service.proto b/google/cloud/talent/v4beta1/company_service.proto index 010d25399..8af4b9ad4 100644 --- a/google/cloud/talent/v4beta1/company_service.proto +++ b/google/cloud/talent/v4beta1/company_service.proto @@ -47,7 +47,9 @@ service CompanyService { rpc GetCompany(GetCompanyRequest) returns (Company) { option (google.api.http) = { get: "/v4beta1/{name=projects/*/tenants/*/companies/*}" - additional_bindings { get: "/v4beta1/{name=projects/*/companies/*}" } + additional_bindings { + get: "/v4beta1/{name=projects/*/companies/*}" + } }; } @@ -68,7 +70,9 @@ service CompanyService { rpc DeleteCompany(DeleteCompanyRequest) returns (google.protobuf.Empty) { option (google.api.http) = { delete: "/v4beta1/{name=projects/*/tenants/*/companies/*}" - additional_bindings { delete: "/v4beta1/{name=projects/*/companies/*}" } + additional_bindings { + delete: "/v4beta1/{name=projects/*/companies/*}" + } }; } @@ -76,7 +80,9 @@ service CompanyService { rpc ListCompanies(ListCompaniesRequest) returns (ListCompaniesResponse) { option (google.api.http) = { get: "/v4beta1/{parent=projects/*/tenants/*}/companies" - additional_bindings { get: "/v4beta1/{parent=projects/*}/companies" } + additional_bindings { + get: "/v4beta1/{parent=projects/*}/companies" + } }; } } @@ -125,15 +131,11 @@ message UpdateCompanyRequest { // Optional but strongly recommended for the best service // experience. // - // If - // [update_mask][google.cloud.talent.v4beta1.UpdateCompanyRequest.update_mask] - // is provided, only the specified fields in - // [company][google.cloud.talent.v4beta1.UpdateCompanyRequest.company] are - // updated. Otherwise all the fields are updated. + // If [update_mask][google.cloud.talent.v4beta1.UpdateCompanyRequest.update_mask] is provided, only the specified fields in + // [company][google.cloud.talent.v4beta1.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.v4beta1.Company] are - // supported. + // top level fields of [Company][google.cloud.talent.v4beta1.Company] are supported. google.protobuf.FieldMask update_mask = 2; } @@ -182,9 +184,8 @@ message ListCompaniesRequest { // // Defaults to false. // - // If true, at most - // [page_size][google.cloud.talent.v4beta1.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.v4beta1.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/v4beta1/completion_service.proto b/google/cloud/talent/v4beta1/completion_service.proto index d2b4ef5aa..139e1e8ee 100644 --- a/google/cloud/talent/v4beta1/completion_service.proto +++ b/google/cloud/talent/v4beta1/completion_service.proto @@ -33,7 +33,9 @@ service Completion { rpc CompleteQuery(CompleteQueryRequest) returns (CompleteQueryResponse) { option (google.api.http) = { get: "/v4beta1/{parent=projects/*/tenants/*}:complete" - additional_bindings { get: "/v4beta1/{parent=projects/*}:complete" } + additional_bindings { + get: "/v4beta1/{parent=projects/*}:complete" + } }; } } @@ -95,25 +97,16 @@ message CompleteQueryRequest { // For more information, see // [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47). // - // For - // [CompletionType.JOB_TITLE][google.cloud.talent.v4beta1.CompleteQueryRequest.CompletionType.JOB_TITLE] - // type, only open jobs with the same - // [language_codes][google.cloud.talent.v4beta1.CompleteQueryRequest.language_codes] - // are returned. - // - // For - // [CompletionType.COMPANY_NAME][google.cloud.talent.v4beta1.CompleteQueryRequest.CompletionType.COMPANY_NAME] - // type, only companies having open jobs with the same - // [language_codes][google.cloud.talent.v4beta1.CompleteQueryRequest.language_codes] - // are returned. - // - // For - // [CompletionType.COMBINED][google.cloud.talent.v4beta1.CompleteQueryRequest.CompletionType.COMBINED] - // type, only open jobs with the same - // [language_codes][google.cloud.talent.v4beta1.CompleteQueryRequest.language_codes] - // or companies having open jobs with the same - // [language_codes][google.cloud.talent.v4beta1.CompleteQueryRequest.language_codes] - // are returned. + // For [CompletionType.JOB_TITLE][google.cloud.talent.v4beta1.CompleteQueryRequest.CompletionType.JOB_TITLE] type, only open jobs with the same + // [language_codes][google.cloud.talent.v4beta1.CompleteQueryRequest.language_codes] are returned. + // + // For [CompletionType.COMPANY_NAME][google.cloud.talent.v4beta1.CompleteQueryRequest.CompletionType.COMPANY_NAME] type, + // only companies having open jobs with the same [language_codes][google.cloud.talent.v4beta1.CompleteQueryRequest.language_codes] are + // returned. + // + // For [CompletionType.COMBINED][google.cloud.talent.v4beta1.CompleteQueryRequest.CompletionType.COMBINED] type, only open jobs with the same + // [language_codes][google.cloud.talent.v4beta1.CompleteQueryRequest.language_codes] or companies having open jobs with the same + // [language_codes][google.cloud.talent.v4beta1.CompleteQueryRequest.language_codes] are returned. // // The maximum number of allowed characters is 255. repeated string language_codes = 3; @@ -139,14 +132,12 @@ message CompleteQueryRequest { // Optional. // - // The scope of the completion. The defaults is - // [CompletionScope.PUBLIC][google.cloud.talent.v4beta1.CompleteQueryRequest.CompletionScope.PUBLIC]. + // The scope of the completion. The defaults is [CompletionScope.PUBLIC][google.cloud.talent.v4beta1.CompleteQueryRequest.CompletionScope.PUBLIC]. CompletionScope scope = 6; // Optional. // - // The completion topic. The default is - // [CompletionType.COMBINED][google.cloud.talent.v4beta1.CompleteQueryRequest.CompletionType.COMBINED]. + // The completion topic. The default is [CompletionType.COMBINED][google.cloud.talent.v4beta1.CompleteQueryRequest.CompletionType.COMBINED]. CompletionType type = 7; } diff --git a/google/cloud/talent/v4beta1/event.proto b/google/cloud/talent/v4beta1/event.proto index ba65b1e4f..74df4336c 100644 --- a/google/cloud/talent/v4beta1/event.proto +++ b/google/cloud/talent/v4beta1/event.proto @@ -107,9 +107,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.v4beta1.JobEvent.JobEventType.APPLICATION_START] - // or - // [JobEventType.APPLICATION_FINISH][google.cloud.talent.v4beta1.JobEvent.JobEventType.APPLICATION_FINISH] + // [JobEventType.APPLICATION_START][google.cloud.talent.v4beta1.JobEvent.JobEventType.APPLICATION_START] or [JobEventType.APPLICATION_FINISH][google.cloud.talent.v4beta1.JobEvent.JobEventType.APPLICATION_FINISH] // events. APPLICATION_QUICK_SUBMISSION = 6; @@ -129,12 +127,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.v4beta1.JobEvent.JobEventType.APPLICATION_START], - // [JobEventType.APPLICATION_FINISH][google.cloud.talent.v4beta1.JobEvent.JobEventType.APPLICATION_FINISH] - // or - // [JobEventType.VIEW][google.cloud.talent.v4beta1.JobEvent.JobEventType.VIEW] - // events. + // send [JobEventType.APPLICATION_START][google.cloud.talent.v4beta1.JobEvent.JobEventType.APPLICATION_START], + // [JobEventType.APPLICATION_FINISH][google.cloud.talent.v4beta1.JobEvent.JobEventType.APPLICATION_FINISH] or [JobEventType.VIEW][google.cloud.talent.v4beta1.JobEvent.JobEventType.VIEW] events. APPLICATION_REDIRECT_FROM_SEARCH = 9; // This event should be used when a company submits an application @@ -177,19 +171,16 @@ message JobEvent { // Required. // - // The type of the event (see - // [JobEventType][google.cloud.talent.v4beta1.JobEvent.JobEventType]). + // The type of the event (see [JobEventType][google.cloud.talent.v4beta1.JobEvent.JobEventType]). JobEventType type = 1; // Required. // - // The [job name(s)][google.cloud.talent.v4beta1.Job.name] associated with - // this event. For example, if this is an - // [impression][google.cloud.talent.v4beta1.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.v4beta1.JobEvent.JobEventType.VIEW] event, this - // field contains the identifier of the viewed job. + // The [job name(s)][google.cloud.talent.v4beta1.Job.name] associated with this event. + // For example, if this is an [impression][google.cloud.talent.v4beta1.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.v4beta1.JobEvent.JobEventType.VIEW] event, this field contains the + // identifier of the viewed job. repeated string jobs = 2; } @@ -218,8 +209,7 @@ message ProfileEvent { // Required. // - // The [profile name(s)][google.cloud.talent.v4beta1.Profile.name] associated - // with this client event. + // The [profile name(s)][google.cloud.talent.v4beta1.Profile.name] associated with this client event. repeated string profiles = 2; // Optional. diff --git a/google/cloud/talent/v4beta1/filters.proto b/google/cloud/talent/v4beta1/filters.proto index 67ec95440..4a8ae540d 100644 --- a/google/cloud/talent/v4beta1/filters.proto +++ b/google/cloud/talent/v4beta1/filters.proto @@ -17,7 +17,6 @@ syntax = "proto3"; package google.cloud.talent.v4beta1; -import "google/api/annotations.proto"; import "google/cloud/talent/v4beta1/application.proto"; import "google/cloud/talent/v4beta1/common.proto"; import "google/cloud/talent/v4beta1/job.proto"; @@ -28,6 +27,7 @@ import "google/protobuf/wrappers.proto"; import "google/type/date.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/v4beta1;talent"; option java_multiple_files = true; @@ -70,17 +70,15 @@ message JobQuery { // Optional. // // The location filter specifies geo-regions containing the jobs to - // search against. See - // [LocationFilter][google.cloud.talent.v4beta1.LocationFilter] for more - // information. + // search against. See [LocationFilter][google.cloud.talent.v4beta1.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.v4beta1.LocationFilter.distance_in_miles] - // parameter, the maximum provided distance is used for all locations. + // [LocationFilter.distance_in_miles][google.cloud.talent.v4beta1.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; @@ -123,17 +121,16 @@ message JobQuery { // Optional. // // This search filter is applied only to - // [Job.compensation_info][google.cloud.talent.v4beta1.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.v4beta1.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; // Optional. // // This filter specifies a structured syntax to match against the - // [Job.custom_attributes][google.cloud.talent.v4beta1.Job.custom_attributes] - // marked as `filterable`. + // [Job.custom_attributes][google.cloud.talent.v4beta1.Job.custom_attributes] marked as `filterable`. // // The syntax for this expression is a subset of SQL syntax. // @@ -168,8 +165,7 @@ message JobQuery { // Optional. // // The employment type filter specifies the employment type of jobs to - // search against, such as - // [EmploymentType.FULL_TIME][google.cloud.talent.v4beta1.EmploymentType.FULL_TIME]. + // search against, such as [EmploymentType.FULL_TIME][google.cloud.talent.v4beta1.EmploymentType.FULL_TIME]. // // If a value isn't specified, jobs in the search results includes any // employment type. @@ -225,9 +221,8 @@ message ProfileQuery { // If a location filter isn't specified, profiles fitting the other search // criteria are retrieved regardless of where they're located. // - // If - // [LocationFilter.negated][google.cloud.talent.v4beta1.LocationFilter.negated] - // is specified, the result doesn't contain profiles from that location. + // If [LocationFilter.negated][google.cloud.talent.v4beta1.LocationFilter.negated] is specified, the result doesn't contain + // profiles from that location. // // For example, search for profiles with addresses in "New York City". repeated LocationFilter location_filters = 2; @@ -241,9 +236,8 @@ message ProfileQuery { // If multiple values are specified, profiles are retrieved with any of the // specified job titles. // - // If - // [JobTitleFilter.negated][google.cloud.talent.v4beta1.JobTitleFilter.negated] - // is specified, the result won't contain profiles with the job titles. + // If [JobTitleFilter.negated][google.cloud.talent.v4beta1.JobTitleFilter.negated] is specified, the result won't contain + // profiles with the job titles. // // For example, search for profiles with a job title "Product Manager". repeated JobTitleFilter job_title_filters = 3; @@ -258,9 +252,8 @@ message ProfileQuery { // If multiple employer filters are specified, profiles with any matching // employers are retrieved. // - // If - // [EmployerFilter.negated][google.cloud.talent.v4beta1.EmployerFilter.negated] - // is specified, the result won't contain profiles that match the employers. + // If [EmployerFilter.negated][google.cloud.talent.v4beta1.EmployerFilter.negated] is specified, the result won't contain + // profiles that match the employers. // // For example, search for profiles that have working experience at "Google // LLC". @@ -276,9 +269,8 @@ message ProfileQuery { // If multiple education filters are specified, profiles that match any // education filters are retrieved. // - // If - // [EducationFilter.negated][google.cloud.talent.v4beta1.EducationFilter.negated] - // is specified, the result won't contain profiles that match the educations. + // If [EducationFilter.negated][google.cloud.talent.v4beta1.EducationFilter.negated] is specified, the result won't contain + // profiles that match the educations. // // For example, search for profiles with a master degree. repeated EducationFilter education_filters = 5; @@ -292,8 +284,8 @@ message ProfileQuery { // If multiple skill filters are specified, profiles that match any skill // filters are retrieved. // - // If [SkillFilter.negated][google.cloud.talent.v4beta1.SkillFilter.negated] - // is specified, the result won't contain profiles that match the skills. + // If [SkillFilter.negated][google.cloud.talent.v4beta1.SkillFilter.negated] is specified, the result won't contain profiles + // that match the skills. // // For example, search for profiles that have "Java" and "Python" in skill // list. @@ -339,25 +331,13 @@ message ProfileQuery { // Optional. // - // The application last stage filters specify the last stage of job - // application. - repeated ApplicationLastStageFilter application_last_stage_filters = 12; - - // Optional. - // // The application job filters specify the job applied for in the application. repeated ApplicationJobFilter application_job_filters = 13; // Optional. // - // The application status filters specify the status of job application. - repeated ApplicationStatusFilter application_status_filters = 14; - - // Optional. - // // This filter specifies a structured syntax to match against the - // [Profile.custom_attributes][google.cloud.talent.v4beta1.Profile.custom_attributes] - // that are marked as `filterable`. + // [Profile.custom_attributes][google.cloud.talent.v4beta1.Profile.custom_attributes] that are marked as `filterable`. // // The syntax for this expression is a subset of Google SQL syntax. // @@ -380,7 +360,7 @@ message ProfileQuery { // // Sample Query: // (key1 = "TEST" OR LOWER(key1)="test" OR NOT EMPTY(key1)) - string custom_field_filter = 15; + string custom_attribute_filter = 15; } // Input only. @@ -437,15 +417,12 @@ message LocationFilter { // Allows the client to return jobs without a // set location, specifically, telecommuting jobs (telecomuting is considered // by the service as a special location. - // [Job.posting_region][google.cloud.talent.v4beta1.Job.posting_region] - // indicates if a job permits telecommuting. If this field is set to - // [TelecommutePreference.TELECOMMUTE_ALLOWED][google.cloud.talent.v4beta1.LocationFilter.TelecommutePreference.TELECOMMUTE_ALLOWED], - // telecommuting jobs are searched, and - // [address][google.cloud.talent.v4beta1.LocationFilter.address] and - // [lat_lng][google.cloud.talent.v4beta1.LocationFilter.lat_lng] are ignored. - // If not set or set to - // [TelecommutePreference.TELECOMMUTE_EXCLUDED][google.cloud.talent.v4beta1.LocationFilter.TelecommutePreference.TELECOMMUTE_EXCLUDED], - // telecommute job are not searched. + // [Job.posting_region][google.cloud.talent.v4beta1.Job.posting_region] indicates if a job permits telecommuting. + // If this field is set to [TelecommutePreference.TELECOMMUTE_ALLOWED][google.cloud.talent.v4beta1.LocationFilter.TelecommutePreference.TELECOMMUTE_ALLOWED], + // telecommuting jobs are searched, and [address][google.cloud.talent.v4beta1.LocationFilter.address] and [lat_lng][google.cloud.talent.v4beta1.LocationFilter.lat_lng] are + // ignored. If not set or set to + // [TelecommutePreference.TELECOMMUTE_EXCLUDED][google.cloud.talent.v4beta1.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 @@ -475,14 +452,11 @@ 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.v4beta1.CompensationFilter.units]. Populate - // one or more - // [units][google.cloud.talent.v4beta1.CompensationFilter.units]. + // CompensationEntry's unit matches provided [units][google.cloud.talent.v4beta1.CompensationFilter.units]. + // Populate one or more [units][google.cloud.talent.v4beta1.CompensationFilter.units]. // - // See - // [CompensationInfo.CompensationEntry][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry] - // for definition of base compensation entry. + // See [CompensationInfo.CompensationEntry][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry] for definition of + // base compensation entry. UNIT_ONLY = 1; // Filter by `base compensation entry's` unit and amount / range. A job @@ -490,25 +464,18 @@ message CompensationFilter { // the base entry's unit matches provided [compensation_units][] and amount // or range overlaps with provided [compensation_range][]. // - // See - // [CompensationInfo.CompensationEntry][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry] - // for definition of base compensation entry. + // See [CompensationInfo.CompensationEntry][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry] for definition of + // base compensation entry. // - // Set exactly one - // [units][google.cloud.talent.v4beta1.CompensationFilter.units] and - // populate [range][google.cloud.talent.v4beta1.CompensationFilter.range]. + // Set exactly one [units][google.cloud.talent.v4beta1.CompensationFilter.units] and populate [range][google.cloud.talent.v4beta1.CompensationFilter.range]. UNIT_AND_AMOUNT = 2; // Filter by annualized base compensation amount and `base compensation - // entry's` unit. Populate - // [range][google.cloud.talent.v4beta1.CompensationFilter.range] and zero or - // more [units][google.cloud.talent.v4beta1.CompensationFilter.units]. + // entry's` unit. Populate [range][google.cloud.talent.v4beta1.CompensationFilter.range] and zero or more [units][google.cloud.talent.v4beta1.CompensationFilter.units]. ANNUALIZED_BASE_AMOUNT = 3; // Filter by annualized total compensation amount and `base compensation - // entry's` unit . Populate - // [range][google.cloud.talent.v4beta1.CompensationFilter.range] and zero or - // more [units][google.cloud.talent.v4beta1.CompensationFilter.units]. + // entry's` unit . Populate [range][google.cloud.talent.v4beta1.CompensationFilter.range] and zero or more [units][google.cloud.talent.v4beta1.CompensationFilter.units]. ANNUALIZED_TOTAL_AMOUNT = 4; } @@ -616,7 +583,7 @@ message JobTitleFilter { message SkillFilter { // Required. // - // The skill name. For example, "java", "j2ee", etc. + // The skill name. For example, "java", "j2ee", and so on. string skill = 1; // Optional. @@ -630,19 +597,16 @@ message SkillFilter { // // Employer filter of the search. message EmployerFilter { - // Enum indicating which set of - // [Profile.employment_records][google.cloud.talent.v4beta1.Profile.employment_records] - // to search against. + // Enum indicating which set of [Profile.employment_records][google.cloud.talent.v4beta1.Profile.employment_records] to search + // against. enum EmployerFilterMode { // Default value. EMPLOYER_FILTER_MODE_UNSPECIFIED = 0; - // Apply to all employers in - // [Profile.employment_records][google.cloud.talent.v4beta1.Profile.employment_records]. + // Apply to all employers in [Profile.employment_records][google.cloud.talent.v4beta1.Profile.employment_records]. ALL_EMPLOYMENT_RECORDS = 1; - // Apply only to current employer in - // [Profile.employment_records][google.cloud.talent.v4beta1.Profile.employment_records]. + // Apply only to current employer in [Profile.employment_records][google.cloud.talent.v4beta1.Profile.employment_records]. CURRENT_EMPLOYMENT_RECORDS_ONLY = 2; // Apply only to past (not current) employers in @@ -657,12 +621,9 @@ message EmployerFilter { // Optional. // - // Define set of - // [EmploymentRecord][google.cloud.talent.v4beta1.EmploymentRecord]s to search - // against. + // Define set of [EmploymentRecord][google.cloud.talent.v4beta1.EmploymentRecord]s to search against. // - // Defaults to - // [EmployerFilterMode.ALL_EMPLOYMENT_RECORDS][google.cloud.talent.v4beta1.EmployerFilter.EmployerFilterMode.ALL_EMPLOYMENT_RECORDS]. + // Defaults to [EmployerFilterMode.ALL_EMPLOYMENT_RECORDS][google.cloud.talent.v4beta1.EmployerFilter.EmployerFilterMode.ALL_EMPLOYMENT_RECORDS]. EmployerFilterMode mode = 2; // Optional. @@ -707,10 +668,7 @@ message EducationFilter { // Work experience filter. // // This filter is used to search for profiles with working experience length -// between -// [min_experience][google.cloud.talent.v4beta1.WorkExperienceFilter.min_experience] -// and -// [max_experience][google.cloud.talent.v4beta1.WorkExperienceFilter.max_experience]. +// between [min_experience][google.cloud.talent.v4beta1.WorkExperienceFilter.min_experience] and [max_experience][google.cloud.talent.v4beta1.WorkExperienceFilter.max_experience]. message WorkExperienceFilter { // Optional. // @@ -727,13 +685,9 @@ message WorkExperienceFilter { // // Application Date Range Filter. // -// The API matches profiles with -// [Application.application_date][google.cloud.talent.v4beta1.Application.application_date] -// between start date and end date (both boundaries are inclusive). The filter -// is ignored if both -// [start_date][google.cloud.talent.v4beta1.ApplicationDateFilter.start_date] -// and [end_date][google.cloud.talent.v4beta1.ApplicationDateFilter.end_date] -// are missing. +// The API matches profiles with [Application.application_date][google.cloud.talent.v4beta1.Application.application_date] between +// start date and end date (both boundaries are inclusive). The filter is +// ignored if both [start_date][google.cloud.talent.v4beta1.ApplicationDateFilter.start_date] and [end_date][google.cloud.talent.v4beta1.ApplicationDateFilter.end_date] are missing. message ApplicationDateFilter { // Optional. // @@ -755,33 +709,14 @@ message ApplicationOutcomeNotesFilter { // Required. // // User entered or selected outcome reason. The API does an exact match on the - // [Application.outcome_notes][google.cloud.talent.v4beta1.Application.outcome_notes] - // in profiles. + // [Application.outcome_notes][google.cloud.talent.v4beta1.Application.outcome_notes] in profiles. string outcome_notes = 1; // Optional. // // If true, The API excludes all candidates with any - // [Application.outcome_notes][google.cloud.talent.v4beta1.Application.outcome_notes] - // matching the outcome reason specified in the filter. - bool negated = 2; -} - -// Input only. -// -// Filter on Last Stage of Application. -message ApplicationLastStageFilter { - // Required. - // - // User entered or selected last stage the candidate reached in the - // application. The API does an exact match on the - // [Application.last_stage][] in profiles. - string last_stage = 1; - - // Optional. - // If true, The API excludes all candidates with any - // [Application.last_stage][] matching the last stage specified in the - // filter. + // [Application.outcome_notes][google.cloud.talent.v4beta1.Application.outcome_notes] matching the outcome reason specified in + // the filter. bool negated = 2; } @@ -791,55 +726,25 @@ message ApplicationLastStageFilter { message ApplicationJobFilter { // Optional. // - // The job resource name in the application. The API does an exact match on - // the [Job.name][google.cloud.talent.v4beta1.Job.name] of - // [Application.job][google.cloud.talent.v4beta1.Application.job] in profiles. - string job = 1; - - // Optional. - // // The job requisition id in the application. The API does an exact match on - // the [Job.requisistion_id][] of - // [Application.job][google.cloud.talent.v4beta1.Application.job] in profiles. + // the [Job.requisistion_id][] of [Application.job][google.cloud.talent.v4beta1.Application.job] in profiles. string job_requisition_id = 2; // Optional. // // The job title in the application. The API does an exact match on the - // [Job.title][google.cloud.talent.v4beta1.Job.title] of - // [Application.job][google.cloud.talent.v4beta1.Application.job] in profiles. + // [Job.title][google.cloud.talent.v4beta1.Job.title] of [Application.job][google.cloud.talent.v4beta1.Application.job] in profiles. string job_title = 3; // Optional. // - // If true, the API excludes all profiles with any - // [Application.job][google.cloud.talent.v4beta1.Application.job] matching the - // filters. + // If true, the API excludes all profiles with any [Application.job][google.cloud.talent.v4beta1.Application.job] + // matching the filters. bool negated = 4; } // Input only. // -// Filter on state of Application. -message ApplicationStatusFilter { - // Required. - // - // User entered or selected application state. The API does an exact match - // between the application state specified in this filter and the - // [Application.state][google.cloud.talent.v4beta1.Application.state] in - // profiles. - Application.ApplicationState application_state = 1; - - // Optional. - // - // If true, The API excludes all candidates with any - // [Application.state][google.cloud.talent.v4beta1.Application.state] matching - // the state specified in the filter. - bool negated = 2; -} - -// Input only. -// // Filter on create timestamp or update timestamp of profiles. message TimeFilter { // Time fields can be used in TimeFilter. @@ -872,7 +777,6 @@ message TimeFilter { // // Specifies which time field to filter profiles. // - // Defaults to - // [TimeField.CREATE_TIME][google.cloud.talent.v4beta1.TimeFilter.TimeField.CREATE_TIME]. + // Defaults to [TimeField.CREATE_TIME][google.cloud.talent.v4beta1.TimeFilter.TimeField.CREATE_TIME]. TimeField time_field = 3; } diff --git a/google/cloud/talent/v4beta1/histogram.proto b/google/cloud/talent/v4beta1/histogram.proto index 22c4f82df..a8caf39a0 100644 --- a/google/cloud/talent/v4beta1/histogram.proto +++ b/google/cloud/talent/v4beta1/histogram.proto @@ -17,8 +17,8 @@ syntax = "proto3"; package google.cloud.talent.v4beta1; -import "google/api/annotations.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent"; option java_multiple_files = true; @@ -33,11 +33,8 @@ message HistogramQuery { // An expression specifies a histogram request against matching resources // (for example, jobs, profiles) for searches. // - // See - // [SearchJobsRequest.histogram_queries][google.cloud.talent.v4beta1.SearchJobsRequest.histogram_queries] - // and - // [SearchProfilesRequest.histogram_queries][google.cloud.talent.v4beta1.SearchProfilesRequest.histogram_queries] - // for details about syntax. + // See [SearchJobsRequest.histogram_queries][google.cloud.talent.v4beta1.SearchJobsRequest.histogram_queries] and + // [SearchProfilesRequest.histogram_queries][google.cloud.talent.v4beta1.SearchProfilesRequest.histogram_queries] for details about syntax. string histogram_query = 1; } diff --git a/google/cloud/talent/v4beta1/job.proto b/google/cloud/talent/v4beta1/job.proto index 67f5c5d61..053634a9a 100644 --- a/google/cloud/talent/v4beta1/job.proto +++ b/google/cloud/talent/v4beta1/job.proto @@ -17,10 +17,10 @@ syntax = "proto3"; package google.cloud.talent.v4beta1; -import "google/api/annotations.proto"; import "google/cloud/talent/v4beta1/common.proto"; import "google/protobuf/timestamp.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent"; option java_multiple_files = true; @@ -29,17 +29,12 @@ option java_package = "com.google.cloud.talent.v4beta1"; 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.v4beta1.Company], which is the hiring entity -// responsible for the job. +// or "job requisition"). A job belongs to a [Company][google.cloud.talent.v4beta1.Company], which is the hiring +// entity responsible for the job. message Job { // Application related details of a job posting. message ApplicationInfo { - // Optional but at least one of - // [uris][google.cloud.talent.v4beta1.Job.ApplicationInfo.uris], - // [emails][google.cloud.talent.v4beta1.Job.ApplicationInfo.emails] or - // [instruction][google.cloud.talent.v4beta1.Job.ApplicationInfo.instruction] - // must be specified. + // Optional. // // Use this field to specify email address(es) to which resumes or // applications can be sent. @@ -47,11 +42,7 @@ message Job { // The maximum number of allowed characters for each entry is 255. repeated string emails = 1; - // Optional but at least one of - // [uris][google.cloud.talent.v4beta1.Job.ApplicationInfo.uris], - // [emails][google.cloud.talent.v4beta1.Job.ApplicationInfo.emails] or - // [instruction][google.cloud.talent.v4beta1.Job.ApplicationInfo.instruction] - // must be specified. + // Optional. // // Use this field to provide instructions, such as "Mail your application // to ...", that a candidate can follow to apply for the job. @@ -62,11 +53,7 @@ message Job { // The maximum number of allowed characters is 3,000. string instruction = 2; - // Optional but at least one of - // [uris][google.cloud.talent.v4beta1.Job.ApplicationInfo.uris], - // [emails][google.cloud.talent.v4beta1.Job.ApplicationInfo.emails] or - // [instruction][google.cloud.talent.v4beta1.Job.ApplicationInfo.instruction] - // must be specified. + // Optional. // // Use this URI field to direct an applicant to a website, for example to // link to an online application form. @@ -79,18 +66,13 @@ message Job { // // Derived details about the job posting. message DerivedInfo { - // Structured locations of the job, resolved from - // [Job.addresses][google.cloud.talent.v4beta1.Job.addresses]. + // Structured locations of the job, resolved from [Job.addresses][google.cloud.talent.v4beta1.Job.addresses]. // - // [locations][google.cloud.talent.v4beta1.Job.DerivedInfo.locations] are - // exactly matched to - // [Job.addresses][google.cloud.talent.v4beta1.Job.addresses] in the same + // [locations][google.cloud.talent.v4beta1.Job.DerivedInfo.locations] are exactly matched to [Job.addresses][google.cloud.talent.v4beta1.Job.addresses] in the same // order. repeated Location locations = 1; - // Job categories derived from - // [Job.title][google.cloud.talent.v4beta1.Job.title] and - // [Job.description][google.cloud.talent.v4beta1.Job.description]. + // Job categories derived from [Job.title][google.cloud.talent.v4beta1.Job.title] and [Job.description][google.cloud.talent.v4beta1.Job.description]. repeated JobCategory job_categories = 3; } @@ -117,8 +99,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.v4beta1.HtmlSanitization.SIMPLE_FORMATTING_ONLY]. + // Defaults to [HtmlSanitization.SIMPLE_FORMATTING_ONLY][google.cloud.talent.v4beta1.HtmlSanitization.SIMPLE_FORMATTING_ONLY]. HtmlSanitization html_sanitization = 2; } @@ -135,8 +116,7 @@ message Job { // example, "projects/api-test-project/jobs/1234". // // Use of this field in job queries and API calls is preferred over the use of - // [requisition_id][google.cloud.talent.v4beta1.Job.requisition_id] since this - // value is unique. + // [requisition_id][google.cloud.talent.v4beta1.Job.requisition_id] since this value is unique. string name = 1; // Required. @@ -156,10 +136,8 @@ message Job { // 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.v4beta1.Job.name], - // [language_code][google.cloud.talent.v4beta1.Job.language_code] and - // [requisition_id][google.cloud.talent.v4beta1.Job.requisition_id]. + // to be created if there is another job with the same [company][google.cloud.talent.v4beta1.Job.name], + // [language_code][google.cloud.talent.v4beta1.Job.language_code] and [requisition_id][google.cloud.talent.v4beta1.Job.requisition_id]. // // The maximum number of allowed characters is 255. string requisition_id = 3; @@ -175,10 +153,9 @@ message Job { // // 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.v4beta1.Job.responsibilities], - // [qualifications][google.cloud.talent.v4beta1.Job.qualifications], and other - // job characteristics. Use of these separate job fields is recommended. + // provided on the job object for [responsibilities][google.cloud.talent.v4beta1.Job.responsibilities], + // [qualifications][google.cloud.talent.v4beta1.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. @@ -195,22 +172,17 @@ 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.v4beta1.Job.requisition_id]s (e.g. - // 'ReqA' becomes 'ReqA-1', 'ReqA-2', etc.) as multiple jobs with the same - // [company][google.cloud.talent.v4beta1.Job.name][], [language_code][] and - // [requisition_id][google.cloud.talent.v4beta1.Job.requisition_id] are not - // allowed. If the original - // [requisition_id][google.cloud.talent.v4beta1.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.v4beta1.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.v4beta1.Job.name][], [language_code][] and + // [requisition_id][google.cloud.talent.v4beta1.Job.requisition_id] are not allowed. If the original [requisition_id][google.cloud.talent.v4beta1.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; - // Required. At least one field within - // [ApplicationInfo][google.cloud.talent.v4beta1.Job.ApplicationInfo] must be - // specified. + // Optional. // // Job application information. ApplicationInfo application_info = 7; @@ -280,11 +252,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.v4beta1.Job.description] is present, - // detected language code based on - // [Job.description][google.cloud.talent.v4beta1.Job.description] is assigned, - // otherwise defaults to 'en_US'. + // If this field is unspecified and [Job.description][google.cloud.talent.v4beta1.Job.description] is present, detected + // language code based on [Job.description][google.cloud.talent.v4beta1.Job.description] is assigned, otherwise + // defaults to 'en_US'. string language_code = 15; // Optional. @@ -307,8 +277,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.v4beta1.Job.description] field. + // as an alternative to using the more general [description][google.cloud.talent.v4beta1.Job.description] field. // // This field accepts and sanitizes HTML input, and also accepts // bold, italic, ordered list, and unordered list markup tags. @@ -319,8 +288,8 @@ message Job { // Optional. // // A description of job responsibilities. The use of this field is - // recommended as an alternative to using the more general - // [description][google.cloud.talent.v4beta1.Job.description] field. + // recommended as an alternative to using the more general [description][google.cloud.talent.v4beta1.Job.description] + // field. // // This field accepts and sanitizes HTML input, and also accepts // bold, italic, ordered list, and unordered list markup tags. @@ -330,25 +299,20 @@ message Job { // Optional. // - // The job [PostingRegion][google.cloud.talent.v4beta1.PostingRegion] (for - // example, state, country) throughout which the job is available. If this - // field is set, a - // [LocationFilter][google.cloud.talent.v4beta1.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.v4beta1.PostingRegion.NATION] or - // [PostingRegion.ADMINISTRATIVE_AREA][google.cloud.talent.v4beta1.PostingRegion.ADMINISTRATIVE_AREA], - // setting job [Job.addresses][google.cloud.talent.v4beta1.Job.addresses] to - // the same location level as this field is strongly recommended. + // The job [PostingRegion][google.cloud.talent.v4beta1.PostingRegion] (for example, state, country) throughout + // which the job is available. If this field is set, a [LocationFilter][google.cloud.talent.v4beta1.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.v4beta1.PostingRegion.NATION] or [PostingRegion.ADMINISTRATIVE_AREA][google.cloud.talent.v4beta1.PostingRegion.ADMINISTRATIVE_AREA], + // setting job [Job.addresses][google.cloud.talent.v4beta1.Job.addresses] to the same location level as this field + // is strongly recommended. PostingRegion posting_region = 20; // Optional. // // The visibility of the job. // - // Defaults to - // [Visibility.ACCOUNT_ONLY][google.cloud.talent.v4beta1.Visibility.ACCOUNT_ONLY] - // if not specified. + // Defaults to [Visibility.ACCOUNT_ONLY][google.cloud.talent.v4beta1.Visibility.ACCOUNT_ONLY] if not specified. Visibility visibility = 21; // Optional. @@ -380,8 +344,7 @@ message Job { // updated with the [UpdateJob][] 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.v4beta1.Job.name][], [language_code][] and - // [requisition_id][google.cloud.talent.v4beta1.Job.requisition_id]. + // [company][google.cloud.talent.v4beta1.Job.name][], [language_code][] and [requisition_id][google.cloud.talent.v4beta1.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 of open jobs @@ -400,11 +363,10 @@ 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.v4beta1.UpdateJobRequest.update_mask]. - // If the field masks include [expiry_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.v4beta1.UpdateJobRequest.update_mask]. If the field masks include + // [expiry_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. diff --git a/google/cloud/talent/v4beta1/job_service.proto b/google/cloud/talent/v4beta1/job_service.proto index dd49339a2..314ac1298 100644 --- a/google/cloud/talent/v4beta1/job_service.proto +++ b/google/cloud/talent/v4beta1/job_service.proto @@ -18,7 +18,6 @@ syntax = "proto3"; package google.cloud.talent.v4beta1; import "google/api/annotations.proto"; -import "google/cloud/talent/v4beta1/batch.proto"; import "google/cloud/talent/v4beta1/common.proto"; import "google/cloud/talent/v4beta1/filters.proto"; import "google/cloud/talent/v4beta1/histogram.proto"; @@ -56,7 +55,9 @@ service JobService { rpc GetJob(GetJobRequest) returns (Job) { option (google.api.http) = { get: "/v4beta1/{name=projects/*/tenants/*/jobs/*}" - additional_bindings { get: "/v4beta1/{name=projects/*/jobs/*}" } + additional_bindings { + get: "/v4beta1/{name=projects/*/jobs/*}" + } }; } @@ -82,7 +83,9 @@ service JobService { rpc DeleteJob(DeleteJobRequest) returns (google.protobuf.Empty) { option (google.api.http) = { delete: "/v4beta1/{name=projects/*/tenants/*/jobs/*}" - additional_bindings { delete: "/v4beta1/{name=projects/*/jobs/*}" } + additional_bindings { + delete: "/v4beta1/{name=projects/*/jobs/*}" + } }; } @@ -90,7 +93,9 @@ service JobService { rpc ListJobs(ListJobsRequest) returns (ListJobsResponse) { option (google.api.http) = { get: "/v4beta1/{parent=projects/*/tenants/*}/jobs" - additional_bindings { get: "/v4beta1/{parent=projects/*}/jobs" } + additional_bindings { + get: "/v4beta1/{parent=projects/*}/jobs" + } }; } @@ -105,13 +110,11 @@ service JobService { }; } - // Searches for jobs using the provided - // [SearchJobsRequest][google.cloud.talent.v4beta1.SearchJobsRequest]. + // Searches for jobs using the provided [SearchJobsRequest][google.cloud.talent.v4beta1.SearchJobsRequest]. // - // This call constrains the - // [visibility][google.cloud.talent.v4beta1.Job.visibility] of jobs present in - // the database, and only returns jobs that the caller has permission to - // search against. + // This call constrains the [visibility][google.cloud.talent.v4beta1.Job.visibility] of jobs + // present in the database, and only returns jobs that the caller has + // permission to search against. rpc SearchJobs(SearchJobsRequest) returns (SearchJobsResponse) { option (google.api.http) = { post: "/v4beta1/{parent=projects/*/tenants/*}/jobs:search" @@ -123,18 +126,16 @@ service JobService { }; } - // Searches for jobs using the provided - // [SearchJobsRequest][google.cloud.talent.v4beta1.SearchJobsRequest]. + // Searches for jobs using the provided [SearchJobsRequest][google.cloud.talent.v4beta1.SearchJobsRequest]. // // This API call is intended for the use case of targeting passive job // seekers (for example, job seekers who have signed up to receive email // alerts about potential job opportunities), and has different algorithmic // adjustments that are targeted to passive job seekers. // - // This call constrains the - // [visibility][google.cloud.talent.v4beta1.Job.visibility] of jobs present in - // the database, and only returns jobs the caller has permission to search - // against. + // This call constrains the [visibility][google.cloud.talent.v4beta1.Job.visibility] of jobs + // present in the database, and only returns jobs the caller has + // permission to search against. rpc SearchJobsForAlert(SearchJobsRequest) returns (SearchJobsResponse) { option (google.api.http) = { post: "/v4beta1/{parent=projects/*/tenants/*}/jobs:searchForAlert" @@ -197,10 +198,8 @@ message UpdateJobRequest { // Optional but strongly recommended to be provided for the best service // experience. // - // If [update_mask][google.cloud.talent.v4beta1.UpdateJobRequest.update_mask] - // is provided, only the specified fields in - // [job][google.cloud.talent.v4beta1.UpdateJobRequest.job] are updated. - // Otherwise all the fields are updated. + // If [update_mask][google.cloud.talent.v4beta1.UpdateJobRequest.update_mask] is provided, only the specified fields in + // [job][google.cloud.talent.v4beta1.UpdateJobRequest.job] are updated. Otherwise all the fields are updated. // // A field mask to restrict the fields that are updated. Only // top level fields of [Job][google.cloud.talent.v4beta1.Job] are supported. @@ -301,11 +300,8 @@ message ListJobsRequest { // // The maximum number of jobs to be returned per page of results. // - // If [job_view][google.cloud.talent.v4beta1.ListJobsRequest.job_view] is set - // to - // [JobView.JOB_VIEW_ID_ONLY][google.cloud.talent.v4beta1.JobView.JOB_VIEW_ID_ONLY], - // the maximum allowed page size is 1000. Otherwise, the maximum allowed page - // size is 100. + // If [job_view][google.cloud.talent.v4beta1.ListJobsRequest.job_view] is set to [JobView.JOB_VIEW_ID_ONLY][google.cloud.talent.v4beta1.JobView.JOB_VIEW_ID_ONLY], the maximum allowed + // page size is 1000. Otherwise, the maximum allowed page size is 100. // // Default is 100 if empty or a number < 1 is specified. int32 page_size = 4; @@ -313,43 +309,31 @@ message ListJobsRequest { // Optional. // // The desired job attributes returned for jobs in the - // search response. Defaults to - // [JobView.JOB_VIEW_FULL][google.cloud.talent.v4beta1.JobView.JOB_VIEW_FULL] - // if no value is specified. + // search response. Defaults to [JobView.JOB_VIEW_FULL][google.cloud.talent.v4beta1.JobView.JOB_VIEW_FULL] if no value is + // specified. JobView job_view = 5; } // An enum that specifies the job attributes that are returned in the -// [MatchingJob.Job][] in -// [SearchJobsResponse][google.cloud.talent.v4beta1.SearchJobsResponse] or -// [Job][google.cloud.talent.v4beta1.Job] objects in +// [MatchingJob.Job][] in [SearchJobsResponse][google.cloud.talent.v4beta1.SearchJobsResponse] or [Job][google.cloud.talent.v4beta1.Job] objects in // [ListJobsResponse][google.cloud.talent.v4beta1.ListJobsResponse]. enum JobView { // Default value. JOB_VIEW_UNSPECIFIED = 0; // A ID only view of job, with following attributes: - // [Job.name][google.cloud.talent.v4beta1.Job.name], - // [Job.requisition_id][google.cloud.talent.v4beta1.Job.requisition_id], - // [Job.language_code][google.cloud.talent.v4beta1.Job.language_code]. + // [Job.name][google.cloud.talent.v4beta1.Job.name], [Job.requisition_id][google.cloud.talent.v4beta1.Job.requisition_id], [Job.language_code][google.cloud.talent.v4beta1.Job.language_code]. JOB_VIEW_ID_ONLY = 1; // A minimal view of the job, with the following attributes: - // [Job.name][google.cloud.talent.v4beta1.Job.name], - // [Job.requisition_id][google.cloud.talent.v4beta1.Job.requisition_id], - // [Job.job_title][], [Job.company][google.cloud.talent.v4beta1.Job.company], - // [Job.DerivedInfo.locations][google.cloud.talent.v4beta1.Job.DerivedInfo.locations], - // [Job.language_code][google.cloud.talent.v4beta1.Job.language_code]. + // [Job.name][google.cloud.talent.v4beta1.Job.name], [Job.requisition_id][google.cloud.talent.v4beta1.Job.requisition_id], [Job.job_title][], + // [Job.company][google.cloud.talent.v4beta1.Job.company], [Job.DerivedInfo.locations][google.cloud.talent.v4beta1.Job.DerivedInfo.locations], [Job.language_code][google.cloud.talent.v4beta1.Job.language_code]. JOB_VIEW_MINIMAL = 2; // A small view of the job, with the following attributes in the search - // results: [Job.name][google.cloud.talent.v4beta1.Job.name], - // [Job.requisition_id][google.cloud.talent.v4beta1.Job.requisition_id], - // [Job.job_title][], [Job.company][google.cloud.talent.v4beta1.Job.company], - // [Job.DerivedInfo.locations][google.cloud.talent.v4beta1.Job.DerivedInfo.locations], - // [Job.visibility][google.cloud.talent.v4beta1.Job.visibility], - // [Job.language_code][google.cloud.talent.v4beta1.Job.language_code], - // [Job.description][google.cloud.talent.v4beta1.Job.description]. + // results: [Job.name][google.cloud.talent.v4beta1.Job.name], [Job.requisition_id][google.cloud.talent.v4beta1.Job.requisition_id], [Job.job_title][], + // [Job.company][google.cloud.talent.v4beta1.Job.company], [Job.DerivedInfo.locations][google.cloud.talent.v4beta1.Job.DerivedInfo.locations], [Job.visibility][google.cloud.talent.v4beta1.Job.visibility], + // [Job.language_code][google.cloud.talent.v4beta1.Job.language_code], [Job.description][google.cloud.talent.v4beta1.Job.description]. JOB_VIEW_SMALL = 3; // All available attributes are included in the search results. @@ -380,11 +364,9 @@ message ListJobsResponse { message SearchJobsRequest { // Input only. // - // Custom ranking information for - // [SearchJobsRequest][google.cloud.talent.v4beta1.SearchJobsRequest]. + // Custom ranking information for [SearchJobsRequest][google.cloud.talent.v4beta1.SearchJobsRequest]. message CustomRankingInfo { - // The importance level for - // [CustomRankingInfo.ranking_expression][google.cloud.talent.v4beta1.SearchJobsRequest.CustomRankingInfo.ranking_expression]. + // The importance level for [CustomRankingInfo.ranking_expression][google.cloud.talent.v4beta1.SearchJobsRequest.CustomRankingInfo.ranking_expression]. enum ImportanceLevel { // Default value if the importance level isn't specified. IMPORTANCE_LEVEL_UNSPECIFIED = 0; @@ -423,8 +405,8 @@ message SearchJobsRequest { // Required. // // Controls over how important the score of - // [CustomRankingInfo.ranking_expression][google.cloud.talent.v4beta1.SearchJobsRequest.CustomRankingInfo.ranking_expression] - // gets applied to job's final ranking position. + // [CustomRankingInfo.ranking_expression][google.cloud.talent.v4beta1.SearchJobsRequest.CustomRankingInfo.ranking_expression] gets applied to job's final + // ranking position. // // An error is thrown if not specified. ImportanceLevel importance_level = 1; @@ -438,10 +420,8 @@ message SearchJobsRequest { // The syntax for this expression is a subset of Google SQL syntax. // // Supported operators are: +, -, *, /, where the left and right side of - // the operator is either a numeric - // [Job.custom_attributes][google.cloud.talent.v4beta1.Job.custom_attributes] - // key, integer/double value or an expression that can be evaluated to a - // number. + // the operator is either a numeric [Job.custom_attributes][google.cloud.talent.v4beta1.Job.custom_attributes] key, + // integer/double value or an expression that can be evaluated to a number. // // Parenthesis are supported to adjust calculation precedence. The // expression must be < 100 characters in length. @@ -505,8 +485,7 @@ message SearchJobsRequest { // // Mode of a search. // - // Defaults to - // [SearchMode.JOB_SEARCH][google.cloud.talent.v4beta1.SearchJobsRequest.SearchMode.JOB_SEARCH]. + // Defaults to [SearchMode.JOB_SEARCH][google.cloud.talent.v4beta1.SearchJobsRequest.SearchMode.JOB_SEARCH]. SearchMode search_mode = 2; // Required. @@ -578,23 +557,19 @@ message SearchJobsRequest { // Job histogram facets: // // * company_id: histogram by [Job.distributor_company_id][]. - // * company_display_name: histogram by - // [Job.company_display_name][google.cloud.talent.v4beta1.Job.company_display_name]. - // * employment_type: histogram by - // [Job.employment_types][google.cloud.talent.v4beta1.Job.employment_types], - // for example, "FULL_TIME", "PART_TIME". - // * company_size: histogram by - // [CompanySize][google.cloud.talent.v4beta1.CompanySize], for example, - // "SMALL", "MEDIUM", "BIG". + // * company_display_name: histogram by [Job.company_display_name][google.cloud.talent.v4beta1.Job.company_display_name]. + // * employment_type: histogram by [Job.employment_types][google.cloud.talent.v4beta1.Job.employment_types], for example, + // "FULL_TIME", "PART_TIME". + // * company_size: histogram by [CompanySize][google.cloud.talent.v4beta1.CompanySize], for example, "SMALL", + // "MEDIUM", "BIG". // * publish_time_in_month: histogram by the [Job.publish_time][] in months. // Must specify list of numeric buckets in spec. // * publish_time_in_year: histogram by the [Job.publish_time][] in years. // Must specify list of numeric buckets in spec. // * degree_type: histogram by the [Job.degree_type][], for example, // "Bachelors", "Masters". - // * job_level: histogram by the - // [Job.job_level][google.cloud.talent.v4beta1.Job.job_level], for example, - // "Entry Level". + // * job_level: histogram by the [Job.job_level][google.cloud.talent.v4beta1.Job.job_level], for example, "Entry + // Level". // * country: histogram by the country code of jobs, for example, "US", "FR". // * admin1: histogram by the admin1 code of jobs, which is a global // placeholder referring to the state, province, or the particular term a @@ -608,14 +583,11 @@ message SearchJobsRequest { // and longitude), for example, 37.4038522,-122.0987765. Since the coordinates // of a city center can change, customers may need to refresh them // periodically. - // * locale: histogram by the - // [Job.language_code][google.cloud.talent.v4beta1.Job.language_code], for - // example, "en-US", "fr-FR". - // * language: histogram by the language subtag of the - // [Job.language_code][google.cloud.talent.v4beta1.Job.language_code], for - // example, "en", "fr". - // * category: histogram by the - // [JobCategory][google.cloud.talent.v4beta1.JobCategory], for example, + // * locale: histogram by the [Job.language_code][google.cloud.talent.v4beta1.Job.language_code], for example, "en-US", + // "fr-FR". + // * language: histogram by the language subtag of the [Job.language_code][google.cloud.talent.v4beta1.Job.language_code], + // for example, "en", "fr". + // * category: histogram by the [JobCategory][google.cloud.talent.v4beta1.JobCategory], for example, // "COMPUTER_AND_IT", "HEALTHCARE". // * base_compensation_unit: histogram by the [CompensationUnit][] of base // salary, for example, "WEEKLY", "MONTHLY". @@ -625,12 +597,10 @@ message SearchJobsRequest { // Must specify list of numeric buckets to group results by. // * annualized_total_compensation: histogram by the total annualized salary. // Must specify list of numeric buckets to group results by. - // * string_custom_attribute: histogram by string - // [Job.custom_attributes][google.cloud.talent.v4beta1.Job.custom_attributes]. + // * string_custom_attribute: histogram by string [Job.custom_attributes][google.cloud.talent.v4beta1.Job.custom_attributes]. // Values can be accessed via square bracket notations like // string_custom_attribute["key1"]. - // * numeric_custom_attribute: histogram by numeric - // [Job.custom_attributes][google.cloud.talent.v4beta1.Job.custom_attributes]. + // * numeric_custom_attribute: histogram by numeric [Job.custom_attributes][google.cloud.talent.v4beta1.Job.custom_attributes]. // Values can be accessed via square bracket notations like // numeric_custom_attribute["key1"]. Must specify list of numeric buckets to // group results by. @@ -654,9 +624,7 @@ message SearchJobsRequest { // // An integer that specifies the current offset (that is, starting result // location, amongst the jobs deemed by the API as relevant) in search - // results. This field is only considered if - // [page_token][google.cloud.talent.v4beta1.SearchJobsRequest.page_token] is - // unset. + // results. This field is only considered if [page_token][google.cloud.talent.v4beta1.SearchJobsRequest.page_token] is unset. // // For example, 0 means to return results starting from the first matching // job, and 10 means to return from the 11th job. This can be used for @@ -674,9 +642,8 @@ message SearchJobsRequest { // Optional. // // The token specifying the current offset within - // search results. See - // [SearchJobsResponse.next_page_token][google.cloud.talent.v4beta1.SearchJobsResponse.next_page_token] - // for an explanation of how to obtain the next set of query results. + // search results. See [SearchJobsResponse.next_page_token][google.cloud.talent.v4beta1.SearchJobsResponse.next_page_token] for + // an explanation of how to obtain the next set of query results. string page_token = 11; // Optional. @@ -689,31 +656,28 @@ message SearchJobsRequest { // * "relevance desc": By relevance descending, as determined by the API // algorithms. Relevance thresholding of query results is only available // with this ordering. - // * "posting`_`publish`_`time desc": By - // [Job.posting_publish_time][google.cloud.talent.v4beta1.Job.posting_publish_time] + // * "posting`_`publish`_`time desc": By [Job.posting_publish_time][google.cloud.talent.v4beta1.Job.posting_publish_time] // descending. - // * "posting`_`update`_`time desc": By - // [Job.posting_update_time][google.cloud.talent.v4beta1.Job.posting_update_time] + // * "posting`_`update`_`time desc": By [Job.posting_update_time][google.cloud.talent.v4beta1.Job.posting_update_time] // descending. // * "title": By [Job.title][google.cloud.talent.v4beta1.Job.title] ascending. - // * "title desc": By [Job.title][google.cloud.talent.v4beta1.Job.title] - // descending. + // * "title desc": By [Job.title][google.cloud.talent.v4beta1.Job.title] descending. // * "annualized`_`base`_`compensation": By job's - // [CompensationInfo.annualized_base_compensation_range][google.cloud.talent.v4beta1.CompensationInfo.annualized_base_compensation_range] - // ascending. Jobs whose annualized base compensation is unspecified are put - // at the end of search results. + // [CompensationInfo.annualized_base_compensation_range][google.cloud.talent.v4beta1.CompensationInfo.annualized_base_compensation_range] ascending. Jobs + // whose annualized base compensation is unspecified are put at the end of + // search results. // * "annualized`_`base`_`compensation desc": By job's - // [CompensationInfo.annualized_base_compensation_range][google.cloud.talent.v4beta1.CompensationInfo.annualized_base_compensation_range] - // descending. Jobs whose annualized base compensation is unspecified are put - // at the end of search results. + // [CompensationInfo.annualized_base_compensation_range][google.cloud.talent.v4beta1.CompensationInfo.annualized_base_compensation_range] descending. Jobs + // whose annualized base compensation is unspecified are put at the end of + // search results. // * "annualized`_`total`_`compensation": By job's - // [CompensationInfo.annualized_total_compensation_range][google.cloud.talent.v4beta1.CompensationInfo.annualized_total_compensation_range] - // ascending. Jobs whose annualized base compensation is unspecified are put - // at the end of search results. + // [CompensationInfo.annualized_total_compensation_range][google.cloud.talent.v4beta1.CompensationInfo.annualized_total_compensation_range] ascending. Jobs + // whose annualized base compensation is unspecified are put at the end of + // search results. // * "annualized`_`total`_`compensation desc": By job's - // [CompensationInfo.annualized_total_compensation_range][google.cloud.talent.v4beta1.CompensationInfo.annualized_total_compensation_range] - // descending. Jobs whose annualized base compensation is unspecified are put - // at the end of search results. + // [CompensationInfo.annualized_total_compensation_range][google.cloud.talent.v4beta1.CompensationInfo.annualized_total_compensation_range] descending. Jobs + // whose annualized base compensation is unspecified are put at the end of + // search results. // * "custom`_`ranking desc": By the relevance score adjusted to the // [SearchJobsRequest.custom_ranking_info.ranking_expression][] with weight // factor assigned by @@ -743,9 +707,8 @@ message SearchJobsRequest { // displayed to the job seeker higher up in the results, with the other jobs // being displayed lower down in the results. // - // Defaults to - // [DiversificationLevel.SIMPLE][google.cloud.talent.v4beta1.SearchJobsRequest.DiversificationLevel.SIMPLE] - // if no value is specified. + // Defaults to [DiversificationLevel.SIMPLE][google.cloud.talent.v4beta1.SearchJobsRequest.DiversificationLevel.SIMPLE] if no value + // is specified. DiversificationLevel diversification_level = 13; // Optional. @@ -757,16 +720,13 @@ message SearchJobsRequest { // Optional. // // Controls whether to disable exact keyword match on [Job.job_title][], - // [Job.description][google.cloud.talent.v4beta1.Job.description], - // [Job.company_display_name][google.cloud.talent.v4beta1.Job.company_display_name], - // [Job.locations][0], - // [Job.qualifications][google.cloud.talent.v4beta1.Job.qualifications]. When - // disable keyword match is turned off, a keyword match returns jobs that do - // not match given category filters when there are matching keywords. For - // example, for the query "program manager," a result is returned even if the - // job posting has the title "software developer," which doesn't fall into - // "program manager" ontology, but does have "program manager" appearing in - // its description. + // [Job.description][google.cloud.talent.v4beta1.Job.description], [Job.company_display_name][google.cloud.talent.v4beta1.Job.company_display_name], [Job.locations][0], + // [Job.qualifications][google.cloud.talent.v4beta1.Job.qualifications]. When disable keyword match is turned off, a + // keyword match returns jobs that do not match given category filters when + // there are matching keywords. For example, for the query "program manager," + // a result is returned even if the job posting has the title "software + // developer," which doesn't fall into "program manager" ontology, but does + // have "program manager" appearing in its description. // // For queries like "cloud" that don't contain title or // location specific ontology, jobs with "cloud" keyword matches are returned @@ -787,11 +747,9 @@ message SearchJobsRequest { message SearchJobsResponse { // Output only. // - // Job entry with metadata inside - // [SearchJobsResponse][google.cloud.talent.v4beta1.SearchJobsResponse]. + // Job entry with metadata inside [SearchJobsResponse][google.cloud.talent.v4beta1.SearchJobsResponse]. message MatchingJob { - // Job resource that matches the specified - // [SearchJobsRequest][google.cloud.talent.v4beta1.SearchJobsRequest]. + // Job resource that matches the specified [SearchJobsRequest][google.cloud.talent.v4beta1.SearchJobsRequest]. Job job = 1; // A summary of the job with core information that's displayed on the search @@ -803,12 +761,10 @@ message SearchJobsResponse { // query keywords are enclosed in HTML bold tags. string job_title_snippet = 3; - // Contains snippets of text from the - // [Job.description][google.cloud.talent.v4beta1.Job.description] and - // similar fields that most closely match a search query's keywords, if - // available. All HTML tags in the original fields are stripped when - // returned in this field, and matching query keywords are enclosed in HTML - // bold tags. + // Contains snippets of text from the [Job.description][google.cloud.talent.v4beta1.Job.description] and similar + // fields that most closely match a search query's keywords, if available. + // All HTML tags in the original fields are stripped when returned in this + // field, and matching query keywords are enclosed in HTML bold tags. string search_text_snippet = 4; // Commute information which is generated based on specified @@ -830,8 +786,7 @@ message SearchJobsResponse { google.protobuf.Duration travel_duration = 2; } - // The Job entities that match the specified - // [SearchJobsRequest][google.cloud.talent.v4beta1.SearchJobsRequest]. + // The Job entities that match the specified [SearchJobsRequest][google.cloud.talent.v4beta1.SearchJobsRequest]. repeated MatchingJob matching_jobs = 1; // The histogram results that match with specified diff --git a/google/cloud/talent/v4beta1/profile.proto b/google/cloud/talent/v4beta1/profile.proto index 54e4b98ee..58a69c1d4 100644 --- a/google/cloud/talent/v4beta1/profile.proto +++ b/google/cloud/talent/v4beta1/profile.proto @@ -36,9 +36,8 @@ option objc_class_prefix = "CTS"; // Cloud Profile Discovery API definition // A resource that represents the profile for a job candidate (also referred to -// as a "single-source profile"). A profile belongs to a -// [Company][google.cloud.talent.v4beta1.Company], which is the -// company/organization that owns the profile. +// as a "single-source profile"). A profile belongs to a [Company][google.cloud.talent.v4beta1.Company], which is +// the company/organization that owns the profile. message Profile { // Required during profile update. // @@ -78,22 +77,17 @@ message Profile { // The cluster id of the profile to associate with other profile(s) for the // same candidate. // - // A random UUID is assigned if - // [group_id][google.cloud.talent.v4beta1.Profile.group_id] isn't provided. To - // ensure global uniqueness, customized - // [group_id][google.cloud.talent.v4beta1.Profile.group_id] isn't supported. - // If [group_id][google.cloud.talent.v4beta1.Profile.group_id] is set, there - // must be at least one other profile with the same system generated - // [group_id][google.cloud.talent.v4beta1.Profile.group_id], otherwise an - // error is thrown. + // A random UUID is assigned if [group_id][google.cloud.talent.v4beta1.Profile.group_id] isn't provided. To ensure + // global uniqueness, customized [group_id][google.cloud.talent.v4beta1.Profile.group_id] isn't supported. If + // [group_id][google.cloud.talent.v4beta1.Profile.group_id] is set, there must be at least one other profile with the + // same system generated [group_id][google.cloud.talent.v4beta1.Profile.group_id], otherwise an error is thrown. // // This is used to link multiple profiles to the same candidate. For example, // a client has a candidate with two profiles, where one was created recently // and the other one was created 5 years ago. These two profiles may be very // different. The clients can create the first profile and get a generated - // [group_id][google.cloud.talent.v4beta1.Profile.group_id], and assign it - // when the second profile is created, indicating these two profiles are - // referring to the same candidate. + // [group_id][google.cloud.talent.v4beta1.Profile.group_id], and assign it when the second profile is created, + // indicating these two profiles are referring to the same candidate. string group_id = 5; // Optional. @@ -117,21 +111,15 @@ message Profile { // See http://schemas.liquid-technologies.com/hr-xml/2007-04-15/ for more // information about Human Resources XML. // - // Users can create a profile with only - // [resume_hrxml][google.cloud.talent.v4beta1.Profile.resume_hrxml] field. For - // example, the API parses the - // [resume_hrxml][google.cloud.talent.v4beta1.Profile.resume_hrxml] and - // creates a profile with all structured fields populated, for example. - // [EmploymentRecord][google.cloud.talent.v4beta1.EmploymentRecord], - // [EducationRecord][google.cloud.talent.v4beta1.EducationRecord], etc. An - // error is thrown if the - // [resume_hrxml][google.cloud.talent.v4beta1.Profile.resume_hrxml] can't be - // parsed. - // - // If the [resume_hrxml][google.cloud.talent.v4beta1.Profile.resume_hrxml] is - // provided during profile creation or update, any other structured data - // provided in the profile is ignored. The API populates these fields by - // parsing the HR-XML. + // Users can create a profile with only [resume_hrxml][google.cloud.talent.v4beta1.Profile.resume_hrxml] field. For example, + // the API parses the [resume_hrxml][google.cloud.talent.v4beta1.Profile.resume_hrxml] and creates a profile with all + // structured fields populated, for example. [EmploymentRecord][google.cloud.talent.v4beta1.EmploymentRecord], + // [EducationRecord][google.cloud.talent.v4beta1.EducationRecord], and so on. An error is thrown if the [resume_hrxml][google.cloud.talent.v4beta1.Profile.resume_hrxml] + // can't be parsed. + // + // If the [resume_hrxml][google.cloud.talent.v4beta1.Profile.resume_hrxml] is provided during profile creation or update, + // any other structured data provided in the profile is ignored. The + // API populates these fields by parsing the HR-XML. string resume_hrxml = 10; // Optional. @@ -163,12 +151,8 @@ message Profile { // Optional. // - // Available contact information besides - // [addresses][google.cloud.talent.v4beta1.Profile.addresses], - // [email_addresses][google.cloud.talent.v4beta1.Profile.email_addresses], - // [phone_numbers][google.cloud.talent.v4beta1.Profile.phone_numbers] and - // [personal_uris][google.cloud.talent.v4beta1.Profile.personal_uris]. For - // example, Hang-out, Skype. + // Available contact information besides [addresses][google.cloud.talent.v4beta1.Profile.addresses], [email_addresses][google.cloud.talent.v4beta1.Profile.email_addresses], + // [phone_numbers][google.cloud.talent.v4beta1.Profile.phone_numbers] and [personal_uris][google.cloud.talent.v4beta1.Profile.personal_uris]. For example, Hang-out, Skype. repeated AdditionalContactInfo additional_contact_info = 16; // Optional. @@ -182,10 +166,8 @@ message Profile { // change is. // For example, only job title is changed from "software engineer" to "senior // software engineer". - // * Provide - // [EmploymentRecord.is_current][google.cloud.talent.v4beta1.EmploymentRecord.is_current] - // for the current employment if possible. If not, it's inferred from user - // inputs. + // * Provide [EmploymentRecord.is_current][google.cloud.talent.v4beta1.EmploymentRecord.is_current] for the current employment if + // possible. If not, it's inferred from user inputs. repeated EmploymentRecord employment_records = 17; // Optional. @@ -198,10 +180,8 @@ message Profile { // * List each education type separately, no matter how minor the change is. // For example, the profile contains the education experience from the same // school but different degrees. - // * Provide - // [EducationRecord.is_current][google.cloud.talent.v4beta1.EducationRecord.is_current] - // for the current education if possible. If not, it's inferred from user - // inputs. + // * Provide [EducationRecord.is_current][google.cloud.talent.v4beta1.EducationRecord.is_current] for the current education if + // possible. If not, it's inferred from user inputs. repeated EducationRecord education_records = 18; // Optional. @@ -214,8 +194,7 @@ message Profile { // // The individual or collaborative activities which the candidate has // participated in, for example, open-source projects, class assignments that - // aren't listed in - // [employment_records][google.cloud.talent.v4beta1.Profile.employment_records]. + // aren't listed in [employment_records][google.cloud.talent.v4beta1.Profile.employment_records]. repeated Activity activities = 20; // Optional. @@ -243,8 +222,7 @@ message Profile { // // A map of fields to hold both filterable and non-filterable custom profile // attributes that aren't covered by the provided structured fields. See - // [CustomAttribute][google.cloud.talent.v4beta1.CustomAttribute] for more - // details. + // [CustomAttribute][google.cloud.talent.v4beta1.CustomAttribute] for more details. // // At most 100 filterable and at most 100 unfilterable keys are supported. If // limit is exceeded, an error is thrown. Custom attributes are `unfilterable` @@ -278,9 +256,7 @@ message PersonName { // // Given/first name. // - // It's derived from - // [formatted_name][google.cloud.talent.v4beta1.PersonName.formatted_name] - // if not provided. + // It's derived from [formatted_name][google.cloud.talent.v4beta1.PersonName.formatted_name] if not provided. // // Number of characters allowed is 100. string given_name = 1; @@ -289,9 +265,7 @@ message PersonName { // // Middle initial. // - // It's derived from - // [formatted_name][google.cloud.talent.v4beta1.PersonName.formatted_name] - // if not provided. + // It's derived from [formatted_name][google.cloud.talent.v4beta1.PersonName.formatted_name] if not provided. // // Number of characters allowed is 20. string middle_initial = 2; @@ -300,9 +274,7 @@ message PersonName { // // Family/last name. // - // It's derived from - // [formatted_name][google.cloud.talent.v4beta1.PersonName.formatted_name] - // if not provided. + // It's derived from [formatted_name][google.cloud.talent.v4beta1.PersonName.formatted_name] if not provided. // // Number of characters allowed is 100. string family_name = 3; @@ -334,7 +306,8 @@ message PersonName { // Optional. // - // A person's name in a structured way (last name, first name, suffix, etc.) + // A person's name in a structured way (last name, first name, suffix, and + // so on.) PersonStructuredName structured_name = 2; } @@ -367,7 +340,7 @@ message Address { // Optional. // // Structured address that contains street address, city, state, country, - // etc. + // and so on. google.type.PostalAddress structured_address = 3; } @@ -418,10 +391,10 @@ message Phone { VOICEMAIL = 6; // A virtual telephone number is a number that can be routed to another - // number and managed by the user via Web, SMS, IVR, etc. It is associated - // with a particular person, and may be routed to either a MOBILE or - // LANDLINE number. The phone usage (see ContactInfoUsage above) should be - // set to PERSONAL for these phone types. Some more information can be + // number and managed by the user via Web, SMS, IVR, and so on. It is + // associated with a particular person, and may be routed to either a MOBILE + // or LANDLINE number. The phone usage (see ContactInfoUsage above) should + // be set to PERSONAL for these phone types. Some more information can be // found here: http://en.wikipedia.org/wiki/Personal_Numbers VIRTUAL = 7; @@ -527,7 +500,7 @@ message EmploymentRecord { // // The name of the employer company/organization. // - // For example, "Google", "Alphabet", etc. + // For example, "Google", "Alphabet", and so on. // // Number of characters allowed is 100. string employer_name = 3; @@ -536,7 +509,7 @@ message EmploymentRecord { // // The division name of the employment. // - // For example, division, department, client, etc. + // For example, division, department, client, and so on. // // Number of characters allowed is 100. string division_name = 4; @@ -550,7 +523,7 @@ message EmploymentRecord { // // The job title of the employment. // - // For example, "Software Engineer", "Data Scientist", etc. + // For example, "Software Engineer", "Data Scientist", and so on. // // Number of characters allowed is 100. string job_title = 6; @@ -564,7 +537,7 @@ message EmploymentRecord { // Optional. // - // If it is a supervisor position. + // If the jobs is a supervisor position. google.protobuf.BoolValue is_supervisor = 8; // Optional. @@ -577,25 +550,19 @@ message EmploymentRecord { // If this employment is current. google.protobuf.BoolValue is_current = 10; - // Output only. The job title snippet shows how the - // [job_title][google.cloud.talent.v4beta1.EmploymentRecord.job_title] is - // related to a search query. It's empty if the - // [job_title][google.cloud.talent.v4beta1.EmploymentRecord.job_title] isn't - // related to the search query. + // Output only. The job title snippet shows how the [job_title][google.cloud.talent.v4beta1.EmploymentRecord.job_title] is related + // to a search query. It's empty if the [job_title][google.cloud.talent.v4beta1.EmploymentRecord.job_title] isn't related to the + // search query. string job_title_snippet = 11; - // Output only. The job description snippet shows how the - // [job_description][google.cloud.talent.v4beta1.EmploymentRecord.job_description] - // is related to a search query. It's empty if the - // [job_description][google.cloud.talent.v4beta1.EmploymentRecord.job_description] - // isn't related to the search query. + // Output only. The job description snippet shows how the [job_description][google.cloud.talent.v4beta1.EmploymentRecord.job_description] + // is related to a search query. It's empty if the [job_description][google.cloud.talent.v4beta1.EmploymentRecord.job_description] isn't + // related to the search query. string job_description_snippet = 12; - // Output only. The employer name snippet shows how the - // [employer_name][google.cloud.talent.v4beta1.EmploymentRecord.employer_name] - // is related to a search query. It's empty if the - // [employer_name][google.cloud.talent.v4beta1.EmploymentRecord.employer_name] - // isn't related to the search query. + // Output only. The employer name snippet shows how the [employer_name][google.cloud.talent.v4beta1.EmploymentRecord.employer_name] is + // related to a search query. It's empty if the [employer_name][google.cloud.talent.v4beta1.EmploymentRecord.employer_name] isn't + // related to the search query. string employer_name_snippet = 13; } @@ -620,7 +587,7 @@ message EducationRecord { // // The name of the school or institution. // - // For example, "Stanford University", "UC Berkeley", etc. + // For example, "Stanford University", "UC Berkeley", and so on. // // Number of characters allowed is 100. string school_name = 4; @@ -660,18 +627,14 @@ message EducationRecord { // If this education is current. google.protobuf.BoolValue is_current = 9; - // Output only. The school name snippet shows how the - // [school_name][google.cloud.talent.v4beta1.EducationRecord.school_name] is + // Output only. The school name snippet shows how the [school_name][google.cloud.talent.v4beta1.EducationRecord.school_name] is // related to a search query in search result. It's empty if the - // [school_name][google.cloud.talent.v4beta1.EducationRecord.school_name] - // isn't related to the search query. + // [school_name][google.cloud.talent.v4beta1.EducationRecord.school_name] isn't related to the search query. string school_name_snippet = 10; - // Output only. The job description snippet shows how the - // [degree][google.cloud.talent.v4beta1.degree] is related to a search query - // in search result. It's empty if the - // [degree][google.cloud.talent.v4beta1.degree] isn't related to the search - // query. + // Output only. The job description snippet shows how the [degree][google.cloud.talent.v4beta1.degree] is + // related to a search query in search result. It's empty if the [degree][google.cloud.talent.v4beta1.degree] + // isn't related to the search query. string degree_snippet = 11; } @@ -686,7 +649,7 @@ message Degree { // // Full Degree name. // - // For example, "B.S.", "Master of Arts", etc. + // For example, "B.S.", "Master of Arts", and so on. // // Number of characters allowed is 100. string degree_name = 2; @@ -703,7 +666,7 @@ message Degree { // Resource that represents an individual or collaborative activity participated // in by a candidate, for example, an open-source project, a class assignment, -// etc. +// and so on. message Activity { // Optional. // @@ -748,25 +711,19 @@ message Activity { // A list of skills used in this activity. repeated Skill skills_used = 7; - // Output only. Activity name snippet shows how the - // [display_name][google.cloud.talent.v4beta1.Activity.display_name] is - // related to a search query. It's empty if the - // [display_name][google.cloud.talent.v4beta1.Activity.display_name] isn't - // related to the search query. + // Output only. Activity name snippet shows how the [display_name][google.cloud.talent.v4beta1.Activity.display_name] is + // related to a search query. It's empty if the [display_name][google.cloud.talent.v4beta1.Activity.display_name] isn't related + // to the search query. string activity_name_snippet = 8; // Output only. Activity description snippet shows how the - // [description][google.cloud.talent.v4beta1.Activity.description] is related - // to a search query. It's empty if the - // [description][google.cloud.talent.v4beta1.Activity.description] isn't - // related to the search query. + // [description][google.cloud.talent.v4beta1.Activity.description] is related to a search query. It's empty if the + // [description][google.cloud.talent.v4beta1.Activity.description] isn't related to the search query. string activity_description_snippet = 9; // Output only. Skill used snippet shows how the corresponding - // [skills_used][google.cloud.talent.v4beta1.Activity.skills_used] are related - // to a search query. It's empty if the corresponding - // [skills_used][google.cloud.talent.v4beta1.Activity.skills_used] are not - // related to the search query. + // [skills_used][google.cloud.talent.v4beta1.Activity.skills_used] are related to a search query. It's empty if the + // corresponding [skills_used][google.cloud.talent.v4beta1.Activity.skills_used] are not related to the search query. repeated string skills_used_snippet = 10; } diff --git a/google/cloud/talent/v4beta1/profile_service.proto b/google/cloud/talent/v4beta1/profile_service.proto index f892d2b37..c692df46d 100644 --- a/google/cloud/talent/v4beta1/profile_service.proto +++ b/google/cloud/talent/v4beta1/profile_service.proto @@ -78,9 +78,7 @@ service ProfileService { // For example, search by raw queries "software engineer in Mountain View" or // search by structured filters (location filter, education filter, etc.). // - // See - // [SearchProfilesRequest][google.cloud.talent.v4beta1.SearchProfilesRequest] - // for more information. + // See [SearchProfilesRequest][google.cloud.talent.v4beta1.SearchProfilesRequest] for more information. rpc SearchProfiles(SearchProfilesRequest) returns (SearchProfilesResponse) { option (google.api.http) = { post: "/v4beta1/{parent=projects/*/tenants/*}:search" @@ -103,9 +101,8 @@ message ListProfilesRequest { // // The token that specifies the current offset (that is, starting result). // - // Please set the value to - // [ListProfilesResponse.next_page_token][google.cloud.talent.v4beta1.ListProfilesResponse.next_page_token] - // to continue the list. + // Please set the value to [ListProfilesResponse.next_page_token][google.cloud.talent.v4beta1.ListProfilesResponse.next_page_token] to + // continue the list. string page_token = 2; // Optional. @@ -201,6 +198,7 @@ message UpdateProfileRequest { // * certifications // * recruitingNotes // * customAttributes + // * groupId google.protobuf.FieldMask update_mask = 2; } @@ -235,8 +233,7 @@ message SearchProfilesRequest { // Optional. // - // Search query to execute. See - // [ProfileQuery][google.cloud.talent.v4beta1.ProfileQuery] for more details. + // Search query to execute. See [ProfileQuery][google.cloud.talent.v4beta1.ProfileQuery] for more details. ProfileQuery profile_query = 3; // Optional. @@ -252,18 +249,16 @@ message SearchProfilesRequest { // The pageToken, similar to offset enables users of the API to paginate // through the search results. To retrieve the first page of results, set the // pageToken to empty. The search response includes a - // [nextPageToken][google.cloud.talent.v4beta1.SearchProfilesResponse.next_page_token] - // field that can be used to populate the pageToken field for the next page of - // results. Using pageToken instead of offset increases the performance of the - // API, especially compared to larger offset values. + // [nextPageToken][google.cloud.talent.v4beta1.SearchProfilesResponse.next_page_token] field that can be + // used to populate the pageToken field for the next page of results. Using + // pageToken instead of offset increases the performance of the API, + // especially compared to larger offset values. string page_token = 5; // Optional. // // An integer that specifies the current offset (that is, starting result) in - // search results. This field is only considered if - // [page_token][google.cloud.talent.v4beta1.SearchProfilesRequest.page_token] - // is unset. + // search results. This field is only considered if [page_token][google.cloud.talent.v4beta1.SearchProfilesRequest.page_token] is unset. // // The maximum allowed value is 5000. Otherwise an error is thrown. // @@ -313,8 +308,7 @@ message SearchProfilesRequest { // Optional. // // A list of expressions specifies histogram requests against matching - // profiles for - // [SearchProfilesRequest][google.cloud.talent.v4beta1.SearchProfilesRequest]. + // profiles for [SearchProfilesRequest][google.cloud.talent.v4beta1.SearchProfilesRequest]. // // The expression syntax looks like a function definition with optional // parameters. @@ -367,29 +361,19 @@ message SearchProfilesRequest { // * experience_in_months: experience in months. 0 means 0 month to 1 month // (exclusive). // * application_date: The application date specifies application start dates. - // See - // [ApplicationDateFilter][google.cloud.talent.v4beta1.ApplicationDateFilter] - // for more details. + // See [ApplicationDateFilter][google.cloud.talent.v4beta1.ApplicationDateFilter] for more details. // * application_outcome_notes: The application outcome reason specifies the // reasons behind the outcome of the job application. - // See - // [ApplicationOutcomeNotesFilter][google.cloud.talent.v4beta1.ApplicationOutcomeNotesFilter] - // for more details. + // See [ApplicationOutcomeNotesFilter][google.cloud.talent.v4beta1.ApplicationOutcomeNotesFilter] for more details. // * application_last_stage: The application last stage specifies the last // stage of job application. - // See - // [ApplicationLastStageFilter][google.cloud.talent.v4beta1.ApplicationLastStageFilter] - // for more details. + // See [ApplicationLastStageFilter][] for more details. // * application_job_title: The application job title specifies the job // applied for in the application. - // See - // [ApplicationJobFilter][google.cloud.talent.v4beta1.ApplicationJobFilter] - // for more details. + // See [ApplicationJobFilter][google.cloud.talent.v4beta1.ApplicationJobFilter] for more details. // * application_status: The application status specifies the status of job // application. - // See - // [ApplicationStatusFilter][google.cloud.talent.v4beta1.ApplicationStatusFilter] - // for more details. + // See [ApplicationStatusFilter][] for more details. // * hirable_status: Hirable status specifies the profile's hirable status. // * string_custom_attribute: String custom attributes. Values can be accessed // via square bracket notation like string_custom_attribute["key1"]. @@ -429,15 +413,13 @@ message SearchProfilesResponse { // [SearchProfilesRequest.histogram_queries][google.cloud.talent.v4beta1.SearchProfilesRequest.histogram_queries]. repeated HistogramQueryResult histogram_query_results = 5; - // The profile entities that match the specified - // [SearchProfilesRequest][google.cloud.talent.v4beta1.SearchProfilesRequest]. + // The profile entities that match the specified [SearchProfilesRequest][google.cloud.talent.v4beta1.SearchProfilesRequest]. repeated SummarizedProfile summarized_profiles = 6; } // Output only. // -// Profile entry with metadata inside -// [SearchProfilesResponse][google.cloud.talent.v4beta1.SearchProfilesResponse]. +// Profile entry with metadata inside [SearchProfilesResponse][google.cloud.talent.v4beta1.SearchProfilesResponse]. message SummarizedProfile { // A list of profiles that are linked by [Profile.cluster_id][]. repeated Profile profiles = 1; diff --git a/google/cloud/talent/v4beta1/tenant.proto b/google/cloud/talent/v4beta1/tenant.proto index f2f2ee496..52104c440 100644 --- a/google/cloud/talent/v4beta1/tenant.proto +++ b/google/cloud/talent/v4beta1/tenant.proto @@ -17,8 +17,8 @@ syntax = "proto3"; package google.cloud.talent.v4beta1; -import "google/api/annotations.proto"; import "google/cloud/talent/v4beta1/common.proto"; +import "google/api/annotations.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent"; option java_multiple_files = true; @@ -66,8 +66,6 @@ message Tenant { // Indicates whether data owned by this tenant may be used to provide product // improvements across other tenants. // - // Defaults behavior is - // [DataUsageType.ISOLATED][google.cloud.talent.v4beta1.Tenant.DataUsageType.ISOLATED] - // if it's unset. + // Defaults behavior is [DataUsageType.ISOLATED][google.cloud.talent.v4beta1.Tenant.DataUsageType.ISOLATED] if it's unset. DataUsageType usage_type = 3; } diff --git a/google/cloud/talent/v4beta1/tenant_service.proto b/google/cloud/talent/v4beta1/tenant_service.proto index 18de6cd09..5af4fd8c5 100644 --- a/google/cloud/talent/v4beta1/tenant_service.proto +++ b/google/cloud/talent/v4beta1/tenant_service.proto @@ -106,15 +106,11 @@ message UpdateTenantRequest { // Optional but strongly recommended for the best service // experience. // - // If - // [update_mask][google.cloud.talent.v4beta1.UpdateTenantRequest.update_mask] - // is provided, only the specified fields in - // [tenant][google.cloud.talent.v4beta1.UpdateTenantRequest.tenant] are - // updated. Otherwise all the fields are updated. + // If [update_mask][google.cloud.talent.v4beta1.UpdateTenantRequest.update_mask] is provided, only the specified fields in + // [tenant][google.cloud.talent.v4beta1.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.v4beta1.Tenant] are - // supported. + // top level fields of [Tenant][google.cloud.talent.v4beta1.Tenant] are supported. google.protobuf.FieldMask update_mask = 2; } |