google-apis-cloudsupport_v2beta 0.29.0 → 0.30.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 830828f2aa8c15a43792d906e3cdcb2e9939a8cbf2c78884eb128142b9c6bc41
-  data.tar.gz: a5f1d248605fac28186593ff9d044c8a9de9402cfdfd4453a121ded809fbc1f0
+  metadata.gz: 60b587971c26792180f3e50037112626cb0694e231879c7ac29384671190c903
+  data.tar.gz: e1849c4c3eb317c1c591bd8c8b926787a7181eb3e8a7d58e1f2fa8cc743b87e4
 SHA512:
-  metadata.gz: 060cdc500def2ffe81f39ce67389cf1f43c2159579a6143ae8141c3f2a8433522afa81945cb2f59bb1a24c01ceba2c0bca1f8e2a69c66dbcd4200a066f7bc64b
-  data.tar.gz: c2205e5045b2616a337bae00d86c97efcfc1e616a160318378d0601649a3f54bac34a5dd60f51c71dcb2221bff689e20be41e40d70aa20939c40d7c0602db8af
+  metadata.gz: c8471742b07bafee3d606362e14811961d8b6a9d44808a826ee65211bf99e24bd73c21e7937d30e9edf16f32f2edb066781d568f0a4166175336bf66cedff407
+  data.tar.gz: a02e2a43f578872298968aaf3dca6b662723c26faca2cdfc07cee7b9b19e699a7a6fe389766556b3b4cb9a19f856d427cbfced08ca96b25b18ff61cae7edbbdf

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-cloudsupport_v2beta
 
+### 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
       
@@ -325,7 +355,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 +372,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 +535,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

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.30.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.12.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20230926"
+      REVISION = "20231217"
     end
   end
 end

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

@@ -184,6 +184,7 @@ module Google
           property :display_name, as: 'displayName'
           property :email, as: 'email'
           property :google_support, as: 'googleSupport'
+          property :username, as: 'username'
         end
       end
       

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.30.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-10-01 00:00:00.000000000 Z
+date: 2023-12-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -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.30.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-cloudsupport_v2beta
 post_install_message: 
 rdoc_options: []