REST Resource: forms.watches

Kaynak: İzleme

Bir formun etkinliklerini izleyen bir izleme. Belirtilen etkinlik gerçekleştiğinde, belirtilen hedefe bir bildirim yayınlanır. Bildirimin özelliklerinde, izlenen formun kimliğini içeren bir formId anahtarı ve türün dizesini içeren bir eventType anahtarı bulunur.

İletiler en az bir kez teslimat seçeneğiyle gönderilir ve yalnızca olağanüstü durumlarda bırakılır. Genellikle tüm bildirimler birkaç saniye içinde güvenilir bir şekilde gönderilir. Ancak bazı durumlarda bildirimler gecikebilir.

İzleme, watches.renew ile yenilenmediği sürece oluşturulduktan yedi gün sonra geçerliliğini yitirir.

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 notları inceleyin.
target

object (WatchTarget)

Zorunlu. Bildirimin gönderileceği yer.
eventType

enum (EventType)

Zorunlu. İzlenecek etkinlik türü.
createTime

string (Timestamp format)

Yalnızca çıkış. Bu öğenin oluşturulduğu zaman damgası.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
expireTime

string (Timestamp format)

Yalnızca çıkış. Bu özelliğin süresinin sona ereceği zaman damgası. Her watches.renew çağrısı, bu değeri gelecekte yedi gün olarak sıfırlar.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
errorType

enum (ErrorType)

Yalnızca çıkış. Teslimat denemesi için en son hata türü. Formu tekrar izlemeye başlamak için watches.renew numaralı telefona çağrı yapılabilir. Bu hatalı bilgi de bu şekilde temizlenir.
state

enum (State)

Yalnızca çıkış. Kol saatinin mevcut durumu. Askıya alınmış kol saatleriyle ilgili ek bilgileri errorType'de bulabilirsiniz.

WatchTarget

Bildirimin gönderileceği hedef.

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
Birlik alanı target. Zorunlu. Bildirimin gönderileceği hedef. target yalnızca aşağıdakilerden biri olabilir:
topic

object (CloudPubsubTopic)

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

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

CloudPubsubTopic

Pub/Sub konusu.

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

string

Zorunlu. Etkinliklerin yayınlanacağı tam nitelikli Pub/Sub konu adı. Bu konunun, çağıran projeye ait olması ve Pub/Sub'da mevcut olması gerekir.

EventType

İzlenebilecek olası etkinlik türleri.

Sıralamalar
EVENT_TYPE_UNSPECIFIED Belirtilmemiş etkinlik türü. 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ındaki değişiklikler hakkında bilgilendirilir.
RESPONSES Yanıtlar etkinlik türü. Bu etkinlik türüne sahip bir kol saati, form yanıtları gönderildiğinde bilgilendirilir.

ErrorType

Olası hata türleri.

Sıralamalar
ERROR_TYPE_UNSPECIFIED Belirtilmemiş hata türü.
PROJECT_NOT_AUTHORIZED Bulut projesinin izlenen forma erişimi yok. Bu durum, kullanıcının projenizin formlarına erişme yetkisini iptal etmesi durumunda ortaya çıkar. Bu hatayı içeren saatler için yeniden deneme yapılmaz. Formu tekrar izlemeye başlamak için watches.renew numaralı telefondan arama yapılabilir.
NO_USER_ACCESS Erişim izni veren kullanıcı, izlenen forma artık erişemez. Bu hatayı içeren saatler için yeniden deneme yapılmaz. Formu tekrar izlemeye başlamak için watches.renew numaralı telefondan arama yapılabilir.
OTHER_ERRORS Başka bir hata türü oluştu. Bildirimlerin devam edip etmeyeceği state kol saatine bağlıdır.

Eyalet

Olası kol saati durumları.

Sıralamalar
STATE_UNSPECIFIED Belirtilmemiş durum.
ACTIVE İzleme etkin.
SUSPENDED Saat, çözülebilecek bir hata nedeniyle askıya alındı. İzleme, süresi dolana kadar mevcut olmaya devam eder. Kol saatini yeniden etkinleştirmeyi denemek için watches.renew numaralı telefonu arayabilirsiniz.

Yöntemler

create

 Yeni bir izleme listesi oluşturun.

delete

 Bir kol saatini silme

list

 Çağıran projenin sahip olduğu kol saatlerinin listesini döndürme.

renew

 Mevcut bir izlemeyi yedi gün boyunca yenileyebilirsiniz.