google-apis-cloudsupport_v2 0.5.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 890fce46d41bf2e587b6bbe9f5b3f1b30bc7c6b78b0fb4341aa68593d5787a3a
-  data.tar.gz: ce17286d25f9af0d9ff9f32f6c264dde414410166ea527e77113a1bc85297d7a
+  metadata.gz: 3aeb9e31593831b263678efcdd04f3a7cf21e354d9adadd6b71b9baf883e8b79
+  data.tar.gz: c2af4c5666c525df315144451915df1923d860098c5051405ba08ad6fddfbd4c
 SHA512:
-  metadata.gz: 37a77ef56cc1cbaa4dfc378d5e5b4ef2166247a86007ee3e181ea7047873a3ba9ba5102e408d033323e74025f65cd23059de6863f496f6ce421ee6c2011bf68d
-  data.tar.gz: 42e0b9bd8313ac03d75a91d4765c2539fc02acaf75b4d4e1adb99fa04cfbe8abf2696dbe3a900a279a238ade211b19c775e022c294e836564d8a085eab561ddd
+  metadata.gz: '05521524870e9fb2f20d16adbfdd7dce3aac2a220ae8d1f96cdf383ec3c538a1afc6ba49d4e03fab78b609cae15e066017df797d0ac6c6d3dbec8d87ceb749a5'
+  data.tar.gz: e9185c0c7ed26d3156350cb8ddc02bfb2433b4e2edb48e5d6b7aa876f81d032cd4d1100590cd6ca4bda3478b33cc77bf8feeb70b15a946644eeb3a5879c8ad45

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-cloudsupport_v2
 
+### v0.7.0 (2024-01-23)
+
+* Regenerated using generator version 0.13.0
+
+### 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.7.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 = "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
       

data/lib/google/apis/cloudsupport_v2/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_v2',
                 client_version: Google::Apis::CloudsupportV2::GEM_VERSION)
           @batch_path = 'batch'

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.7.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_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.7.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-cloudsupport_v2
 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 V2