Subscriptions

API зеркала позволяет подписаться на уведомления , которые отправляются, когда пользователь выполняет определенные действия над элементом временной шкалы или когда местоположение пользователя обновляется.

Список методов для этого ресурса см. в конце этой страницы.

Представления ресурсов

Подписка на события в коллекции. 

{
  "kind": "mirror#subscription",
  "id": string,
  "updated": datetime,
  "collection": string,
  "operation": [
    string
  ],
  "callbackUrl": string,
  "verifyToken": string,
  "userToken": string,
  "notification": {
    "collection": string,
    "itemId": string,
    "operation": string,
    "userActions": [
      {
        "type": string,
        "payload": string
      }
    ],
    "verifyToken": string,
    "userToken": string
  }
}
Имя свойства Ценить Описание Примечания
callbackUrl string URL-адрес, по которому должны доставляться уведомления (должен начинаться с https:// ). записываемый
collection string Коллекция, на которую можно подписаться. Допустимые значения:
  • timeline — изменения на временной шкале, включая вставку, удаление и обновление.
  • locations - Обновления локаций.
  • settings - Обновления настроек.
 записываемый
id string Идентификатор подписки.
kind string Тип ресурса. Это всегда mirror#subscription .
notification nested object Объект-контейнер для уведомлений. Это значение не заполняется в ресурсе Subscription .
notification. collection string Коллекция, создавшая уведомление.
notification. itemId string Идентификатор элемента, создавшего уведомление.
notification. operation string Тип операции, вызвавшей уведомление.

Приемлемые значения:
  • " DELETE "
  • " INSERT "
  • " MENU_ACTION "
  • " UPDATE "
notification. userActions[] list Список действий, предпринятых пользователем, которые вызвали уведомление.
notification.userActions[]. payload string Дополнительная полезная нагрузка для действия.

Для действий типа CUSTOM это идентификатор выбранного пункта пользовательского меню.
notification.userActions[]. type string Тип действия. Значение этого может быть:
  • SHARE — пользователь поделился элементом.
  • REPLY – пользователь ответил на товар.
  • REPLY_ALL — пользователь ответил всем получателям сообщения.
  • CUSTOM — пользователь выбрал пользовательский пункт меню на элементе временной шкалы.
  • DELETE – пользователь удалил элемент.
  • PIN – пользователь закрепил элемент.
  • UNPIN – пользователь открепил элемент.
  • LAUNCH – пользователь инициировал голосовую команду.
В будущем могут быть добавлены дополнительные типы. UserActions с нераспознанными типами следует игнорировать.
notification. userToken string Токен пользователя, предоставленный службой при подписке на уведомления.
notification. verifyToken string Токен секретной проверки, предоставленный службой при подписке на уведомления.
operation[] list Список операций, на которые следует подписаться. Пустой список означает, что на все операции над коллекцией должна быть подписана подписка. Допустимые значения:
  • UPDATE — элемент обновлен.
  • INSERT – добавлен новый элемент.
  • DELETE – элемент удален.
 записываемый
updated datetime Время последнего изменения этой подписки, отформатированное в соответствии с RFC 3339.
userToken string Непрозрачный токен, отправляемый подписчику в уведомлениях, чтобы он мог определить идентификатор пользователя. записываемый
verifyToken string Секретный токен, отправляемый подписчику в уведомлениях, чтобы он мог проверить, что уведомление было создано Google. записываемый

Методы

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