通过PHP使用Google API创建并公开共享Google表格

本教程详细介绍了如何使用php通过google Sheets API创建新的Google表格，并利用Google Drive API设置其访问权限，使其可以通过链接公开访问或共享。文章将指导您获取表格URL并按需配置共享权限，确保您能高效地管理通过API创建的表格的可见性。

概述

在使用google sheets api通过编程方式创建新的电子表格时，一个常见的需求是使其能够通过链接访问，甚至公开共享。默认情况下，通过spreadsheets.create方法创建的表格是私有的。要实现“通过链接访问”或“公开共享”的功能，我们需要结合使用google sheets api来创建表格，以及google drive api来管理其权限。

步骤一：创建Google表格并获取其URL

首先，您需要使用Google Sheets API创建电子表格。在创建成功后，API响应中会包含一个spreadsheetId，这是构建表格访问链接的关键。

以下是使用PHP创建表格并获取其URL的示例代码：

<?php  require_once 'vendor/autoload.php'; // 确保已加载composer依赖  // 假设 $client 变量已经过认证并配置，例如使用OAuth 2.0 // $client = new Google_Client(); // $client->setapplicationName('Google Sheets API PHP Quickstart'); // $client->setScopes([Google_Service_Sheets::SPREADSHEETS, Google_Service_Drive::DRIVE]); // $client->setAuthConfig('credentials.JSon'); // 您的凭据文件 // $client->setaccessType('offline'); // $client->setPrompt('select_account consent'); // ... 认证流程 ...  $service = new Google_Service_Sheets($client);  $title = '我的新API创建表格'; // 您希望为表格设置的标题  // 创建一个新的Spreadsheet对象 $spreadsheetProperties = [     'properties' => [         'title' => $title,     ] ]; $spreadsheet = new Google_Service_Sheets_Spreadsheet($spreadsheetProperties);  try {     // 调用create方法创建表格，并指定只返回spreadsheetId字段以优化性能     $createdSpreadsheet = $service->spreadsheets->create($spreadsheet, ['fields' => 'spreadsheetId']);     $spreadsheetId = $createdSpreadsheet->spreadsheetId;      // 构建新创建表格的URL     $spreadsheetUrl = "https://docs.google.com/spreadsheets/d/" . $spreadsheetId . "/edit";      printf("表格创建成功！n");     printf("表格ID: %sn", $spreadsheetId);     printf("表格URL: %sn", $spreadsheetUrl);  } catch (GoogleServiceException $e) {     printf("创建表格时发生错误: %sn", $e->getMessage()); }  ?>

代码说明：

• Google_Service_Sheets($client)：初始化Sheets服务。
• Google_Service_Sheets_Spreadsheet：定义新表格的属性，这里只设置了标题。
• $service-youjiankuohaophpcnspreadsheets->create($spreadsheet, [‘fields’ => ‘spreadsheetId’])：执行创建操作。通过[‘fields’ => ‘spreadsheetId’]，我们明确指示API只返回表格ID，这是一种良好的实践，可以减少网络负载。
• $createdSpreadsheet->spreadsheetId：从API响应中提取新创建表格的唯一标识符。
• “https://docs.google.com/spreadsheets/d/” . $spreadsheetId . “/edit”：这是Google表格的标准URL格式，通过拼接spreadsheetId即可得到可访问的链接。

至此，您已经成功创建了一个Google表格并获取了其URL。然而，这个表格仍然是私有的，只有拥有相应Google账号权限的用户才能访问。

立即学习“PHP免费学习笔记（深入）”；

步骤二：通过Google Drive API设置表格共享权限

要使表格能够通过链接公开访问（即“任何人都可以查看”），我们需要使用Google Drive API来修改其权限。Google Sheets文件本质上是存储在Google Drive中的文件，因此其权限管理也通过Drive API进行。

Copilot

Copilot是由微软公司开发的一款AI生产力工具，旨在通过先进的人工智能技术，帮助用户快速完成各种任务，提升工作效率。

63

查看详情

继续以上一步获取的$spreadsheetId，我们可以添加一个“任何人”都可以访问的权限。

<?php // ... 承接上一步的代码，确保 $client 仍然可用且已认证 ... // 确保 $spreadsheetId 变量已从上一步获取  if (isset($spreadsheetId)) {     $driveService = new Google_Service_Drive($client);      // 创建一个新的权限对象     $newPermission = new Google_Service_Drive_Permission();     $newPermission->setType('anyone'); // 设置权限类型为“任何人”     $newPermission->setRole('reader'); // 设置角色为“阅读者”，也可以是'writer'（编辑者）      try {         // 将新权限应用到指定ID的表格         $driveService->permissions->create($spreadsheetId, $newPermission);         printf("表格已成功设置为通过链接公开共享（阅读者权限）。n");     } catch (GoogleServiceException $e) {         printf("设置表格共享权限时发生错误: %sn", $e->getMessage());     } } else {     printf("未获取到表格ID，无法设置共享权限。n"); }  ?>

代码说明：

• Google_Service_Drive($client)：初始化Drive服务。请确保您的$client配置包含了Google_Service_Drive::DRIVE范围。
• Google_Service_Drive_Permission()：创建一个权限对象。
• $newPermission->setType(‘anyone’)：这是关键一步，它将权限授予给所有拥有链接的用户，无需登录Google账号。
• $newPermission->setRole(‘reader’)：定义“任何人”的角色。
  • reader：只读权限。
  • writer：编辑权限（请谨慎使用，因为这意味着任何人都可以修改您的表格）。
• $driveService->permissions->create($spreadsheetId, $newPermission)：将定义的权限应用到之前创建的表格上。

注意事项

1. API Scope（授权范围）：确保您的Google Client在认证时包含了必要的API范围。对于创建表格，需要Google_Service_Sheets::SPREADSHEETS。对于管理权限，需要Google_Service_Drive::DRIVE或更具体的Google_Service_Drive::DRIVE_FILE。
2. 公共共享的风险：将表格设置为type(‘anyone’)和role(‘reader’)意味着任何知道链接的人都可以查看您的表格内容。如果表格包含敏感信息，请勿使用此方法。
3. 权限管理：如果您不希望公开共享表格，只需跳过步骤二的代码即可。表格将保持私有，仅由创建它的服务账号或明确共享的用户访问。
4. 错误处理：在实际生产环境中，务必添加健壮的错误处理机制来捕获api调用可能抛出的异常。

总结

通过结合使用Google Sheets API和Google Drive API，您可以灵活地通过PHP创建Google表格，并精确控制其访问权限。首先，使用Sheets API创建表格并获取其spreadsheetId，然后利用Drive API，通过permissions.create方法为该spreadsheetId对应的文件设置anyone类型的权限，从而实现通过链接公开访问或共享。理解并正确应用这些步骤，将使您能够高效地自动化Google表格的创建和权限管理流程。

以上就是通过PHP使用Google API创建并公开共享Google表格的详细内容，更多请关注php js json go composer app access api调用 red php 标识符 对象 https 自动化