Class ScriptApp

Menghapus pemicu yang diberikan sehingga tidak lagi berjalan.

// Deletes all triggers in the current project. const triggers = ScriptApp.getProjectTriggers(); for (let i = 0; i < triggers.length; i++) {   ScriptApp.deleteTrigger(triggers[i]); }

Parameter

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

• https://www.googleapis.com/auth/script.scriptapp

Mendapatkan objek yang memeriksa apakah pengguna telah memberikan otorisasi untuk semua persyaratan skrip. Objek ini juga menyediakan URL otorisasi bagi pengguna untuk memberikan izin tersebut, jika ada persyaratan skrip yang tidak diizinkan.

Beberapa eksekusi skrip dapat dimulai tanpa izin pengguna untuk semua cakupan yang diperlukan yang digunakan oleh skrip. Informasi dalam objek ini memungkinkan Anda mengontrol akses ke bagian kode yang memerlukan cakupan tertentu dan meminta otorisasi cakupan tersebut untuk eksekusi berikutnya.

const authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL); const status = authInfo.getAuthorizationStatus(); const url = authInfo.getAuthorizationUrl();

Parameter

Pulang pergi

AuthorizationInfo — Objek yang dapat memberikan informasi tentang status otorisasi pengguna.

Mendapatkan objek yang memeriksa apakah pengguna telah memberikan otorisasi untuk cakupan yang diminta. Objek juga menyediakan URL otorisasi bagi pengguna untuk memberikan izin tersebut, jika ada cakupan yang diminta tidak diizinkan.

Beberapa eksekusi skrip dapat dimulai tanpa izin pengguna untuk semua cakupan yang diperlukan yang digunakan oleh skrip. Informasi dalam objek ini memungkinkan Anda mengontrol akses ke bagian kode yang memerlukan cakupan tertentu dan meminta otorisasi cakupan tersebut untuk eksekusi berikutnya. Cakupan yang tidak valid atau tidak diperlukan oleh skrip akan menyebabkan error.

const authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL, [   'https://www.googleapis.com/auth/documents',   'https://www.googleapis.com/auth/presentations', ]); const status = authInfo.getAuthorizationStatus(); const url = authInfo.getAuthorizationUrl();

Parameter

Pulang pergi

AuthorizationInfo — Objek yang memberikan informasi tentang status otorisasi pengguna dan URL otorisasi jika beberapa izin tidak ada.

Mendapatkan token identitas OpenID Connect untuk pengguna efektif, jika cakupan openid telah diberikan. Cakupan ini tidak disertakan secara default, dan Anda harus menambahkannya sebagai cakupan eksplisit dalam file manifes untuk memintanya. Sertakan cakupan https://www.googleapis.com/auth/userinfo.email atau https://www.googleapis.com/auth/userinfo.profile untuk menampilkan informasi pengguna tambahan dalam token.

Token ID yang ditampilkan adalah Token Web JSON (JWT) yang dienkode, dan harus didekode untuk mengekstrak informasi darinya. Contoh berikut menunjukkan cara mendekode token dan mengekstrak ID profil Google pengguna yang efektif.

const idToken = ScriptApp.getIdentityToken(); const body = idToken.split('.')[1]; const decoded = Utilities                     .newBlob(                         Utilities.base64Decode(body),                         )                     .getDataAsString(); const payload = JSON.parse(decoded);  Logger.log(`Profile ID: ${payload.sub}`);

Pulang pergi

String — Token identitas jika tersedia; jika tidak, null.

Menampilkan nilai enum yang menunjukkan cara skrip diinstal sebagai add-on untuk pengguna saat ini (misalnya, apakah pengguna menginstalnya secara pribadi melalui Chrome Web Store, atau apakah administrator domain menginstalnya untuk semua pengguna).

Pulang pergi

InstallationSource — Sumber penginstalan.

Mendapatkan token akses OAuth 2.0 untuk pengguna yang efektif. Jika cakupan OAuth skrip cukup untuk mengotorisasi Google API lain yang biasanya memerlukan alur OAuth-nya sendiri (seperti Google Picker), skrip dapat melewati prompt otorisasi kedua dengan meneruskan token ini. Masa berlaku token akan berakhir setelah beberapa waktu (minimal beberapa menit); skrip harus menangani kegagalan otorisasi dan memanggil metode ini untuk mendapatkan token baru jika diperlukan.

