Script Service

Script

Bu hizmet, komut dosyası tetikleyicilerine ve komut dosyası yayınlamaya erişim sağlar.

Sınıflar

AdKısa açıklama
AuthModeApps Script'in tetiklenmiş bir işlev aracılığıyla hangi yetkili hizmet kategorilerini çalıştırabileceğini tanımlayan bir listeleme.
AuthorizationInfoKullanıcının bir veya daha fazla hizmeti kullanmak için bu komut dosyasını yetkilendirmesi gerekip gerekmediğini belirlemek ve yetkilendirme iletişim kutusunun URL'sini sağlamak için kullanılan bir nesne.
AuthorizationStatusBir komut dosyasının yetkilendirme durumunu belirten bir listeleme.
CalendarTriggerBuilderTakvim tetikleyicileri için oluşturucu.
ClockTriggerBuilderSaat tetikleyicileri için bir oluşturucu.
DocumentTriggerBuilderDoküman tetikleyicileri için bir oluşturucu.
EventTypeTetiklenen etkinliğin türünü belirten bir liste.
FormTriggerBuilderForm tetikleyicileri için bir oluşturucu.
InstallationSourceKomut dosyasının mevcut kullanıcı için eklenti olarak nasıl yüklendiğini belirten bir listeleme.
ScriptAppKomut dosyası yayınlama ve tetikleyicilere erişme ve bunları değiştirme.
ServiceKomut dosyası yayınlamaya erişme ve bu işlemi değiştirme
SpreadsheetTriggerBuilderE-tablo tetikleyicileri için oluşturucu.
StateTokenBuilderKomut dosyalarının, geri çağırma API'lerinde (OAuth akışları gibi) kullanılabilecek durum jetonları oluşturmasına olanak tanır.
TriggerKomut dosyası tetikleyicisi.
TriggerBuilderKomut dosyası tetikleyicileri için genel bir oluşturucu.
TriggerSourceTetikleyicinin etkinleştirilmesine neden olan etkinliğin kaynağını belirten bir listeleme.

AuthMode

Özellikler

MülkTürAçıklama
NONEEnumYetkilendirme gerektiren hizmetlere erişime izin vermeyen bir mod.
CUSTOM_FUNCTIONEnumÖzel e-tablo işlevlerinde kullanılmak üzere sınırlı sayıda hizmet alt kümesine erişime izin veren bir mod.
LIMITEDEnumSınırlı sayıda hizmete erişime izin veren bir mod.
FULLEnumYetkilendirme gerektiren tüm hizmetlere erişime izin veren bir mod.

AuthorizationInfo

Yöntemler

YöntemDönüş türüKısa açıklama
getAuthorizationStatus()AuthorizationStatusKullanıcının bir veya daha fazla hizmeti (örneğin, ScriptApp.AuthorizationStatus.REQUIRED) kullanmak için bu komut dosyasını yetkilendirmesi gerekip gerekmediğini belirten bir değer alır.
getAuthorizationUrl()StringKomut dosyasına erişim izni vermek için kullanılabilecek yetkilendirme URL'sini alır.

AuthorizationStatus

Özellikler

MülkTürAçıklama
REQUIREDEnumKullanıcının bir veya daha fazla hizmeti kullanabilmesi için bu komut dosyasını yetkilendirmesi gerekir.
NOT_REQUIREDEnumKullanıcı, bu komut dosyasına şu anda ihtiyaç duyduğu tüm yetkileri verdi.

CalendarTriggerBuilder

Yöntemler

YöntemDönüş türüKısa açıklama
create()TriggerTetikleyiciyi oluşturur ve döndürür.
onEventUpdated()CalendarTriggerBuilderBir takvim girişi oluşturulduğunda, güncellendiğinde veya silindiğinde etkinleşen bir tetikleyici belirtir.

ClockTriggerBuilder

Yöntemler

YöntemDönüş türüKısa açıklama
after(durationMilliseconds)ClockTriggerBuilderTetikleyicinin çalıştığı mevcut zamandan sonra geçecek minimum süreyi (milisaniye cinsinden) belirtir.
at(date)ClockTriggerBuilderTetikleyicinin ne zaman çalışacağını belirtir.
atDate(year, month, day)ClockTriggerBuilderTetikleyicinin, varsayılan olarak gece yarısına (+/- 15 dakika) yakın bir zamanda, belirtilen tarihte etkinleşeceğini belirtir.
atHour(hour)ClockTriggerBuilderTetikleyicinin çalışacağı saati belirtir.
create()TriggerTetikleyiciyi oluşturur.
everyDays(n)ClockTriggerBuilderTetikleyicinin n günde bir çalışacağını belirtir.
everyHours(n)ClockTriggerBuilderTetikleyicinin n saatte bir çalışacağını belirtir.
everyMinutes(n)ClockTriggerBuilderTetikleyicinin n dakikada bir çalışacağını belirtir.
everyWeeks(n)ClockTriggerBuilderTetikleyicinin n haftada bir çalışacağını belirtir.
inTimezone(timezone)ClockTriggerBuilderTetikleyicinin çalışacağı tarih/saat için saat dilimini belirtir.
nearMinute(minute)ClockTriggerBuilderTetikleyicinin çalışacağı dakikayı (artı veya eksi 15 dakika) belirtir.
onMonthDay(day)ClockTriggerBuilderTetikleyicinin çalıştırıldığı ayın tarihini belirtir.
onWeekDay(day)ClockTriggerBuilderTetikleyicinin çalışacağı haftanın gününü belirtir.

