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
  ]
}
屬性名稱 說明 附註
acceptCommands[] list 聯絡人可處理的語音選單指令清單。Glass 的每個語音選單指令最多可顯示三位聯絡人。如果超過此數量,特定指令將顯示 priority 最高的三個聯絡人。 可寫入
acceptCommands[].type string 這個指令對應的作業類型。允許的值包括:
  • TAKE_A_NOTE - 共用時間軸項目,內含「新增記事」的使用者語音轉錄稿語音選單指令。
  • POST_AN_UPDATE - 分享時間軸項目,內含「張貼最新動態」的使用者語音轉錄稿語音選單指令。
可寫入
acceptTypes[] list 聯絡人支援的 MIME 類型清單。如果聯絡人的接受 Types 符合項目上任何類型的附件,系統就會向使用者顯示聯絡人。如未提供接受類型,則所有項目都會顯示聯絡人。 可寫入
displayName string 這位聯絡人的顯示名稱。 可寫入
id string 這位聯絡人的 ID。這項資訊是由應用程式產生,並視為不透明權杖。 可寫入
imageUrls[] list 一組聯絡人要顯示的圖片網址。大部分的聯絡人只會有一張圖片,而「群組」則只有一張圖片。聯絡人最多可包含 8 個圖片網址,且網址會經過調整,並裁剪成用戶端上的馬賽克圖片。 可寫入
kind string 資源的類型。一律為 mirror#contact
phoneNumber string 聯絡人的主要電話號碼。這可以是完整的電話號碼,包含國碼和區碼,或是當地電話號碼。 可寫入
priority unsigned integer 聯絡人在聯絡人清單中排序的優先順序。優先順序較高的聯絡人會顯示在優先順序較低的聯絡人之前。 可寫入
sharingFeatures[] list 聯絡人可處理的共用功能清單。允許的值包括:
  • ADD_CAPTION
source string 建立此聯絡人的應用程式 ID。可由 API 填入
speakableName string 此聯絡人的姓名 (應要唸出)。如果系統必須將這位聯絡人的姓名用於消歧選單,就會使用這個名稱成為預期的發音。如果聯絡人名稱的字元無法識別,或是顯示拼寫方式與意思不同,這項功能就非常實用。 可寫入
type string 這位聯絡人的類型。用於在 UI 中排序。允許的值包括:
  • INDIVIDUAL - 代表單人。此為預設值。
  • GROUP - 代表多名使用者,
可寫入

方法

刪除
刪除聯絡人。
取得
按 ID 取得單一聯絡人。
插入
插入新聯絡人。
list
擷取已驗證使用者的聯絡人清單。
修補程式
更新現有聯絡人。這個方法支援修補語意
更新
更新現有聯絡人。