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 类型列表。如果该联系人的任一 allowTypes 与该项中的任一附件类型匹配,则系统会向用户显示该联系人。如果未提供 allowTypes,将显示所有商品的联系人信息。 可写入
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 此联系人的类型。这用于在界面中进行排序。允许的值为:
  • INDIVIDUAL - 代表一个人。这是默认值。
  • GROUP - 代表多人。
可写入

方法

delete
删除联系人。
get
根据 ID 获取单个联系人。
插入
插入新的联系人。
list
检索通过身份验证的用户的联系人列表。
补丁程序
更新就地联系人。此方法支持补丁语义
update
更新就地联系人。