google-apis-domains_v1 0.19.0 → 0.21.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 77dc1449f998932e9b30d03fa4b240364cef75291859442e40bcdeda28bf7c72
-  data.tar.gz: 7becc47df5549e36de8dbd4cb6a4bdf5838ef6169fbe502a73d6cb98927d315d
+  metadata.gz: e29182a56a3b901a3fe015e02f10353f0aabab6b480dbd22bb17ce40236859a5
+  data.tar.gz: 640aca2b681536e407ca65e608f02c25ce03d910df9a06d421ba2e825215e6ed
 SHA512:
-  metadata.gz: 97f08be1b33aefd7f3777e2ad3e2298bc42cc5b7ec1d525874ebfe06f809b295144b198956fa187eb13d33629af085c3b334623bb83039a50f807d123da99d3d
-  data.tar.gz: 4f8717314fcf4d55c76e06f81e9a4c98b3a53976a73c4051fe4a9ce7b7dc2834a742c2da336f40d986def91586ec4ca1fda03c23abafe30efdc162cede01b3b2
+  metadata.gz: 9cf82bb7eb8bad9669a5d16b9853bc0438fb56bbef63c79f99237e3958a517e977f22d618f26b76775275c54da15d82c51938d9bf49a801f0b5db0c5139ef914
+  data.tar.gz: 0f66d8711989e0c84f835ca84fd5216a2a194b777e0ecee2227a71abc3cea20ce3dad27f5ff772757ab83ee14a855d38a54db944bb46cc6f160f6bf25537f280

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-domains_v1
 
+### v0.21.0 (2023-11-12)
+
+* Regenerated from discovery document revision 20231108
+
+### v0.20.0 (2023-09-10)
+
+* Regenerated from discovery document revision 20230904
+
 ### v0.19.0 (2023-05-14)
 
 * Regenerated from discovery document revision 20230503

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

@@ -431,6 +431,8 @@ module Google
         # @return [Array<Google::Apis::DomainsV1::GlueRecord>]
         attr_accessor :glue_records
       
+        # Deprecated: For more information, see [Cloud Domains feature deprecation](
+        # https://cloud.google.com/domains/docs/deprecations/feature-deprecations)
         # Configuration for using the free DNS zone provided by Google Domains as a `
         # Registration`'s `dns_provider`. You cannot configure the DNS zone itself using
         # the API. To configure the DNS zone, go to [Google Domains](https://domains.
@@ -521,6 +523,8 @@ module Google
         end
       end
       
+      # Deprecated: For more information, see [Cloud Domains feature deprecation](
+      # https://cloud.google.com/domains/docs/deprecations/feature-deprecations)
       # Request for the `ExportRegistration` method.
       class ExportRegistrationRequest
         include Google::Apis::Core::Hashable
@@ -627,6 +631,8 @@ module Google
         end
       end
       
+      # Deprecated: For more information, see [Cloud Domains feature deprecation](
+      # https://cloud.google.com/domains/docs/deprecations/feature-deprecations)
       # Configuration for using the free DNS zone provided by Google Domains as a `
       # Registration`'s `dns_provider`. You cannot configure the DNS zone itself using
       # the API. To configure the DNS zone, go to [Google Domains](https://domains.
@@ -667,6 +673,8 @@ module Google
         end
       end
       
+      # Deprecated: For more information, see [Cloud Domains feature deprecation](
+      # https://cloud.google.com/domains/docs/deprecations/feature-deprecations)
       # Request for the `ImportDomain` method.
       class ImportDomainRequest
         include Google::Apis::Core::Hashable
@@ -820,7 +828,28 @@ module Google
       class ManagementSettings
         include Google::Apis::Core::Hashable
       
