Method assetlinks.check

判斷指定來源和目標資產之間是否存在指定的 (方向) 關係。

「關聯」指的是兩項資產之間 (依來源資產聲明擁有權) 的連結意圖。這類關係的例子就是權限或權限的委派。

基礎架構系統最常使用這個指令來檢查動作的先決條件。舉例來說，客戶可能會想知道能否將網址改為傳送到特定行動應用程式。客戶可以檢查網站與行動應用程式的相關資產連結，以判斷是否應執行這項作業。

安全性注意事項：如果你將安全資產指定為來源 (例如 HTTPS 網站或 Android 應用程式)，API 就能確保用於產生回應的任何陳述式均以安全的方式由該資產的擁有者建立。反之，如果來源素材資源是不安全的 HTTP 網站 (也就是網址以 http:// 而非 https:// 開頭)，API 就無法安全驗證其陳述式，也無法確保第三方未修改網站的陳述式。詳情請參閱 Digital Asset Links 技術設計規格。

HTTP 要求

GET https://digitalassetlinks.googleapis.com/v1/assetlinks:check

查詢參數

參數名稱 類型 說明
source object(Asset) 代管陳述式清單的來源。用於將 Check() 呼叫轉送至適當的來源。
relation string

關係的查詢字串。

我們會識別與 <kind>/<detail> 格式字串的關係，其中 <kind> 必須是一組預先定義的用途類別之一，而 <detail> 是任意形式的小寫英數字元字串，說明這個陳述式的特定用途。

如需目前支援的關係清單，請參閱 API 說明文件。

查詢要比對資產連結時，查詢和資產連結的關係字串必須完全相符。

範例：關聯 delegate_permission/common.handle_all_urls 的查詢符合關聯 delegate_permission/common.handle_all_urls 的資產連結。
target object(Asset) 陳述的目標資產。

要求主體

要求主體必須為空白。

回應主體

如果成功，回應主體即會包含具有以下結構的資料：

CheckAssetLinks 呼叫的回應訊息。

JSON 表示法 
{
  "linked": boolean,
  "maxAge": string,
  "debugString": string,
}
欄位名稱 類型 說明
linked boolean 如果要求中指定的資產與要求中指定的關係連結，則設為 true。必要
maxAge string

從放送時間開始，系統會將回應視為有效停止的進一步更新時間。必要

時間長度以秒為單位，最多可有 9 個小數位數，並應以「s」結尾，例如："3.5s"。
debugString string

人類可讀的訊息內含有助於使用者瞭解、重現及偵錯結果的資訊。

留言將會以英文撰寫，我們目前不打算提供任何翻譯。

請注意，無法保證這個字串的內容或格式。我們可能會隨時變更任何資訊，恕不另行通知。請勿嘗試透過程式輔助方式剖析這項資料。如果覺得您必須這麼做，因為該 API 不會公開您需要的資訊，請先與我們聯絡。

試試看！

使用 APIs Explorer 針對即時資料呼叫這個方法，然後查看回應。