google-apis-digitalassetlinks_v1 0.18.0 → 0.20.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 35dd7c4b500a6dc3da145b304cfb3cc4ce653177c537854a50aa455469099b5f
-  data.tar.gz: de6e4d2ab373cdbed87bea1c257ac6559706c99f52b59bcf03373c4716e2a577
+  metadata.gz: 858dbd99b2219d2047bf68ffb2fae7b508835b6c4b2866593ecd7ed52bb5b5db
+  data.tar.gz: b65b792b99ea0df8d35bdb2fb19612fffa974b0d7fbc7e7b2be2e128885d0296
 SHA512:
-  metadata.gz: 7eda0e1ed29a88ea527a65ccbd89be91e594cb52ce77e39419df0a2d4e9f7affd7a78c86388f7e243222940fdaa4791a98a73541a51a2b7c83c2202317028d36
-  data.tar.gz: 34cf239364071ca71dd522381c14aa01d37fcd4179af2ad0cdce563134bd22202ecb69e083fdffd361b8b5a756cbb58c450677a446d3c9bbcd1d688259f92063
+  metadata.gz: 30fd3ed37d3f83b1509001a6536b556484dbd91571fd9f5c4a88635cfa7e9aaa657e828ab4cb14dff6df1b6f7dfe2b7d0461a68795d5f16b4c8c4b15a73b781d
+  data.tar.gz: a0affcef0eabc0e22a9e6030342d6194f7925bcfab3924d4239c17a80315563c0bc3be58e275d39066186f5ab954e1c16074c3f3faeb531234f133b91a6e5c1d

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Release history for google-apis-digitalassetlinks_v1
 
+### v0.20.0 (2025-04-13)
+
+* Regenerated from discovery document revision 20250405
+
+### v0.19.0 (2025-02-26)
+
+* Regenerated from discovery document revision 20250211
+* Regenerated using generator version 0.16.0
+
 ### v0.18.0 (2024-11-17)
 
 * Regenerated from discovery document revision 20241109

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

@@ -76,6 +76,89 @@ module Google
         end
       end
       
+      # Message used to check for the existence of multiple digital asset links within
+      # a single RPC.
+      class BulkCheckRequest
+        include Google::Apis::Core::Hashable
+      
+        # If specified, will be used in any given template statement that doesn’t
+        # specify a relation.
+        # Corresponds to the JSON property `defaultRelation`
+        # @return [String]
+        attr_accessor :default_relation
+      
+        # Uniquely identifies an asset. A digital asset is an identifiable and
+        # addressable online entity that typically provides some service or content.
+        # Examples of assets are websites, Android apps, Twitter feeds, and Plus Pages.
+        # Corresponds to the JSON property `defaultSource`
+        # @return [Google::Apis::DigitalassetlinksV1::Asset]
+        attr_accessor :default_source
+      
+        # Uniquely identifies an asset. A digital asset is an identifiable and
+        # addressable online entity that typically provides some service or content.
+        # Examples of assets are websites, Android apps, Twitter feeds, and Plus Pages.
+        # Corresponds to the JSON property `defaultTarget`
+        # @return [Google::Apis::DigitalassetlinksV1::Asset]
+        attr_accessor :default_target
+      
+        # Same configuration as in CheckRequest; all statement checks will use the same
+        # configuration.
+        # Corresponds to the JSON property `returnRelationExtensions`
+        # @return [Boolean]
+        attr_accessor :return_relation_extensions
+        alias_method :return_relation_extensions?, :return_relation_extensions
+      
+        # List of statements to check. For each statement, you can omit a field if the
+        # corresponding default_* field below was supplied. Minimum 1 statement; maximum
+        # 1,000 statements. Any additional statements will be ignored.
+        # Corresponds to the JSON property `statements`
+        # @return [Array<Google::Apis::DigitalassetlinksV1::StatementTemplate>]
+        attr_accessor :statements
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @default_relation = args[:default_relation] if args.key?(:default_relation)
+          @default_source = args[:default_source] if args.key?(:default_source)
+          @default_target = args[:default_target] if args.key?(:default_target)
+          @return_relation_extensions = args[:return_relation_extensions] if args.key?(:return_relation_extensions)
+          @statements = args[:statements] if args.key?(:statements)
+        end
+      end
+      
+      # Response for BulkCheck call. Results are sent in a list in the same order in
+      # which they were sent. Individual check errors are described in the appropriate
+      # check_results entry. If the entire call fails, the response will include a
+      # bulk_error_code field describing the error.
+      class BulkCheckResponse
+        include Google::Apis::Core::Hashable
+      
+        # Error code for the entire request. Present only if the entire request failed.
+        # Individual check errors will not trigger the presence of this field.
+        # Corresponds to the JSON property `bulkErrorCode`
+        # @return [String]
+        attr_accessor :bulk_error_code
+      
+        # List of results for each check request. Results are returned in the same order
+        # in which they were sent in the request.
+        # Corresponds to the JSON property `checkResults`
+        # @return [Array<Google::Apis::DigitalassetlinksV1::CheckResponse>]
+        attr_accessor :check_results
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @bulk_error_code = args[:bulk_error_code] if args.key?(:bulk_error_code)
+          @check_results = args[:check_results] if args.key?(:check_results)
+        end
+      end
+      
       # Describes an X509 certificate.
       class CertificateInfo
         include Google::Apis::Core::Hashable
