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 Список команд голосового меню, которые может обрабатывать контакт. На стекле отображается до трех контактов для каждой команды голосового меню. Если их больше, для этой конкретной команды отображаются три контакта с наивысшим priority . записываемый
acceptCommands[]. type string Тип операции, которому соответствует эта команда. Допустимые значения:
  • TAKE_A_NOTE — предоставляет общий доступ к элементу временной шкалы с транскрипцией речи пользователя из команды голосового меню «Сделать заметку».
  • POST_AN_UPDATE — публикует элемент временной шкалы с транскрипцией речи пользователя из команды голосового меню «Опубликовать обновление».
записываемый
acceptTypes[] list Список типов MIME, которые поддерживает контакт. Контакт будет показан пользователю, если какой-либо из его AcceptTypes соответствует любому из типов вложений в элементе. Если AcceptTypes не указаны, контакт будет отображаться для всех элементов. записываемый
displayName string Имя, которое будет отображаться для этого контакта. записываемый
id string Идентификатор этого контакта. Он генерируется приложением и рассматривается как непрозрачный токен. записываемый
imageUrls[] list Набор URL-адресов изображений для отображения для контакта. Большинство контактов будет иметь одно изображение, но «групповой» контакт может включать до 8 URL-адресов изображений, и их размер будет изменен и обрезан в виде мозаики на клиенте. записываемый
kind string Тип ресурса. Это всегда mirror#contact .
phoneNumber string Основной номер телефона для контакта. Это может быть полный номер с кодом страны и кодом города или местный номер. записываемый
priority unsigned integer Приоритет контакта для определения порядка в списке контактов. Контакты с более высоким приоритетом будут отображаться перед контактами с более низким приоритетом. записываемый
sharingFeatures[] list Список функций общего доступа, которые может использовать контакт. Допустимые значения:
  • ADD_CAPTION
source string Идентификатор приложения, создавшего этот контакт. Это заполняется API
speakableName string Имя этого контакта как следует произносить. Если имя этого контакта необходимо произнести как часть голосового меню устранения неоднозначности, это имя используется в качестве ожидаемого произношения. Это полезно для имен контактов, содержащих непроизносимые символы или отображаемое написание которых не является фонетическим. записываемый
type string Тип этого контакта. Это используется для сортировки в пользовательском интерфейсе. Допустимые значения:
  • INDIVIDUAL - Представляет одного человека. Это значение по умолчанию.
  • GROUP — представляет собой более чем одного человека.
записываемый

Методы

удалить
Удаляет контакт.
получать
Получает один контакт по идентификатору.
вставлять
Вставляет новый контакт.
список
Получает список контактов для аутентифицированного пользователя.
пластырь
Обновляет контакт на месте. Этот метод поддерживает семантику исправлений .
обновлять
Обновляет контакт на месте.