G-gen の min です。Google Apps Script（以下、GAS）で開発したアドオンをユーザーが実行した際、スクリプトプロパティの読み取り時に PERMISSION_DENIED エラーが発生しました。本記事では、この事象の原因と対処法を解説します。

事象

GAS で作成した機能を Google Workspace アドオンとして配布し、利用者がそのアドオンのメニューを実行した際、以下のようなエラーログが Google Cloud の Cloud Logging に記録され、処理が失敗しました。

{
  "insertId": "-w58fk8fbk0qfb",
  "jsonPayload": {
    "message": "ストレージからの読み取り中にサーバーエラーが発生しました。エラーコード: PERMISSION_DENIED。",
    "serviceContext": {
      "service": "AKfycbw...（省略）..."
    }
  },
  "resource": {
    "type": "app_script_function",
    "labels": {
      "project_id": "000000000000",
      "invocation_type": "menu",
      "function_name": "callUpdateMasterData"
    }
  },
  "severity": "ERROR",
  "labels": {
    "script.googleapis.com/deployment_id": "AKfycbw...（省略）..."
  }
}

メインのエラーメッセージは、以下のとおりです。

ストレージからの読み取り中にサーバーエラーが発生しました。エラーコード: PERMISSION_DENIED。

該当のスクリプトでは、PropertiesService.getScriptProperties().getProperty('KEY_NAME') メソッドを使用し、GAS エディタ上で手動設定したスクリプトプロパティを読み取ろうとしていました。

該当のソースコード

const TARGET_URL = PropertiesService.getScriptProperties().getProperty('TARGET_URL');
  
function callUpdateMasterData() {
  // ...処理...
  // URLにアクセスしてデータを取得する
  const response = UrlFetchApp.fetch(TARGET_URL);
  
  // 結果をログに出力する
  Logger.log('Response Code: ' + response.getResponseCode());
}

スクリプトプロパティ

原因

このエラーは、Google Workspace Marketplace で配布されるアドオンのセキュリティ仕様と、スクリプト実行環境の関係に起因しています。

Google Workspace アドオンでは、スクリプト実行ユーザーの環境で処理が実行されます。しかし、スクリプトプロパティは「スクリプトプロジェクト（ファイル）に紐づく共有ストレージ」であり、そのファイルにアクセス権を持つユーザー間で共有されるものです。

Marketplace 経由で配布されたアドオンを使用する場合、実行ユーザー（アドオン利用者）はスクリプトプロジェクト自体の所有者や編集者ではありません。

ユーザーには、開発者の Google ドライブ内にある GAS プロジェクトファイル自体へのアクセス権限がないため、結果としてそのファイルに付随するプロパティストアへのアクセスも拒否されます。

PropertiesService.getScriptProperties() を用いた読み取り処理が、実行時に PERMISSION_DENIED エラーとなります。

参考 : プロパティサービス

対処法

定数としてコード内に記述する

外部サービスの URL や固定の ID など、公開されても問題ない設定値であれば、スクリプトプロパティではなくコード内の定数（const）として記述することでエラーを回避できます。

// 修正前：スクリプトプロパティから読み取る（アドオン配布時にエラーになる）
// const TARGET_URL = PropertiesService.getScriptProperties().getProperty('TARGET_URL');
  
// 修正後：コード内に定数として定義する
const TARGET_URL = 'https://blog.g-gen.co.jp/';
  
function callUpdateMasterData() {
  // ...処理...
  // URLにアクセスしてデータを取得する
  const response = UrlFetchApp.fetch(TARGET_URL);
  
  // 結果をログに出力する
  Logger.log('Response Code: ' + response.getResponseCode());
}