googleapis-common-protos-types 1.7.0 → 1.9.0

data/lib/google/type/localized_text_pb.rb

@@ -1,15 +1,34 @@
+# frozen_string_literal: true
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/type/localized_text.proto
 
 require 'google/protobuf'
 
-Google::Protobuf::DescriptorPool.generated_pool.build do
-  add_file("google/type/localized_text.proto", :syntax => :proto3) do
-    add_message "google.type.LocalizedText" do
-      optional :text, :string, 1
-      optional :language_code, :string, 2
+
+descriptor_data = "\n google/type/localized_text.proto\x12\x0bgoogle.type\"4\n\rLocalizedText\x12\x0c\n\x04text\x18\x01 \x01(\t\x12\x15\n\rlanguage_code\x18\x02 \x01(\tBz\n\x0f\x63om.google.typeB\x12LocalizedTextProtoP\x01ZHgoogle.golang.org/genproto/googleapis/type/localized_text;localized_text\xf8\x01\x01\xa2\x02\x03GTPb\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError => e
+  # Compatibility code: will be removed in the next major version.
+  require 'google/protobuf/descriptor_pb'
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = [
+  ]
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
     end
   end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
 end
 
 module Google
@@ -17,3 +36,42 @@ module Google
     LocalizedText = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.type.LocalizedText").msgclass
   end
 end
+
+#### Source proto file: google/type/localized_text.proto ####
+#
+# // Copyright 2021 Google LLC
+# //
+# // Licensed under the Apache License, Version 2.0 (the "License");
+# // you may not use this file except in compliance with the License.
+# // You may obtain a copy of the License at
+# //
+# //     http://www.apache.org/licenses/LICENSE-2.0
+# //
+# // Unless required by applicable law or agreed to in writing, software
+# // distributed under the License is distributed on an "AS IS" BASIS,
+# // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# // See the License for the specific language governing permissions and
+# // limitations under the License.
+#
+# syntax = "proto3";
+#
+# package google.type;
+#
+# option cc_enable_arenas = true;
+# option go_package = "google.golang.org/genproto/googleapis/type/localized_text;localized_text";
+# option java_multiple_files = true;
+# option java_outer_classname = "LocalizedTextProto";
+# option java_package = "com.google.type";
+# option objc_class_prefix = "GTP";
+#
+# // Localized variant of a text in a particular language.
+# message LocalizedText {
+#   // Localized string in the language corresponding to `language_code' below.
+#   string text = 1;
+#
+#   // The text's BCP-47 language code, such as "en-US" or "sr-Latn".
+#   //
+#   // For more information, see
+#   // http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
+#   string language_code = 2;
+# }

data/lib/google/type/money_pb.rb

@@ -1,16 +1,34 @@
+# frozen_string_literal: true
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/type/money.proto
 
 require 'google/protobuf'
 
-Google::Protobuf::DescriptorPool.generated_pool.build do
-  add_file("google/type/money.proto", :syntax => :proto3) do
-    add_message "google.type.Money" do
-      optional :currency_code, :string, 1
-      optional :units, :int64, 2
-      optional :nanos, :int32, 3
+
+descriptor_data = "\n\x17google/type/money.proto\x12\x0bgoogle.type\"<\n\x05Money\x12\x15\n\rcurrency_code\x18\x01 \x01(\t\x12\r\n\x05units\x18\x02 \x01(\x03\x12\r\n\x05nanos\x18\x03 \x01(\x05\x42`\n\x0f\x63om.google.typeB\nMoneyProtoP\x01Z6google.golang.org/genproto/googleapis/type/money;money\xf8\x01\x01\xa2\x02\x03GTPb\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError => e
+  # Compatibility code: will be removed in the next major version.
+  require 'google/protobuf/descriptor_pb'
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = [
+  ]
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
     end
   end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
 end
 
 module Google
@@ -18,3 +36,48 @@ module Google
     Money = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.type.Money").msgclass
   end
 end
