指令碼專案

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

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

建立及刪除專案

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

建立獨立專案

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

  1. 前往 script.google.com。
  2. 按一下 「新專案」。
  3. 在指令碼編輯器中，按一下「未命名專案」。
  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。如要使用 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 帳戶。