Token yang ditampilkan oleh metode ini hanya mencakup cakupan yang saat ini diperlukan skrip. Cakupan yang sebelumnya diberi otorisasi, tetapi tidak lagi digunakan oleh skrip, tidak disertakan dalam token yang ditampilkan. Jika cakupan OAuth tambahan diperlukan di luar yang diperlukan oleh skrip itu sendiri, cakupan tersebut dapat ditentukan dalam file manifes skrip.

Pulang pergi

String — Representasi string dari token OAuth 2.0.

Mendapatkan semua pemicu yang dapat diinstal yang terkait dengan project saat ini dan pengguna saat ini.

Logger.log(     `Current project has ${ScriptApp.getProjectTriggers().length} triggers.`, );

Pulang pergi

Trigger[] — Array pemicu pengguna saat ini yang terkait dengan project ini.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

• https://www.googleapis.com/auth/script.scriptapp

Mendapatkan ID unik project skrip. Ini adalah metode yang lebih disukai untuk mendapatkan ID unik untuk project skrip, bukan getProjectKey(). ID ini dapat digunakan di semua tempat yang sebelumnya menyediakan kunci project.

Pulang pergi

String — ID project skrip.

Mendapatkan objek yang digunakan untuk mengontrol publikasi skrip sebagai aplikasi web.

// Get the URL of the published web app. const url = ScriptApp.getService().getUrl();

Pulang pergi

Service — Objek yang digunakan untuk mengamati dan mengontrol publikasi skrip sebagai aplikasi web.

Mendapatkan semua pemicu yang dapat diinstal yang dimiliki oleh pengguna ini dalam dokumen tertentu, hanya untuk skrip atau add-on ini. Metode ini tidak dapat digunakan untuk melihat pemicu yang dilampirkan ke skrip lain.

const doc = DocumentApp.getActiveDocument(); const triggers = ScriptApp.getUserTriggers(doc); // Log the handler function for the first trigger in the array. Logger.log(triggers[0].getHandlerFunction());

Parameter

Pulang pergi

Trigger[] — Array pemicu yang dimiliki oleh pengguna ini dalam dokumen tertentu.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

• https://www.googleapis.com/auth/script.scriptapp

Mendapatkan semua pemicu yang dapat diinstal yang dimiliki oleh pengguna ini dalam formulir tertentu, hanya untuk skrip atau add-on ini. Metode ini tidak dapat digunakan untuk melihat pemicu yang dilampirkan ke skrip lain.

const form = FormApp.getActiveForm(); const triggers = ScriptApp.getUserTriggers(form); // Log the trigger source for the first trigger in the array. Logger.log(triggers[0].getTriggerSource());

Parameter

Pulang pergi

Trigger[] — Array pemicu yang dimiliki pengguna ini dalam formulir tertentu.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

• https://www.googleapis.com/auth/script.scriptapp

Mendapatkan semua pemicu yang dapat diinstal yang dimiliki oleh pengguna ini di spreadsheet tertentu, hanya untuk skrip atau add-on ini. Metode ini tidak dapat digunakan untuk melihat pemicu yang dilampirkan ke skrip lain.

const ss = SpreadsheetApp.getActiveSpreadsheet(); const triggers = ScriptApp.getUserTriggers(ss); // Log the event type for the first trigger in the array. Logger.log(triggers[0].getEventType());

Parameter

Pulang pergi

Trigger[] — Array pemicu yang dimiliki pengguna ini dalam spreadsheet tertentu.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

• https://www.googleapis.com/auth/script.scriptapp

Membatalkan otorisasi yang dimiliki pengguna efektif untuk menjalankan skrip saat ini. Digunakan untuk membatalkan validitas izin apa pun untuk skrip saat ini. Hal ini sangat berguna untuk fungsi yang ditandai sebagai otorisasi sekali pakai. Karena fungsi otorisasi sekali pakai hanya dapat dipanggil pada jalankan pertama setelah skrip mendapatkan otorisasi, jika Anda ingin melakukan tindakan setelahnya, Anda harus mencabut otorisasi yang dimiliki skrip, sehingga pengguna dapat melihat dialog otorisasi lagi.

ScriptApp.invalidateAuth();

Menampilkan

Error — saat pembatalan validasi gagal

Membuat builder untuk token status yang dapat digunakan dalam API callback (seperti alur OAuth).

