Script Service

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

Sınıflar

Ad	Kısa açıklama
`AuthMode`	Apps Komut Dosyası'nın tetiklenen bir işlev aracılığıyla hangi yetkili hizmet kategorilerini yürütebileceğini tanımlayan bir sıralama.
`AuthorizationInfo`	Kullanıcının, komut dosyasının gerekli kapsamları için yetkilendirme verip vermediğini kontrol eden bir nesne.
`AuthorizationStatus`	Bir komut dosyasının yetkilendirme durumunu belirten bir sıralama.
`CalendarTriggerBuilder`	Takvim tetikleyicileri için oluşturucu.
`ClockTriggerBuilder`	Saat tetikleyicileri için bir oluşturucu.
`DocumentTriggerBuilder`	Doküman tetikleyicileri için bir oluşturucu.
`EventType`	Tetiklenen etkinliğin türünü belirten bir sıralama.
`FormTriggerBuilder`	Form tetikleyicileri için bir oluşturucu.
`InstallationSource`	Komut dosyasının mevcut kullanıcı için nasıl eklenti olarak yüklendiğini gösteren bir sıralama.
`ScriptApp`	Komut dosyası yayınlama ve tetikleyicilere erişme ve bunları değiştirme.
`Service`	Komut dosyası yayınlama özelliğine erişme ve bu özelliği kullanma.
`SpreadsheetTriggerBuilder`	E-tablo tetikleyicileri için oluşturucu.
`StateTokenBuilder`	Komut dosyalarının, geri çağırma API'lerinde (ör. OAuth akışları) kullanılabilen durum jetonları oluşturmasına olanak tanır.
`Trigger`	Komut dosyası tetikleyicisi.
`TriggerBuilder`	Komut dosyası tetikleyicileri için genel bir oluşturucu.
`TriggerSource`	Tetikleyicinin etkinleştirilmesine neden olan etkinliğin kaynağını belirten bir sıralama.

`AuthMode`

Özellikler

Mülk	Tür	Açıklama
`NONE`	`Enum`	Yetkilendirme gerektiren hizmetlere erişime izin verilmeyen bir mod.
`CUSTOM_FUNCTION`	`Enum`	Özel e-tablo işlevlerinde kullanılmak üzere hizmetlerin sınırlı bir alt kümesine erişime izin veren mod.
`LIMITED`	`Enum`	Hizmetlerin sınırlı bir alt kümesine erişime izin veren mod.
`FULL`	`Enum`	Yetkilendirme gerektiren tüm hizmetlere erişime izin veren bir mod.

`AuthorizationInfo`

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
`getAuthorizationStatus()`	`AuthorizationStatus`	Kullanıcının bir veya daha fazla hizmeti (ör. `ScriptApp.AuthorizationStatus.REQUIRED`) kullanmak için bu komut dosyasını yetkilendirmesi gerekip gerekmediğini belirten bir değer alır.
`getAuthorizationUrl()`	`String\|null`	Komut dosyasına erişim izni vermek için kullanılabilecek yetkilendirme URL'sini alır.
`getAuthorizedScopes()`	`String[]\|null`	Komut dosyası için yetkilendirilmiş kapsamların listesini alır.

`AuthorizationStatus`

Özellikler

Mülk	Tür	Açıklama
`REQUIRED`	`Enum`	Kullanıcının, bir veya daha fazla hizmeti kullanmak için bu komut dosyasını yetkilendirmesi gerekir.
`NOT_REQUIRED`	`Enum`	Kullanıcı, bu komut dosyasına şu anda ihtiyaç duyduğu tüm yetkileri verdi.

`CalendarTriggerBuilder`

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
`create()`	`Trigger`	Tetikleyiciyi oluşturur ve döndürür.
`onEventUpdated()`	`CalendarTriggerBuilder`	Bir takvim girişi oluşturulduğunda, güncellendiğinde veya silindiğinde etkinleşen bir tetikleyiciyi belirtir.

