aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGoogle APIs <noreply@google.com>2019-04-08 20:04:28 -0700
committerCopybara-Service <copybara-worker@google.com>2019-04-08 20:04:56 -0700
commit2c0815acf6b4d7269f9d2a90a07cbb59a40e70b8 (patch)
treea418607710007246d423df020fbf35c38180e689
parent9a02c5acecb43f38fae4fa52c6420f21c335b888 (diff)
downloadgoogleapis-2c0815acf6b4d7269f9d2a90a07cbb59a40e70b8.tar.gz
Synchronize new proto/yaml changes.
PiperOrigin-RevId: 242591107
-rw-r--r--google/cloud/talent/v4beta1/application.proto16
-rw-r--r--google/cloud/talent/v4beta1/application_service.proto16
-rw-r--r--google/cloud/talent/v4beta1/common.proto137
-rw-r--r--google/cloud/talent/v4beta1/company.proto10
-rw-r--r--google/cloud/talent/v4beta1/company_service.proto27
-rw-r--r--google/cloud/talent/v4beta1/completion_service.proto39
-rw-r--r--google/cloud/talent/v4beta1/event.proto30
-rw-r--r--google/cloud/talent/v4beta1/filters.proto208
-rw-r--r--google/cloud/talent/v4beta1/histogram.proto9
-rw-r--r--google/cloud/talent/v4beta1/job.proto122
-rw-r--r--google/cloud/talent/v4beta1/job_service.proto215
-rw-r--r--google/cloud/talent/v4beta1/profile.proto169
-rw-r--r--google/cloud/talent/v4beta1/profile_service.proto54
-rw-r--r--google/cloud/talent/v4beta1/tenant.proto6
-rw-r--r--google/cloud/talent/v4beta1/tenant_service.proto10
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;
}