如何使用 PHP 自动共享 Google Docs 链接（无需对方请求访问）_技术教程

本文详解如何在 PHP 中调用 Google Drive API v3，为新创建的 Google 文档设置公开或指定用户的编辑/查看权限，生成可直接访问的 `webViewLink`，彻底避免“请求访问”提示。

要实现“分享 Google Docs 链接而无需接收方点击‘请求访问’”，核心在于：文档必须通过 Drive API 显式设置共享权限（Permission），且权限需面向具体用户、群组、域名或设为公开可见。仅创建文档并获取 webViewLink 是不够的——默认情况下该链接仍受私有权限保护。

你当前代码已成功创建文档（Google_Service_Docs），但缺少关键步骤：调用 Drive API v3 的 Permissions.create 方法为文档赋予明确访问权限。你尝试使用的 permissions->insert() 是旧版 v2 的方法，在 v3 中已被弃用，这正是报错 Call to undefined method ... insert() 的根本原因。

✅ 正确做法如下：

1. 初始化 Drive API v3 服务（非 Docs）

你需要单独初始化 Google_Service_Drive（v3），而非复用 Google_Service_Docs：

// 在创建 $service = new Google_Service_Docs($client); 后添加：
$driveService = new Google_Service_Drive($client);

2. 设置共享权限（关键步骤）

使用 Permissions.create 添加权限。以下示例授予指定邮箱编辑权（writer）：

$fileId = $documentId; // 你创建的文档 ID

// 创建用户级编辑权限
$userPermission = new Google_Service_Drive_Permission([
    'type' => 'user',
    'role' => 'writer', // 可选: 'reader', 'commenter', 'writer'
    'emailAddress' => 'recipient@example.com' // ✅ 注意：v3 使用 'emailAddress'，非 'value'
]);

try {
    $permission = $driveService->permissions->create(
        $fileId,
        $userPermission,
        ['fields' => 'id,kind,emailAddress,role,type'] // 指定返回字段
    );
    printf("Permission created for %s (ID: %s)\n", $permission->emailAddress, $permission->id);
} catch (Exception $e) {
    error_log("Permission creation failed: " . $e->getMessage());
}

3. 获取可直接访问的链接（webViewLink）

权限生效后，即可安全获取 webViewLink（无需登录即可打开，前提是权限已开放）：

// 获取文件元数据（含 webViewLink 和权限状态）
$file = $driveService->files->get($fileId, [
    'fields' => 'id,name,webViewLink,sharingUser,permissions'
]);
printf("Shared document link: %s\n", $file->webViewLink);
// 输出示例: https://docs.google.com/document/d/1abc.../edit?usp=sharing

⚠️ 重要注意事项

权限传播延迟：新权限通常秒级生效，但极少数情况可能需数秒，请勿立即重试。

公开分享（慎用）：若需任何人可查看，设 type='anyone' + role='reader'：

$anyonePermission = new Google_Service_Drive_Permission([
    'type' => 'anyone',
    'role' => 'reader'
]);
$driveService->permissions->create($fileId, $anyonePermission);