`ClockTriggerBuilder`

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
`after(durationMilliseconds)`	`ClockTriggerBuilder`	Tetikleyicinin çalışacağı, geçerli zamandan sonraki minimum süreyi (milisaniye cinsinden) belirtir.
`at(date)`	`ClockTriggerBuilder`	Tetikleyicinin ne zaman çalışacağını belirtir.
`atDate(year, month, day)`	`ClockTriggerBuilder`	Tetikleyicinin, belirtilen tarihte varsayılan olarak gece yarısına yakın bir zamanda (+/- 15 dakika) tetikleneceğini belirtir.
`atHour(hour)`	`ClockTriggerBuilder`	Tetikleyicinin çalışacağı saati belirtir.
`create()`	`Trigger`	Tetikleyiciyi oluşturur.
`everyDays(n)`	`ClockTriggerBuilder`	Tetikleyicinin her `n` günde bir çalıştırılacağını belirtir.
`everyHours(n)`	`ClockTriggerBuilder`	Tetikleyicinin her `n` saatte bir çalıştırılacağını belirtir.
`everyMinutes(n)`	`ClockTriggerBuilder`	Tetikleyicinin her `n` dakikada bir çalıştırılacağını belirtir.
`everyWeeks(n)`	`ClockTriggerBuilder`	Tetikleyicinin her `n` haftada bir çalıştırılacağını belirtir.
`inTimezone(timezone)`	`ClockTriggerBuilder`	Tetikleyicinin çalıştığı belirtilen tarihler/saat için saat dilimini belirtir.
`nearMinute(minute)`	`ClockTriggerBuilder`	Tetikleyicinin çalışacağı dakikayı belirtir (artı veya eksi 15 dakika).
`onMonthDay(day)`	`ClockTriggerBuilder`	Tetikleyicinin ay içinde çalışacağı tarihi belirtir.
`onWeekDay(day)`	`ClockTriggerBuilder`	Tetikleyicinin çalışacağı haftanın gününü belirtir.

`DocumentTriggerBuilder`

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
`create()`	`Trigger`	Yeni tetikleyiciyi oluşturur ve döndürür.
`onOpen()`	`DocumentTriggerBuilder`	Doküman açıldığında etkinleşen bir tetikleyici belirtir.

`EventType`

Özellikler

Mülk	Tür	Açıklama
`CLOCK`	`Enum`	Tetikleyici, zamana dayalı etkinlik belirli bir zamana ulaştığında tetiklenir.
`ON_OPEN`	`Enum`	Tetikleyici, kullanıcı Google Dokümanlar, E-Tablolar veya Formlar dosyasını açtığında etkinleşir.
`ON_EDIT`	`Enum`	Tetikleyici, kullanıcı Google E-Tablolar dosyasını düzenlediğinde (ör. bir hücreye yeni bir değer girerek) etkinleşir. Bu işlem, değişiklik yerine düzenleme olarak kabul edilir.
`ON_FORM_SUBMIT`	`Enum`	Kullanıcı bir Google Formu'nu yanıtladığında tetikleyici etkinleşir.
`ON_CHANGE`	`Enum`	Tetikleyici, kullanıcı Google E-Tablolar dosyasını değiştirdiğinde (örneğin, satır ekleyerek) etkinleşir. Bu işlem, düzenleme yerine değişiklik olarak kabul edilir.
`ON_EVENT_UPDATED`	`Enum`	Tetikleyici, belirtilen Google Takvim'de bir etkinlik oluşturulduğunda, güncellendiğinde veya silindiğinde bir kez tetiklenir.

`FormTriggerBuilder`

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
`create()`	`Trigger`	Yeni tetikleyiciyi oluşturur ve döndürür.
`onFormSubmit()`	`FormTriggerBuilder`	Forma yanıt gönderildiğinde etkinleşen bir tetikleyici belirtir.
`onOpen()`	`FormTriggerBuilder`	Formun düzenleme görünümü açıldığında tetiklenen bir tetikleyici belirtir.

`InstallationSource`

Özellikler

Mülk	Tür	Açıklama
`APPS_MARKETPLACE_DOMAIN_ADD_ON`	`Enum`	Eklenti, kullanıcının alanı için yönetici tarafından yüklendi.
`NONE`	`Enum`	Komut dosyası eklenti olarak çalışmıyor.
`WEB_STORE_ADD_ON`	`Enum`	Eklenti, kullanıcı tarafından Chrome Web Mağazası'ndan yüklenmiştir.

`ScriptApp`

Özellikler

