Etkinlik Nesneleri

Basit tetikleyiciler ve yüklenebilir tetikleyiciler Apps Komut Dosyası'nın bir işlevi otomatik olarak çalıştırmak için kullanılır. Bir tetikleyici etkinleştiğinde Apps Komut Dosyası, işlevi bir etkinlik nesnesini bağımsız değişken olarak iletir. e Event nesnesi, etkinleşmesini sağlayın. Örneğin, aşağıdaki örnek kod basit bir onEdit(e) gösterir belirlemek üzere etkinlik nesnesini kullanan bir Google E-Tablolar komut dosyası için tetikleyici hücre düzenlendi.

function onEdit(e){
  // Set a comment on the edited cell to indicate when it was changed.
  var range = e.range;
  range.setNote('Last modified: ' + new Date());
}

Bu sayfada, etkinlik nesnesindeki farklı türler için alanlar tetikleyiciler için geçerlidir.

Yüklenebilir tetikleyicilerin oluşturduğu etkinlikler, Etkinliği oluşturan tetikleyiciyi tanımlayan triggerUid. Bu özellik, birden fazla yüklenebilir tetikleyicisi olan komut dosyaları için faydalıdır.

Google E-Tablolar etkinlikleri

Google E-Tablolar'a özel çeşitli tetikleyiciler, komut dosyalarının kullanıcının işlem olarak görebilirsiniz.

Aç (basit ve yüklenebilir)
authMode	ScriptApp.AuthMode sıralamasındaki bir değer. LIMITED
source	Spreadsheet komut dosyasının bağlı olduğu Google E-Tablolar dosyasını temsil eden bir nesnedir. Spreadsheet
triggerUid	Bu etkinliği oluşturan tetikleyicinin kimliği (yalnızca yüklenebilir tetikleyiciler). 4034124084959907503
user	User nesnesi, Etkin kullanıcıyı (varsa) temsil eder (bir dizi karmaşık güvenlik kısıtlamasına bağlı olarak). [e-mail]

Değiştir (yüklenebilir)
authMode	ScriptApp.AuthMode sıralamasındaki bir değer. FULL
changeType	Değişikliğin türü (EDIT, INSERT_ROW, INSERT_COLUMN, REMOVE_ROW, REMOVE_COLUMN, INSERT_GRID, REMOVE_GRID, FORMAT veya OTHER). INSERT_ROW
source	Spreadsheet (örneğin, komut dosyasının bulunduğu Google E-Tablolar dosyasını temsil eden) nesne bağlı. Spreadsheet
triggerUid	Bu etkinliği oluşturan tetikleyicinin kimliği. 4034124084959907503
user	User nesnesi, Etkin kullanıcıyı (varsa) temsil eder (bir dizi karmaşık güvenlik kısıtlamasına bağlı olarak). [e-mail]

Düzenle (basit ve yüklenebilir)
authMode	ScriptApp.AuthMode sıralamasındaki bir değer. LIMITED
oldValue	Varsa düzenlemeden önceki hücre değeri. Yalnızca düzenlenen aralık tek bir hücredir. Hücrede daha önce hiç yoksa tanımsız olur içerik. 1234
range	Range nesnesi, gösterilen hücreyi veya hücre aralığını gösterir. Range
source	Spreadsheet komut dosyasının bağlı olduğu Google E-Tablolar dosyasını temsil eden bir nesnedir. Spreadsheet
triggerUid	Bu etkinliği oluşturan tetikleyicinin kimliği (yalnızca yüklenebilir tetikleyiciler). 4034124084959907503
user	User nesnesi, Etkin kullanıcıyı (varsa) temsil eder (bir dizi karmaşık güvenlik kısıtlamasına bağlı olarak). [e-mail]
value	Düzenlemeden sonraki yeni hücre değeri. Yalnızca, düzenlenen aralık bir Tek hücreli. 10

