Method statements.list

擷取指定來源中符合指定目標和陳述式字串的所有陳述式清單。

根據「Digital Asset Links 技術設計規格」所述，這個 API 能保證所有含有安全來源資產 (例如 HTTPS 網站或 Android 應用程式) 的陳述式均以安全的方式提交。具體而言，如果網站不安全 (也就是網址開頭為 http://，而非 https://)，則無法做出這項保證。

當 API 用戶端想要瞭解兩項資產相關的所有方式，或列舉特定來源資產中的所有關係時，List 指令最為實用。範例：這項功能可讓使用者前往相關項目。執行行動應用程式時，這項功能可讓您輕鬆瀏覽對應的網站或 Google+ 個人資料。

HTTP 要求

GET https://digitalassetlinks.googleapis.com/v1/statements:list

查詢參數

參數名稱 類型 說明
source object(Asset) 代管陳述式清單的來源。用於將 List() 要求導向正確的來源。必要
relation string

只能使用符合指定關係的關聯。

如要進一步瞭解關聯字串的詳細定義，請參閱 Statement 訊息。

為了讓查詢比對陳述式，必須符合下列其中一項條件：

  • 查詢和陳述式的關係字串完全相符，或
  • 查詢的相關字串空白或遺失。

範例：關聯 delegate_permission/common.handle_all_urls 的查詢符合關聯 delegate_permission/common.handle_all_urls 的資產連結。

要求主體

要求主體必須為空白。

回應主體

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

List 呼叫的回應訊息。

JSON 表示法 
{
  "statements": [
    {
      object(Statement)
    }
  ],
  "maxAge": string,
  "debugString": string,
}
欄位名稱 類型 說明
statements[] object(Statement) 已找到的所有相符陳述式的清單。
maxAge string

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

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

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

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

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

陳述式

闡述了一項符合來源資產和目標資產關聯性的可靠陳述。

聲明一律由來源資產撰寫，無論是直接處理，還是委派給儲存在其他位置的對帳單清單即可。

如需陳述式和資產的詳細定義，請參閱 API 說明文件到達網頁。

JSON 表示法 
{
  "source": {
    object(Asset)
  },
  "relation": string,
  "target": {
    object(Asset)
  },
}
欄位名稱 類型 說明
source object(Asset) 每個陳述式都有來源素材資源。必要
relation string

與來源資產擁有者 (也就是發布聲明的個人或實體) 按照預期的方式使用聲明。每個完整的陳述都有關聯。

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

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

範例：必須提供 delegate_permission/common.handle_all_urls
target object(Asset) 每個陳述式都有目標資產。必要

試試看！

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