google-shopping-merchant-accounts-v1beta 0.a → 0.1.2

data/proto_docs/google/shopping/type/types.rb

@@ -0,0 +1,210 @@
+# frozen_string_literal: true
+
+# Copyright 2024 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
+#
+#     https://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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Shopping
+    module Type
+      # The weight represented as the value in string and the unit.
+      # @!attribute [rw] amount_micros
+      #   @return [::Integer]
+      #     Required. The weight represented as a number in micros (1 million micros is
+      #     an equivalent to one's currency standard unit, for example, 1 kg = 1000000
+      #     micros).
+      #     This field can also be set as infinity by setting to -1.
+      #     This field only support -1 and positive value.
+      # @!attribute [rw] unit
+      #   @return [::Google::Shopping::Type::Weight::WeightUnit]
+      #     Required. The weight unit.
+      #     Acceptable values are: kg and lb
+      class Weight
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+
+        # The weight unit.
+        module WeightUnit
+          # unit unspecified
+          WEIGHT_UNIT_UNSPECIFIED = 0
+
+          # lb unit.
+          POUND = 1
+
+          # kg unit.
+          KILOGRAM = 2
+        end
+      end
+
+      # The price represented as a number and currency.
+      # @!attribute [rw] amount_micros
+      #   @return [::Integer]
+      #     The price represented as a number in micros (1 million micros is an
+      #     equivalent to one's currency standard unit, for example, 1 USD = 1000000
+      #     micros).
+      # @!attribute [rw] currency_code
+      #   @return [::String]
+      #     The currency of the price using three-letter acronyms according to [ISO
+      #     4217](http://en.wikipedia.org/wiki/ISO_4217).
+      class Price
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
+
+      # A message that represents custom attributes. Exactly one of `value` or
+      # `group_values` must not be empty.
+      # @!attribute [rw] name
+      #   @return [::String]
+      #     The name of the attribute.
+      # @!attribute [rw] value
+      #   @return [::String]
+      #     The value of the attribute. If `value` is not empty, `group_values` must be
+      #     empty.
+      # @!attribute [rw] group_values
+      #   @return [::Array<::Google::Shopping::Type::CustomAttribute>]
+      #     Subattributes within this attribute group.  If
+      #     `group_values` is not empty, `value` must be empty.
+      class CustomAttribute
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
+
+      # Destinations available for a product.
+      #
+      # Destinations are used in Merchant Center to allow you to control where the
+      # products from your data feed should be displayed.
+      class Destination
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+
+        # Destination values.
+        module DestinationEnum
+          # Not specified.
+          DESTINATION_ENUM_UNSPECIFIED = 0
+
+          # [Shopping ads](https://support.google.com/google-ads/answer/2454022).
+          SHOPPING_ADS = 1
+
+          # [Display ads](https://support.google.com/merchants/answer/6069387).
+          DISPLAY_ADS = 2
+
+          # [Local inventory
+          # ads](https://support.google.com/merchants/answer/3057972).
+          LOCAL_INVENTORY_ADS = 3
+
+          # [Free listings](https://support.google.com/merchants/answer/9199328).
+          FREE_LISTINGS = 4
+
+          # [Free local product
+          # listings](https://support.google.com/merchants/answer/9825611).
+          FREE_LOCAL_LISTINGS = 5
+
+          # [YouTube Shopping](https://support.google.com/merchants/answer/12362804).
+          YOUTUBE_SHOPPING = 6
+        end
+      end
+
+      # Reporting contexts that your account and product issues apply to.
+      #
+      # Reporting contexts are groups of surfaces and formats for product results on
+      # Google. They can represent the entire destination (for example, [Shopping
+      # ads](https://support.google.com/merchants/answer/6149970)) or a subset of
+      # formats within a destination (for example, [Demand Gen
+      # ads](https://support.google.com/merchants/answer/13389785)).
+      class ReportingContext
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+
+        # Reporting context values.
+        module ReportingContextEnum
+          # Not specified.
+          REPORTING_CONTEXT_ENUM_UNSPECIFIED = 0
+
+          # [Shopping ads](https://support.google.com/merchants/answer/6149970).
+          SHOPPING_ADS = 1
+
+          # Deprecated:  Use `DEMAND_GEN_ADS` instead.
+          # [Discovery and Demand Gen
+          # ads](https://support.google.com/merchants/answer/13389785).
+          DISCOVERY_ADS = 2
+
+          # [Demand Gen ads](https://support.google.com/merchants/answer/13389785).
+          DEMAND_GEN_ADS = 13
+
+          # [Demand Gen ads on Discover
+          # surface](https://support.google.com/merchants/answer/13389785).
+          DEMAND_GEN_ADS_DISCOVER_SURFACE = 14
+
+          # [Video ads](https://support.google.com/google-ads/answer/6340491).
+          VIDEO_ADS = 3
+
+          # [Display ads](https://support.google.com/merchants/answer/6069387).
+          DISPLAY_ADS = 4
+
+          # [Local inventory
+          # ads](https://support.google.com/merchants/answer/3271956).
+          LOCAL_INVENTORY_ADS = 5
+
+          # [Vehicle inventory
+          # ads](https://support.google.com/merchants/answer/11544533).
+          VEHICLE_INVENTORY_ADS = 6
+
+          # [Free product
+          # listings](https://support.google.com/merchants/answer/9199328).
+          FREE_LISTINGS = 7
+
+          # [Free local product
+          # listings](https://support.google.com/merchants/answer/9825611).
+          FREE_LOCAL_LISTINGS = 8
+
+          # [Free local vehicle
+          # listings](https://support.google.com/merchants/answer/11544533).
+          FREE_LOCAL_VEHICLE_LISTINGS = 9
+
+          # [YouTube
+          # Shopping](https://support.google.com/merchants/answer/13478370).
+          YOUTUBE_SHOPPING = 10
+
+          # [Cloud retail](https://cloud.google.com/solutions/retail).
+          CLOUD_RETAIL = 11
+
+          # [Local cloud retail](https://cloud.google.com/solutions/retail).
+          LOCAL_CLOUD_RETAIL = 12
+        end
+      end
+
+      # [Channel](https://support.google.com/merchants/answer/7361332) of a product.
+      #
+      # Channel is used to distinguish between online and local products.
+      class Channel
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+
+        # Channel values.
+        module ChannelEnum
+          # Not specified.
+          CHANNEL_ENUM_UNSPECIFIED = 0
+
+          # Online product.
+          ONLINE = 1
+
+          # Local product.
+          LOCAL = 2
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/type/date.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+# Copyright 2024 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
+#
+#     https://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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Type
+    # Represents a whole or partial calendar date, such as a birthday. The time of
+    # day and time zone are either specified elsewhere or are insignificant. The
+    # date is relative to the Gregorian Calendar. This can represent one of the
+    # following:
+    #
+    # * A full date, with non-zero year, month, and day values
+    # * A month and day value, with a zero year, such as an anniversary
+    # * A year on its own, with zero month and day values
+    # * A year and month value, with a zero day, such as a credit card expiration
+    # date
+    #
+    # Related types are [google.type.TimeOfDay][google.type.TimeOfDay] and
+    # `google.protobuf.Timestamp`.
+    # @!attribute [rw] year
+    #   @return [::Integer]
+    #     Year of the date. Must be from 1 to 9999, or 0 to specify a date without
+    #     a year.
+    # @!attribute [rw] month
+    #   @return [::Integer]
+    #     Month of a year. Must be from 1 to 12, or 0 to specify a year without a
+    #     month and day.
+    # @!attribute [rw] day
+    #   @return [::Integer]
+    #     Day of a month. Must be from 1 to 31 and valid for the year and month, or 0
+    #     to specify a year by itself or a year and month where the day isn't
+    #     significant.
+    class Date
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+  end
+end