Form gönderme (yüklenebilir)
Dikkat: SpreadsheetTriggerBuilder ile birlikte bu form gönderme tetikleyicisini kullandığınızdan emin olun.
authMode	ScriptApp.AuthMode sıralamasındaki bir değer. FULL
namedValues	Form gönderimindeki soru adlarını ve değerleri içeren bir nesne. { 'First Name': ['Jane'], 'Timestamp': ['6/7/2015 20:54:13'], 'Last Name': ['Doe'] }
range	Range nesnesi, gösterilen hücreyi veya hücre aralığını gösterir. Range
triggerUid	Bu etkinliği oluşturan tetikleyicinin kimliği. 4034124084959907503
values	Değerlerin e-tabloda göründüğü aynı sırayla yer aldığı dizi. ['2015/05/04 15:00', '[e-mail]', 'Bob', '27', 'Bill', '28', 'Susan', '25']

Google Dokümanlar etkinlikleri

Tetikleyiciler, kullanıcı bir dokümanı açtığında Google Dokümanlar'ın yanıt vermesine olanak tanır.

Aç (basit ve yüklenebilir)
authMode	ScriptApp.AuthMode sıralamasındaki bir değer. LIMITED
source	Document nesnesi, komut dosyasının bağlı olduğu Google Dokümanlar dosyasını temsil eder. Document
triggerUid	Bu etkinliği oluşturan tetikleyicinin kimliği (yalnızca yüklenebilir tetikleyiciler). 4034124084959907503
user	User nesnesi, Etkin kullanıcıyı (varsa) temsil eder (bir dizi karmaşık güvenlik kısıtlamasına bağlı olarak). [e-mail]

Google Slaytlar etkinlikleri

Tetikleyiciler, kullanıcı bir sunuyu açtığında Google Slaytlar'ın yanıt vermesine olanak tanır.

Aç (basit)
authMode	ScriptApp.AuthMode sıralamasındaki bir değer. LIMITED
source	Presentation nesnesi, komut dosyasının bağlı olduğu Google Slaytlar dosyasını temsil eder. Presentation
user	User nesnesi, Etkin kullanıcıyı (varsa) temsil eder (bir dizi karmaşık güvenlik kısıtlamasına bağlı olarak). [e-mail]

Google Formlar etkinlikleri

Google Formlar'a özel tetikleyiciler, kullanıcı bir formu düzenlediğinde komut dosyalarının yanıt vermesini sağlar. veya bir yanıt gönderdiğinde.

Aç * (basit ve yüklenebilir)
authMode	ScriptApp.AuthMode sıralamasındaki bir değer. LIMITED
source	Form nesnesi, komut dosyasının bağlı olduğu Google Formlar dosyasını temsil eder. Form
triggerUid	Bu etkinliği oluşturan tetikleyicinin kimliği (yalnızca yüklenebilir tetikleyiciler). 4034124084959907503
user	User nesnesi, Etkin kullanıcıyı (varsa) temsil eder (bir dizi karmaşık güvenlik kısıtlamasına bağlı olarak). [e-mail]

* Bu etkinlik, bir kullanıcı yanıt vermek üzere bir formu açtığında değil, Bir düzenleyici formu değiştirmek için açtığında.

Form gönderme (yüklenebilir)
Dikkat: FormTriggerBuilder ile birlikte bu form gönderme tetikleyicisini kullandığınızdan emin olun.
authMode	ScriptApp.AuthMode sıralamasındaki bir değer. FULL
response	FormResponse nesnesi, kullanıcının forma verdiği yanıtı bir bütün olarak temsil eder. FormResponse
source	Form nesnesi, komut dosyasının bağlı olduğu Google Formlar dosyasını temsil eder. Form
triggerUid	Bu etkinliği oluşturan tetikleyicinin kimliği. 4034124084959907503

Google Takvim etkinlikleri