@@ -139,6 +222,15 @@ module Google
         # @return [String]
         attr_accessor :max_age
       
+        # Statements may specify relation level extensions/payloads to express more
+        # details when declaring permissions to grant from the source asset to the
+        # target asset. When requested, the API will return relation_extensions
+        # specified in any and all statements linking the requested source and target
+        # assets by the relation specified in the request.
+        # Corresponds to the JSON property `relationExtensions`
+        # @return [Array<Hash<String,Object>>]
+        attr_accessor :relation_extensions
+      
         def initialize(**args)
            update!(**args)
         end
@@ -149,6 +241,7 @@ module Google
           @error_code = args[:error_code] if args.key?(:error_code)
           @linked = args[:linked] if args.key?(:linked)
           @max_age = args[:max_age] if args.key?(:max_age)
+          @relation_extensions = args[:relation_extensions] if args.key?(:relation_extensions)
         end
       end
       
@@ -217,6 +310,60 @@ module Google
         # @return [String]
         attr_accessor :relation
       
+        # Statements may specify relation level extensions/payloads to express more
+        # details when declaring permissions to grant from the source asset to the
+        # target asset. These relation extensions should be specified in the `
+        # relation_extensions` object, keyed by the relation type they're associated
+        # with. ` relation: ["delegate_permission/common.handle_all_urls"], target: `...`
+        # , relation_extensions: ` "delegate_permission/common.handle_all_urls": ` ...
+        # handle_all_urls specific payload specified here... ` ` ` When requested, and
+        # specified in the statement file, the API will return relation_extensions
+        # associated with the statement's relation type. i.e. the API will only return
+        # relation_extensions specified for "delegate_permission/common.handle_all_urls"
+        # if this statement object's relation type is "delegate_permission/common.
+        # handle_all_urls".
+        # Corresponds to the JSON property `relationExtensions`
+        # @return [Hash<String,Object>]
+        attr_accessor :relation_extensions
+      
+        # Uniquely identifies an asset. A digital asset is an identifiable and
+        # addressable online entity that typically provides some service or content.
+        # Examples of assets are websites, Android apps, Twitter feeds, and Plus Pages.
+        # Corresponds to the JSON property `source`
+        # @return [Google::Apis::DigitalassetlinksV1::Asset]
+        attr_accessor :source
+      
+        # Uniquely identifies an asset. A digital asset is an identifiable and
+        # addressable online entity that typically provides some service or content.
+        # Examples of assets are websites, Android apps, Twitter feeds, and Plus Pages.
+        # Corresponds to the JSON property `target`
+        # @return [Google::Apis::DigitalassetlinksV1::Asset]
+        attr_accessor :target
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @relation = args[:relation] if args.key?(:relation)
+          @relation_extensions = args[:relation_extensions] if args.key?(:relation_extensions)
+          @source = args[:source] if args.key?(:source)
+          @target = args[:target] if args.key?(:target)
+        end
+      end
+      
+      # A single statement to check in a bulk call using BulkCheck. See CheckRequest
+      # for details about each field.
+      class StatementTemplate
+        include Google::Apis::Core::Hashable
+      
+        # The relationship being asserted between the source and target. If omitted, you
+        # must specify a BulkCheckRequest.default_relation value to use here.
+        # Corresponds to the JSON property `relation`
+        # @return [String]
+        attr_accessor :relation
+      
         # Uniquely identifies an asset. A digital asset is an identifiable and
         # addressable online entity that typically provides some service or content.
         # Examples of assets are websites, Android apps, Twitter feeds, and Plus Pages.

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

