Contacts

如需本資源的方法清單,請見本頁結尾。

資源表示法

可以用來建立創作者或聯絡人的個人或群組。

{
  "kind": "mirror#contact",
  "source": string,
  "id": string,
  "displayName": string,
  "imageUrls": [
    string
  ],
  "type": string,
  "acceptTypes": [
    string
  ],
  "phoneNumber": string,
  "priority": unsigned integer,
  "acceptCommands": [
    {
      "type": string
    }
  ],
  "speakableName": string,
  "sharingFeatures": [
    string
  ]
}
資源名稱 說明 Notes
acceptCommands[] list 聯絡人可處理的語音選單指令清單。Glass 針對每個語音選單指令最多可顯示三個聯絡人。如果數量超過這個上限,系統會顯示該指令 priority 中三個最高的聯絡人。 可寫入
acceptCommands[].type string 這個指令所對應的作業類型。允許的值包括:
  • TAKE_A_NOTE - 透過「新增記事」語音選單指令,共用使用者語音轉錄的時間軸項目。
  • POST_AN_UPDATE:透過「張貼更新」語音選單指令,分享使用者語音轉錄的時間軸項目。
可寫入
acceptTypes[] list 聯絡人支援的 MIME 類型清單。只要聯絡人的 TypeType 與項目中的任何附件類型相符,系統就會向使用者顯示該聯絡人。如果您未提供接受類型,系統就會顯示所有聯絡人的聯絡人。 可寫入
displayName string 此聯絡人的顯示名稱。 可寫入
id string 此聯絡人的 ID。應用程式是由應用程式產生,而且會視為不透明的符記。 可寫入
imageUrls[] list 聯絡人的聯絡圖片網址組合。大多數的聯絡人都有一張圖片,一個「群組」聯絡人最多可包含 8 個圖片網址,而會經過調整並裁剪成用戶端的馬賽克。 可寫入
kind string 資源類型。一律為 mirror#contact
phoneNumber string 聯絡人的主要電話號碼。可以是完整的號碼,須包含國家/地區代碼與區碼或區碼。 可寫入
priority unsigned integer 聯絡人的決定優先順序,以決定聯絡人清單中的排序。系統會優先顯示優先順序較高的聯絡人,優先顯示其優先順序較低的聯絡人。 可寫入
sharingFeatures[] list 聯絡人可處理的分享清單。允許的值包括:
  • ADD_CAPTION
source string 建立此聯絡人的應用程式編號。這會由 API 填入
speakableName string 此聯絡人名稱,應為發音。如果此聯絡人的名稱必須透過語音消除選單顯示,此名稱會用來當做預期發音。如果聯絡人名稱沒有發音,或是顯示拼音並非拼音,就很適合使用這個名稱。 可寫入
type string 此聯絡人的類型。用於在 UI 中排序。允許的值包括:
  • INDIVIDUAL - 代表單一人物。此為預設值。
  • GROUP - 代表不只一個人。
可寫入

方法

刪除
刪除聯絡人。
取得
依據 ID 取得單一聯絡人。
插入
插入新的聯絡人。
list
擷取已驗證使用者的聯絡人清單,
修補
更新某個聯絡人。這個方法支援修補語意
更新
更新某個聯絡人。