From 5d3c7b5c7a17a250b4f991fa9c767c9cd2a24254 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Wed, 7 Aug 2019 09:28:23 -0700 Subject: [PATCH] Update docstrings (via synth). (#8986) --- .../cloud/talent_v4beta1/proto/filters.proto | 5 +++-- .../cloud/talent_v4beta1/proto/filters_pb2.py | 15 +++++++------- .../cloud/talent_v4beta1/proto/profile.proto | 4 +++- .../cloud/talent_v4beta1/proto/profile_pb2.py | 7 +++++-- .../cloud/talent_v4beta1/proto/tenant.proto | 4 ---- .../cloud/talent_v4beta1/proto/tenant_pb2.py | 20 +++++-------------- talent/synth.metadata | 6 +++--- 7 files changed, 27 insertions(+), 34 deletions(-) diff --git a/talent/google/cloud/talent_v4beta1/proto/filters.proto b/talent/google/cloud/talent_v4beta1/proto/filters.proto index 1d79a0ddb2f4..9ebd6c205a24 100644 --- a/talent/google/cloud/talent_v4beta1/proto/filters.proto +++ b/talent/google/cloud/talent_v4beta1/proto/filters.proto @@ -395,8 +395,9 @@ message LocationFilter { // used to address ambiguity of the user-input location, for example, // "Liverpool" against "Liverpool, NY, US" or "Liverpool, UK". // - // Set this field if all the jobs to search against are from a same region, - // or jobs are world-wide, but the job seeker is from a specific region. + // Set this field to bias location resolution toward a specific country + // or territory. If this field is not set, application behavior is biased + // toward the United States by default. // // See http://cldr.unicode.org/ and // http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html diff --git a/talent/google/cloud/talent_v4beta1/proto/filters_pb2.py b/talent/google/cloud/talent_v4beta1/proto/filters_pb2.py index 2098227ed407..ec1c7a8f583d 100644 --- a/talent/google/cloud/talent_v4beta1/proto/filters_pb2.py +++ b/talent/google/cloud/talent_v4beta1/proto/filters_pb2.py @@ -2243,13 +2243,14 @@ Optional. CLDR region code of the country/region of the address. This is used to address ambiguity of the user-input location, for example, "Liverpool" against "Liverpool, NY, US" - or "Liverpool, UK". Set this field if all the jobs to search - against are from a same region, or jobs are world-wide, but - the job seeker is from a specific region. See - http://cldr.unicode.org/ and http://www.unicode.org/cldr/chart - s/30/supplemental/territory\_information.html for details. - Example: "CH" for Switzerland. Note that this filter is not - applicable for Profile Search related queries. + or "Liverpool, UK". Set this field to bias location + resolution toward a specific country or territory. If this + field is not set, application behavior is biased toward the + United States by default. See http://cldr.unicode.org/ and ht + tp://www.unicode.org/cldr/charts/30/supplemental/territory\_in + formation.html for details. Example: "CH" for Switzerland. + Note that this filter is not applicable for Profile Search + related queries. lat_lng: Optional. The latitude and longitude of the geographic center from which to search. This field's ignored if ``address`` is diff --git a/talent/google/cloud/talent_v4beta1/proto/profile.proto b/talent/google/cloud/talent_v4beta1/proto/profile.proto index c0dee8b68f6d..819f13a62e62 100644 --- a/talent/google/cloud/talent_v4beta1/proto/profile.proto +++ b/talent/google/cloud/talent_v4beta1/proto/profile.proto @@ -46,7 +46,9 @@ message Profile { // for example, "projects/api-test-project/tenants/foo/profiles/bar". string name = 1; - // Optional. Profile's id in client system if available. + // Optional. Profile's id in client system if available. This value is not + // required to be unique to each profile. However, providing unique values + // makes it easier to specify individual profiles when filing support tickets. // // The maximum number of bytes allowed is 100. string external_id = 2; diff --git a/talent/google/cloud/talent_v4beta1/proto/profile_pb2.py b/talent/google/cloud/talent_v4beta1/proto/profile_pb2.py index 07c03ff026a7..195bd143568d 100644 --- a/talent/google/cloud/talent_v4beta1/proto/profile_pb2.py +++ b/talent/google/cloud/talent_v4beta1/proto/profile_pb2.py @@ -2680,8 +2680,11 @@ ants/{tenant\_id}/profiles/{profile\_id}", for example, "projects/api-test-project/tenants/foo/profiles/bar". external_id: - Optional. Profile's id in client system if available. The - maximum number of bytes allowed is 100. + Optional. Profile's id in client system if available. This + value is not required to be unique to each profile. However, + providing unique values makes it easier to specify individual + profiles when filing support tickets. The maximum number of + bytes allowed is 100. source: Optional. The source description indicating where the profile is acquired. For example, if a candidate profile is acquired diff --git a/talent/google/cloud/talent_v4beta1/proto/tenant.proto b/talent/google/cloud/talent_v4beta1/proto/tenant.proto index 98eb4bf018fb..00ed1a6a3418 100644 --- a/talent/google/cloud/talent_v4beta1/proto/tenant.proto +++ b/talent/google/cloud/talent_v4beta1/proto/tenant.proto @@ -17,10 +17,6 @@ syntax = "proto3"; package google.cloud.talent.v4beta1; -import "google/api/annotations.proto"; -import "google/protobuf/timestamp.proto"; -import "google/protobuf/wrappers.proto"; - option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent"; option java_multiple_files = true; option java_outer_classname = "TenantResourceProto"; diff --git a/talent/google/cloud/talent_v4beta1/proto/tenant_pb2.py b/talent/google/cloud/talent_v4beta1/proto/tenant_pb2.py index 58e8b024c8a1..21b850e49585 100644 --- a/talent/google/cloud/talent_v4beta1/proto/tenant_pb2.py +++ b/talent/google/cloud/talent_v4beta1/proto/tenant_pb2.py @@ -15,11 +15,6 @@ _sym_db = _symbol_database.Default() -from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2 -from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2 -from google.protobuf import wrappers_pb2 as google_dot_protobuf_dot_wrappers__pb2 - - DESCRIPTOR = _descriptor.FileDescriptor( name="google/cloud/talent_v4beta1/proto/tenant.proto", package="google.cloud.talent.v4beta1", @@ -28,13 +23,8 @@ "\n\037com.google.cloud.talent.v4beta1B\023TenantResourceProtoP\001ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\242\002\003CTS" ), serialized_pb=_b( - '\n.google/cloud/talent_v4beta1/proto/tenant.proto\x12\x1bgoogle.cloud.talent.v4beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1egoogle/protobuf/wrappers.proto"\xf8\x01\n\x06Tenant\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x13\n\x0b\x65xternal_id\x18\x02 \x01(\t\x12\x45\n\nusage_type\x18\x03 \x01(\x0e\x32\x31.google.cloud.talent.v4beta1.Tenant.DataUsageType\x12\x34\n,keyword_searchable_profile_custom_attributes\x18\x04 \x03(\t"N\n\rDataUsageType\x12\x1f\n\x1b\x44\x41TA_USAGE_TYPE_UNSPECIFIED\x10\x00\x12\x0e\n\nAGGREGATED\x10\x01\x12\x0c\n\x08ISOLATED\x10\x02\x42\x81\x01\n\x1f\x63om.google.cloud.talent.v4beta1B\x13TenantResourceProtoP\x01ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\xa2\x02\x03\x43TSb\x06proto3' + '\n.google/cloud/talent_v4beta1/proto/tenant.proto\x12\x1bgoogle.cloud.talent.v4beta1"\xf8\x01\n\x06Tenant\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x13\n\x0b\x65xternal_id\x18\x02 \x01(\t\x12\x45\n\nusage_type\x18\x03 \x01(\x0e\x32\x31.google.cloud.talent.v4beta1.Tenant.DataUsageType\x12\x34\n,keyword_searchable_profile_custom_attributes\x18\x04 \x03(\t"N\n\rDataUsageType\x12\x1f\n\x1b\x44\x41TA_USAGE_TYPE_UNSPECIFIED\x10\x00\x12\x0e\n\nAGGREGATED\x10\x01\x12\x0c\n\x08ISOLATED\x10\x02\x42\x81\x01\n\x1f\x63om.google.cloud.talent.v4beta1B\x13TenantResourceProtoP\x01ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\xa2\x02\x03\x43TSb\x06proto3' ), - dependencies=[ - google_dot_api_dot_annotations__pb2.DESCRIPTOR, - google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR, - google_dot_protobuf_dot_wrappers__pb2.DESCRIPTOR, - ], ) @@ -60,8 +50,8 @@ ], containing_type=None, serialized_options=None, - serialized_start=345, - serialized_end=423, + serialized_start=250, + serialized_end=328, ) _sym_db.RegisterEnumDescriptor(_TENANT_DATAUSAGETYPE) @@ -154,8 +144,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=175, - serialized_end=423, + serialized_start=80, + serialized_end=328, ) _TENANT.fields_by_name["usage_type"].enum_type = _TENANT_DATAUSAGETYPE diff --git a/talent/synth.metadata b/talent/synth.metadata index f31f3116f7e5..79dedd36e2d2 100644 --- a/talent/synth.metadata +++ b/talent/synth.metadata @@ -1,5 +1,5 @@ { - "updateTime": "2019-08-06T12:41:16.157242Z", + "updateTime": "2019-08-07T12:36:04.122564Z", "sources": [ { "generator": { @@ -12,8 +12,8 @@ "git": { "name": "googleapis", "remote": "https://github.com/googleapis/googleapis.git", - "sha": "e699b0cba64ffddfae39633417180f1f65875896", - "internalRef": "261759677" + "sha": "6d29882872298c8bfbaef33bd69bfca275c4d2eb", + "internalRef": "262019251" } }, {