google-apis-cloudsupport_v2beta 0.29.0 → 0.31.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 830828f2aa8c15a43792d906e3cdcb2e9939a8cbf2c78884eb128142b9c6bc41
-  data.tar.gz: a5f1d248605fac28186593ff9d044c8a9de9402cfdfd4453a121ded809fbc1f0
+  metadata.gz: e3fbae872ccebcbd8c9cbf0e05522f167913c5709ec73d331cb29f7ffd484a5e
+  data.tar.gz: f623929dca7a15dd7c234410b18caa16404f7752dc3cacf639507f68e34b6ea7
 SHA512:
-  metadata.gz: 060cdc500def2ffe81f39ce67389cf1f43c2159579a6143ae8141c3f2a8433522afa81945cb2f59bb1a24c01ceba2c0bca1f8e2a69c66dbcd4200a066f7bc64b
-  data.tar.gz: c2205e5045b2616a337bae00d86c97efcfc1e616a160318378d0601649a3f54bac34a5dd60f51c71dcb2221bff689e20be41e40d70aa20939c40d7c0602db8af
+  metadata.gz: e2c3339617d009059169c8c23b89b31111dd899aa9853722c5d13348875cda6764385d1e698067e1544bd07e22b1a7a0a24d5d85e304df53a840fd59fd51c4a8
+  data.tar.gz: ecd4d5689072f29776ba7f209ebcf076581f6e5dccb9c1247408b2b4823ffa7816216a6e7cc7213aac9e771cdcf3d2b87ed11a0706144b07a341f5789ad39444

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Release history for google-apis-cloudsupport_v2beta
 
+### v0.31.0 (2024-01-23)
+
+* Regenerated from discovery document revision 20240120
+* Regenerated using generator version 0.13.0
+
+### v0.30.0 (2023-12-24)
+
+* Regenerated from discovery document revision 20231217
+
 ### v0.29.0 (2023-10-01)
 
 * Regenerated from discovery document revision 20230926

data/lib/google/apis/cloudsupport_v2beta/classes.rb

@@ -22,8 +22,9 @@ module Google
   module Apis
     module CloudsupportV2beta
       
-      # An object containing information about the effective user and authenticated
-      # principal responsible for an action.
+      # An Actor represents an entity that performed an action. For example, an actor
+      # could be a user who posted a comment on a support case, a user who uploaded an
+      # attachment, or a service account that created a support case.
       class Actor
         include Google::Apis::Core::Hashable
       
@@ -35,11 +36,10 @@ module Google
         # @return [String]
         attr_accessor :display_name
       
-        # The email address of the actor. If not provided, it is inferred from
-        # credentials supplied during case creation. If the authenticated principal does
-        # not have an email address, one must be provided. When a name is provided, an
-        # email must also be provided. This will be obfuscated if the user is a Google
-        # Support agent.
+        # The email address of the actor. If not provided, it is inferred from the
+        # credentials supplied during case creation. When a name is provided, an email
+        # must also be provided. If the user is a Google Support agent, this is
+        # obfuscated. This field is deprecated. Use **username** field instead.
         # Corresponds to the JSON property `email`
         # @return [String]
         attr_accessor :email
@@ -50,6 +50,14 @@ module Google
         attr_accessor :google_support
         alias_method :google_support?, :google_support
       
+        # Output only. The username of the actor. It may look like an email or other
+        # format provided by the identity provider. If not provided, it is inferred from
+        # the credentials supplied. When a name is provided, a username must also be
+        # provided. If the user is a Google Support agent, this will not be set.
+        # Corresponds to the JSON property `username`
+        # @return [String]
+        attr_accessor :username
+      
         def initialize(**args)
            update!(**args)
         end
@@ -59,10 +67,15 @@ module Google
           @display_name = args[:display_name] if args.key?(:display_name)
           @email = args[:email] if args.key?(:email)
           @google_support = args[:google_support] if args.key?(:google_support)
+          @username = args[:username] if args.key?(:username)
         end
       end
       
-      # Represents a file attached to a support case.
+      # An Attachment contains metadata about a file that was uploaded to a case - it
+      # is NOT a file itself. That being said, the name of an Attachment object can be
+      # used to download its accompanying file through the `media.download` endpoint.
+      # While attachments can be uploaded in the console at the same time as a comment,
+      # they're associated on a "case" level, not a "comment" level.
       class Attachment
         include Google::Apis::Core::Hashable
       
@@ -71,8 +84,9 @@ module Google
         # @return [String]
         attr_accessor :create_time
       
