REST Resource: forms.watches

Kaynak: İzleme

Form etkinliklerini takip eden bir saat. Belirtilen 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 dizesine sahip olan bir eventType anahtarı içerir.

İletiler en az bir kez teslim edilerek gönderilir ve yalnızca olağanüstü durumlarda kaldırılır. Genel olarak tüm bildirimlerin birkaç saniye içinde teslim edilmesi gerekir. Ancak, bazı durumlarda bildirimler gecikebilir.

watches.renew ile yenilenmeyen bir saatin 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 saatin kimliği. CreateWatchRequest.watch_id sayfasındaki notlara bakın.
target

object (WatchTarget)

Zorunlu. Bildirimin gönderileceği hedef.
eventType

enum (EventType)

Zorunlu. İzlenecek etkinlik türü.
createTime

string (Timestamp format)

Yalnızca çıkış. Bunun oluşturulduğu tarihi gösteren zaman damgası.

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
expireTime

string (Timestamp format)

Yalnızca çıkış. Süresinin ne zaman dolacağını gösteren zaman damgası. Her watches.renew çağrısı bu süreyi gelecekteki yedi gün olarak sıfırlar.

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
errorType

enum (ErrorType)

Yalnızca çıkış. Teslimat girişimi için en son hata türü. Formu izlemeye devam etmek için watches.renew numaralı telefona bir sesli arama yapılabilir. Bu arama, söz konusu hata bilgilerini de temizler.
state

enum (State)

Yalnızca çıkış. Saatin mevcut durumu. Askıya alınan saatlerle ilgili daha fazla bilgiyi errorType sayfasında bulabilirsiniz.

WatchTarget

Bildirim tesliminin 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
target alanı. Zorunlu. Bildirim tesliminin hedefi. target şunlardan yalnızca biri olabilir:
topic

object (CloudPubsubTopic)

Pub/Sub konusu. Bildirim almak için konunun, serviceAccount:forms-notifications@system.gserviceaccount.com Formlar hizmet hesabına yayınlama ayrıcalıkları vermesi gerekir. Yalnızca konu sahibi olan proje bu konuyla bir saat oluşturabilir.

Pub/Sub teslimat garantileri dikkate alınmalıdır.

CloudPubsubTopic

Pub/Sub konusu.

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

string

Zorunlu. Etkinliklerin yayınlanacağı tam nitelikli bir Pub/Sub konu adı. Bu konu, çağrıda bulunan 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 etkinlik türü. Bu etkinlik türüne sahip bir kol saati, form içeriği ve ayarlarında yapılan değişikliklerle ilgili bildirim alır.
RESPONSES Yanıtlar etkinlik türü. Form yanıtları gönderildiğinde bu etkinlik türüne sahip bir kol saatine bildirim gönderilir.

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ı, projenizin formlarına erişme yetkisini iptal ettiyse bu durum meydana gelir. Bu hataya sahip saatler yeniden denenmez. Formu izlemeye tekrar başlamak için watches.renew numaralı telefona bir arama yapılabilir.
NO_USER_ACCESS Erişim izni veren kullanıcının artık izlenen forma erişimi yok. Bu hataya sahip saatler yeniden denenmez. Formu izlemeye tekrar başlamak için watches.renew numaralı telefona bir arama yapılabilir.
OTHER_ERRORS Başka bir hata türü oluştu. Bildirimlerin devam edip etmeyeceği state saatine bağlıdır.

Eyalet

Olası izleme durumları.

Sıralamalar
STATE_UNSPECIFIED Belirtilmemiş durum.
ACTIVE Kol saati etkin durumda.
SUSPENDED Kol saati, giderilebilecek bir hata nedeniyle askıya alındı. Saat, süresi dolana kadar varlığını sürdürür. Kol saatini yeniden etkinleştirmeyi denemek için watches.renew numaralı telefona bir arama yapılabilir

Yöntemler

create

 Yeni saat oluştur.

delete

 Kol saatini silebilir.

list

 Çağıran projeye ait saatlerin listesini döndürür.

renew

 Mevcut bir saati yedi gün için yenileyin.