Rails中使用Google服务账号调用Drive API，web_content_link始终为nil

问题分析 #

出现这个问题的核心原因有两个：

1. Drive API v3默认返回字段限制：list_files方法默认仅返回基础字段（如id、name、mime_type），web_view_link和web_content_link不在默认返回集合内。
2. 权限与文件归属问题：服务账号拥有独立的Drive存储空间，默认只能访问自身空间内的文件；若访问个人Drive的文件，未共享给服务账号则无法生成有效链接；即使是服务账号自身的文件，未设置外部访问权限时，这两个链接也会为nil。

解决方案 #

1. 修改list_files调用，指定返回字段 #

在调用list_files时显式声明需要返回的字段，确保包含web_view_link和web_content_link：

修改控制器代码：

class FilesController < ApplicationController
  def index
    @drive = GOOGLE_DRIVE_SERVICE
    # 显式指定需要获取的字段
    @files_list = GOOGLE_DRIVE_SERVICE.list_files(
      fields: 'files(id,name,mime_type,web_view_link,web_content_link)'
    )
  end
end

2. 确保服务账号有权访问目标文件 #

• 如果访问的是个人Google Drive中的文件：

  1. 打开Google Drive找到目标文件/文件夹，右键选择「共享」
  2. 输入服务账号凭证文件（google_drive_credentials.json）中的client_email字段值
  3. 给服务账号分配「查看者」及以上权限，保存设置

• 如果是服务账号自身Drive中的文件：
  需要给文件添加外部访问权限才能生成有效链接，示例代码如下（可在创建文件后调用）：

# 为指定文件添加任何人可查看的权限
permission = Google::Apis::DriveV3::Permission.new(
  type: 'anyone',
  role: 'reader'
)
GOOGLE_DRIVE_SERVICE.create_permission(file_id, permission)

3. 验证结果 #

重新运行Rails项目，此时web_view_link和web_content_link应该会返回有效链接（前提是文件权限设置正确）。

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