指令碼專案

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

指令碼編輯器在任何時間都只會開啟一個專案。您可以在多個瀏覽器視窗或分頁中開啟多個專案。

建立及刪除專案

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

建立獨立專案

如要透過 Apps Script 建立獨立專案，請按照下列步驟操作：

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

從 Google 雲端硬碟建立獨立專案

  1. 開啟 Google 雲端硬碟。
  2. 依序點選「新增」>「更多」 >「Google Apps Script」。

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

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

從 Google 表單建立繫結容器的專案

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

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

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

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

刪除繫結容器的專案

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

刪除獨立專案

  1. 前往 script.google.com。
  2. 在要刪除的專案右側，依序點選「更多」圖示 >「移除」 >「移除」。

管理專案中的檔案

建立檔案

  1. 開啟 Apps Script 專案。
  2. 依序按一下左側的「編輯器」「新增」。
  3. 選取要建立的檔案類型並命名。

刪除檔案

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

從 Apps Script 專案匯出檔案

如要將程式碼檔案從 Apps Script 中取出，您可以將每個檔案中的程式碼複製並貼到偏好的文字編輯器，或在指令列中使用 clasp。如要使用 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 帳戶。