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.

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.

(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).

amin@example.com

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).

amin@example.com

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).

amin@example.com
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)
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', 'amin@example.com', '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.

(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).

amin@example.com

Google Slaytlar etkinlikleri

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

(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).

amin@example.com

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.

* (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).

amin@example.com

* 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)
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.
ziyaret edin.

EventUpdated

(yüklenebilir)
authMode

ScriptApp.AuthMode enum.

FULL
calendarId

Etkinlik güncellemesinin gerçekleştiği takvimin dize kimliği.

susan@example.com
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