-        # Output only. The renewal method for this `Registration`.
+        # Optional. The desired renewal method for this `Registration`. The actual `
+        # renewal_method` is automatically updated to reflect this choice. If unset or
+        # equal to `RENEWAL_METHOD_UNSPECIFIED`, it will be treated as if it were set to
+        # `AUTOMATIC_RENEWAL`. Can't be set to `RENEWAL_DISABLED` during resource
+        # creation and can only be updated when the `Registration` resource has state `
+        # ACTIVE` or `SUSPENDED`. When `preferred_renewal_method` is set to `
+        # AUTOMATIC_RENEWAL` the actual `renewal_method` can be set to `RENEWAL_DISABLED`
+        # in case of e.g. problems with the Billing Account or reported domain abuse.
+        # In such cases check the `issues` field on the `Registration`. After the
+        # problem is resolved the `renewal_method` will be automatically updated to `
+        # preferred_renewal_method` in a few hours.
+        # Corresponds to the JSON property `preferredRenewalMethod`
+        # @return [String]
+        attr_accessor :preferred_renewal_method
+      
+        # Output only. The actual renewal method for this `Registration`. When `
+        # preferred_renewal_method` is set to `AUTOMATIC_RENEWAL` the actual `
+        # renewal_method` can be equal to `RENEWAL_DISABLED` in case of e.g. problems
+        # with the Billing Account or reported domain abuse. In such cases check the `
+        # issues` field on the `Registration`. After the problem is resolved the `
+        # renewal_method` will be automatically updated to `preferred_renewal_method` in
+        # a few hours.
         # Corresponds to the JSON property `renewalMethod`
         # @return [String]
         attr_accessor :renewal_method
@@ -836,6 +865,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @preferred_renewal_method = args[:preferred_renewal_method] if args.key?(:preferred_renewal_method)
           @renewal_method = args[:renewal_method] if args.key?(:renewal_method)
           @transfer_lock_state = args[:transfer_lock_state] if args.key?(:transfer_lock_state)
         end
@@ -914,13 +944,13 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # The normal response of the operation in case of success. If the original
-        # method returns no data on success, such as `Delete`, the response is `google.
-        # protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`,
-        # the response should be the resource. For other methods, the response should
-        # have the type `XxxResponse`, where `Xxx` is the original method name. For
-        # example, if the original method name is `TakeSnapshot()`, the inferred
-        # response type is `TakeSnapshotResponse`.
+        # The normal, successful response of the operation. If the original method
+        # returns no data on success, such as `Delete`, the response is `google.protobuf.
+        # Empty`. If the original method is standard `Get`/`Create`/`Update`, the
+        # response should be the resource. For other methods, the response should have
+        # the type `XxxResponse`, where `Xxx` is the original method name. For example,
+        # if the original method name is `TakeSnapshot()`, the inferred response type is
+        # `TakeSnapshotResponse`.
         # Corresponds to the JSON property `response`
         # @return [Hash<String,Object>]
         attr_accessor :response
@@ -999,22 +1029,22 @@ module Google
       # evaluates to `true`. A condition can add constraints based on attributes of
       # the request, the resource, or both. To learn which resources support
       # conditions in their IAM policies, see the [IAM documentation](https://cloud.
-      # google.com/iam/help/conditions/resource-policies). **JSON example:** ` "
+      # google.com/iam/help/conditions/resource-policies). **JSON example:** ``` ` "
       # bindings": [ ` "role": "roles/resourcemanager.organizationAdmin", "members": [
       # "user:mike@example.com", "group:admins@example.com", "domain:google.com", "
       # serviceAccount:my-project-id@appspot.gserviceaccount.com" ] `, ` "role": "
       # roles/resourcemanager.organizationViewer", "members": [ "user:eve@example.com"
       # ], "condition": ` "title": "expirable access", "description": "Does not grant
       # access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:
-      # 00:00.000Z')", ` ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:**
-      # bindings: - members: - user:mike@example.com - group:admins@example.com -
-      # domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com
-      # role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.
-      # com role: roles/resourcemanager.organizationViewer condition: title: expirable
-      # access description: Does not grant access after Sep 2020 expression: request.
-      # time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 For
-      # a description of IAM and its features, see the [IAM documentation](https://
-      # cloud.google.com/iam/docs/).
+      # 00:00.000Z')", ` ` ], "etag": "BwWWja0YfJA=", "version": 3 ` ``` **YAML
+      # example:** ``` bindings: - members: - user:mike@example.com - group:admins@
+      # example.com - domain:google.com - serviceAccount:my-project-id@appspot.
+      # gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: -
+      # user:eve@example.com role: roles/resourcemanager.organizationViewer condition:
+      # title: expirable access description: Does not grant access after Sep 2020
+      # expression: request.time < timestamp('2020-10-01T00:00:00.000Z') etag:
+      # BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the
+      # [IAM documentation](https://cloud.google.com/iam/docs/).
       class Policy
         include Google::Apis::Core::Hashable
       