DocumentTriggerBuilder

Yöntemler

YöntemDönüş türüKısa açıklama
create()TriggerYeni tetikleyiciyi oluşturur ve döndürür.
onOpen()DocumentTriggerBuilderBelge açıldığında tetiklenecek bir tetikleyici belirtir.

EventType

Özellikler

MülkTürAçıklama
CLOCKEnumTetikleyici, zamana dayalı etkinlik belirli bir zamana ulaştığında tetiklenir.
ON_OPENEnumTetikleyici, kullanıcı Google Dokümanlar, E-Tablolar veya Formlar dosyasını açtığında etkinleştirilir.
ON_EDITEnumTetikleyici, kullanıcı Google E-Tablolar dosyasını düzenlediğinde (ör. bir hücreye yeni bir değer girerek, bu işlem değişiklik yerine düzenleme olarak sayılır) tetiklenir.
ON_FORM_SUBMITEnumTetikleyici, kullanıcı bir Google Formu'na yanıt verdiğinde etkinleştirilir.
ON_CHANGEEnumTetikleyici, kullanıcı Google E-Tablolar dosyasını değiştirdiğinde (ör. düzenleme yerine değişiklik olarak sayılan bir satır ekleyerek) tetiklenir.
ON_EVENT_UPDATEDEnumTetikleyici, belirtilen Google Takvim'de bir etkinlik oluşturulduğunda, güncellendiğinde veya silindiğinde etkinleştirilir.

FormTriggerBuilder

Yöntemler

YöntemDönüş türüKısa açıklama
create()TriggerYeni tetikleyiciyi oluşturur ve döndürür.
onFormSubmit()FormTriggerBuilderForma yanıt gönderildiğinde tetiklenecek bir tetikleyici belirtir.
onOpen()FormTriggerBuilderFormun düzenleme görünümü açıldığında tetiklenecek bir tetikleyici belirtir.

InstallationSource

Özellikler

MülkTürAçıklama
APPS_MARKETPLACE_DOMAIN_ADD_ONEnumEklenti, yönetici tarafından kullanıcının alanı için yüklendi.
NONEEnumKomut dosyası eklenti olarak çalışmıyor.
WEB_STORE_ADD_ONEnumEklenti, kullanıcı tarafından Chrome Web Mağazası'ndan yüklendi.

ScriptApp

Özellikler

MülkTürAçıklama
AuthModeAuthModeApps Script'in tetiklenmiş bir işlev aracılığıyla hangi yetkili hizmet kategorilerini çalıştırabileceğini tanımlayan bir listeleme.
AuthorizationStatusAuthorizationStatusBir komut dosyasının yetkilendirme durumunu belirten bir listeleme.
EventTypeEventTypeTetiklenen etkinliğin türünü belirten bir liste.
InstallationSourceInstallationSourceKomut dosyasının kullanıcıya eklenti olarak nasıl yüklendiğini belirten bir listeleme.
TriggerSourceTriggerSourceTetikleyicinin etkinleştirilmesine neden olan etkinliğin kaynağını belirten bir listeleme.
WeekDayWeekdayHaftanın günlerini temsil eden bir liste.

Yöntemler

YöntemDönüş türüKısa açıklama
deleteTrigger(trigger)voidBelirtilen tetikleyiciyi kaldırarak artık çalışmasını engeller.
getAuthorizationInfo(authMode)AuthorizationInfoKullanıcının bir veya daha fazla hizmeti kullanmak için bu komut dosyasını yetkilendirmesi gerekip gerekmediğini belirlemek ve yetkilendirme iletişim kutusunun URL'sini sağlamak için kullanılan bir nesne alır.
getIdentityToken()Stringopenid kapsamı verilmişse etkili kullanıcı için bir OpenID Connect kimlik jetonu alır.
getInstallationSource()InstallationSourceKomut dosyasının mevcut kullanıcı için eklenti olarak nasıl yüklendiğini belirten bir enum değeri döndürür (örneğin, kullanıcının Chrome Web Mağazası üzerinden kişisel olarak yükleyip yüklemediğini veya bir alan yöneticisinin tüm kullanıcılar için yükleyip yüklemediğini).
getOAuthToken()StringEtkili kullanıcı için OAuth 2.0 erişim jetonunu alır.
getProjectTriggers()Trigger[]Mevcut proje ve mevcut kullanıcıyla ilişkili tüm yüklenebilir tetikleyicileri alır.
getScriptId()StringKomut dosyası projesinin benzersiz kimliğini alır.
getService()ServiceKomut dosyasının web uygulaması olarak yayınlanmasını kontrol etmek için kullanılan bir nesne alır.
getUserTriggers(document)Trigger[]Yalnızca bu komut dosyası veya eklenti için, belirli bir dokümanda bu kullanıcıya ait tüm yüklenebilir tetikleyicileri alır.
getUserTriggers(form)Trigger[]Yalnızca bu komut dosyası veya eklenti için, belirli bir formda bu kullanıcıya ait tüm yüklenebilir tetikleyicileri alır.
getUserTriggers(spreadsheet)Trigger[]Yalnızca bu komut dosyası veya eklenti için, belirli bir e-tabloda bu kullanıcıya ait tüm yüklenebilir tetikleyicileri alır.
invalidateAuth()voidGeçerli komut dosyasını yürütmek için etkili kullanıcının sahip olduğu yetkiyi geçersiz kılar.
newStateToken()StateTokenBuilderGeri çağırma API'sinde (OAuth akışı gibi) kullanılabilecek bir durum jetonu için bir oluşturucu oluşturur.
newTrigger(functionName)TriggerBuilderTetiklendiğinde belirli bir işlevi çağıran, yüklenebilir bir tetikleyici oluşturma işlemini başlatır.