+
+#### Source proto file: google/type/money.proto ####
+#
+# // Copyright 2021 Google LLC
+# //
+# // Licensed under the Apache License, Version 2.0 (the "License");
+# // you may not use this file except in compliance with the License.
+# // You may obtain a copy of the License at
+# //
+# //     http://www.apache.org/licenses/LICENSE-2.0
+# //
+# // Unless required by applicable law or agreed to in writing, software
+# // distributed under the License is distributed on an "AS IS" BASIS,
+# // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# // See the License for the specific language governing permissions and
+# // limitations under the License.
+#
+# syntax = "proto3";
+#
+# package google.type;
+#
+# option cc_enable_arenas = true;
+# option go_package = "google.golang.org/genproto/googleapis/type/money;money";
+# option java_multiple_files = true;
+# option java_outer_classname = "MoneyProto";
+# option java_package = "com.google.type";
+# option objc_class_prefix = "GTP";
+#
+# // Represents an amount of money with its currency type.
+# message Money {
+#   // The three-letter currency code defined in ISO 4217.
+#   string currency_code = 1;
+#
+#   // The whole units of the amount.
+#   // For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+#   int64 units = 2;
+#
+#   // Number of nano (10^-9) units of the amount.
+#   // The value must be between -999,999,999 and +999,999,999 inclusive.
+#   // If `units` is positive, `nanos` must be positive or zero.
+#   // If `units` is zero, `nanos` can be positive, zero, or negative.
+#   // If `units` is negative, `nanos` must be negative or zero.
+#   // For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+#   int32 nanos = 3;
+# }

data/lib/google/type/month_pb.rb

@@ -1,26 +1,34 @@
+# frozen_string_literal: true
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/type/month.proto
 
 require 'google/protobuf'
 
-Google::Protobuf::DescriptorPool.generated_pool.build do
-  add_file("google/type/month.proto", :syntax => :proto3) do
-    add_enum "google.type.Month" do
-      value :MONTH_UNSPECIFIED, 0
-      value :JANUARY, 1
-      value :FEBRUARY, 2
-      value :MARCH, 3
-      value :APRIL, 4
-      value :MAY, 5
-      value :JUNE, 6
-      value :JULY, 7
-      value :AUGUST, 8
-      value :SEPTEMBER, 9
-      value :OCTOBER, 10
-      value :NOVEMBER, 11
-      value :DECEMBER, 12
+
+descriptor_data = "\n\x17google/type/month.proto\x12\x0bgoogle.type*\xb0\x01\n\x05Month\x12\x15\n\x11MONTH_UNSPECIFIED\x10\x00\x12\x0b\n\x07JANUARY\x10\x01\x12\x0c\n\x08\x46\x45\x42RUARY\x10\x02\x12\t\n\x05MARCH\x10\x03\x12\t\n\x05\x41PRIL\x10\x04\x12\x07\n\x03MAY\x10\x05\x12\x08\n\x04JUNE\x10\x06\x12\x08\n\x04JULY\x10\x07\x12\n\n\x06\x41UGUST\x10\x08\x12\r\n\tSEPTEMBER\x10\t\x12\x0b\n\x07OCTOBER\x10\n\x12\x0c\n\x08NOVEMBER\x10\x0b\x12\x0c\n\x08\x44\x45\x43\x45MBER\x10\x0c\x42]\n\x0f\x63om.google.typeB\nMonthProtoP\x01Z6google.golang.org/genproto/googleapis/type/month;month\xa2\x02\x03GTPb\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError => e
+  # Compatibility code: will be removed in the next major version.
+  require 'google/protobuf/descriptor_pb'
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = [
+  ]
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
     end
   end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
 end
 
 module Google
@@ -28,3 +36,71 @@ module Google
     Month = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.type.Month").enummodule
   end
 end