@@ -16,13 +16,13 @@ module Google
   module Apis
     module DigitalassetlinksV1
       # Version of the google-apis-digitalassetlinks_v1 gem
-      GEM_VERSION = "0.18.0"
+      GEM_VERSION = "0.20.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.15.1"
+      GENERATOR_VERSION = "0.16.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20241109"
+      REVISION = "20250405"
     end
   end
 end

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

@@ -34,6 +34,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class BulkCheckRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class BulkCheckResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class CertificateInfo
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -58,6 +70,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class StatementTemplate
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class WebAsset
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -83,6 +101,29 @@ module Google
         end
       end
       
+      class BulkCheckRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :default_relation, as: 'defaultRelation'
+          property :default_source, as: 'defaultSource', class: Google::Apis::DigitalassetlinksV1::Asset, decorator: Google::Apis::DigitalassetlinksV1::Asset::Representation
+      
+          property :default_target, as: 'defaultTarget', class: Google::Apis::DigitalassetlinksV1::Asset, decorator: Google::Apis::DigitalassetlinksV1::Asset::Representation
+      
+          property :return_relation_extensions, as: 'returnRelationExtensions'
+          collection :statements, as: 'statements', class: Google::Apis::DigitalassetlinksV1::StatementTemplate, decorator: Google::Apis::DigitalassetlinksV1::StatementTemplate::Representation
+      
+        end
+      end
+      
+      class BulkCheckResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :bulk_error_code, as: 'bulkErrorCode'
+          collection :check_results, as: 'checkResults', class: Google::Apis::DigitalassetlinksV1::CheckResponse, decorator: Google::Apis::DigitalassetlinksV1::CheckResponse::Representation
+      
+        end
+      end
+      
       class CertificateInfo
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -97,6 +138,7 @@ module Google
           collection :error_code, as: 'errorCode'
           property :linked, as: 'linked'
           property :max_age, as: 'maxAge'
+          collection :relation_extensions, as: 'relationExtensions'
         end
       end
       
@@ -112,6 +154,18 @@ module Google
       end
       
       class Statement
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :relation, as: 'relation'
+          hash :relation_extensions, as: 'relationExtensions'
+          property :source, as: 'source', class: Google::Apis::DigitalassetlinksV1::Asset, decorator: Google::Apis::DigitalassetlinksV1::Asset::Representation
+      
+          property :target, as: 'target', class: Google::Apis::DigitalassetlinksV1::Asset, decorator: Google::Apis::DigitalassetlinksV1::Asset::Representation
+      
+        end
+      end
+      
+      class StatementTemplate
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :relation, as: 'relation'

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

@@ -51,6 +51,39 @@ module Google
           @batch_path = 'batch'
         end
         
+        # Send a bundle of statement checks in a single RPC to minimize latency and
+        # service load. Statements need not be all for the same source and/or target. We
+        # recommend using this method when you need to check more than one statement in
+        # a short period of time.
+        # @param [Google::Apis::DigitalassetlinksV1::BulkCheckRequest] bulk_check_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::DigitalassetlinksV1::BulkCheckResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DigitalassetlinksV1::BulkCheckResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def bulk_assetlink_check(bulk_check_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/assetlinks:bulkCheck', options)
+          command.request_representation = Google::Apis::DigitalassetlinksV1::BulkCheckRequest::Representation
+          command.request_object = bulk_check_request_object
+          command.response_representation = Google::Apis::DigitalassetlinksV1::BulkCheckResponse::Representation
+          command.response_class = Google::Apis::DigitalassetlinksV1::BulkCheckResponse
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Determines whether the specified (directional) relationship exists between the
         # specified source and target assets. The relation describes the intent of the
         # link between the two assets as claimed by the source asset. An example for
@@ -79,6 +112,14 @@ module Google
         #   relation strings must match exactly. Example: A query with relation `
         #   delegate_permission/common.handle_all_urls` matches an asset link with
         #   relation `delegate_permission/common.handle_all_urls`.