-        # An object containing information about the effective user and authenticated
-        # principal responsible for an action.
+        # An Actor represents an entity that performed an action. For example, an actor
+        # could be a user who posted a comment on a support case, a user who uploaded an
+        # attachment, or a service account that created a support case.
         # Corresponds to the JSON property `creator`
         # @return [Google::Apis::CloudsupportV2beta::Actor]
         attr_accessor :creator
@@ -157,11 +171,23 @@ module Google
         end
       end
       
-      # A support case.
+      # A Case is an object that contains the details of a support case. It contains
+      # fields for the time it was created, its priority, its classification, and more.
+      # Cases can also have comments and attachments that get added over time. A case
+      # is parented by a Google Cloud organization or project. Organizations are
+      # identified by a number, so the name of a case parented by an organization
+      # would look like this: ``` organizations/123/cases/456 ``` Projects have two
+      # unique identifiers, an ID and a number, and they look like this: ``` projects/
+      # abc/cases/456 ``` ``` projects/123/cases/456 ``` You can use either of them
+      # when calling the API. To learn more about project identifiers, see [AIP-2510](
+      # https://google.aip.dev/cloud/2510).
       class Case
         include Google::Apis::Core::Hashable
       
-        # A classification object with a product type and value.
+        # A Case Classification represents the topic that a case is about. It's very
+        # important to use accurate classifications, because they're used to route your
+        # cases to specialists who can help you. A classification always has an ID that
+        # is its unique identifier. A valid ID is required when creating a case.
         # Corresponds to the JSON property `classification`
         # @return [Google::Apis::CloudsupportV2beta::CaseClassification]
         attr_accessor :classification
@@ -178,8 +204,9 @@ module Google
         # @return [String]
         attr_accessor :create_time
       
-        # An object containing information about the effective user and authenticated
-        # principal responsible for an action.
+        # An Actor represents an entity that performed an action. For example, an actor
+        # could be a user who posted a comment on a support case, a user who uploaded an
+        # attachment, or a service account that created a support case.
         # Corresponds to the JSON property `creator`
         # @return [Google::Apis::CloudsupportV2beta::Actor]
         attr_accessor :creator
@@ -280,7 +307,10 @@ module Google
         end
       end
       
-      # A classification object with a product type and value.
+      # A Case Classification represents the topic that a case is about. It's very
+      # important to use accurate classifications, because they're used to route your
+      # cases to specialists who can help you. A classification always has an ID that
+      # is its unique identifier. A valid ID is required when creating a case.
       class CaseClassification
         include Google::Apis::Core::Hashable
       
@@ -301,6 +331,12 @@ module Google
         # @return [String]
         attr_accessor :id
       
+        # The full product a case may be associated with, including Product Line and
+        # Product Subline.
+        # Corresponds to the JSON property `product`
+        # @return [Google::Apis::CloudsupportV2beta::Product]
+        attr_accessor :product
+      
         def initialize(**args)
            update!(**args)
         end
@@ -309,6 +345,7 @@ module Google
         def update!(**args)
           @display_name = args[:display_name] if args.key?(:display_name)
           @id = args[:id] if args.key?(:id)
+          @product = args[:product] if args.key?(:product)
         end
       end
       
@@ -325,7 +362,9 @@ module Google
         end
       end
       
-      # A comment associated with a support case.
+      # Case comments are the main way Google Support communicates with a user who has
+      # opened a case. When a user responds to Google Support, the user's responses
+      # also appear as comments.
       class Comment
         include Google::Apis::Core::Hashable
       
@@ -340,8 +379,9 @@ module Google
         # @return [String]
         attr_accessor :create_time
       
-        # An object containing information about the effective user and authenticated
-        # principal responsible for an action.
+        # An Actor represents an entity that performed an action. For example, an actor
+        # could be a user who posted a comment on a support case, a user who uploaded an
+        # attachment, or a service account that created a support case.
         # Corresponds to the JSON property `creator`
         # @return [Google::Apis::CloudsupportV2beta::Actor]
         attr_accessor :creator
@@ -502,7 +542,11 @@ module Google
       class CreateAttachmentRequest
         include Google::Apis::Core::Hashable
       
-        # Represents a file attached to a support case.
+        # An Attachment contains metadata about a file that was uploaded to a case - it
+        # is NOT a file itself. That being said, the name of an Attachment object can be
+        # used to download its accompanying file through the `media.download` endpoint.
+        # While attachments can be uploaded in the console at the same time as a comment,
+        # they're associated on a "case" level, not a "comment" level.
         # Corresponds to the JSON property `attachment`
         # @return [Google::Apis::CloudsupportV2beta::Attachment]
         attr_accessor :attachment
