指令碼專案

指令碼專案代表 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. 依序按一下「新增」>「更多」>「Google Apps Script」。

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

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

使用 Google 表單建立容器專案

  1. 在 Google 表單中開啟表單。
  2. 依序按一下「更多」圖示 >「指令碼編輯器」。
  3. 在指令碼編輯器中，按一下「Untitled project」。
  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。如要使用夾扣，請參閱下載指令碼專案。

設定專案的時區

您可以為 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 帳戶。