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 会针对每条语音菜单命令最多显示 3 位联系人。如果超过这个数量,针对该特定命令,系统会显示 priority 最高的三个联系人。 可写入
acceptCommands[].type string 与此命令对应的操作类型。允许的值包括:
  • TAKE_A_NOTE - 与通过“添加记事”语音菜单命令的用户语音转录内容共享时间轴项。
  • POST_AN_UPDATE - 与通过“发布更新”语音菜单命令转录的用户语音内容分享时间轴项。
可写入
acceptTypes[] list 联系人支持的 MIME 类型的列表。如果联系人的任何一种 acceptTypes 与该项的任何附件类型匹配,该联系人便会向用户显示。如果未提供 acceptType,则将针对所有项显示联系人。 可写入
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 - 代表多个人。
可写入

方法

删除
删除联系人。
get
根据 ID 获取单个联系人。
insert
插入新联系人。
list
检索经过身份验证的用户的联系人列表。
patch
在原位更新联系人。此方法支持补丁语义
update
在原位更新联系人。