Skip to content

Commit 0c5405f

Browse files
yoshi-automationbusunkim96
authored andcommitted
docs(talent): update docstrings (via synth) (#9644)
1 parent 332c8ff commit 0c5405f

File tree

9 files changed

+52
-47
lines changed

9 files changed

+52
-47
lines changed

talent/google/cloud/talent_v4beta1/gapic/enums.py

+5-5
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ class AvailabilitySignalType(enum.IntEnum):
4040
RESUME_UPDATE (int): Resume update signal.
4141
4242
In the context of ``Profile.availability_signals``, this signal is
43-
related to the candidates most recent update to their resume. For a
43+
related to the candidate's most recent update to their resume. For a
4444
``SummarizedProfile.summary``, ``last_update_time`` is calculated from
4545
max(\ ``Profile.resume_update_time``) from all
4646
``SummarizedProfile.profiles``.
@@ -50,7 +50,7 @@ class AvailabilitySignalType(enum.IntEnum):
5050
CANDIDATE_UPDATE (int): Candidate update signal.
5151
5252
In the context of ``Profile.availability_signals``, this signal is
53-
related to the candidates most recent update to their profile. For a
53+
related to the candidate's most recent update to their profile. For a
5454
``SummarizedProfile.summary``, ``last_update_time`` is calculated from
5555
max(\ ``Profile.candidate_update_time``) from all
5656
``SummarizedProfile.profiles``.
@@ -60,7 +60,7 @@ class AvailabilitySignalType(enum.IntEnum):
6060
CLIENT_SUBMISSION (int): Client submission signal.
6161
6262
In the context of ``Profile.availability_signals``, this signal is
63-
related to the candidates most recent submission. ``last_update_time``
63+
related to the candidate's most recent submission. ``last_update_time``
6464
is calculated from max(\ ``Application.create_time``) from all
6565
``Application`` records where ``Application.stage`` is any of the
6666
following: ``HIRING_MANAGER_REVIEW`` ``INTERVIEW`` ``OFFER_EXTENDED``
@@ -958,7 +958,7 @@ class PhoneType(enum.IntEnum):
958958
associated with a particular person, and may be routed to either a
959959
MOBILE or LANDLINE number. The ``phone usage`` should be set to PERSONAL
960960
for these phone types. Some more information can be found here:
961-
http://en.wikipedia.org/wiki/Personal\_Numbers
961+
https://en.wikipedia.org/wiki/Personal\_Numbers
962962
VOIP (int): Voice over IP numbers. This includes TSoIP (Telephony Service over IP).
963963
MOBILE_OR_LANDLINE (int): In some regions (e.g. the USA), it is impossible to distinguish between
964964
fixed-line and mobile numbers by looking at the phone number itself.
@@ -1015,7 +1015,7 @@ class ResumeType(enum.IntEnum):
10151015
Attributes:
10161016
RESUME_TYPE_UNSPECIFIED (int): Default value.
10171017
HRXML (int): The profile contents in HR-XML format.
1018-
See http://schemas.liquid-technologies.com/hr-xml/2007-04-15/ for more
1018+
See https://schemas.liquid-technologies.com/hr-xml/2007-04-15/ for more
10191019
information about Human Resources XML.
10201020
OTHER_RESUME_TYPE (int): Resume type not specified.
10211021
"""

talent/google/cloud/talent_v4beta1/gapic/job_service_client.py

+1-1
Original file line numberDiff line numberDiff line change
@@ -1640,7 +1640,7 @@ def batch_update_jobs(
16401640
The format is "projects/{project\_id}/tenants/{tenant\_id}". For
16411641
example, "projects/foo/tenant/bar". If tenant id is unspecified, a
16421642
default tenant is created. For example, "projects/foo".
1643-
jobs (list[Union[dict, ~google.cloud.talent_v4beta1.types.Job]]): The jobs to be updated.
1643+
jobs (list[Union[dict, ~google.cloud.talent_v4beta1.types.Job]]): Required. The jobs to be updated.
16441644
16451645
If a dict is provided, it must be of the same form as the protobuf
16461646
message :class:`~google.cloud.talent_v4beta1.types.Job`

talent/google/cloud/talent_v4beta1/proto/common.proto

+19-15
Original file line numberDiff line numberDiff line change
@@ -1077,8 +1077,8 @@ enum AvailabilitySignalType {
10771077
// In the context of
10781078
// [Profile.availability_signals][google.cloud.talent.v4beta1.Profile.availability_signals],
10791079
// this signal is related to the candidate's most recent application.
1080-
// [last_update_time][Profile.availability_signals.last_update_time] is
1081-
// calculated from
1080+
// [last_update_time][google.cloud.talent.v4beta1.AvailabilitySignal.last_update_time]
1081+
// is calculated from
10821082
// max([Application.create_time][google.cloud.talent.v4beta1.Application.create_time])
10831083
// from all [Application][google.cloud.talent.v4beta1.Application] records
10841084
// where [Application.source][google.cloud.talent.v4beta1.Application.source]
@@ -1093,18 +1093,19 @@ enum AvailabilitySignalType {
10931093
// [AvailabilityFilter][google.cloud.talent.v4beta1.AvailabilityFilter], the
10941094
// filter is applied on
10951095
// [Profile.availability_signals][google.cloud.talent.v4beta1.Profile.availability_signals]
1096-
// where [type][Profile.availability_signals.type] is JOB_APPLICATION.
1096+
// where [type][google.cloud.talent.v4beta1.AvailabilitySignal.type] is
1097+
// JOB_APPLICATION.
10971098
JOB_APPLICATION = 1;
10981099

10991100
// Resume update signal.
11001101
//
11011102
// In the context of
11021103
// [Profile.availability_signals][google.cloud.talent.v4beta1.Profile.availability_signals],
1103-
// this signal is related to the candidates most recent update to their
1104+
// this signal is related to the candidate's most recent update to their
11041105
// resume. For a
11051106
// [SummarizedProfile.summary][google.cloud.talent.v4beta1.SummarizedProfile.summary],
1106-
// [last_update_time][Profile.availability_signals.last_update_time] is
1107-
// calculated from
1107+
// [last_update_time][google.cloud.talent.v4beta1.AvailabilitySignal.last_update_time]
1108+
// is calculated from
11081109
// max([Profile.resume_update_time][google.cloud.talent.v4beta1.Profile.resume_update_time])
11091110
// from all
11101111
// [SummarizedProfile.profiles][google.cloud.talent.v4beta1.SummarizedProfile.profiles].
@@ -1113,18 +1114,19 @@ enum AvailabilitySignalType {
11131114
// [AvailabilityFilter][google.cloud.talent.v4beta1.AvailabilityFilter], the
11141115
// filter is applied on
11151116
// [Profile.availability_signals][google.cloud.talent.v4beta1.Profile.availability_signals]
1116-
// where [type][Profile.availability_signals.type] is RESUME_UPDATE.
1117+
// where [type][google.cloud.talent.v4beta1.AvailabilitySignal.type] is
1118+
// RESUME_UPDATE.
11171119
RESUME_UPDATE = 2;
11181120

11191121
// Candidate update signal.
11201122
//
11211123
// In the context of
11221124
// [Profile.availability_signals][google.cloud.talent.v4beta1.Profile.availability_signals],
1123-
// this signal is related to the candidates most recent update to their
1125+
// this signal is related to the candidate's most recent update to their
11241126
// profile. For a
11251127
// [SummarizedProfile.summary][google.cloud.talent.v4beta1.SummarizedProfile.summary],
1126-
// [last_update_time][Profile.availability_signals.last_update_time] is
1127-
// calculated from
1128+
// [last_update_time][google.cloud.talent.v4beta1.AvailabilitySignal.last_update_time]
1129+
// is calculated from
11281130
// max([Profile.candidate_update_time][google.cloud.talent.v4beta1.Profile.candidate_update_time])
11291131
// from all
11301132
// [SummarizedProfile.profiles][google.cloud.talent.v4beta1.SummarizedProfile.profiles].
@@ -1133,16 +1135,17 @@ enum AvailabilitySignalType {
11331135
// [AvailabilityFilter][google.cloud.talent.v4beta1.AvailabilityFilter], the
11341136
// filter is applied on
11351137
// [Profile.availability_signals][google.cloud.talent.v4beta1.Profile.availability_signals]
1136-
// where [type][Profile.availability_signals.type] is CANDIDATE_UPDATE.
1138+
// where [type][google.cloud.talent.v4beta1.AvailabilitySignal.type] is
1139+
// CANDIDATE_UPDATE.
11371140
CANDIDATE_UPDATE = 3;
11381141

11391142
// Client submission signal.
11401143
//
11411144
// In the context of
11421145
// [Profile.availability_signals][google.cloud.talent.v4beta1.Profile.availability_signals],
1143-
// this signal is related to the candidates most recent submission.
1144-
// [last_update_time][Profile.availability_signals.last_update_time] is
1145-
// calculated from
1146+
// this signal is related to the candidate's most recent submission.
1147+
// [last_update_time][google.cloud.talent.v4beta1.AvailabilitySignal.last_update_time]
1148+
// is calculated from
11461149
// max([Application.create_time][google.cloud.talent.v4beta1.Application.create_time])
11471150
// from all [Application][google.cloud.talent.v4beta1.Application] records
11481151
// where [Application.stage][google.cloud.talent.v4beta1.Application.stage] is
@@ -1157,6 +1160,7 @@ enum AvailabilitySignalType {
11571160
// [AvailabilityFilter][google.cloud.talent.v4beta1.AvailabilityFilter], the
11581161
// filter is applied on
11591162
// [Profile.availability_signals][google.cloud.talent.v4beta1.Profile.availability_signals]
1160-
// where [type][Profile.availability_signals.type] is CLIENT_SUBMISSION.
1163+
// where [type][google.cloud.talent.v4beta1.AvailabilitySignal.type] is
1164+
// CLIENT_SUBMISSION.
11611165
CLIENT_SUBMISSION = 4;
11621166
}

talent/google/cloud/talent_v4beta1/proto/filters.proto

+2-2
Original file line numberDiff line numberDiff line change
@@ -496,8 +496,8 @@ message LocationFilter {
496496
// or territory. If this field is not set, application behavior is biased
497497
// toward the United States by default.
498498
//
499-
// See http://cldr.unicode.org/ and
500-
// http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
499+
// See https://cldr.unicode.org/ and
500+
// https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
501501
// for details. Example: "CH" for Switzerland.
502502
// Note that this filter is not applicable for Profile Search related queries.
503503
string region_code = 2;

talent/google/cloud/talent_v4beta1/proto/filters_pb2.py

+3-3
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

talent/google/cloud/talent_v4beta1/proto/job_service.proto

+2-2
Original file line numberDiff line numberDiff line change
@@ -866,8 +866,8 @@ message BatchUpdateJobsRequest {
866866
// is created. For example, "projects/foo".
867867
string parent = 1 [(google.api.field_behavior) = REQUIRED];
868868

869-
// The jobs to be updated.
870-
repeated Job jobs = 2;
869+
// Required. The jobs to be updated.
870+
repeated Job jobs = 2 [(google.api.field_behavior) = REQUIRED];
871871

872872
// Strongly recommended for the best service experience. Be aware that it will
873873
// also increase latency when checking the status of a batch operation.

talent/google/cloud/talent_v4beta1/proto/job_service_pb2.py

+13-12
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

talent/google/cloud/talent_v4beta1/proto/profile.proto

+2-2
Original file line numberDiff line numberDiff line change
@@ -319,7 +319,7 @@ message Resume {
319319
RESUME_TYPE_UNSPECIFIED = 0;
320320

321321
// The profile contents in HR-XML format.
322-
// See http://schemas.liquid-technologies.com/hr-xml/2007-04-15/ for more
322+
// See https://schemas.liquid-technologies.com/hr-xml/2007-04-15/ for more
323323
// information about Human Resources XML.
324324
HRXML = 1;
325325

@@ -484,7 +484,7 @@ message Phone {
484484
// or LANDLINE number. The [phone
485485
// usage][google.cloud.talent.v4beta1.ContactInfoUsage] should be set to
486486
// PERSONAL for these phone types. Some more information can be found here:
487-
// http://en.wikipedia.org/wiki/Personal_Numbers
487+
// https://en.wikipedia.org/wiki/Personal_Numbers
488488
VIRTUAL = 7;
489489

490490
// Voice over IP numbers. This includes TSoIP (Telephony Service over IP).

talent/synth.metadata

+5-5
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,19 @@
11
{
2-
"updateTime": "2019-10-30T12:33:54.698582Z",
2+
"updateTime": "2019-11-08T13:33:27.527945Z",
33
"sources": [
44
{
55
"generator": {
66
"name": "artman",
7-
"version": "0.41.0",
8-
"dockerImage": "googleapis/artman@sha256:75b38a3b073a7b243545f2332463096624c802bb1e56b8cb6f22ba1ecd325fa9"
7+
"version": "0.41.1",
8+
"dockerImage": "googleapis/artman@sha256:545c758c76c3f779037aa259023ec3d1ef2d57d2c8cd00a222cb187d63ceac5e"
99
}
1010
},
1111
{
1212
"git": {
1313
"name": "googleapis",
1414
"remote": "https://github.com/googleapis/googleapis.git",
15-
"sha": "7c4cf35d5fe3b8ad664bd219edd6d9f28a788b64",
16-
"internalRef": "277334937"
15+
"sha": "d323b287c782802242005072d15f1474d7d10819",
16+
"internalRef": "279234903"
1717
}
1818
},
1919
{

0 commit comments

Comments
 (0)