feat: Automated regeneration of jobs v3 client (googleapis#22291)

Auto-created at 2025-03-30 10:16:00 +0000 using the toys pull request generator.

Author: yoshi-code-bot

generated/google-apis-jobs_v3/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Release history for google-apis-jobs_v3
 
+### v0.30.0 (2025-03-30)
+
+* Regenerated from discovery document revision 20250326
+* Regenerated using generator version 0.16.0
+
 ### v0.29.0 (2024-12-22)
 
 * Regenerated from discovery document revision 20241217

generated/google-apis-jobs_v3/lib/google/apis/jobs_v3/classes.rb

@@ -1615,16 +1615,16 @@ class Location
         # @return [String]
         attr_accessor :location_type
 
-        # Represents a postal address. For example 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
+        # Represents a postal address (for example, 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 by user input or from importing existing data, depending on the type
-        # of process. Advice on address input / editing: - Use an internationalization-
-        # ready address widget such as https://github.com/google/libaddressinput) -
+        # of process. Advice on address input or editing: - Use an internationalization-
+        # 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, see: https://support.google.com/business/answer/6397478
+        # this schema, see: https://support.google.com/business/answer/6397478.
         # Corresponds to the JSON property `postalAddress`
         # @return [Google::Apis::JobsV3::PostalAddress]
         attr_accessor :postal_address
@@ -1873,46 +1873,46 @@ def update!(**args)
         end
       end
 
-      # Represents a postal address. For example 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
+      # Represents a postal address (for example, 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 by user input or from importing existing data, depending on the type
-      # of process. Advice on address input / editing: - Use an internationalization-
-      # ready address widget such as https://github.com/google/libaddressinput) -
+      # of process. Advice on address input or editing: - Use an internationalization-
+      # 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, see: https://support.google.com/business/answer/6397478
+      # this schema, see: https://support.google.com/business/answer/6397478.
       class PostalAddress
         include Google::Apis::Core::Hashable
 
         # 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 (For example "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 (
-        # For example Japan), address_language is used to make it explicit (For example "
-        # 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
+        # values in `address_lines` do not have type information and may sometimes
+        # contain multiple values in a single field (for example, "Austin, TX"), it is
+        # important that the line order is clear. The order of address lines should be "
+        # envelope order" for the country or region of the address. In places where this
+        # can vary (for example, Japan), `address_language` is used to make it explicit (
+        # for example, "ja" for large-to-small ordering and "ja-Latn" or "en" for small-
+        # to-large). In 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).
+        # 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).
         # Corresponds to the JSON property `addressLines`
         # @return [Array<String>]
         attr_accessor :address_lines
 
         # 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 (For example "Barcelona" and not "Catalonia").
-        # Many countries don't use an administrative area in postal addresses. For
-        # example in Switzerland this should be left unpopulated.
+        # an oblast, or a prefecture. For Spain, this is the province and not the
+        # autonomous community (for example, "Barcelona" and not "Catalonia"). Many
+        # countries don't use an administrative area in postal addresses. For example,
+        # in Switzerland, this should be left unpopulated.
         # Corresponds to the JSON property `administrativeArea`
         # @return [String]
         attr_accessor :administrative_area
@@ -1929,10 +1929,10 @@ class PostalAddress
         # @return [String]
         attr_accessor :language_code
 
-        # 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.
+        # Optional. Generally refers to the city or 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`.
         # Corresponds to the JSON property `locality`
         # @return [String]
         attr_accessor :locality
@@ -1944,8 +1944,8 @@ class PostalAddress
 
         # 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 (For example state/zip validation
-        # in the U.S.A.).
+        # validation with other parts of the address (for example, state or zip code
+        # validation in the United States).
         # Corresponds to the JSON property `postalCode`
         # @return [String]
         attr_accessor :postal_code
@@ -1974,15 +1974,15 @@ class PostalAddress
 
         # 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 (For example "CEDEX 7"), or just a number
+        # optionally followed by a number (for example, "CEDEX 7"), or just a number
         # alone, representing the "sector code" (Jamaica), "delivery area indicator" (
-        # Malawi) or "post office indicator" (For example Côte d'Ivoire).
+        # Malawi) or "post office indicator" (Côte d'Ivoire).
         # Corresponds to the JSON property `sortingCode`
         # @return [String]
         attr_accessor :sorting_code
 
-        # Optional. Sublocality of the address. For example, this can be neighborhoods,
-        # boroughs, districts.
+        # Optional. Sublocality of the address. For example, this can be a neighborhood,
+        # borough, or district.
         # Corresponds to the JSON property `sublocality`
         # @return [String]
         attr_accessor :sublocality

generated/google-apis-jobs_v3/lib/google/apis/jobs_v3/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module JobsV3
       # Version of the google-apis-jobs_v3 gem
-      GEM_VERSION = "0.29.0"
+      GEM_VERSION = "0.30.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.15.1"
+      GENERATOR_VERSION = "0.16.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20241217"
+      REVISION = "20250326"
     end
   end
 end