google-apis-cloudsupport_v2beta 0.28.0 → 0.30.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9f39d56eb38f84807afcfc4c6dbda7197df541f382edb784579e394b36b1f29e
-  data.tar.gz: a04dfebf26395a2bce4d166eeabaa853ea0ded7cf5a373b648356c0dd3eaee12
+  metadata.gz: 60b587971c26792180f3e50037112626cb0694e231879c7ac29384671190c903
+  data.tar.gz: e1849c4c3eb317c1c591bd8c8b926787a7181eb3e8a7d58e1f2fa8cc743b87e4
 SHA512:
-  metadata.gz: 3fd82da5e727575991a90a4b0c476685397011c0787ccd5bc7fd12719d7e87e04954dcd326c52809194210ab26263bc0cd8fec1b10a08df1e2b1be79a63d9f9f
-  data.tar.gz: 61470fbbc9eae8fcb75788326e5a1c89732a72991e9b556e4b19a604bec98e9f6239b53e4fb51aaf20d15f5ca43ff1f2ef6be59ffd19578703d69d68ff4f3c20
+  metadata.gz: c8471742b07bafee3d606362e14811961d8b6a9d44808a826ee65211bf99e24bd73c21e7937d30e9edf16f32f2edb066781d568f0a4166175336bf66cedff407
+  data.tar.gz: a02e2a43f578872298968aaf3dca6b662723c26faca2cdfc07cee7b9b19e699a7a6fe389766556b3b4cb9a19f856d427cbfced08ca96b25b18ff61cae7edbbdf

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # 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
+
 ### v0.28.0 (2023-09-24)
 
 * Regenerated from discovery document revision 20230920

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.28.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 = "20230920"
+      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
       

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

@@ -417,19 +417,17 @@ module Google
         #   projects/`. - `state`: Can be `OPEN` or `CLOSED`. - `priority`: Can be `P0`, `
         #   P1`, `P2`, `P3`, or `P4`. You can specify multiple values for priority using
         #   the `OR` operator. For example, `priority=P1 OR priority=P2`. - `creator.email`
-        #   : The email address of the case creator. - `billingAccount`: A billing account
-        #   in the form `billingAccounts/` You must specify either `organization` or `
-        #   project`. To search across `displayName`, `description`, and comments, use a
-        #   global restriction with no keyword or operator. For example, `"my search"`. To
-        #   search only cases updated after a certain date, use `update_time` restricted
-        #   with that particular date, time, and timezone in ISO datetime format. For
-        #   example, `update_time>"2020-01-01T00:00:00-05:00"`. `update_time` only
-        #   supports the greater than operator (`>`). Examples: - `organization="
+        #   : The email address of the case creator. You must specify either `organization`
+        #   or `project`. To search across `displayName`, `description`, and comments,
+        #   use a global restriction with no keyword or operator. For example, `"my search"
+        #   `. To search only cases updated after a certain date, use `update_time`
+        #   restricted with that particular date, time, and timezone in ISO datetime
+        #   format. For example, `update_time>"2020-01-01T00:00:00-05:00"`. `update_time`
+        #   only supports the greater than operator (`>`). Examples: - `organization="
         #   organizations/123456789"` - `project="projects/my-project-id"` - `project="
-        #   projects/123456789"` - `billing_account="billingAccounts/123456-A0B0C0-CUZ789"`
-        #   - `organization="organizations/123456789" AND state=CLOSED` - `project="
-        #   projects/my-project-id" AND creator.email="tester@example.com"` - `project="
-        #   projects/my-project-id" AND (priority=P0 OR priority=P1)`
+        #   projects/123456789"` - `organization="organizations/123456789" AND state=
+        #   CLOSED` - `project="projects/my-project-id" AND creator.email="tester@example.
+        #   com"` - `project="projects/my-project-id" AND (priority=P0 OR priority=P1)`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-cloudsupport_v2beta
 version: !ruby/object:Gem::Version
-  version: 0.28.0
+  version: 0.30.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-09-24 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.28.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: []