@@ -1239,12 +1269,16 @@ module Google
         # options. After choosing a name, call `RetrieveRegisterParameters` to ensure
         # availability and obtain information like pricing, which is needed to build a
         # call to `RegisterDomain`. Another way to create a new `Registration` is to
-        # transfer an existing domain from another registrar. First, go to the current
+        # transfer an existing domain from another registrar (Deprecated: For more
+        # information, see [Cloud Domains feature deprecation](https://cloud.google.com/
+        # domains/docs/deprecations/feature-deprecations)). First, go to the current
         # registrar to unlock the domain for transfer and retrieve the domain's transfer
         # authorization code. Then call `RetrieveTransferParameters` to confirm that the
         # domain is unlocked and to get values needed to build a call to `TransferDomain`
         # . Finally, you can create a new `Registration` by importing an existing domain
-        # managed with [Google Domains](https://domains.google/). First, call `
+        # managed with [Google Domains](https://domains.google/) (Deprecated: For more
+        # information, see [Cloud Domains feature deprecation](https://cloud.google.com/
+        # domains/docs/deprecations/feature-deprecations)). First, call `
         # RetrieveImportableDomains` to list domains to which the calling user has
         # sufficient access. Then call `ImportDomain` on any domain names you want to
         # use with Cloud Domains.
@@ -1331,12 +1365,16 @@ module Google
       # options. After choosing a name, call `RetrieveRegisterParameters` to ensure
       # availability and obtain information like pricing, which is needed to build a
       # call to `RegisterDomain`. Another way to create a new `Registration` is to
-      # transfer an existing domain from another registrar. First, go to the current
+      # transfer an existing domain from another registrar (Deprecated: For more
+      # information, see [Cloud Domains feature deprecation](https://cloud.google.com/
+      # domains/docs/deprecations/feature-deprecations)). First, go to the current
       # registrar to unlock the domain for transfer and retrieve the domain's transfer
       # authorization code. Then call `RetrieveTransferParameters` to confirm that the
       # domain is unlocked and to get values needed to build a call to `TransferDomain`
       # . Finally, you can create a new `Registration` by importing an existing domain
-      # managed with [Google Domains](https://domains.google/). First, call `
+      # managed with [Google Domains](https://domains.google/) (Deprecated: For more
+      # information, see [Cloud Domains feature deprecation](https://cloud.google.com/
+      # domains/docs/deprecations/feature-deprecations)). First, call `
       # RetrieveImportableDomains` to list domains to which the calling user has
       # sufficient access. Then call `ImportDomain` on any domain names you want to
       # use with Cloud Domains.
@@ -1419,7 +1457,9 @@ module Google
         # @return [Array<String>]
         attr_accessor :supported_privacy
       
-        # Output only. The reason the domain transfer failed. Only set for domains in
+        # Output only. Deprecated: For more information, see [Cloud Domains feature
+        # deprecation](https://cloud.google.com/domains/docs/deprecations/feature-
+        # deprecations) The reason the domain transfer failed. Only set for domains in
         # TRANSFER_FAILED state.
         # Corresponds to the JSON property `transferFailureReason`
         # @return [String]
@@ -1461,6 +1501,8 @@ module Google
         end
       end
       
+      # Deprecated: For more information, see [Cloud Domains feature deprecation](
+      # https://cloud.google.com/domains/docs/deprecations/feature-deprecations)
       # Response for the `RetrieveImportableDomains` method.
       class RetrieveImportableDomainsResponse
         include Google::Apis::Core::Hashable
@@ -1506,10 +1548,14 @@ module Google
         end
       end
       
+      # Deprecated: For more information, see [Cloud Domains feature deprecation](
+      # https://cloud.google.com/domains/docs/deprecations/feature-deprecations)
       # Response for the `RetrieveTransferParameters` method.
       class RetrieveTransferParametersResponse
         include Google::Apis::Core::Hashable
       
+        # Deprecated: For more information, see [Cloud Domains feature deprecation](
+        # https://cloud.google.com/domains/docs/deprecations/feature-deprecations)
         # Parameters required to transfer a domain from another registrar.
         # Corresponds to the JSON property `transferParameters`
         # @return [Google::Apis::DomainsV1::TransferParameters]