Takvim tetikleyicileri bir kullanıcının takvim etkinlikleri güncellendiğinde (oluşturulduğunda, olup olmadığını kontrol edin.

Bu tetikleyiciler hangi etkinliğin veya nasıl değiştiğini size bildirmez. Bunun yerine, kodunuzun artımlı senkronizasyon işlemi yapması gerektiğini belirtir. takvimdeki son değişiklikleri alın. Tam açıklama için daha fazla bilgi edinmek için Şu uygulama için kaynakları senkronize etme kılavuzu: Calendar API.

Apps Komut Dosyası'nda Takvim ile senkronize etmek için aşağıdaki adımları uygulayın:

1. Şu hizmetler için Takvim gelişmiş hizmetini etkinleştirin: komut dosyası projesidir. Yerleşik Takvim hizmeti bu iş akışını takip edebilir.
2. Hangi takvimlerin senkronize edileceğini belirleyin. Bunun gibi her takvim için ilk senkronizasyon işlemini gerçekleştirme "Takvim gelişmiş" hizmetinin Events.list() yöntemini kullanın.
3. İlk senkronizasyonun sonucu söz konusu takvim için bir nextSyncToken döndürür. Bu jetonu daha sonra kullanmak üzere saklayın.
4. Bir takvimi belirten Apps Komut Dosyası EventUpdated tetikleyicisi etkinleştiğinde etkinlik değişikliği, artımlı senkronizasyon gerçekleştirme kaydedilen nextSyncToken adresini kullanarak, etkilenen takvim için geçerlidir. Bu aslında başka bir Events.list() isteğe bağlıdır, ancak nextSyncToken sağlandığında yanıt yalnızca son senkronizasyondan bu yana değişen etkinlikler.
5. Hangi etkinliklerin güncellendiğini öğrenmek için senkronizasyonun yanıtını inceleyin ve kodunuzun doğru şekilde yanıt vermesini sağlayın. Örneğin, değişikliği günlüğe kaydedebilir, e-tabloyu güncelleme, e-posta bildirimleri gönderme veya başka işlemler yapma.
6. Bu takvim için depoladığınız nextSyncToken değerini, döndürülen takvimle güncelleyin artımlı senkronizasyon isteği tarafından oluşturulabilir. Bu, bir sonraki senkronizasyon işlemini yalnızca en güncel değişiklikleri döndürür.

Dikkat: Senkronizasyon jetonları zaman zaman sunucu tarafından geçersiz kılınarak 410 hata. Bu durumda, kodunuzun tam senkronizasyon ve ilgili takvimde depolanan tüm senkronize edilmiş veriler ile jetonları değiştirin.

EventUpdated (yüklenebilir)
authMode	ScriptApp.AuthMode enum. FULL
calendarId	Etkinlik güncellemesinin gerçekleştiği takvimin dize kimliği. [e-mail]
triggerUid	Bu etkinliği oluşturan tetikleyicinin kimliği. 4034124084959907503

Google Workspace Eklenti etkinlikleri

onInstall() tetikleyicisi çalışır Kullanıcı bir eklenti yüklediğinde otomatik olarak.

Yükle (basit)
authMode	ScriptApp.AuthMode sıralamasındaki bir değer. FULL

Google Chat uygulaması etkinlikleri

Google Chat'teki etkinlik nesneleri hakkında bilgi edinmek için: Google Chat uygulamanızla olan etkileşimleri alın ve yanıtlayın.

Zamana dayalı etkinlikler

Zamana dayalı tetikleyiciler (saat tetikleyicileri de denir) komut dosyalarının belirli bir zamanda veya belirli bir yinelenen aralık.

Zaman odaklı (yüklenebilir)
authMode	ScriptApp.AuthMode sıralamasındaki bir değer. FULL
day-of-month	1 ile 31 arasında. Bu özellik adı tire içerdiğinden erişilmesi gerekir e['day-of-month'] kullanın. 31
day-of-week	1 (Pazartesi) ile 7 (Pazar) arasında. Bu özellik adı tire içerdiğinden erişilmesi gerekir e['day-of-week'] kullanın. 7
hour	0 ile 23 arasında. 23
minute	0 ile 59 arasında. 59
month	1 ile 12 arasında. 12
second	0 ile 59 arasında. 59
timezone	Saat dilimi. UTC
triggerUid	Bu etkinliği oluşturan tetikleyicinin kimliği. 4034124084959907503
week-of-year	1 ile 52 arasında. Bu özellik adı tire içerdiğinden erişilmesi gerekir e['week-of-year'] kullanın. 52
year	Yıl. 2015