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 numaralandırma.
`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 gösteren 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, bu komut dosyasının bir veya daha fazla hizmeti kullanmasına izin vermesi 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 geçerli saatten sonra çalışacağı minimum süreyi (milisaniye cinsinden) belirtir.
`at(date)`	`ClockTriggerBuilder`	Tetikleyicinin ne zaman çalışacağını belirtir.
`atDate(year, month, day)`	`ClockTriggerBuilder`	Tetikleyicinin, varsayılan olarak gece yarısına yakın bir zamanda (+/- 15 dakika) belirtilen tarihte 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`	Belge açıldığında tetiklenen 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`	Tetikleyici, kullanıcı bir Google Formu'nu yanıtladığında 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 çalışır.

`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 tetiklenen 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 numaralandırma.
`AuthorizationStatus`	`AuthorizationStatus`	Bir komut dosyasının yetkilendirme durumunu gösteren 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 gösteren bir sıralama.
`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ının komut dosyasını Chrome Web Mağazası üzerinden kişisel olarak mı yüklediği veya bir alan yöneticisinin tüm kullanıcılar için mi yüklediğ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[]`	Belirtilen dokümanda, bu komut dosyası veya eklenti için yalnızca bu kullanıcının sahip olduğu yüklenebilir tüm 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 olan ve yalnızca bu komut dosyası veya eklenti için yüklenebilen tüm tetikleyicileri 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ının istediği 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ı 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 tetiklenen 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`	Jetonuna bir bağımsız değişken ekler.
`withMethod(method)`	`StateTokenBuilder`	Geri çağırma işlevi ayarlar.
`withTimeout(seconds)`	`StateTokenBuilder`	Jetonun geçerli olduğu 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 etkinleşmesine 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-03-06 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