基于GCP服务账户的PHP版Apps Script API调用技术问询

我来帮你搞定用GCP服务账户授权调用Apps Script API的事儿！之前你用服务账户搞定过SpreadSheet API，那这套思路其实可以复用，只不过Apps Script API这边有几个关键步骤得注意。

第一步：准备工作（服务账户配置） #

• 先在GCP控制台的API库中搜索并启用Apps Script API，确保服务账户能访问这个API。
• 给服务账户分配脚本权限：打开你的Apps Script编辑器，通过「共享」功能把服务账户的邮箱添加为脚本的编辑器/开发者，没有这一步会直接触发权限不足的错误。
• 如果你是Google Workspace用户，需要以域内用户身份执行脚本的话，还要在Workspace Admin控制台给服务账户配置域范围授权，指定Apps Script相关的作用域。

第二步：PHP代码实现（基于Google Client Library） #

首先确保你已经安装了Google官方的PHP客户端库：

composer require google/apiclient:^2.0

然后编写核心代码，这里直接用服务账户密钥完成授权，跳过OAuth2的流程：

<?php
require __DIR__ . '/vendor/autoload.php';

// 初始化Google客户端
$client = new Google\Client();
// 加载服务账户密钥文件（替换成你自己的密钥路径）
$client->setAuthConfig('/path/to/your/service-account-key.json');
// 设置Apps Script API所需的作用域
$client->addScope([
    'https://www.googleapis.com/auth/script.execution',
    // 如果需要管理脚本项目，再添加下面这个作用域
    // 'https://www.googleapis.com/auth/script.projects'
]);
// 指定用服务账户授权模式
$client->useApplicationDefaultCredentials();

// 初始化Apps Script API服务实例
$service = new Google\Service\Script($client);

// 构造执行请求
$executionRequest = new Google\Service\Script\ExecutionRequest();
$executionRequest->setFunction('yourTargetFunction'); // 替换成你要执行的脚本函数名
// 如果函数需要参数，在这里传入数组，比如：
// $executionRequest->setParameters(['param1', 'param2']);
// 若不需要调试日志，可设置devMode为false
// $executionRequest->setDevMode(false);

try {
    // 执行脚本，替换成你的Apps Script项目ID（在编辑器「项目设置」中查看）
    $response = $service->scripts->run('YOUR_SCRIPT_PROJECT_ID', $executionRequest);
    
    if ($response->getError()) {
        // 处理脚本执行错误
        $errorDetails = $response->getError()->getDetails()[0];
        echo "执行失败: " . $errorDetails['errorMessage'];
    } else {
        // 获取函数返回结果
        $result = $response->getResponse()->get('result');
        echo "执行成功，结果: " . print_r($result, true);
    }
} catch (Exception $e) {
    echo "API调用异常: " . $e->getMessage();
}
?>

关键注意事项 #

• 权限检查优先：如果遇到PERMISSION_DENIED错误，先确认服务账户邮箱已经被添加到脚本共享列表，作用域配置正确；Workspace用户还要检查域范围授权是否生效。
• 脚本ID别填错：脚本ID在Apps编辑器的「项目设置」里，不是脚本的部署ID，别搞混了。
• 模拟域内用户（仅Workspace）：如果需要以域内某个用户身份执行脚本，要在代码里加上$client->setSubject('user@your-domain.com');，同时确保服务账户已经获得对应的域范围授权。

内容的提问来源于stack exchange，提问作者Yogender Singh