google-apis-cloudsupport_v2 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 890fce46d41bf2e587b6bbe9f5b3f1b30bc7c6b78b0fb4341aa68593d5787a3a
-  data.tar.gz: ce17286d25f9af0d9ff9f32f6c264dde414410166ea527e77113a1bc85297d7a
+  metadata.gz: 9855bd223eb33fd972bbce63cf9eb6dad8aaae4d1993efb78c87ca039469775c
+  data.tar.gz: 5ea09b7507768bf1d12766f4edb33b7dd40080df369a4551a51b421262d2860f
 SHA512:
-  metadata.gz: 37a77ef56cc1cbaa4dfc378d5e5b4ef2166247a86007ee3e181ea7047873a3ba9ba5102e408d033323e74025f65cd23059de6863f496f6ce421ee6c2011bf68d
-  data.tar.gz: 42e0b9bd8313ac03d75a91d4765c2539fc02acaf75b4d4e1adb99fa04cfbe8abf2696dbe3a900a279a238ade211b19c775e022c294e836564d8a085eab561ddd
+  metadata.gz: 898ff4f6b1c44cb0ef5783815461cff738fd1ffb297b0beb26843cf3f5cbabaff75849b306f05440cf18cb03eee6117c9d89f51a7cd6c7309611c604d7017e64
+  data.tar.gz: 6119c7f3666be20c0364842685360e442e7bd34040c0590b9ea3c3900831bbe13386c709e511773bf47868bfcb96de439270a357dc24fd21b6ff2a30bfc77fec

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-cloudsupport_v2
 
+### v0.6.0 (2023-12-24)
+
+* Regenerated from discovery document revision 20231217
+
 ### v0.5.0 (2023-10-01)
 
 * Regenerated from discovery document revision 20230926

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

@@ -22,8 +22,9 @@ module Google
   module Apis
     module CloudsupportV2
       
-      # 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::CloudsupportV2::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::CloudsupportV2::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::CloudsupportV2::Actor]
         attr_accessor :creator
@@ -274,7 +301,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
       
@@ -319,7 +349,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
       
@@ -334,8 +366,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::CloudsupportV2::Actor]
         attr_accessor :creator
@@ -496,7 +529,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::CloudsupportV2::Attachment]
         attr_accessor :attachment

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

@@ -16,13 +16,13 @@ module Google
   module Apis
     module CloudsupportV2
       # Version of the google-apis-cloudsupport_v2 gem
-      GEM_VERSION = "0.5.0"
+      GEM_VERSION = "0.6.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_v2/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_v2
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.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_v2/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-cloudsupport_v2/v0.5.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-cloudsupport_v2/v0.6.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-cloudsupport_v2
 post_install_message: 
 rdoc_options: []