Mülk	Tür	Açıklama
`AuthMode`	`AuthMode`	Apps Komut Dosyası'nın tetiklenen bir işlev aracılığıyla hangi yetkili hizmet kategorilerini yürütebileceğini tanımlayan bir sıralama.
`AuthorizationStatus`	`AuthorizationStatus`	Bir komut dosyasının yetkilendirme durumunu belirten bir sıralama.
`EventType`	`EventType`	Tetiklenen etkinliğin türünü belirten bir sıralama.
`InstallationSource`	`InstallationSource`	Komut dosyasının kullanıcıya eklenti olarak nasıl yüklendiğini belirten bir numaralandırma.
`TriggerSource`	`TriggerSource`	Tetikleyicinin etkinleştirilmesine neden olan etkinliğin kaynağını belirten bir sıralama.
`WeekDay`	`Weekday`	Haftanın günlerini temsil eden bir sıralama.

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
`deleteTrigger(trigger)`	`void`	Belirtilen tetikleyiciyi kaldırarak artık çalışmamasını sağlar.
`getAuthorizationInfo(authMode)`	`AuthorizationInfo`	Kullanıcının tüm komut dosyası gereksinimleri için yetkilendirme verip vermediğini kontrol eden bir nesne alır.
`getAuthorizationInfo(authMode, oAuthScopes)`	`AuthorizationInfo`	Kullanıcının istenen kapsamlar için yetki verip vermediğini kontrol eden bir nesne alır.
`getIdentityToken()`	`String\|null`	`openid` kapsamı verilmişse geçerli kullanıcı için OpenID Connect kimlik jetonu alır.
`getInstallationSource()`	`InstallationSource`	Komut 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ı tarafından Chrome Web Mağazası üzerinden kişisel olarak mı yüklendiği veya bir alan yöneticisi tarafından tüm kullanıcılar için mi yüklendiği).
`getOAuthToken()`	`String`	Etkili kullanıcı için OAuth 2.0 erişim jetonunu alır.
`getProjectTriggers()`	`Trigger[]`	Geçerli proje ve geçerli kullanıcıyla ilişkili tüm yüklenebilir tetikleyicileri alır.
`getScriptId()`	`String`	Komut dosyası projesinin benzersiz kimliğini alır.
`getService()`	`Service`	Komut dosyasının web uygulaması olarak yayınlanmasını kontrol etmek için kullanılan bir nesneyi alır.
`getUserTriggers(document)`	`Trigger[]`	Belirli bir dokümanda, yalnızca bu komut dosyası veya eklenti için bu kullanıcının sahip olduğu tüm yüklenebilir tetikleyicileri alır.
`getUserTriggers(form)`	`Trigger[]`	Belirtilen formda, bu kullanıcıya ait olan ve yalnızca bu komut dosyası veya eklenti için yüklenebilen tüm tetikleyicileri alır.
`getUserTriggers(spreadsheet)`	`Trigger[]`	Belirtilen e-tabloda, bu kullanıcıya ait ve yüklenebilir tüm tetikleyicileri yalnızca bu komut dosyası veya eklenti için alır.
`invalidateAuth()`	`void`	Geçerli kullanıcının mevcut komut dosyasını yürütmek için sahip olduğu yetkilendirmeyi geçersiz kılar.
`newStateToken()`	`StateTokenBuilder`	Geri çağırma API'sinde (ör. OAuth akışı) kullanılabilecek bir durum jetonu için oluşturucu oluşturur.
`newTrigger(functionName)`	`TriggerBuilder`	Tetiklendiğinde belirli bir işlevi çağıran, yüklenebilir bir tetikleyici oluşturma sürecini başlatır.
`requireAllScopes(authMode)`	`void`	Kullanıcının, komut dosyası tarafından istenen tüm kapsamlar için izin verip vermediğini doğrular.
`requireScopes(authMode, oAuthScopes)`	`void`	Kullanıcının istenen kapsamlar için izin verip vermediğini doğrular.

`Service`

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
`getUrl()`	`String`	Dağıtılmışsa web uygulamasının URL'sini, aksi takdirde `null` değerini döndürür.
`isEnabled()`	`Boolean`	Komut dosyasına web uygulaması olarak erişilebiliyorsa `true` değerini döndürür.

