Method assetlinks.check
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Belirtilen kaynak ve hedef öğeler arasında, belirtilen (yönsel) ilişkinin mevcut olup olmadığını belirler.
İlişki, kaynak öğe tarafından hak talebinde bulunulan şekliyle iki öğe arasındaki bağlantının amacını açıklar. Ayrıcalıkların veya izinlerin verilmesi bu tür ilişkilere bir örnektir.
Bu komut, çoğunlukla altyapı sistemleri tarafından işlemin ön koşullarını kontrol etmek için kullanılır. Örneğin, bir müşteri bunun yerine belirli bir mobil uygulamaya web URL'si göndermenin uygun olup olmadığını bilmek isteyebilir. Müşteri işleme izin verilip verilmeyeceğine karar vermek için web sitesi ile mobil uygulama arasındaki ilgili öğe bağlantısını kontrol edebilir.
Güvenlikle ilgili bir not: Kaynak olarak HTTPS web sitesi veya Android uygulaması gibi bir güvenli öğe belirtirseniz API, yanıtı oluşturmak için kullanılan tüm ifadelerin söz konusu öğenin sahibi tarafından güvenli bir şekilde yapıldığından emin olur. Buna karşılık, kaynak öğe güvenli olmayan bir HTTP web sitesiyse (yani URL, https:// yerine http:// ile başlıyorsa) API, ifadelerini güvenli bir şekilde doğrulayamaz ve web sitesinin ifadelerinin bir üçüncü taraf tarafından değiştirilmediğinden emin olmak mümkün değildir. Daha fazla bilgi için Dijital Varlık Bağlantıları teknik tasarım spesifikasyonuna bakın.
HTTP isteği
GET https://digitalassetlinks.googleapis.com/v1/assetlinks:check
Sorgu parametreleri
| Parametre adı |
Tür |
Açıklama |
source |
object(Asset) |
İfade listesini barındıran kaynak. Bu, Check() çağrısını uygun kaynağa yönlendirmek için kullanılır. |
relation |
string |
İlişkiye ilişkin sorgu dizesi. İlişkileri <kind>/<detail> biçimindeki dizelerle tanımlarız. Burada <kind> önceden tanımlanmış bir dizi amaç kategorisinden biri olmalıdır; <detail> ise ifadenin belirli kullanım alanını açıklayan serbest biçimli küçük harfli alfanümerik dizedir. Desteklenen ilişkilerin güncel listesi için API belgelerimize bakın. Sorgunun bir öğe bağlantısıyla eşleşmesi için hem sorgunun hem de öğe bağlantısının ilişki dizelerinin tam olarak eşleşmesi gerekir. Örnek: delegate_permission/common.handle_all_urls ilişkisine sahip bir sorgu, delegate_permission/common.handle_all_urls ilişkisine sahip bir öğe bağlantısıyla eşleşiyor. |
target |
object(Asset) |
İfadenin hedef öğesi. |
İstek içeriği
İstek metni boş olmalıdır.
Yanıt gövdesi
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
CheckAssetLinks çağrısı için yanıt mesajı.
| JSON gösterimi |
{
"linked": boolean,
"maxAge": string,
"debugString": string,
} |
| Alan adı |
Tür |
Açıklama |
linked |
boolean |
İstekte belirtilen öğeler istekte belirtilen ilişkiyle bağlanıyorsa "doğru" olarak ayarlanır. Zorunlu |
maxAge |
string |
Yayın tarihinden itibaren, başka güncellemeler engellenecekse yanıtın ne kadar süreyle geçerli olarak kabul edilmesi gerektiği. Zorunlu En fazla dokuz kesirli basamağa sahip, "s" ile sonlandırılmış, saniye cinsinden süre. Örnek: "3.5s". |
debugString |
string |
Son kullanıcıların sonucu anlamasına, yeniden üretmesine ve hata ayıklamasına yardımcı olacak bilgiler içeren, kullanıcılar tarafından okunabilen mesaj. Mesaj İngilizce olacaktır. Şu an için çeviri hizmeti sunmayı planlamıyoruz. Bu dizenin içeriği veya biçimi hakkında herhangi bir garanti verilmediğini lütfen unutmayın. İşbu belgenin herhangi bir kısmı, bildirimde bulunulmaksızın değiştirilebilir. Bu verileri programlı bir şekilde ayrıştırmaya çalışmamalısınız. İhtiyacınız olan bilgiler API tarafından başka şekilde açığa çıkarılmadığı için bu işlemi yapmanız gerektiğini düşünüyorsanız lütfen önce bizimle iletişime geçin. |
Deneyin.
Canlı verilerde bu yöntemi çağırmak ve yanıtı görmek için API Gezgini'ni kullanın.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2024-06-26 UTC.
[null,null,["Son güncelleme tarihi: 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."]]
