Method assetlinks.check
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Menentukan apakah ada hubungan yang ditentukan (arah) antara aset sumber dan target yang ditentukan.
Relasi menjelaskan maksud penautan antara kedua aset tersebut seperti yang diklaim oleh aset sumber. Contoh untuk hubungan tersebut adalah pendelegasian hak istimewa atau izin.
Perintah ini paling sering digunakan oleh sistem infrastruktur untuk memeriksa prasyarat untuk suatu tindakan. Misalnya, klien mungkin ingin tahu apakah URL web boleh dikirim ke aplikasi seluler tertentu sebagai gantinya. Klien dapat memeriksa link aset yang relevan dari situs ke aplikasi seluler untuk memutuskan apakah operasi harus diizinkan.
Catatan tentang keamanan: jika Anda menentukan aset aman sebagai sumbernya, seperti situs HTTPS atau aplikasi Android, API akan memastikan bahwa setiap pernyataan yang digunakan untuk menghasilkan respons telah dibuat dengan cara yang aman oleh pemilik aset tersebut. Sebaliknya, jika aset sumber adalah situs HTTP yang tidak aman (yaitu, URL dimulai dengan http:// dan bukan https://), API tidak dapat memverifikasi pernyataannya secara aman, dan tidak mungkin memastikan bahwa pernyataan situs belum diubah oleh pihak ketiga. Untuk informasi selengkapnya, lihat Spesifikasi desain teknis Digital Asset Links.
Permintaan HTTP
GET https://digitalassetlinks.googleapis.com/v1/assetlinks:check
Parameter kueri
| Nama parameter |
Jenis |
Deskripsi |
source |
object(Asset) |
Sumber yang menghosting daftar laporan. Ini digunakan untuk merutekan panggilan Check() ke sumber yang tepat. |
relation |
string |
String kueri untuk relasi. Kami mengidentifikasi hubungan dengan string format <kind>/<detail>, dengan <kind> harus berupa salah satu dari kumpulan kategori tujuan yang ditentukan sebelumnya, dan <detail> adalah string alfanumerik huruf kecil bentuk bebas yang menjelaskan kasus penggunaan spesifik pernyataan. Lihat dokumentasi API kami untuk mengetahui daftar relasi yang didukung saat ini. Agar kueri cocok dengan link aset, string relasi di kueri dan link aset harus sama persis. Contoh: Kueri dengan relasi delegate_permission/common.handle_all_urls cocok dengan link aset dengan relasi delegate_permission/common.handle_all_urls. |
target |
object(Asset) |
Aset target pernyataan. |
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Jika berhasil, isi respons memuat data dengan struktur berikut:
Pesan respons untuk panggilan CheckAssetLinks.
| Representasi JSON |
{
"linked": boolean,
"maxAge": string,
"debugString": string,
} |
| Nama kolom |
Jenis |
Deskripsi |
linked |
boolean |
Tetapkan ke benar jika aset yang ditentukan dalam permintaan ditautkan oleh hubungan yang ditentukan dalam permintaan. WAJIB |
maxAge |
string |
Mulai dari waktu penayangan, berapa lama lagi respons akan dianggap valid dengan membatasi update lebih lanjut. WAJIB Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s". |
debugString |
string |
Pesan yang dapat dibaca manusia berisi informasi yang dimaksudkan untuk membantu pengguna akhir memahami, mereproduksi, dan men-debug hasil. Pesan tersebut akan menggunakan bahasa Inggris dan saat ini kami tidak berencana menawarkan terjemahan apa pun. Perlu diketahui bahwa tidak ada jaminan yang dibuat terkait konten atau format string ini. Aspek apa pun dari konten tersebut dapat berubah tanpa pemberitahuan. Anda tidak boleh mencoba mengurai data ini secara terprogram. Jika Anda merasa perlu melakukan hal ini karena informasi yang Anda butuhkan tidak diekspos oleh API, hubungi kami terlebih dahulu. |
Cobalah!
Gunakan APIs Explorer untuk memanggil metode ini pada data langsung dan melihat responsnya.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2024-06-26 UTC.
[null,null,["Terakhir diperbarui pada 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."]]