+
+#### Source proto file: google/type/month.proto ####
+#
+# // Copyright 2021 Google LLC
+# //
+# // Licensed under the Apache License, Version 2.0 (the "License");
+# // you may not use this file except in compliance with the License.
+# // You may obtain a copy of the License at
+# //
+# //     http://www.apache.org/licenses/LICENSE-2.0
+# //
+# // Unless required by applicable law or agreed to in writing, software
+# // distributed under the License is distributed on an "AS IS" BASIS,
+# // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# // See the License for the specific language governing permissions and
+# // limitations under the License.
+#
+# syntax = "proto3";
+#
+# package google.type;
+#
+# option go_package = "google.golang.org/genproto/googleapis/type/month;month";
+# option java_multiple_files = true;
+# option java_outer_classname = "MonthProto";
+# option java_package = "com.google.type";
+# option objc_class_prefix = "GTP";
+#
+# // Represents a month in the Gregorian calendar.
+# enum Month {
+#   // The unspecified month.
+#   MONTH_UNSPECIFIED = 0;
+#
+#   // The month of January.
+#   JANUARY = 1;
+#
+#   // The month of February.
+#   FEBRUARY = 2;
+#
+#   // The month of March.
+#   MARCH = 3;
+#
+#   // The month of April.
+#   APRIL = 4;
+#
+#   // The month of May.
+#   MAY = 5;
+#
+#   // The month of June.
+#   JUNE = 6;
+#
+#   // The month of July.
+#   JULY = 7;
+#
+#   // The month of August.
+#   AUGUST = 8;
+#
+#   // The month of September.
+#   SEPTEMBER = 9;
+#
+#   // The month of October.
+#   OCTOBER = 10;
+#
+#   // The month of November.
+#   NOVEMBER = 11;
+#
+#   // The month of December.
+#   DECEMBER = 12;
+# }

data/lib/google/type/phone_number_pb.rb

@@ -1,22 +1,34 @@
+# frozen_string_literal: true
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/type/phone_number.proto
 
 require 'google/protobuf'
 
-Google::Protobuf::DescriptorPool.generated_pool.build do
-  add_file("google/type/phone_number.proto", :syntax => :proto3) do
-    add_message "google.type.PhoneNumber" do
-      optional :extension, :string, 3
-      oneof :kind do
-        optional :e164_number, :string, 1
-        optional :short_code, :message, 2, "google.type.PhoneNumber.ShortCode"
-      end
-    end
-    add_message "google.type.PhoneNumber.ShortCode" do
-      optional :region_code, :string, 1
-      optional :number, :string, 2
+
+descriptor_data = "\n\x1egoogle/type/phone_number.proto\x12\x0bgoogle.type\"\xab\x01\n\x0bPhoneNumber\x12\x15\n\x0b\x65\x31\x36\x34_number\x18\x01 \x01(\tH\x00\x12\x38\n\nshort_code\x18\x02 \x01(\x0b\x32\".google.type.PhoneNumber.ShortCodeH\x00\x12\x11\n\textension\x18\x03 \x01(\t\x1a\x30\n\tShortCode\x12\x13\n\x0bregion_code\x18\x01 \x01(\t\x12\x0e\n\x06number\x18\x02 \x01(\tB\x06\n\x04kindBt\n\x0f\x63om.google.typeB\x10PhoneNumberProtoP\x01ZDgoogle.golang.org/genproto/googleapis/type/phone_number;phone_number\xf8\x01\x01\xa2\x02\x03GTPb\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError => e
+  # Compatibility code: will be removed in the next major version.
+  require 'google/protobuf/descriptor_pb'
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = [
+  ]
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
     end
   end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
 end
 
 module Google
@@ -25,3 +37,119 @@ module Google
     PhoneNumber::ShortCode = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.type.PhoneNumber.ShortCode").msgclass
   end
 end
