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 針對即時資料呼叫這個方法，並查看回應。