Method assetlinks.check
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Determina se esiste una relazione (direzionale) specificata tra gli asset di origine e di destinazione specificati.
La relazione descrive l'intento del collegamento tra le due risorse rivendicate dalla risorsa di origine. Un esempio di queste relazioni è la delega di privilegi o autorizzazioni.
Questo comando viene utilizzato principalmente dai sistemi dell'infrastruttura per verificare le condizioni preliminari per un'azione. Ad esempio, un cliente potrebbe voler sapere se è possibile inviare un URL web a una determinata app mobile. Il cliente può cercare il link dell'asset pertinente dal sito web all'app mobile per decidere se l'operazione deve essere consentita.
Nota sulla sicurezza: se specifichi un asset sicuro come origine, ad esempio un sito web HTTPS o un'app per Android, l'API garantirà che tutte le istruzioni utilizzate per generare la risposta siano state effettuate in modo sicuro dal proprietario dell'asset. Al contrario, se l'asset di origine è un sito web HTTP non sicuro (ovvero l'URL inizia con http:// anziché https://), l'API non può verificare le proprie dichiarazioni in modo sicuro e non è possibile garantire che le istruzioni del sito web non siano state alterate da una terza parte. Per ulteriori informazioni, consulta la specifica di progettazione tecnica di Digital Asset Links.
Richiesta HTTP
GET https://digitalassetlinks.googleapis.com/v1/assetlinks:check
Parametri di ricerca
| Nome del parametro |
Tipo |
Descrizione |
source |
object(Asset) |
La fonte che ospita l'elenco degli estratti conto. Viene utilizzato per instradare la chiamata Check() all'origine corretta. |
relation |
string |
Stringa di query per la relazione. Identifichiamo le relazioni con stringhe del formato <kind>/<detail>, dove <kind> deve far parte di un insieme di categorie di scopi predefinite, mentre <detail> è una stringa alfanumerica minuscola in formato libero che descrive il caso d'uso specifico dell'istruzione. Per l'elenco aggiornato delle relazioni supportate, consulta la documentazione relativa all'API. Affinché una query corrisponda a un link di asset, le stringhe di relazione della query e del link dell'asset devono corrispondere esattamente. Esempio: una query con relazione delegate_permission/common.handle_all_urls corrisponde a un link di asset con la relazione delegate_permission/common.handle_all_urls. |
target |
object(Asset) |
L'asset target dell'estratto conto. |
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Messaggio di risposta per la chiamata CheckAssetLinks.
| Rappresentazione JSON |
{
"linked": boolean,
"maxAge": string,
"debugString": string,
} |
| Nome campo |
Tipo |
Descrizione |
linked |
boolean |
Viene impostato su true se gli asset specificati nella richiesta sono collegati dalla relazione specificata nella richiesta. REQUIRED |
maxAge |
string |
Dalla pubblicazione, indica per quanto tempo la risposta deve essere considerata valida salvo ulteriori aggiornamenti. REQUIRED Durata in secondi con un massimo di nove cifre frazionarie, terminata con "s". Esempio: "3.5s". |
debugString |
string |
Messaggio leggibile contenente informazioni destinate ad aiutare gli utenti finali a comprendere, riprodurre ed eseguire il debug del risultato. Il messaggio sarà in inglese e al momento non prevediamo di offrire alcuna traduzione. Tieni presente che non vengono garantite garanzie in merito ai contenuti o al formato di questa stringa. Qualsiasi suo aspetto potrebbe essere soggetto a modifica senza preavviso. Non tentare di analizzare questi dati in modo programmatico. Se ritieni di dover svolgere questa operazione perché le informazioni di cui hai bisogno non vengono altrimenti esposte dall'API, contattaci. |
Prova.
Utilizza Explorer API per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2024-06-26 UTC.
[null,null,["Ultimo aggiornamento 2024-06-26 UTC."],[[["\u003cp\u003eVerifies the existence of a relationship between two digital assets, like websites and apps.\u003c/p\u003e\n"],["\u003cp\u003eUses the \u003ccode\u003eGET\u003c/code\u003e method with query parameters specifying the source, relation, and target assets.\u003c/p\u003e\n"],["\u003cp\u003eReturns a JSON response indicating if the assets are linked and provides additional debugging information.\u003c/p\u003e\n"],["\u003cp\u003ePrimarily used for security checks and ensuring the integrity of relationships between assets.\u003c/p\u003e\n"],["\u003cp\u003eOffers enhanced security when the source asset is secure (HTTPS or Android app).\u003c/p\u003e\n"]]],[],null,["# Method assetlinks.check\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.CheckResponse.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nDetermines whether the specified (directional) relationship exists between the specified source and target assets.\n\nThe relation describes the intent of the link between the two assets as claimed by the source asset. An example for such relationships is the delegation of privileges or permissions.\n\nThis command is most often used by infrastructure systems to check preconditions for an action. For example, a client may want to know if it is OK to send a web URL to a particular mobile app instead. The client can check for the relevant asset link from the website to the mobile app to decide if the operation should be allowed.\n\nA note about security: if you specify a secure asset as the source, such as an HTTPS website or an Android app, the API will ensure that any statements used to generate the response have been made in a secure way by the owner of that asset. Conversely, if the source asset is an insecure HTTP website (that is, the URL starts with `http://` instead of `https://`), the API cannot verify its statements securely, and it is not possible to ensure that the website's statements have not been altered by a third party. For more information, see the [Digital Asset Links technical design specification](https://github.com/google/digitalassetlinks/blob/master/well-known/details.md).\n\n### HTTP request\n\n`GET https://digitalassetlinks.googleapis.com/v1/assetlinks:check`\n\n### Query parameters\n\n| Parameter name | Type | Description |\n|----------------|-------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `source` | `object(`[Asset](/digital-asset-links/reference/rest/v1/Asset)`)` | The source hosting the statement list. This is used to route the `Check()` call to the proper source. |\n| `relation` | `string` | Query string for the relation. We identify relations with strings of the format `\u003ckind\u003e/\u003cdetail\u003e`, where `\u003ckind\u003e` must be one of a set of pre-defined purpose categories, and `\u003cdetail\u003e` 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`. |\n| `target` | `object(`[Asset](/digital-asset-links/reference/rest/v1/Asset)`)` | The target asset of the statement. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\nResponse message for the CheckAssetLinks call.\n\n| JSON representation |\n|-------------------------------------------------------------------------|\n| ``` { \"linked\": boolean, \"maxAge\": string, \"debugString\": string, } ``` |\n\n| Field name | Type | Description |\n|---------------|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `linked` | `boolean` | Set to true if the assets specified in the request are linked by the relation specified in the request. REQUIRED |\n| `maxAge` | `string` | From serving time, how much longer the response should be considered valid barring further updates. REQUIRED A duration in seconds with up to nine fractional digits, terminated by '`s`'. Example: `\"3.5s\"`. |\n| `debugString` | `string` | Human-readable message containing information intended to help end users understand, reproduce and debug the result. The message will be in English and we are currently not planning to offer any translations. Please note that no guarantees are made about the contents or format of this string. Any aspect of it may be subject to change without notice. You should not attempt to programmatically parse this data. If you feel that you need to do this because the information you need is not otherwise exposed by the API, please contact us first. |\n\nTry it!\n-------\n\nUse the [APIs Explorer](https://developers.google.com/apis-explorer/?discovery_url=/digital-asset-links/v1/discoverydocument.json#p/digitalassetlinks/v1/digitalassetlinks.assetlinks.check?relation=delegate_permission%252Fcommon.handle_all_urls&source.web.site=https%253A%252F%252Fexample.digitalassetlinks.org&target.androidApp.certificate.sha256Fingerprint=10%253A39%253A38%253AEE%253A45%253A37%253AE5%253A9E%253A8E%253AE7%253A92%253AF6%253A54%253A50%253A4F%253AB8%253A34%253A6F%253AC6%253AB3%253A46%253AD0%253ABB%253AC4%253A41%253A5F%253AC3%253A39%253AFC%253AFC%253A8E%253AC1&target.androidApp.packageName=org.digitalassetlinks.sampleapp) to call this method on live data and see the response."]]
