本文将指导你如何使用 Google Sheets API 和 PHP 创建一个新的 Google Sheet 电子表格，并使其可以通过链接公开访问。我们将涵盖创建电子表格、获取其 URL 以及设置适当的共享权限，以便任何人都可以查看或编辑该电子表格。
创建电子表格
首先，你需要使用 Google Sheets API 创建一个新的电子表格。以下代码片段展示了如何使用 Google_Service_Sheets 类创建电子表格，并设置其标题：
[
'title' => $title,
]
]);
$spreadsheet = $service->spreadsheets->create($spreadsheet, ['fields' => 'spreadsheetId']);
// 电子表格的 ID 可以通过 $spreadsheet->spreadsheetId 访问
echo "电子表格ID: " . $spreadsheet->spreadsheetId . "\n";
?>代码解释:
- $service = new Google_Service_Sheets($client);: 创建 Google Sheets API 的服务对象。 $client 应该是已经正确配置并授权的 Google API 客户端实例。
- $spreadsheet = new Google_Service_Sheets_Spreadsheet([...]);: 创建一个新的 Google_Service_Sheets_Spreadsheet 对象，并设置其属性，例如标题。
- $service->spreadsheets->create($spreadsheet, ['fields' => 'spreadsheetId']);: 使用 spreadsheets->create 方法创建电子表格。 ['fields' => 'spreadsheetId'] 参数告诉 API 只返回电子表格的 ID，这可以提高效率。
- echo "电子表格ID: " . $spreadsheet->spreadsheetId . "\n";: 输出新创建的电子表格的ID。
获取电子表格的 URL
创建电子表格后，你需要获取其 URL，以便共享。可以使用以下代码片段生成电子表格的 URL：
立即学习“PHP免费学习笔记（深入）”；
spreadsheetId . "/edit";
printf("电子表格 URL: %s\n", $url);
?>代码解释:
- $url = "https://docs.google.com/spreadsheets/d/" . $spreadsheet->spreadsheetId . "/edit";: 使用电子表格的 ID 构建电子表格的 URL。 该 URL 允许用户编辑电子表格。
设置共享权限
默认情况下，新创建的电子表格是私有的。你需要设置共享权限，使其可以通过链接访问。以下代码片段展示了如何将电子表格设置为可链接访问：
setType('anyone');
$newPermission->setRole('reader'); // 或者 'writer' 如果你想允许编辑
$drive->permissions->create($spreadsheet->spreadsheetId, $newPermission);
?>代码解释:
- $drive = new Google_Service_Drive($client);: 创建 Google Drive API 的服务对象。
- $newPermission = new Google_Service_Drive_Permission();: 创建一个新的权限对象。
- $newPermission->setType('anyone');: 将权限类型设置为 anyone，这意味着任何拥有链接的人都可以访问。
- $newPermission->setRole('reader');: 将角色设置为 reader，这意味着拥有链接的人只能查看电子表格。 如果需要允许编辑，可以将角色设置为 writer。
- $drive->permissions->create($spreadsheet->spreadsheetId, $newPermission);: 使用 permissions->create 方法创建权限。
完整示例
以下是一个完整的示例，展示了如何创建可链接访问的电子表格：
setApplicationName('Google Sheets API PHP Quickstart');
$client->setScopes(Google_Service_Sheets::SPREADSHEETS, Google_Service_Drive::DRIVE);
$client->setAuthConfig('path/to/your/credentials.json'); // 替换为你的 credentials.json 文件的路径
$client->setAccessType('offline');
$client->setPrompt('consent');
// 加载之前保存的凭据 (如果存在)
$tokenPath = 'token.json';
if (file_exists($tokenPath)) {
$accessToken = json_decode(file_get_contents($tokenPath), true);
$client->setAccessToken($accessToken);
}
// 如果没有有效的凭据，则获取一个新的凭据
if ($client->isAccessTokenExpired()) {
if ($client->getRefreshToken()) {
$client->fetchAccessTokenWithRefreshToken($client->getRefreshToken());
} else {
// 获取授权 URL
$authUrl = $client->createAuthUrl();
printf("请访问以下 URL 并授权应用程序:\n%s\n", $authUrl);
fwrite(STDOUT, "输入授权码: ");
$authCode = trim(fgets(STDIN));
// 交换授权码以获取访问令牌
$accessToken = $client->fetchAccessTokenWithAuthCode($authCode);
$client->setAccessToken($accessToken);
// 检查是否出现错误
if (array_key_exists('error', $accessToken)) {
throw new Exception(join(', ', $accessToken));
}
// 将凭据保存到磁盘以供下次使用
if (!file_exists(dirname($tokenPath))) {
mkdir(dirname($tokenPath), 0700, true);
}
file_put_contents($tokenPath, json_encode($client->getAccessToken()));
}
}
// 创建 Google Sheets 和 Drive 服务对象
$service = new Google_Service_Sheets($client);
$drive = new Google_Service_Drive($client);
// 创建一个新的电子表格
$title = 'My New Spreadsheet';
$spreadsheet = new Google_Service_Sheets_Spreadsheet([
'properties' => [
'title' => $title,
]
]);
$spreadsheet = $service->spreadsheets->create($spreadsheet, ['fields' => 'spreadsheetId']);
// 获取电子表格的 URL
$url = "https://docs.google.com/spreadsheets/d/" . $spreadsheet->spreadsheetId . "/edit";
printf("电子表格 URL: %s\n", $url);
// 设置共享权限
$newPermission = new Google_Service_Drive_Permission();
$newPermission->setType('anyone');
$newPermission->setRole('reader'); // 或者 'writer' 如果你想允许编辑
$drive->permissions->create($spreadsheet->spreadsheetId, $newPermission);
echo "电子表格已成功创建并设置为可链接访问。\n";
?>注意事项:
- 确保你已经安装了 Google API 客户端库：composer require google/apiclient:"^2.0"
- 替换 path/to/your/credentials.json 为你的 credentials.json 文件的实际路径。
- 你需要创建一个 Google Cloud 项目，启用 Google Sheets API 和 Google Drive API，并下载 credentials.json 文件。 详细步骤请参考 Google API 文档。
- 首次运行此脚本时，你需要授权应用程序访问你的 Google 帐户。
- token.json 文件用于存储访问令牌，以便下次运行时可以自动授权。
- 选择适当的角色（reader 或 writer）以控制对电子表格的访问权限。
总结
通过使用 Google Sheets API 和 Google Drive API，你可以使用 PHP 创建新的 Google Sheet 电子表格，并使其可以通过链接公开访问。 这对于需要与他人共享数据的应用程序非常有用。 请务必注意安全问题，并根据需要设置适当的共享权限。