@@ -1559,22 +1605,22 @@ module Google
         # evaluates to `true`. A condition can add constraints based on attributes of
         # the request, the resource, or both. To learn which resources support
         # conditions in their IAM policies, see the [IAM documentation](https://cloud.
-        # google.com/iam/help/conditions/resource-policies). **JSON example:** ` "
+        # google.com/iam/help/conditions/resource-policies). **JSON example:** ``` ` "
         # bindings": [ ` "role": "roles/resourcemanager.organizationAdmin", "members": [
         # "user:mike@example.com", "group:admins@example.com", "domain:google.com", "
         # serviceAccount:my-project-id@appspot.gserviceaccount.com" ] `, ` "role": "
         # roles/resourcemanager.organizationViewer", "members": [ "user:eve@example.com"
         # ], "condition": ` "title": "expirable access", "description": "Does not grant
         # access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:
-        # 00:00.000Z')", ` ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:**
-        # bindings: - members: - user:mike@example.com - group:admins@example.com -
-        # domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com
-        # role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.
-        # com role: roles/resourcemanager.organizationViewer condition: title: expirable
-        # access description: Does not grant access after Sep 2020 expression: request.
-        # time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 For
-        # a description of IAM and its features, see the [IAM documentation](https://
-        # cloud.google.com/iam/docs/).
+        # 00:00.000Z')", ` ` ], "etag": "BwWWja0YfJA=", "version": 3 ` ``` **YAML
+        # example:** ``` bindings: - members: - user:mike@example.com - group:admins@
+        # example.com - domain:google.com - serviceAccount:my-project-id@appspot.
+        # gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: -
+        # user:eve@example.com role: roles/resourcemanager.organizationViewer condition:
+        # title: expirable access description: Does not grant access after Sep 2020
+        # expression: request.time < timestamp('2020-10-01T00:00:00.000Z') etag:
+        # BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the
+        # [IAM documentation](https://cloud.google.com/iam/docs/).
         # Corresponds to the JSON property `policy`
         # @return [Google::Apis::DomainsV1::Policy]
         attr_accessor :policy
@@ -1676,6 +1722,8 @@ module Google
         end
       end
       
+      # Deprecated: For more information, see [Cloud Domains feature deprecation](
+      # https://cloud.google.com/domains/docs/deprecations/feature-deprecations)
       # Request for the `TransferDomain` method.
       class TransferDomainRequest
         include Google::Apis::Core::Hashable
@@ -1698,12 +1746,16 @@ module Google
         # options. After choosing a name, call `RetrieveRegisterParameters` to ensure
         # availability and obtain information like pricing, which is needed to build a
         # call to `RegisterDomain`. Another way to create a new `Registration` is to
-        # transfer an existing domain from another registrar. First, go to the current
+        # transfer an existing domain from another registrar (Deprecated: For more
+        # information, see [Cloud Domains feature deprecation](https://cloud.google.com/
+        # domains/docs/deprecations/feature-deprecations)). First, go to the current
         # registrar to unlock the domain for transfer and retrieve the domain's transfer
         # authorization code. Then call `RetrieveTransferParameters` to confirm that the
         # domain is unlocked and to get values needed to build a call to `TransferDomain`
         # . Finally, you can create a new `Registration` by importing an existing domain
-        # managed with [Google Domains](https://domains.google/). First, call `
+        # managed with [Google Domains](https://domains.google/) (Deprecated: For more
+        # information, see [Cloud Domains feature deprecation](https://cloud.google.com/
+        # domains/docs/deprecations/feature-deprecations)). First, call `
         # RetrieveImportableDomains` to list domains to which the calling user has
         # sufficient access. Then call `ImportDomain` on any domain names you want to
         # use with Cloud Domains.
@@ -1736,6 +1788,8 @@ module Google
         end
       end
       
+      # Deprecated: For more information, see [Cloud Domains feature deprecation](
+      # https://cloud.google.com/domains/docs/deprecations/feature-deprecations)
       # Parameters required to transfer a domain from another registrar.
       class TransferParameters
         include Google::Apis::Core::Hashable

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

@@ -16,13 +16,13 @@ module Google
   module Apis
     module DomainsV1
       # Version of the google-apis-domains_v1 gem
-      GEM_VERSION = "0.19.0"
+      GEM_VERSION = "0.21.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 = "20230503"
+      REVISION = "20231108"
     end
   end
 end

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

