指令碼專案

指令碼專案代表 Google Apps Script 中的檔案和資源集合,有時也稱為「指令碼」。指令碼專案具有一或多個指令碼檔案,可以是程式碼檔案 (具有 .gs 副檔名) 或 HTML 檔案 (副檔名為 .html)。您也可以在 HTML 檔案中加入 JavaScript 和 CSS

無論何時,指令碼編輯器都只能開啟一項專案,您可以在多個瀏覽器視窗或分頁中開啟多項專案。

建立及刪除專案

本節說明如何建立及刪除獨立或容器繫結的 Apps Script 專案。

建立獨立專案

如何透過 Apps Script 建立獨立專案:

  1. 前往 script.google.com
  2. 按一下 「New Project」
  3. 在指令碼編輯器中,按一下「Untitled project」(未命名的專案)
  4. 為您的專案命名,然後按一下「重新命名」

透過 Google 雲端硬碟建立獨立專案

  1. 開啟 Google 雲端硬碟
  2. 依序點選「New」>「More」>「Google Apps Script」

透過 Google 文件、試算表或簡報建立容器繫結專案

  1. 開啟 Google 文件文件、試算表或簡報簡報。
  2. 依序按一下「擴充功能」>「Google Apps Script」
  3. 在指令碼編輯器中,按一下「Untitled project」(未命名的專案)
  4. 為您的專案命名,然後按一下「重新命名」

透過 Google 表單建立容器繫結專案

  1. 在 Google 表單中開啟表單。
  2. 依序按一下「更多」圖示 >「指令碼編輯器」
  3. 在指令碼編輯器中,按一下「Untitled project」(未命名的專案)
  4. 為您的專案命名,然後按一下「重新命名」

使用 clasp 指令列工具建立獨立專案

clasp 是一項指令列工具,可讓您透過終端機建立、提取/推送及部署 Apps Script 專案。

詳情請參閱使用 clasp 的指令列介面指南。

刪除容器繫結專案

  1. 使用上述適當方法開啟容器繫結專案。
  2. 按一下左上方的「總覽」圖示
  3. 依序按一下右上方的「移除」圖示 >「永久刪除」

刪除獨立專案

  1. 前往 script.google.com
  2. 在要刪除的專案右側,依序按一下「更多」圖示 >「Remove」 >「Remove」

管理專案中的檔案

建立檔案

  1. 開啟 Apps Script 專案。
  2. 按一下左側的「Editor」圖示 >「Add 」。
  3. 選取要建立的檔案類型並設定名稱。

刪除檔案

  1. 開啟 Apps Script 專案。
  2. 按一下左側的「編輯器」圖示
  3. 找到要刪除的檔案,依序點選旁邊的「更多」圖示 >「Delete」

從 Apps Script 專案匯出檔案

如要從 Apps Script 中提取程式碼檔案,您可以複製每個檔案中的程式碼,並貼到慣用的文字編輯器中,或是在指令列中使用 clasp。 如要使用夾扣,請參閱下載指令碼專案

設定專案的時區

您可以為 Apps Script 專案設定時區。指令碼執行的函式會使用這個時區。

  1. 開啟 Apps Script 專案。
  2. 按一下左側的「專案設定」圖示 專案設定圖示
  3. 在「時區」部分選取要使用的時區。

如果您希望特定函式使用不同於指令碼專案的時區,請在函式中明確輸入時區。例如,在以下範例中,每個函式會在 Google 日曆中建立新事件。第一個函式會預設為專案時區。第二個函式會指定太平洋時區,因此無論專案的時區為何,活動都以太平洋時間為準。

function createEvent(){
// Creates an event in the script project's time zone and logs the ID
var event = CalendarApp.getDefaultCalendar().createEvent('New test event',
   new Date('December 20, 2022 17:00:00'),
   new Date('December 20, 2022 18:00:00'));
console.log('Event ID: ' + event.getId());
}
function createEventPacific(){
// Creates an event with a specified time zone and logs the event ID.
var event = CalendarApp.getDefaultCalendar().createEvent('New sample event',
   new Date('December 20, 2022 17:00:00 PDT'),
   new Date('December 20, 2022 18:00:00 PDT'));
console.log('Event ID: ' + event.getId());
}

修正多個 Google 帳戶的問題

如果您同時登入多個 Google 帳戶,則可能會無法存取外掛程式和網頁應用程式。Apps Script、外掛程式或網頁應用程式不支援多重登入,或同時登入多個 Google 帳戶。

  • 如果您在登入多個帳戶的情況下開啟 Apps Script 編輯器,Google 會提示您選擇要繼續使用的帳戶。

  • 如果您在開啟網頁應用程式或外掛程式時遇到多登入問題,請嘗試下列其中一種解決方案:

    • 登出所有 Google 帳戶,只登入具有您要存取的外掛程式或網頁應用程式的帳戶。
    • 在 Google Chrome 中開啟無痕式視窗或同等的私密瀏覽視窗,然後登入具有您要存取的外掛程式或網頁應用程式的 Google 帳戶。