如何验证导入的Google Sheet来自指定Google Workspace且非公开？

核心思路 #

通过Google Drive API获取Sheet的元数据与权限信息，从组织归属和访问权限两个维度验证：

1. 确认Sheet所属的Google Workspace域名匹配预期值
2. 确认Sheet未设置公开访问权限

具体步骤 #

1. 提取Sheet ID

从用户输入的URL中解析出唯一的Sheet ID，常见URL格式为：
https://docs.google.com/spreadsheets/d/{SheetID}/edit...
用正则表达式提取ID：

import re
match = re.search(r'/d/([a-zA-Z0-9-_]+)', sheet_url)
sheet_id = match.group(1) if match else None

2. 调用Drive API获取文件元数据

通过Drive API的files.get接口，请求包含domain（归属组织域名）、permissions（权限列表）、visibility（可见性）的字段。需确保应用已授权drive.readonly或更高权限。

3. 验证Workspace归属

检查返回的domain字段是否等于预期的Workspace域名（如your-company.com）：

• 若domain不存在，说明Sheet属于个人Google账户，直接拒绝
• 若domain与预期不符，说明不属于目标Workspace

4. 验证非公开权限

从两个维度确认Sheet未公开：

• 检查visibility字段：若值为PUBLIC，则为公开文件
• 遍历permissions列表：若存在type:anyone的权限条目（包括anyoneWithLink或完全公开），则判定为公开

代码示例（Python） #

from googleapiclient.discovery import build
import re

def validate_google_sheet(sheet_url, expected_domain, credentials):
    # 提取Sheet ID
    match = re.search(r'/d/([a-zA-Z0-9-_]+)', sheet_url)
    if not match:
        return False, "无效的Sheet URL格式"
    file_id = match.group(1)

    # 初始化Drive API客户端
    drive_service = build('drive', 'v3', credentials=credentials)

    try:
        # 获取关键元数据
        file_metadata = drive_service.files().get(
            fileId=file_id,
            fields='domain, permissions, visibility'
        ).execute()
    except Exception as e:
        return False, f"获取文件信息失败: {str(e)}"

    # 验证Workspace归属
    file_domain = file_metadata.get('domain')
    if not file_domain or file_domain != expected_domain:
        return False, "Sheet不属于指定的Google Workspace"

    # 验证非公开
    if file_metadata.get('visibility') == 'PUBLIC':
        return False, "Sheet为公开可访问状态"
    for perm in file_metadata.get('permissions', []):
        if perm.get('type') == 'anyone':
            return False, "Sheet包含公开访问权限"

    return True, "Sheet验证通过"

注意事项 #

• 应用需启用Google Drive API，并在OAuth授权中请求drive.readonly权限（如需修改Sheet，需追加spreadsheets权限）
• 若Sheet位于Shared Drive，domain字段仍会返回所属Workspace域名，无需额外处理Shared Drive的归属验证
• 对于权限继承自文件夹/Shared Drive的情况，Drive API返回的permissions会包含继承的权限，无需单独遍历父级资源

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