+
+#### Source proto file: google/type/phone_number.proto ####
+#
+# // Copyright 2021 Google LLC
+# //
+# // Licensed under the Apache License, Version 2.0 (the "License");
+# // you may not use this file except in compliance with the License.
+# // You may obtain a copy of the License at
+# //
+# //     http://www.apache.org/licenses/LICENSE-2.0
+# //
+# // Unless required by applicable law or agreed to in writing, software
+# // distributed under the License is distributed on an "AS IS" BASIS,
+# // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# // See the License for the specific language governing permissions and
+# // limitations under the License.
+#
+# syntax = "proto3";
+#
+# package google.type;
+#
+# option cc_enable_arenas = true;
+# option go_package = "google.golang.org/genproto/googleapis/type/phone_number;phone_number";
+# option java_multiple_files = true;
+# option java_outer_classname = "PhoneNumberProto";
+# option java_package = "com.google.type";
+# option objc_class_prefix = "GTP";
+#
+# // An object representing a phone number, suitable as an API wire format.
+# //
+# // This representation:
+# //
+# //  - should not be used for locale-specific formatting of a phone number, such
+# //    as "+1 (650) 253-0000 ext. 123"
+# //
+# //  - is not designed for efficient storage
+# //  - may not be suitable for dialing - specialized libraries (see references)
+# //    should be used to parse the number for that purpose
+# //
+# // To do something meaningful with this number, such as format it for various
+# // use-cases, convert it to an `i18n.phonenumbers.PhoneNumber` object first.
+# //
+# // For instance, in Java this would be:
+# //
+# //    com.google.type.PhoneNumber wireProto =
+# //        com.google.type.PhoneNumber.newBuilder().build();
+# //    com.google.i18n.phonenumbers.Phonenumber.PhoneNumber phoneNumber =
+# //        PhoneNumberUtil.getInstance().parse(wireProto.getE164Number(), "ZZ");
+# //    if (!wireProto.getExtension().isEmpty()) {
+# //      phoneNumber.setExtension(wireProto.getExtension());
+# //    }
+# //
+# //  Reference(s):
+# //   - https://github.com/google/libphonenumber
+# message PhoneNumber {
+#   // An object representing a short code, which is a phone number that is
+#   // typically much shorter than regular phone numbers and can be used to
+#   // address messages in MMS and SMS systems, as well as for abbreviated dialing
+#   // (e.g. "Text 611 to see how many minutes you have remaining on your plan.").
+#   //
+#   // Short codes are restricted to a region and are not internationally
+#   // dialable, which means the same short code can exist in different regions,
+#   // with different usage and pricing, even if those regions share the same
+#   // country calling code (e.g. US and CA).
+#   message ShortCode {
+#     // Required. The BCP-47 region code of the location where calls to this
+#     // short code can be made, such as "US" and "BB".
+#     //
+#     // Reference(s):
+#     //  - http://www.unicode.org/reports/tr35/#unicode_region_subtag
+#     string region_code = 1;
+#
+#     // Required. The short code digits, without a leading plus ('+') or country
+#     // calling code, e.g. "611".
+#     string number = 2;
+#   }
+#
+#   // Required.  Either a regular number, or a short code.  New fields may be
+#   // added to the oneof below in the future, so clients should ignore phone
+#   // numbers for which none of the fields they coded against are set.
+#   oneof kind {
+#     // The phone number, represented as a leading plus sign ('+'), followed by a
+#     // phone number that uses a relaxed ITU E.164 format consisting of the
+#     // country calling code (1 to 3 digits) and the subscriber number, with no
+#     // additional spaces or formatting, e.g.:
+#     //  - correct: "+15552220123"
+#     //  - incorrect: "+1 (555) 222-01234 x123".
+#     //
+#     // The ITU E.164 format limits the latter to 12 digits, but in practice not
+#     // all countries respect that, so we relax that restriction here.
+#     // National-only numbers are not allowed.
+#     //
+#     // References:
+#     //  - https://www.itu.int/rec/T-REC-E.164-201011-I
+#     //  - https://en.wikipedia.org/wiki/E.164.
+#     //  - https://en.wikipedia.org/wiki/List_of_country_calling_codes
+#     string e164_number = 1;
+#
+#     // A short code.
+#     //
+#     // Reference(s):
+#     //  - https://en.wikipedia.org/wiki/Short_code
+#     ShortCode short_code = 2;
+#   }
+#
+#   // The phone number's extension. The extension is not standardized in ITU
+#   // recommendations, except for being defined as a series of numbers with a
+#   // maximum length of 40 digits. Other than digits, some other dialing
+#   // characters such as ',' (indicating a wait) or '#' may be stored here.
+#   //
+#   // Note that no regions currently use extensions with short codes, so this
+#   // field is normally only set in conjunction with an E.164 number. It is held
+#   // separately from the E.164 number to allow for short code extensions in the
+#   // future.
+#   string extension = 3;
+# }