@@ -487,6 +487,7 @@ module Google
       class ManagementSettings
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :preferred_renewal_method, as: 'preferredRenewalMethod'
           property :renewal_method, as: 'renewalMethod'
           property :transfer_lock_state, as: 'transferLockState'
         end

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

@@ -299,14 +299,15 @@ module Google
         # Deletes a `Registration` resource. This method works on any `Registration`
         # resource using [Subscription or Commitment billing](/domains/pricing#billing-
         # models), provided that the resource was created at least 1 day in the past.
-        # For `Registration` resources using [Monthly billing](/domains/pricing#billing-
-        # models), this method works if: * `state` is `EXPORTED` with `expire_time` in
-        # the past * `state` is `REGISTRATION_FAILED` * `state` is `TRANSFER_FAILED`
         # When an active registration is successfully deleted, you can continue to use
         # the domain in [Google Domains](https://domains.google/) until it expires. The
         # calling user becomes the domain's sole owner in Google Domains, and
         # permissions for the domain are subsequently managed there. The domain does not
         # renew automatically unless the new owner sets up billing in Google Domains.
+        # After January 2024 you will only be able to delete `Registration` resources
+        # when `state` is one of: `EXPORTED`, `EXPIRED`,`REGISTRATION_FAILED` or `
+        # TRANSFER_FAILED`. See [Cloud Domains feature deprecation](https://cloud.google.
+        # com/domains/docs/deprecations/feature-deprecations) for more details.
         # @param [String] name
         #   Required. The name of the `Registration` to delete, in the format `projects/*/
         #   locations/*/registrations/*`.
@@ -337,6 +338,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Deprecated: For more information, see [Cloud Domains feature deprecation](
+        # https://cloud.google.com/domains/docs/deprecations/feature-deprecations)
         # Exports a `Registration` resource, such that it is no longer managed by Cloud
         # Domains. When an active domain is successfully exported, you can continue to
         # use the domain in [Google Domains](https://domains.google/) until it expires.
@@ -452,6 +455,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Deprecated: For more information, see [Cloud Domains feature deprecation](
+        # https://cloud.google.com/domains/docs/deprecations/feature-deprecations)
         # Imports a domain name from [Google Domains](https://domains.google/) for use
         # in Cloud Domains. To transfer a domain from another registrar, use the `
         # TransferDomain` method instead. Since individual users can own domains in
@@ -694,7 +699,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists domain names from [Google Domains](https://domains.google/) that can be
+        # Deprecated: For more information, see [Cloud Domains feature deprecation](
+        # https://cloud.google.com/domains/docs/deprecations/feature-deprecations) Lists
+        # domain names from [Google Domains](https://domains.google/) that can be
         # imported to Cloud Domains using the `ImportDomain` method. Since individual
         # users can own domains in Google Domains, the list of domains returned depends
         # on the individual user making the call. Domains already managed by Cloud
@@ -770,8 +777,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets parameters needed to transfer a domain name from another registrar to
-        # Cloud Domains. For domains already managed by [Google Domains](https://domains.
+        # Deprecated: For more information, see [Cloud Domains feature deprecation](
+        # https://cloud.google.com/domains/docs/deprecations/feature-deprecations) Gets
+        # parameters needed to transfer a domain name from another registrar to Cloud
+        # Domains. For domains already managed by [Google Domains](https://domains.
         # google/), use `ImportDomain` instead. Use the returned values to call `
         # TransferDomain`.
         # @param [String] location
@@ -919,6 +928,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Deprecated: For more information, see [Cloud Domains feature deprecation](
+        # https://cloud.google.com/domains/docs/deprecations/feature-deprecations)
         # Transfers a domain name from another registrar to Cloud Domains. For domains
         # already managed by [Google Domains](https://domains.google/), use `
         # ImportDomain` instead. Before calling this method, go to the domain's current

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-domains_v1
 version: !ruby/object:Gem::Version
-  version: 0.19.0
+  version: 0.21.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-05-14 00:00:00.000000000 Z
+date: 2023-11-12 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-domains_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-domains_v1/v0.19.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-domains_v1/v0.21.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-domains_v1
 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.2
+rubygems_version: 3.4.19
 signing_key: 
 specification_version: 4
 summary: Simple REST client for Cloud Domains API V1