feat: Automated regeneration of DigitalAssetLinks client (#13302)

Auto-created at 2025-04-10 13:13:42 +0000 using the toys pull request generator.

Author: yoshi-code-bot

clients/digital_asset_links/lib/google_api/digital_asset_links/v1/api/assetlinks.ex

@@ -105,6 +105,7 @@ defmodule GoogleApi.DigitalAssetLinks.V1.Api.Assetlinks do
       *   `:uploadType` (*type:* `String.t`) - Legacy upload protocol for media (e.g. "media", "multipart").
       *   `:upload_protocol` (*type:* `String.t`) - Upload protocol for media (e.g. "raw", "multipart").
       *   `:relation` (*type:* `String.t`) - Query string for the relation. We identify relations with strings of the format `/`, where `` must be one of a set of pre-defined purpose categories, and `` is a free-form lowercase alphanumeric string that describes the specific use case of the statement. Refer to [our API documentation](/digital-asset-links/v1/relation-strings) for the current list of supported relations. For a query to match an asset link, both the query's and the asset link's 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`.
+      *   `:returnRelationExtensions` (*type:* `boolean()`) - 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.
       *   `:"source.androidApp.certificate.sha256Fingerprint"` (*type:* `String.t`) - The uppercase SHA-265 fingerprint of the certificate. From the PEM certificate, it can be acquired like this: $ keytool -printcert -file $CERTFILE | grep SHA256: SHA256: 14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83: \\ 42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5 or like this: $ openssl x509 -in $CERTFILE -noout -fingerprint -sha256 SHA256 Fingerprint=14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64: \\ 16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5 In this example, the contents of this field would be `14:6D:E9:83:C5:73: 06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF: 44:E5`. If these tools are not available to you, you can convert the PEM certificate into the DER format, compute the SHA-256 hash of that string and represent the result as a hexstring (that is, uppercase hexadecimal representations of each octet, separated by colons).
       *   `:"source.androidApp.packageName"` (*type:* `String.t`) - Android App assets are naturally identified by their Java package name. For example, the Google Maps app uses the package name `com.google.android.apps.maps`. REQUIRED
       *   `:"source.web.site"` (*type:* `String.t`) - Web assets are identified by a URL that contains only the scheme, hostname and port parts. The format is http[s]://[:] Hostnames must be fully qualified: they must end in a single period ("`.`"). Only the schemes "http" and "https" are currently allowed. Port numbers are given as a decimal number, and they must be omitted if the standard port numbers are used: 80 for http and 443 for https. We call this limited URL the "site". All URLs that share the same scheme, hostname and port are considered to be a part of the site and thus belong to the web asset. Example: the asset with the site `https://www.google.com` contains all these URLs: * `https://www.google.com/` * `https://www.google.com:443/` * `https://www.google.com/foo` * `https://www.google.com/foo?bar` * `https://www.google.com/foo#bar` * `https://user@password:www.google.com/` But it does not contain these URLs: * `http://www.google.com/` (wrong scheme) * `https://google.com/` (hostname does not match) * `https://www.google.com:444/` (port does not match) REQUIRED
@@ -137,6 +138,7 @@ defmodule GoogleApi.DigitalAssetLinks.V1.Api.Assetlinks do
       :uploadType => :query,
       :upload_protocol => :query,
       :relation => :query,
+      :returnRelationExtensions => :query,
       :"source.androidApp.certificate.sha256Fingerprint" => :query,
       :"source.androidApp.packageName" => :query,
       :"source.web.site" => :query,

clients/digital_asset_links/lib/google_api/digital_asset_links/v1/api/statements.ex

@@ -44,6 +44,7 @@ defmodule GoogleApi.DigitalAssetLinks.V1.Api.Statements do
       *   `:uploadType` (*type:* `String.t`) - Legacy upload protocol for media (e.g. "media", "multipart").
       *   `:upload_protocol` (*type:* `String.t`) - Upload protocol for media (e.g. "raw", "multipart").
       *   `:relation` (*type:* `String.t`) - Use only associations that match the specified relation. See the [`Statement`](#Statement) message for a detailed definition of relation strings. For a query to match a statement, one of the following must be true: * both the query's and the statement's relation strings match exactly, or * the query's relation 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`.
+      *   `:returnRelationExtensions` (*type:* `boolean()`) - 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.
       *   `:"source.androidApp.certificate.sha256Fingerprint"` (*type:* `String.t`) - The uppercase SHA-265 fingerprint of the certificate. From the PEM certificate, it can be acquired like this: $ keytool -printcert -file $CERTFILE | grep SHA256: SHA256: 14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83: \\ 42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5 or like this: $ openssl x509 -in $CERTFILE -noout -fingerprint -sha256 SHA256 Fingerprint=14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64: \\ 16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5 In this example, the contents of this field would be `14:6D:E9:83:C5:73: 06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF: 44:E5`. If these tools are not available to you, you can convert the PEM certificate into the DER format, compute the SHA-256 hash of that string and represent the result as a hexstring (that is, uppercase hexadecimal representations of each octet, separated by colons).
       *   `:"source.androidApp.packageName"` (*type:* `String.t`) - Android App assets are naturally identified by their Java package name. For example, the Google Maps app uses the package name `com.google.android.apps.maps`. REQUIRED
       *   `:"source.web.site"` (*type:* `String.t`) - Web assets are identified by a URL that contains only the scheme, hostname and port parts. The format is http[s]://[:] Hostnames must be fully qualified: they must end in a single period ("`.`"). Only the schemes "http" and "https" are currently allowed. Port numbers are given as a decimal number, and they must be omitted if the standard port numbers are used: 80 for http and 443 for https. We call this limited URL the "site". All URLs that share the same scheme, hostname and port are considered to be a part of the site and thus belong to the web asset. Example: the asset with the site `https://www.google.com` contains all these URLs: * `https://www.google.com/` * `https://www.google.com:443/` * `https://www.google.com/foo` * `https://www.google.com/foo?bar` * `https://www.google.com/foo#bar` * `https://user@password:www.google.com/` But it does not contain these URLs: * `http://www.google.com/` (wrong scheme) * `https://google.com/` (hostname does not match) * `https://www.google.com:444/` (port does not match) REQUIRED
@@ -73,6 +74,7 @@ defmodule GoogleApi.DigitalAssetLinks.V1.Api.Statements do
       :uploadType => :query,
       :upload_protocol => :query,
       :relation => :query,
+      :returnRelationExtensions => :query,
       :"source.androidApp.certificate.sha256Fingerprint" => :query,
       :"source.androidApp.packageName" => :query,
       :"source.web.site" => :query

clients/digital_asset_links/lib/google_api/digital_asset_links/v1/metadata.ex

@@ -20,7 +20,7 @@ defmodule GoogleApi.DigitalAssetLinks.V1 do
   API client metadata for GoogleApi.DigitalAssetLinks.V1.
   """
 
-  @discovery_revision "20250211"
+  @discovery_revision "20250405"
 
   def discovery_revision(), do: @discovery_revision
 end

clients/digital_asset_links/lib/google_api/digital_asset_links/v1/model/bulk_check_request.ex

@@ -24,6 +24,7 @@ defmodule GoogleApi.DigitalAssetLinks.V1.Model.BulkCheckRequest do
   *   `defaultRelation` (*type:* `String.t`, *default:* `nil`) - If specified, will be used in any given template statement that doesn’t specify a relation.
   *   `defaultSource` (*type:* `GoogleApi.DigitalAssetLinks.V1.Model.Asset.t`, *default:* `nil`) - If specified, will be used in any given template statement that doesn’t specify a source.
   *   `defaultTarget` (*type:* `GoogleApi.DigitalAssetLinks.V1.Model.Asset.t`, *default:* `nil`) - If specified, will be used in any given template statement that doesn’t specify a target.
+  *   `returnRelationExtensions` (*type:* `boolean()`, *default:* `nil`) - Same configuration as in CheckRequest; all statement checks will use the same configuration.
   *   `statements` (*type:* `list(GoogleApi.DigitalAssetLinks.V1.Model.StatementTemplate.t)`, *default:* `nil`) - 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.
   """
 
@@ -33,12 +34,14 @@ defmodule GoogleApi.DigitalAssetLinks.V1.Model.BulkCheckRequest do
           :defaultRelation => String.t() | nil,
           :defaultSource => GoogleApi.DigitalAssetLinks.V1.Model.Asset.t() | nil,
           :defaultTarget => GoogleApi.DigitalAssetLinks.V1.Model.Asset.t() | nil,
+          :returnRelationExtensions => boolean() | nil,
           :statements => list(GoogleApi.DigitalAssetLinks.V1.Model.StatementTemplate.t()) | nil
         }
 
   field(:defaultRelation)
   field(:defaultSource, as: GoogleApi.DigitalAssetLinks.V1.Model.Asset)
   field(:defaultTarget, as: GoogleApi.DigitalAssetLinks.V1.Model.Asset)
+  field(:returnRelationExtensions)
   field(:statements, as: GoogleApi.DigitalAssetLinks.V1.Model.StatementTemplate, type: :list)
 end
 

clients/digital_asset_links/lib/google_api/digital_asset_links/v1/model/check_response.ex

@@ -25,6 +25,7 @@ defmodule GoogleApi.DigitalAssetLinks.V1.Model.CheckResponse do
   *   `errorCode` (*type:* `list(String.t)`, *default:* `nil`) - Error codes that describe the result of the Check operation.
   *   `linked` (*type:* `boolean()`, *default:* `nil`) - Set to true if the assets specified in the request are linked by the relation specified in the request.
   *   `maxAge` (*type:* `String.t`, *default:* `nil`) - From serving time, how much longer the response should be considered valid barring further updates. REQUIRED
+  *   `relationExtensions` (*type:* `list(map())`, *default:* `nil`) - 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.
   """
 
   use GoogleApi.Gax.ModelBase
@@ -33,13 +34,15 @@ defmodule GoogleApi.DigitalAssetLinks.V1.Model.CheckResponse do
           :debugString => String.t() | nil,
           :errorCode => list(String.t()) | nil,
           :linked => boolean() | nil,
-          :maxAge => String.t() | nil
+          :maxAge => String.t() | nil,
+          :relationExtensions => list(map()) | nil
         }
 
   field(:debugString)
   field(:errorCode, type: :list)
   field(:linked)
   field(:maxAge)
+  field(:relationExtensions, type: :list)
 end
 
 defimpl Poison.Decoder, for: GoogleApi.DigitalAssetLinks.V1.Model.CheckResponse do

clients/digital_asset_links/lib/google_api/digital_asset_links/v1/model/statement.ex

@@ -22,6 +22,7 @@ defmodule GoogleApi.DigitalAssetLinks.V1.Model.Statement do
   ## Attributes
 
   *   `relation` (*type:* `String.t`, *default:* `nil`) - The relation identifies the use of the statement as intended by the source asset's owner (that is, the person or entity who issued the statement). Every complete statement has a relation. We identify relations with strings of the format `/`, where `` must be one of a set of pre-defined purpose categories, and `` is a free-form lowercase alphanumeric string that describes the specific use case of the statement. Refer to [our API documentation](/digital-asset-links/v1/relation-strings) for the current list of supported relations. Example: `delegate_permission/common.handle_all_urls` REQUIRED
+  *   `relationExtensions` (*type:* `map()`, *default:* `nil`) - 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".
   *   `source` (*type:* `GoogleApi.DigitalAssetLinks.V1.Model.Asset.t`, *default:* `nil`) - Every statement has a source asset. REQUIRED
   *   `target` (*type:* `GoogleApi.DigitalAssetLinks.V1.Model.Asset.t`, *default:* `nil`) - Every statement has a target asset. REQUIRED
   """
@@ -30,11 +31,13 @@ defmodule GoogleApi.DigitalAssetLinks.V1.Model.Statement do
 
   @type t :: %__MODULE__{
           :relation => String.t() | nil,
+          :relationExtensions => map() | nil,
           :source => GoogleApi.DigitalAssetLinks.V1.Model.Asset.t() | nil,
           :target => GoogleApi.DigitalAssetLinks.V1.Model.Asset.t() | nil
         }
 
   field(:relation)
+  field(:relationExtensions, type: :map)
   field(:source, as: GoogleApi.DigitalAssetLinks.V1.Model.Asset)
   field(:target, as: GoogleApi.DigitalAssetLinks.V1.Model.Asset)
 end