指令碼專案

指令碼專案代表 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. 依序按一下「擴充功能」>>「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，您可以複製每個檔案的程式碼，並貼到慣用的文字編輯器，或是在指令列中使用 夾扣。如要使用夾扣，請參閱「下載指令碼專案」。

設定專案的時區

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

  1. 開啟 Apps Script 專案。
  2. 按一下左側的「Project Settings」圖示 專案設定的圖示。
  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 帳戶。