data/proto_docs/google/type/datetime.rb

@@ -0,0 +1,99 @@
+# frozen_string_literal: true
+
+# Copyright 2024 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
+#
+#     https://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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Type
+    # Represents civil time (or occasionally physical time).
+    #
+    # This type can represent a civil time in one of a few possible ways:
+    #
+    #  * When utc_offset is set and time_zone is unset: a civil time on a calendar
+    #    day with a particular offset from UTC.
+    #  * When time_zone is set and utc_offset is unset: a civil time on a calendar
+    #    day in a particular time zone.
+    #  * When neither time_zone nor utc_offset is set: a civil time on a calendar
+    #    day in local time.
+    #
+    # The date is relative to the Proleptic Gregorian Calendar.
+    #
+    # If year is 0, the DateTime is considered not to have a specific year. month
+    # and day must have valid, non-zero values.
+    #
+    # This type may also be used to represent a physical time if all the date and
+    # time fields are set and either case of the `time_offset` oneof is set.
+    # Consider using `Timestamp` message for physical time instead. If your use
+    # case also would like to store the user's timezone, that can be done in
+    # another field.
+    #
+    # This type is more flexible than some applications may want. Make sure to
+    # document and validate your application's limitations.
+    # @!attribute [rw] year
+    #   @return [::Integer]
+    #     Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a
+    #     datetime without a year.
+    # @!attribute [rw] month
+    #   @return [::Integer]
+    #     Required. Month of year. Must be from 1 to 12.
+    # @!attribute [rw] day
+    #   @return [::Integer]
+    #     Required. Day of month. Must be from 1 to 31 and valid for the year and
+    #     month.
+    # @!attribute [rw] hours
+    #   @return [::Integer]
+    #     Required. Hours of day in 24 hour format. Should be from 0 to 23. An API
+    #     may choose to allow the value "24:00:00" for scenarios like business
+    #     closing time.
+    # @!attribute [rw] minutes
+    #   @return [::Integer]
+    #     Required. Minutes of hour of day. Must be from 0 to 59.
+    # @!attribute [rw] seconds
+    #   @return [::Integer]
+    #     Required. Seconds of minutes of the time. Must normally be from 0 to 59. An
+    #     API may allow the value 60 if it allows leap-seconds.
+    # @!attribute [rw] nanos
+    #   @return [::Integer]
+    #     Required. Fractions of seconds in nanoseconds. Must be from 0 to
+    #     999,999,999.
+    # @!attribute [rw] utc_offset
+    #   @return [::Google::Protobuf::Duration]
+    #     UTC offset. Must be whole seconds, between -18 hours and +18 hours.
+    #     For example, a UTC offset of -4:00 would be represented as
+    #     { seconds: -14400 }.
+    # @!attribute [rw] time_zone
+    #   @return [::Google::Type::TimeZone]
+    #     Time zone.
+    class DateTime
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # Represents a time zone from the
+    # [IANA Time Zone Database](https://www.iana.org/time-zones).
+    # @!attribute [rw] id
+    #   @return [::String]
+    #     IANA Time Zone Database time zone, e.g. "America/New_York".
+    # @!attribute [rw] version
+    #   @return [::String]
+    #     Optional. IANA Time Zone Database version number, e.g. "2019a".
+    class TimeZone
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+  end
+end