data/lib/google/type/postal_address_pb.rb

@@ -1,24 +1,34 @@
+# frozen_string_literal: true
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/type/postal_address.proto
 
 require 'google/protobuf'
 
-Google::Protobuf::DescriptorPool.generated_pool.build do
-  add_file("google/type/postal_address.proto", :syntax => :proto3) do
-    add_message "google.type.PostalAddress" do
-      optional :revision, :int32, 1
-      optional :region_code, :string, 2
-      optional :language_code, :string, 3
-      optional :postal_code, :string, 4
-      optional :sorting_code, :string, 5
-      optional :administrative_area, :string, 6
-      optional :locality, :string, 7
-      optional :sublocality, :string, 8
-      repeated :address_lines, :string, 9
-      repeated :recipients, :string, 10
-      optional :organization, :string, 11
+
+descriptor_data = "\n google/type/postal_address.proto\x12\x0bgoogle.type\"\xfd\x01\n\rPostalAddress\x12\x10\n\x08revision\x18\x01 \x01(\x05\x12\x13\n\x0bregion_code\x18\x02 \x01(\t\x12\x15\n\rlanguage_code\x18\x03 \x01(\t\x12\x13\n\x0bpostal_code\x18\x04 \x01(\t\x12\x14\n\x0csorting_code\x18\x05 \x01(\t\x12\x1b\n\x13\x61\x64ministrative_area\x18\x06 \x01(\t\x12\x10\n\x08locality\x18\x07 \x01(\t\x12\x13\n\x0bsublocality\x18\x08 \x01(\t\x12\x15\n\raddress_lines\x18\t \x03(\t\x12\x12\n\nrecipients\x18\n \x03(\t\x12\x14\n\x0corganization\x18\x0b \x01(\tBx\n\x0f\x63om.google.typeB\x12PostalAddressProtoP\x01ZFgoogle.golang.org/genproto/googleapis/type/postaladdress;postaladdress\xf8\x01\x01\xa2\x02\x03GTPb\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError => e
+  # Compatibility code: will be removed in the next major version.
+  require 'google/protobuf/descriptor_pb'
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = [
+  ]
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
     end
   end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
 end
 
 module Google
@@ -26,3 +36,140 @@ module Google
     PostalAddress = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.type.PostalAddress").msgclass
   end
 end