Service

Yöntemler

YöntemDönüş türüKısa açıklama
getUrl()StringDağıtılmışsa web uygulamasının URL'sini, aksi takdirde null değerini döndürür.
isEnabled()BooleanKomut dosyasına web uygulaması olarak erişilebiliyorsa true değerini döndürür.

SpreadsheetTriggerBuilder

Yöntemler

YöntemDönüş türüKısa açıklama
create()TriggerTetikleyiciyi oluşturur ve döndürür.
onChange()SpreadsheetTriggerBuilderE-tablonun içeriği veya yapısı değiştiğinde tetiklenecek bir tetikleyici belirtir.
onEdit()SpreadsheetTriggerBuilderE-tablo düzenlendiğinde tetiklenecek bir tetikleyici belirtir.
onFormSubmit()SpreadsheetTriggerBuilderE-tabloya bir form gönderildiğinde tetiklenecek bir tetikleyici belirtir.
onOpen()SpreadsheetTriggerBuilderE-tablo açıldığında tetiklenecek bir tetikleyici belirtir.

StateTokenBuilder

Yöntemler

YöntemDönüş türüKısa açıklama
createToken()StringDurum jetonunun şifrelenmiş dize temsilini oluşturur.
withArgument(name, value)StateTokenBuilderJetona bağımsız değişken ekler.
withMethod(method)StateTokenBuilderGeri çağırma işlevi ayarlar.
withTimeout(seconds)StateTokenBuilderJetonun geçerli olduğu süreyi (saniye cinsinden) ayarlar.

Trigger

Yöntemler

YöntemDönüş türüKısa açıklama
getEventType()EventTypeTetikleyicinin etkinleştiği etkinlik türünü döndürür.
getHandlerFunction()StringTetikleyici etkinleştirildiğinde çağrılacak işlevi döndürür.
getTriggerSource()TriggerSourceTetikleyicinin etkinleştirilmesine neden olacak etkinliklerin kaynağını döndürür.
getTriggerSourceId()StringKaynağa özgü kimliği döndürür.
getUniqueId()StringTetikleyicileri birbirinden ayırt etmek için kullanılabilecek benzersiz bir tanımlayıcı döndürür.

TriggerBuilder

Yöntemler

YöntemDönüş türüKısa açıklama
forDocument(document)DocumentTriggerBuilderBelirtilen dokümana bağlı bir DocumentTriggerBuilder oluşturup döndürür.
forDocument(key)DocumentTriggerBuilderBelirtilen kimliğe sahip belgeye bağlı bir DocumentTriggerBuilder oluşturup döndürür.
forForm(form)FormTriggerBuilderBelirtilen forma bağlı bir FormTriggerBuilder oluşturup döndürür.
forForm(key)FormTriggerBuilderBelirtilen kimliğe sahip forma bağlı bir FormTriggerBuilder oluşturup döndürür.
forSpreadsheet(sheet)SpreadsheetTriggerBuilderBelirtilen e-tabloya bağlı bir SpreadsheetTriggerBuilder oluşturup döndürür.
forSpreadsheet(key)SpreadsheetTriggerBuilderBelirtilen kimliğe sahip e-tabloya bağlı bir SpreadsheetTriggerBuilder oluşturup döndürür.
forUserCalendar(emailId)CalendarTriggerBuilderTakvim tetikleyicileri oluşturmak için bir oluşturucu döndürür.
timeBased()ClockTriggerBuilderZamana dayalı tetikleyiciler oluşturmak için bir ClockTriggerBuilder oluşturur ve döndürür.

TriggerSource

Özellikler

MülkTürAçıklama
SPREADSHEETSEnumGoogle E-Tablolar, tetikleyicinin etkinleşmesine neden olur.
CLOCKEnumZamana dayalı bir etkinlik, tetikleyicinin etkinleştirilmesine neden olur.
FORMSEnumGoogle Formlar, tetikleyicinin etkinleşmesine neden olur.
DOCUMENTSEnumGoogle Dokümanlar tetikleyicinin etkinleşmesine neden olur.
CALENDAREnumGoogle Takvim, tetikleyicinin etkinleşmesine neden olur.