data/proto_docs/google/type/interval.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+# Copyright 2024 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
+#
+#     https://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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Type
+    # Represents a time interval, encoded as a Timestamp start (inclusive) and a
+    # Timestamp end (exclusive).
+    #
+    # The start must be less than or equal to the end.
+    # When the start equals the end, the interval is empty (matches no time).
+    # When both start and end are unspecified, the interval matches any time.
+    # @!attribute [rw] start_time
+    #   @return [::Google::Protobuf::Timestamp]
+    #     Optional. Inclusive start of the interval.
+    #
+    #     If specified, a Timestamp matching this interval will have to be the same
+    #     or after the start.
+    # @!attribute [rw] end_time
+    #   @return [::Google::Protobuf::Timestamp]
+    #     Optional. Exclusive end of the interval.
+    #
+    #     If specified, a Timestamp matching this interval will have to be before the
+    #     end.
+    class Interval
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+  end
+end

data/proto_docs/google/type/phone_number.rb

@@ -0,0 +1,112 @@
+# frozen_string_literal: true
+
+# Copyright 2024 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
+#
+#     https://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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Type
+    # 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
+    # @!attribute [rw] e164_number
+    #   @return [::String]
+    #     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
+    # @!attribute [rw] short_code
+    #   @return [::Google::Type::PhoneNumber::ShortCode]
+    #     A short code.
+    #
+    #     Reference(s):
+    #      - https://en.wikipedia.org/wiki/Short_code
+    # @!attribute [rw] extension
+    #   @return [::String]
+    #     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.
+    class PhoneNumber
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+
+      # 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).
+      # @!attribute [rw] region_code
+      #   @return [::String]
+      #     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
+      # @!attribute [rw] number
+      #   @return [::String]
+      #     Required. The short code digits, without a leading plus ('+') or country
+      #     calling code, e.g. "611".
+      class ShortCode
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
+    end
+  end
+end

data/proto_docs/google/type/postal_address.rb

@@ -0,0 +1,135 @@
+# frozen_string_literal: true
+
+# Copyright 2024 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
+#
+#     https://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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Type
+    # 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
+    # @!attribute [rw] revision
+    #   @return [::Integer]
+    #     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.
+    # @!attribute [rw] region_code
+    #   @return [::String]
+    #     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.
+    # @!attribute [rw] language_code
+    #   @return [::String]
+    #     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".
+    # @!attribute [rw] postal_code
+    #   @return [::String]
+    #     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.).
+    # @!attribute [rw] sorting_code
+    #   @return [::String]
+    #     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).
+    # @!attribute [rw] administrative_area
+    #   @return [::String]
+    #     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.
+    # @!attribute [rw] locality
+    #   @return [::String]
+    #     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.
+    # @!attribute [rw] sublocality
+    #   @return [::String]
+    #     Optional. Sublocality of the address.
+    #     For example, this can be neighborhoods, boroughs, districts.
+    # @!attribute [rw] address_lines
+    #   @return [::Array<::String>]
+    #     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).
+    # @!attribute [rw] recipients
+    #   @return [::Array<::String>]
+    #     Optional. The recipient at the address.
+    #     This field may, under certain circumstances, contain multiline information.
+    #     For example, it might contain "care of" information.
+    # @!attribute [rw] organization
+    #   @return [::String]
+    #     Optional. The name of the organization at the address.
+    class PostalAddress
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+  end
+end