`SpreadsheetTriggerBuilder`

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
`create()`	`Trigger`	Tetikleyiciyi oluşturur ve döndürür.
`onChange()`	`SpreadsheetTriggerBuilder`	E-tablonun içeriği veya yapısı değiştirildiğinde tetiklenen bir tetikleyici belirtir.
`onEdit()`	`SpreadsheetTriggerBuilder`	E-tablo düzenlendiğinde etkinleşen bir tetikleyici belirtir.
`onFormSubmit()`	`SpreadsheetTriggerBuilder`	E-tabloya form gönderildiğinde tetiklenen bir tetikleyici belirtir.
`onOpen()`	`SpreadsheetTriggerBuilder`	E-tablo açıldığında tetiklenen bir tetikleyici belirtir.

`StateTokenBuilder`

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
`createToken()`	`String`	Durum jetonunun şifrelenmiş dize gösterimini oluşturur.
`withArgument(name, value)`	`StateTokenBuilder`	Jetonun bağımsız değişkenini ekler.
`withMethod(method)`	`StateTokenBuilder`	Geri çağırma işlevi ayarlar.
`withTimeout(seconds)`	`StateTokenBuilder`	Jetonun geçerli olacağı süreyi (saniye cinsinden) ayarlar.

`Trigger`

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
`getEventType()`	`EventType`	Tetikleyicinin etkinleştiği etkinlik türünü döndürür.
`getHandlerFunction()`	`String`	Tetikleyici tetiklendiğinde çağrılan işlevi döndürür.
`getTriggerSource()`	`TriggerSource`	Tetikleyicinin etkinleştirilmesine neden olan etkinliklerin kaynağını döndürür.
`getTriggerSourceId()`	`String`	Kaynağa özel kimliği döndürür.
`getUniqueId()`	`String`	Tetikleyicileri birbirinden ayırt etmek için kullanılabilecek benzersiz bir tanımlayıcı döndürür.

`TriggerBuilder`

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
`forDocument(document)`	`DocumentTriggerBuilder`	Belirtilen dokümana bağlı bir `DocumentTriggerBuilder` oluşturur ve döndürür.
`forDocument(key)`	`DocumentTriggerBuilder`	Belirtilen kimliğe sahip dokümana bağlı bir `DocumentTriggerBuilder` oluşturur ve döndürür.
`forForm(form)`	`FormTriggerBuilder`	Belirtilen forma bağlı bir `FormTriggerBuilder` oluşturur ve döndürür.
`forForm(key)`	`FormTriggerBuilder`	Belirtilen kimliğe sahip formla ilişkili bir `FormTriggerBuilder` oluşturur ve döndürür.
`forSpreadsheet(sheet)`	`SpreadsheetTriggerBuilder`	Belirtilen e-tabloya bağlı bir `SpreadsheetTriggerBuilder` oluşturur ve döndürür.
`forSpreadsheet(key)`	`SpreadsheetTriggerBuilder`	Belirtilen kimliğe sahip e-tabloya bağlı bir `SpreadsheetTriggerBuilder` oluşturur ve döndürür.
`forUserCalendar(emailId)`	`CalendarTriggerBuilder`	Takvim tetikleyicileri oluşturmak için bir oluşturucu döndürür.
`timeBased()`	`ClockTriggerBuilder`	Zamana dayalı tetikleyiciler oluşturmak için `ClockTriggerBuilder` oluşturur ve döndürür.

`TriggerSource`

Özellikler

Mülk	Tür	Açıklama
`SPREADSHEETS`	`Enum`	Google E-Tablolar, tetikleyicinin etkinleşmesine neden olur.
`CLOCK`	`Enum`	Zamana dayalı bir etkinlik, tetikleyicinin etkinleştirilmesine neden olur.
`FORMS`	`Enum`	Google Formlar, tetikleyicinin etkinleşmesine neden olur.
`DOCUMENTS`	`Enum`	Google Dokümanlar, tetikleyicinin etkinleşmesine neden olur.
`CALENDAR`	`Enum`	Google Takvim, tetikleyicinin çalışmasına neden olur.

Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.

Son güncelleme tarihi: 2026-04-13 UTC.

Blog
Google Workspace Developers blogunu okuyun
Stack Overflow
google-apps-script etiketi altında soru sorma
Kod Örnekleri
Kod örneklerimizi keşfedin veya kendi örneklerinizi oluşturmak için bunları kopyalayın
Videolar
Apps Komut Dosyası eğitimlerini izleyin