Asset

用於識別資產的專屬識別碼。

數位資產是可識別且可識別的線上實體，通常能提供部分服務或內容。例如網站、Android 應用程式、Twitter 動態饋給和專頁。

JSON 表示法 
{
  // Union field, only one of the following:
  "web": {
    object(WebAsset)
  },
  "androidApp": {
    object(AndroidAppAsset)
  },
}
欄位名稱 類型 說明
欄位的值，只能填入下列其中一個值：
web object(WebAsset) 如果這是網路資產，則可設定。
androidApp object(AndroidAppAsset) 如果這是 Android 應用程式資產，請進行設定。

網路資產

說明網路資產。

JSON 表示法 
{
  "site": string,
}
欄位名稱 類型 說明
site string

網址所標的網址僅包含配置、主機名稱和通訊埠部分。格式為

http[s]://<hostname>[:<port>]

主機名稱必須是完整的名稱，且必須以單一半形句號 (「.」) 結尾。

目前只允許使用配置「http」和「https」。

通訊埠號碼會以十進位數字的形式提供，使用標準通訊埠號碼時，必須省略這些數字：http 為 80，https 為 443。

這個有限網址就稱為「網站」。凡是具有相同配置、主機名稱和通訊埠的網址，都會被視為網站的一部分，因此屬於網站資產。

範例：含有 https://www.google.com 網站的素材資源包含所有網址：

  • https://www.google.com/
  • https://www.google.com:443/
  • https://www.google.com/foo
  • https://www.google.com/foo?bar
  • https://www.google.com/foo#bar
  • https://user@password:www.google.com/

但不含下列網址：

  • http://www.google.com/ (錯誤配置)
  • https://google.com/ (主機名稱不相符)
  • https://www.google.com:444/ (通訊埠不相符) REQUIRED

Android 應用程式素材資源

用於說明 Android 應用程式資產。

JSON 表示法 
{
  "packageName": string,
  "certificate": {
    object(CertificateInfo)
  },
}
欄位名稱 類型 說明
packageName string Android 應用程式素材資源可由其 Java 套件名稱自然辨識。舉例來說，Google 地圖應用程式使用套件名稱 com.google.android.apps.maps，必填
certificate object(CertificateInfo)

我們並未強制對套件名稱強制執行全球性政策，我們也要求簽署憑證，且必須搭配套件名稱，才能識別應用程式。

某些應用程式的簽署金鑰會經過輪替，因此可能會隨著不同的金鑰簽署。系統會將這些資產視為唯一的 ID，因為我們使用 (套件名稱、憑證) 做為專屬 ID。這通常不會造成任何問題，因為兩個版本的應用程式都會產生相同或類似的陳述式。但是，當金鑰旋轉時，需要更新應用程式的其他資產必須更新。

(請注意，發布及查詢陳述式的語法包含語法糖，可讓您輕鬆指定由多個憑證已知的應用程式。)必填

憑證資訊

描述 X509 憑證。

JSON 表示法 
{
  "sha256Fingerprint": string,
}
欄位名稱 類型 說明
sha256Fingerprint string

憑證的大寫 SHA-265 指紋。PEM 憑證可透過下列方式取得：

$ keytool -printcert -file $CERTFILE | grep SHA256:
SHA256: 14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83: \
    42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5

或像這樣：

$ openssl x509 -in $CERTFILE -noout -fingerprint -sha256
SHA256 Fingerprint=14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64: \
    16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5

在這個範例中，這個欄位的內容會是 14:6D:E9:83:C5:73: 06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF: 44:E5。

如果您無法使用這些工具，可以將 PEM 憑證轉換為 DER 格式，然後計算該字串的 SHA-256 雜湊值，並將結果顯示為十六進位字串 (也就是每個八位元的大寫十六進位表示法，並以冒號分隔)。