REST Resource: forms.watches

Kaynak: Watch

Form etkinlikleri için izleme. Belirlenen etkinlik gerçekleştiğinde, belirtilen hedefe bir bildirim yayınlanır. Bildirimin özellikleri, izlenen formun kimliğine sahip bir formId anahtarı ve türün dizesini içeren bir eventType anahtarı içerir.

İletiler en az bir kez teslim edilerek gönderilir ve yalnızca olağanüstü durumlarda atlanır. Genellikle tüm bildirimler birkaç saniye içinde güvenilir bir şekilde teslim edilir; Ancak bazı durumlarda bildirimler gecikebilir.

watches.renew ile yenilenmeyen bir kol saatinin süresi, oluşturulduktan yedi gün sonra dolar

JSON gösterimi 
{
  "id": string,
  "target": {
    object (WatchTarget)
  },
  "eventType": enum (EventType),
  "createTime": string,
  "expireTime": string,
  "errorType": enum (ErrorType),
  "state": enum (State)
}
Alanlar
id

string

Yalnızca çıkış. Bu kol saatinin kimliği. CreateWatchRequest.watch_id ile ilgili notlara bakın.
target

object (WatchTarget)

Zorunlu. Bildirimin gönderileceği yer.
eventType

enum (EventType)

Zorunlu. İzlenecek etkinlik türü.
createTime

string (Timestamp format)

Yalnızca çıkış. Bunun oluşturulduğu tarihin zaman damgası.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
expireTime

string (Timestamp format)

Yalnızca çıkış. Bu sürenin dolacağı zamanı belirten zaman damgası. Her watches.renew çağrısı, bu süreyi yedi güne sıfırlar.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
errorType

enum (ErrorType)

Yalnızca çıkış. Teslim girişimine ilişkin en yeni hata türü. Formu tekrar izlemeye başlamak için watches.renew hattını aratarak bu hata bilgilerinin de temizlenmesini sağlayabilirsiniz.
state

enum (State)

Yalnızca çıkış. Saatin mevcut durumu. Askıya alınmış kol saatleri hakkında daha fazla bilgiye errorType üzerinden ulaşabilirsiniz.

WatchTarget

Bildirim yayınlama hedefi.

JSON gösterimi 
{

  // Union field target can be only one of the following:
  "topic": {
    object (CloudPubsubTopic)
  }
  // End of list of possible types for union field target.
}
Alanlar
Birleştirme alanı target. Zorunlu. Bildirim yayınlama hedefi. target şunlardan yalnızca biri olabilir:
topic

object (CloudPubsubTopic)

Pub/Sub konusudur. Bildirim almak için konunun, Formlar hizmet hesabına (serviceAccount:forms-notifications@system.gserviceaccount.com) yayınlama ayrıcalığı vermesi gerekir. Yalnızca konusunun sahibi olan proje bu konuyla kol saati oluşturabilir.

Pub/Sub yayın garantileri dikkate alınmalıdır.

CloudPubsubTopic

Pub/Sub konusudur.

JSON gösterimi 
{
  "topicName": string
}
Alanlar
topicName

string

Zorunlu. Etkinliklerin yayınlanacağı tam nitelikli Pub/Sub konu adı. Bu konu, çağrı yapan projeye ait olmalı ve Pub/Sub'da zaten mevcut olmalıdır.

EventType

İzlenebilecek olası etkinlik türleri.

Sıralamalar
EVENT_TYPE_UNSPECIFIED Etkinlik türü belirtilmedi. Bu değer kullanılmamalıdır.
SCHEMA Şema etkinliği türü. Bu etkinlik türüne sahip kol saati, form içeriği ve ayarlarında yapılan değişiklikler hakkında bilgilendirilir.
RESPONSES Yanıtlar etkinlik türü. Form yanıtları gönderildiğinde bu etkinlik türündeki bir saat bilgilendirilir.

ErrorType

Olası hata türleri.

Sıralamalar
ERROR_TYPE_UNSPECIFIED Belirtilmemiş hata türü.
PROJECT_NOT_AUTHORIZED Cloud projesinin izlenen forma erişimi yok. Kullanıcı, formlarına erişme yetkisini iptal ettiyse bu durum gerçekleşir. Bu hataya sahip izlemeler yeniden denenmez. Formu tekrar izlemeye başlamak için watches.renew numaralı telefonu arayabilirsiniz
NO_USER_ACCESS Erişim izni veren kullanıcının artık izlenen forma erişimi yok. Bu hataya sahip izlemeler yeniden denenmez. Formu tekrar izlemeye başlamak için watches.renew numaralı telefonu arayabilirsiniz
OTHER_ERRORS Başka bir hata türü oluştu. Bildirimlerin devam edip etmemesi kol saatine state bağlıdır.

Eyalet

Olası İzleme durumları.

Sıralamalar
STATE_UNSPECIFIED Belirtilmemiş durum.
ACTIVE Kol saati etkin.
SUSPENDED Kol saati, çözülebilecek bir hata nedeniyle askıya alındı. Kol saati, süresi dolana kadar var olmaya devam eder. Kol saatini yeniden etkinleştirme girişiminde bulunmak için watches.renew numaralı telefona arama yapılabilir

Yöntemler

create

 Yeni saat oluşturun.

delete

 Kol saatini silme

list

 Çağrı projesine ait saatlerin listesini döndürün.

renew

 Mevcut kol saatinizi yedi gün süreyle yenilemek