+
+#### Source proto file: google/type/postal_address.proto ####
+#
+# // Copyright 2021 Google LLC
+# //
+# // Licensed under the Apache License, Version 2.0 (the "License");
+# // you may not use this file except in compliance with the License.
+# // You may obtain a copy of the License at
+# //
+# //     http://www.apache.org/licenses/LICENSE-2.0
+# //
+# // Unless required by applicable law or agreed to in writing, software
+# // distributed under the License is distributed on an "AS IS" BASIS,
+# // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# // See the License for the specific language governing permissions and
+# // limitations under the License.
+#
+# syntax = "proto3";
+#
+# package google.type;
+#
+# option cc_enable_arenas = true;
+# option go_package = "google.golang.org/genproto/googleapis/type/postaladdress;postaladdress";
+# option java_multiple_files = true;
+# option java_outer_classname = "PostalAddressProto";
+# option java_package = "com.google.type";
+# option objc_class_prefix = "GTP";
+#
+# // Represents a postal address, e.g. for postal delivery or payments addresses.
+# // Given a postal address, a postal service can deliver items to a premise, P.O.
+# // Box or similar.
+# // It is not intended to model geographical locations (roads, towns,
+# // mountains).
+# //
+# // In typical usage an address would be created via user input or from importing
+# // existing data, depending on the type of process.
+# //
+# // Advice on address input / editing:
+# //  - Use an i18n-ready address widget such as
+# //    https://github.com/google/libaddressinput)
+# // - Users should not be presented with UI elements for input or editing of
+# //   fields outside countries where that field is used.
+# //
+# // For more guidance on how to use this schema, please see:
+# // https://support.google.com/business/answer/6397478
+# message PostalAddress {
+#   // The schema revision of the `PostalAddress`. This must be set to 0, which is
+#   // the latest revision.
+#   //
+#   // All new revisions **must** be backward compatible with old revisions.
+#   int32 revision = 1;
+#
+#   // Required. CLDR region code of the country/region of the address. This
+#   // is never inferred and it is up to the user to ensure the value is
+#   // correct. See http://cldr.unicode.org/ and
+#   // http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
+#   // for details. Example: "CH" for Switzerland.
+#   string region_code = 2;
+#
+#   // Optional. BCP-47 language code of the contents of this address (if
+#   // known). This is often the UI language of the input form or is expected
+#   // to match one of the languages used in the address' country/region, or their
+#   // transliterated equivalents.
+#   // This can affect formatting in certain countries, but is not critical
+#   // to the correctness of the data and will never affect any validation or
+#   // other non-formatting related operations.
+#   //
+#   // If this value is not known, it should be omitted (rather than specifying a
+#   // possibly incorrect default).
+#   //
+#   // Examples: "zh-Hant", "ja", "ja-Latn", "en".
+#   string language_code = 3;
+#
+#   // Optional. Postal code of the address. Not all countries use or require
+#   // postal codes to be present, but where they are used, they may trigger
+#   // additional validation with other parts of the address (e.g. state/zip
+#   // validation in the U.S.A.).
+#   string postal_code = 4;
+#
+#   // Optional. Additional, country-specific, sorting code. This is not used
+#   // in most regions. Where it is used, the value is either a string like
+#   // "CEDEX", optionally followed by a number (e.g. "CEDEX 7"), or just a number
+#   // alone, representing the "sector code" (Jamaica), "delivery area indicator"
+#   // (Malawi) or "post office indicator" (e.g. Côte d'Ivoire).
+#   string sorting_code = 5;
+#
+#   // Optional. Highest administrative subdivision which is used for postal
+#   // addresses of a country or region.
+#   // For example, this can be a state, a province, an oblast, or a prefecture.
+#   // Specifically, for Spain this is the province and not the autonomous
+#   // community (e.g. "Barcelona" and not "Catalonia").
+#   // Many countries don't use an administrative area in postal addresses. E.g.
+#   // in Switzerland this should be left unpopulated.
+#   string administrative_area = 6;
+#
+#   // Optional. Generally refers to the city/town portion of the address.
+#   // Examples: US city, IT comune, UK post town.
+#   // In regions of the world where localities are not well defined or do not fit
+#   // into this structure well, leave locality empty and use address_lines.
+#   string locality = 7;
+#
+#   // Optional. Sublocality of the address.
+#   // For example, this can be neighborhoods, boroughs, districts.
+#   string sublocality = 8;
+#
+#   // Unstructured address lines describing the lower levels of an address.
+#   //
+#   // Because values in address_lines do not have type information and may
+#   // sometimes contain multiple values in a single field (e.g.
+#   // "Austin, TX"), it is important that the line order is clear. The order of
+#   // address lines should be "envelope order" for the country/region of the
+#   // address. In places where this can vary (e.g. Japan), address_language is
+#   // used to make it explicit (e.g. "ja" for large-to-small ordering and
+#   // "ja-Latn" or "en" for small-to-large). This way, the most specific line of
+#   // an address can be selected based on the language.
+#   //
+#   // The minimum permitted structural representation of an address consists
+#   // of a region_code with all remaining information placed in the
+#   // address_lines. It would be possible to format such an address very
+#   // approximately without geocoding, but no semantic reasoning could be
+#   // made about any of the address components until it was at least
+#   // partially resolved.
+#   //
+#   // Creating an address only containing a region_code and address_lines, and
+#   // then geocoding is the recommended way to handle completely unstructured
+#   // addresses (as opposed to guessing which parts of the address should be
+#   // localities or administrative areas).
+#   repeated string address_lines = 9;
+#
+#   // Optional. The recipient at the address.
+#   // This field may, under certain circumstances, contain multiline information.
+#   // For example, it might contain "care of" information.
+#   repeated string recipients = 10;
+#
+#   // Optional. The name of the organization at the address.
+#   string organization = 11;
+# }