+        # @param [Boolean] return_relation_extensions
+        #   Whether to return relation_extensions payloads specified in the source Digital
+        #   Asset Links statements linking the requested source and target assets by the
+        #   requested relation type. If this is set to `false` (default),
+        #   relation_extensions specified will not be returned, even if they are specified
+        #   in the DAL statement file. If set to `true`, the API will propagate any and
+        #   all relation_extensions, across statements, linking the source and target
+        #   assets by the requested relation type, if specified in the DAL statement file.
         # @param [String] source_android_app_certificate_sha256_fingerprint
         #   The uppercase SHA-265 fingerprint of the certificate. From the PEM certificate,
         #   it can be acquired like this: $ keytool -printcert -file $CERTFILE | grep
@@ -160,11 +201,12 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def check_assetlink(relation: nil, source_android_app_certificate_sha256_fingerprint: nil, source_android_app_package_name: nil, source_web_site: nil, target_android_app_certificate_sha256_fingerprint: nil, target_android_app_package_name: nil, target_web_site: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def check_assetlink(relation: nil, return_relation_extensions: nil, source_android_app_certificate_sha256_fingerprint: nil, source_android_app_package_name: nil, source_web_site: nil, target_android_app_certificate_sha256_fingerprint: nil, target_android_app_package_name: nil, target_web_site: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:get, 'v1/assetlinks:check', options)
           command.response_representation = Google::Apis::DigitalassetlinksV1::CheckResponse::Representation
           command.response_class = Google::Apis::DigitalassetlinksV1::CheckResponse
           command.query['relation'] = relation unless relation.nil?
+          command.query['returnRelationExtensions'] = return_relation_extensions unless return_relation_extensions.nil?
           command.query['source.androidApp.certificate.sha256Fingerprint'] = source_android_app_certificate_sha256_fingerprint unless source_android_app_certificate_sha256_fingerprint.nil?
           command.query['source.androidApp.packageName'] = source_android_app_package_name unless source_android_app_package_name.nil?
           command.query['source.web.site'] = source_web_site unless source_web_site.nil?
@@ -197,6 +239,13 @@ module Google
         #   string is empty or missing. Example: A query with relation `
         #   delegate_permission/common.handle_all_urls` matches an asset link with
         #   relation `delegate_permission/common.handle_all_urls`.
+        # @param [Boolean] return_relation_extensions
+        #   Whether to return any relation_extensions payloads specified in the source
+        #   digital asset links statements. If this is set to `false` (default),
+        #   relation_extensions specified will not be returned, even if they are specified
+        #   in the DAL statement file. If set to `true`, the API will propagate
+        #   relation_extensions associated with each statement's relation type, if
+        #   specified in the DAL statement file.
         # @param [String] source_android_app_certificate_sha256_fingerprint
         #   The uppercase SHA-265 fingerprint of the certificate. From the PEM certificate,
         #   it can be acquired like this: $ keytool -printcert -file $CERTFILE | grep
@@ -246,11 +295,12 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_statements(relation: nil, source_android_app_certificate_sha256_fingerprint: nil, source_android_app_package_name: nil, source_web_site: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def list_statements(relation: nil, return_relation_extensions: nil, source_android_app_certificate_sha256_fingerprint: nil, source_android_app_package_name: nil, source_web_site: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:get, 'v1/statements:list', options)
           command.response_representation = Google::Apis::DigitalassetlinksV1::ListResponse::Representation
           command.response_class = Google::Apis::DigitalassetlinksV1::ListResponse
           command.query['relation'] = relation unless relation.nil?
+          command.query['returnRelationExtensions'] = return_relation_extensions unless return_relation_extensions.nil?
           command.query['source.androidApp.certificate.sha256Fingerprint'] = source_android_app_certificate_sha256_fingerprint unless source_android_app_certificate_sha256_fingerprint.nil?
           command.query['source.androidApp.packageName'] = source_android_app_package_name unless source_android_app_package_name.nil?
           command.query['source.web.site'] = source_web_site unless source_web_site.nil?

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-digitalassetlinks_v1
 version: !ruby/object:Gem::Version
-  version: 0.18.0
+  version: 0.20.0
 platform: ruby
 authors:
 - Google LLC
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-12-04 00:00:00.000000000 Z
+date: 2025-04-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,9 +57,8 @@ 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-digitalassetlinks_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-digitalassetlinks_v1/v0.18.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-digitalassetlinks_v1/v0.20.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-digitalassetlinks_v1
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -75,8 +73,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key: 
+rubygems_version: 3.6.5
 specification_version: 4
 summary: Simple REST client for Digital Asset Links API V1
 test_files: []