@@ -1048,6 +1092,32 @@ module Google
         end
       end
       
+      # The full product a case may be associated with, including Product Line and
+      # Product Subline.
+      class Product
+        include Google::Apis::Core::Hashable
+      
+        # The Product Line of the Product.
+        # Corresponds to the JSON property `productLine`
+        # @return [String]
+        attr_accessor :product_line
+      
+        # The Product Subline of the Product, such as "Maps Billing".
+        # Corresponds to the JSON property `productSubline`
+        # @return [String]
+        attr_accessor :product_subline
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @product_line = args[:product_line] if args.key?(:product_line)
+          @product_subline = args[:product_subline] if args.key?(:product_subline)
+        end
+      end
+      
       # The response message for SearchCaseClassifications endpoint.
       class SearchCaseClassificationsResponse
         include Google::Apis::Core::Hashable

data/lib/google/apis/cloudsupport_v2beta/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module CloudsupportV2beta
       # Version of the google-apis-cloudsupport_v2beta gem
-      GEM_VERSION = "0.29.0"
+      GEM_VERSION = "0.31.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.12.0"
+      GENERATOR_VERSION = "0.13.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20230926"
+      REVISION = "20240120"
     end
   end
 end

data/lib/google/apis/cloudsupport_v2beta/representations.rb

@@ -160,6 +160,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class Product
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class SearchCaseClassificationsResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -184,6 +190,7 @@ module Google
           property :display_name, as: 'displayName'
           property :email, as: 'email'
           property :google_support, as: 'googleSupport'
+          property :username, as: 'username'
         end
       end
       
@@ -240,6 +247,8 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :display_name, as: 'displayName'
           property :id, as: 'id'
+          property :product, as: 'product', class: Google::Apis::CloudsupportV2beta::Product, decorator: Google::Apis::CloudsupportV2beta::Product::Representation
+      
         end
       end
       
@@ -454,6 +463,14 @@ module Google
         end
       end
       
+      class Product
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :product_line, as: 'productLine'
+          property :product_subline, as: 'productSubline'
+        end
+      end
+      
       class SearchCaseClassificationsResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/lib/google/apis/cloudsupport_v2beta/service.rb

@@ -33,6 +33,8 @@ module Google
       #
       # @see https://cloud.google.com/support/docs/apis
       class CloudSupportService < Google::Apis::Core::BaseService
+        DEFAULT_ENDPOINT_TEMPLATE = "https://cloudsupport.$UNIVERSE_DOMAIN$/"
+
         # @return [String]
         #  API key. Your API key identifies your project and provides you with API access,
         #  quota, and reports. Required unless you provide an OAuth 2.0 token.
@@ -44,7 +46,7 @@ module Google
         attr_accessor :quota_user
 
         def initialize
-          super('https://cloudsupport.googleapis.com/', '',
+          super(DEFAULT_ENDPOINT_TEMPLATE, '',
                 client_name: 'google-apis-cloudsupport_v2beta',
                 client_version: Google::Apis::CloudsupportV2beta::GEM_VERSION)
           @batch_path = 'batch'
@@ -311,6 +313,8 @@ module Google
         # @param [String] page_token
         #   A token identifying the page of results to return. If unspecified, the first
         #   page is retrieved.
+        # @param [String] product_line
+        #   The product line to request cases for.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -328,7 +332,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_cases(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def list_cases(parent, filter: nil, page_size: nil, page_token: nil, product_line: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:get, 'v2beta/{+parent}/cases', options)
           command.response_representation = Google::Apis::CloudsupportV2beta::ListCasesResponse::Representation
           command.response_class = Google::Apis::CloudsupportV2beta::ListCasesResponse
@@ -336,6 +340,7 @@ module Google
           command.query['filter'] = filter unless filter.nil?
           command.query['pageSize'] = page_size unless page_size.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['productLine'] = product_line unless product_line.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-cloudsupport_v2beta
 version: !ruby/object:Gem::Version
-  version: 0.29.0
+  version: 0.31.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-10-01 00:00:00.000000000 Z
+date: 2024-01-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.11.0
+        version: 0.12.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.11.0
+        version: 0.12.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-cloudsupport_v2beta/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-cloudsupport_v2beta/v0.29.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-cloudsupport_v2beta/v0.31.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-cloudsupport_v2beta
 post_install_message: 
 rdoc_options: []
@@ -75,7 +75,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
+rubygems_version: 3.5.3
 signing_key: 
 specification_version: 4
 summary: Simple REST client for Google Cloud Support API V2beta