Google Apps Komut Dosyası,
diğer Google sistemleri ile harici sistemlerde kullanılabilir. Bu hizmetler
JavaScript'in standardına benzer genel nesneler olarak sağlanır
Math
nesnesini tanımlayın. Örneğin Math, random() ve
PI gibi sabit değerler, Apps Komut Dosyası'nın
E-tablo hizmeti,
openById(id),
sınıflar (alt nesneler)
Range ve
DataValidationCriteria.
Google Cloud'u denetleyen hizmetler için referans belgeler Google Workspace ürünler "Google Workspace Hizmetler" öğesinin altındaki "Referans" başlıkta bulabilirsiniz. Kamu hizmetleri kullanıcı arayüzleri oluşturmak, XML'yi ayrıştırmak veya günlük verilerini yazma gibi) verilerin toplanması "Komut Dosyası Hizmetleri" içinde bölümüne bakın.
Modern JavaScript özellikleri
Apps Komut Dosyası, iki JavaScript çalışma zamanını destekler: modern V8 çalışma zamanı ve Mozilla'nın Rhino JavaScript yorumcusu.
V8 çalışma zamanı, modern ECMAScript söz dizimi ve özellikleri. Rhino'nun çalışma zamanı, daha eski JavaScript 1.6 standart ve 1.7 ve 1,8 İstediğiniz çalışma zamanını istediğiniz gibi seçebilirsiniz kullanmanızı öneririz, ancak V8 çalışma zamanı kesinlikle önerilir.
Her çalışma zamanı, kullanabileceğiniz JavaScript sınıflarını ve nesneleri
ve komut dosyası gibi
ve gelişmiş Google hizmetleri üzerinden kullanılabilir. Sizin
komut dosyalarında
Array,
Date,
RegExp,
vb.
yanı sıra
Math ve
Object
anlamına gelir.
Otomatik tamamlamayı kullanma
Komut dosyası düzenleyici, "içerik yardımı" sağlar yaygın olarak bilinen "otomatik tamamlama", global nesnelerin yanı sıra yöntemler ve enum'ları da ortaya çıkaran komut dosyasının mevcut bağlamında geçerli olur. Otomatik tamamlama önerileri gösteriliyor global nesne, enum veya yöntemden sonra nokta işareti koyduğunuzda otomatik olarak komutu Apps Komut Dosyası sınıfını döndürür. Örneğin:
- Genel bir nesnenin tam adını yazar veya otomatik tamamlama özelliğinden bir ad seçerseniz
.(nokta) yazarsanız bu sınıfa ait tüm yöntemleri ve numaralandırmaları görürsünüz. - Birkaç karakter yazarsanız geçerli tüm filtreleri görürsünüz önerilere yer verebilirsiniz.
Küresel nesneleri anlama
Her hizmet en az bir genel (üst düzey) nesne sağlar; örneğin,
Gmail hizmetine yalnızca
GmailApp nesnesini tıklayın. Bazı hizmetler
birden çok global nesne sağlama; örneğin
Temel hizmet dört genel nesne içerir:
Browser,
Logger,
MimeType ve
Session.
Arama yöntemleri
Neredeyse tüm yerleşik veya yerleşik ya da küresel gelişmiş hizmetlere, veya Apps Komut Dosyası sınıfını döndürür. Komut dosyaları şu biçimde yöntem çağrıları yapar:
GlobalObjectName.methodName(argument1, argument2, ..., argumentN);
Örneğin, bir komut dosyası
sendEmail(recipient, subject, body)
aşağıdaki gibi bir yöntem kullanabilirsiniz:
GmailApp.sendEmail('claire@example.com', 'Subject line', 'This is the body.');
Bir yöntem başka bir Apps Komut Dosyası sınıfı döndürürse tek bir uygulamada zincir yöntem çağrısı oluşturabilirsiniz
satırında görünür. (Dönüş türleri hem otomatik tamamlamada hem de bir yöntemin referansında gösterilir
documentation.) Örneğin,
DocumentApp.create()
Document değerini döndürür; dolayısıyla,
aşağıdaki iki kod bölümü eşdeğerdir:
var doc = DocumentApp.create('New document');
var body = doc.getBody();
body.appendParagraph('New paragraph.');
// Same result as above.
DocumentApp.create('New document').getBody().appendParagraph('New paragraph.');
Alt sınıflara erişme
Her hizmette, erişilemeyen bir veya daha fazla alt sınıf bulunur
en üst düzeyde bulunuyor. new anahtar kelimesini şu amaçlarla kullanamazsınız:
bu sınıfları,
Date;
Bir alt sınıfa, yalnızca o sınıfı döndüren bir yöntemi çağırarak erişebilirsiniz. Eğer
belirli bir sınıfa nasıl erişeceğinizden emin değilseniz hizmetin kök sayfasını ziyaret edin
referans belgeleri ve istediğiniz sınıfı döndüren bir yöntem arayın.
Arayüzlerle ilgili işlemler
Bazı hizmetler, "arayüzler" olarak etiketlenmiş özel sınıflar içerir
referans belgelerden bahsedeceğim. Bunlar, dönüş türü olarak kullanılan genel sınıflardır
kesin türü önceden belirleyemeyen yöntemler için; örneğin,
Belge hizmeti yöntemi
Body.getChild(childIndex)
genel bir Element nesnesi döndürür.
Element, başka bir sınıfı temsil eden bir arayüzdür.
Paragraph veya
Table. Arayüz nesneleri
faydalı olabilir. bunun yerine genellikle
Element.asParagraph()
kullanarak belirli bir sınıfa gönderebilirsiniz.
Sıralamalarla çalışma
Çoğu hizmet, adlandırılmış değerlerin birkaç numaralandırmasını (sıralanmış tür) içerir. Örneğin,
Örneğin, Drive hizmeti
Access ve
Permission kullanarak hangi kullanıcıların
dosya veya klasöre erişimi olur. Neredeyse her durumda bu enum'lara erişirsiniz.
. Örneğin,
Folder.setSharing(accessType, permissionType)
şöyle görünür:
// Creates a folder that anyone on the Internet can read from and write to. (Domain administrators can
// prohibit this setting for Google Workspace users.)
var folder = DriveApp.createFolder('Shared Folder');
folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);