// Generate a callback URL, given the name of a callback function. The script // does not need to be published as a web app; the /usercallback URL suffix // replaces /edit in any script's URL. function getCallbackURL(callbackFunction) {   // IMPORTANT: Replace string below with the URL from your script, minus the   // /edit at the end.   const scriptUrl =       'https://script.google.com/macros/d/1234567890abcdefghijklmonpqrstuvwxyz';   const urlSuffix = '/usercallback?state=';   const stateToken = ScriptApp.newStateToken()                          .withMethod(callbackFunction)                          .withTimeout(120)                          .createToken();   return scriptUrl + urlSuffix + stateToken; }

Di sebagian besar alur OAuth2, token state diteruskan ke endpoint otorisasi secara langsung (bukan sebagai bagian dari URL callback), dan endpoint otorisasi kemudian meneruskannya sebagai bagian dari URL callback.

Contoh:

• Skrip mengalihkan pengguna ke URL otorisasi OAuth2: https://accounts.google.com/o/oauth2/auth?state=token_generated_with_this_method&callback_uri=https://script.google.com/macros/d/1234567890abcdefghijklmonpqrstuvwxyz/usercallback&other_oauth2_parameters
• Pengguna mengklik beri otorisasi, dan halaman otorisasi OAuth2 mengalihkan pengguna kembali ke https://script.google.com/macros/d/1234567890abcdefghijklmonpqrstuvwxyz/usercallback?state=token_generated_with_this_method&other_params_that_include_tokens_or_grants
• Pengalihan di atas (kembali ke http://script.google.com/...), menyebabkan permintaan browser ke /usercallback, yang memanggil metode yang ditentukan oleh StateTokenBuilder.withMethod(method).

Pulang pergi

StateTokenBuilder — Objek yang digunakan untuk melanjutkan proses pembuatan token status.

Memulai proses pembuatan pemicu yang dapat diinstal yang, saat diaktifkan, memanggil fungsi tertentu.

// Creates an edit trigger for a spreadsheet identified by ID. ScriptApp.newTrigger('myFunction')     .forSpreadsheet('1234567890abcdefghijklmnopqrstuvwxyz_a1b2c3')     .onEdit()     .create();

Sebelum membuat pemicu, verifikasi bahwa fungsi terkait memiliki semua izin OAuth yang diperlukan

Parameter

Pulang pergi

TriggerBuilder — Objek yang digunakan untuk melanjutkan proses pembuatan pemicu.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

• https://www.googleapis.com/auth/script.scriptapp

Memvalidasi apakah pengguna telah memberikan izin untuk semua cakupan yang diminta oleh skrip. Gunakan metode ini jika alur eksekusi bergantung pada semua cakupan yang diminta skrip. Jika ada izin yang tidak ada, metode ini akan mengakhiri eksekusi saat ini dan merender dialog otorisasi untuk meminta izin yang tidak ada.

Metode ini hanya berfungsi saat pengguna menjalankan skrip dari platform yang mendukung izin terperinci, misalnya, dari dalam IDE Apps Script. Saat skrip dijalankan dengan izin yang tidak ada dari platform yang tidak didukung, seperti add-on Google Workspace, skrip akan merender dialog otorisasi di awal eksekusi untuk meminta semua cakupan.

ScriptApp.requireAllScopes(ScriptApp.AuthMode.FULL);

Parameter

Memvalidasi apakah pengguna telah memberikan izin untuk cakupan yang diminta. Gunakan metode ini jika alur eksekusi bergantung pada satu atau beberapa layanan. Jika salah satu izin yang ditentukan tidak ada, metode ini akan mengakhiri eksekusi saat ini dan merender dialog otorisasi untuk meminta izin yang tidak ada. Cakupan yang tidak valid atau tidak diperlukan oleh skrip akan menyebabkan error.

Metode ini hanya berfungsi saat pengguna menjalankan skrip dari platform yang mendukung izin terperinci, misalnya, dari dalam IDE Apps Script. Saat skrip dijalankan dengan izin yang tidak ada dari platform yang tidak didukung, seperti add-on Google Workspace, skrip akan merender dialog otorisasi di awal eksekusi untuk meminta semua cakupan.

ScriptApp.requireScopes(ScriptApp.AuthMode.FULL, [   'https://www.googleapis.com/auth/documents',   'https://www.googleapis.com/auth/presentations', ]);

Parameter