Android原生应用迁移至'drive.file'权限域后的文件访问问题咨询

问题背景 #

开发全原生Android应用时，收到谷歌通知需从受限的auth/drive权限域迁移至权限更宽松的auth/drive.file权限域，迁移过程中遇到两个核心问题：

• 不使用Google Picker API时，如何通过auth/drive.file访问文件/文件夹？当前调用接口出现404 File not found错误，是否有无需变更权限域的解决办法？
• 若上述方法不可行，Android端如何实现类似Google Picker API的云端硬盘文件选择功能？官方文档显示仅可通过Google Workspace API实现，是否有其他替代方案？

已执行操作与问题细节 #

1. 修改授权流程，从https://accounts.google.com/o/oauth2/token获取了带有auth/drive.file权限的刷新令牌和访问令牌
2. 发送GET /drive/v3/files请求获取文件夹列表，响应的items字段为空
3. 发送GET /drive/v3/files/{fileId}请求访问根文件夹，返回404 File not found错误

相关代码与错误日志 #

请求代码 #

// Header
Header[] requestHeaders = new Header[]{
        // Access token already obtained from post https://accounts.google.com/o/oauth2/token
        new BasicHeader("Authorization", accessToken),
        new BasicHeader("Cache-Control", "no-cache"),
        new BasicHeader("Pragma", "no-cache"),
        new BasicHeader("Accept", "text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2"),
        new BasicHeader("Connection", "keep-alive")
};

InputStream inputStream = null;
try {
    // Perform a GET request to retrieve data
    setHttpResponse(
            doGet(httpClient, "https://www.googleapis.com/drive/v3/files/{fileId}", requestHeaders)
    );
    int status = getHttpResponse().getStatusLine().getStatusCode();

    // setting response data
    inputStream = getHttpResponse().getEntity().getContent();
    String responseContentType = GoogleDriveUtils.getResponseContentType(this.getHttpResponse());

    // Error determination
    // Status other than 200 or Content-Type other than "application/json"
    if (status != 200 || !GoogleDriveUtils.isContentTypeJson(responseContentType)) {
        // exception 
        throw GoogleDriveUtils.createGoogleDriveException(
                fulUrl, inputStream, status, responseContentType,
                this.getHttpResponse(), GoogleDriveConsts.PROCESS_TYPE_RETRIEVAL);
    }

    // Response Analysis
    googleDriveAboutInfo = GoogleDriveAboutInfo.parseGoogleDriveAboutInfo(inputStream);

} 

错误响应 #

{
  "error": {
    "code": 404,
    "message": "File not found: {FileID}",
    "errors": [
      {
        "message": "File not found: {FileID}",
        "domain": "global",
        "reason": "notFound",
        "location": "file",
        "locationType": "other"
      }
    ]
  }
}

解决方案 #

问题1：不使用Picker API时的auth/drive.file访问问题 #

auth/drive.file权限的核心规则是仅能访问用户明确授权给应用的文件/文件夹，范围包括：

• 应用自身创建的文件
• 用户通过应用授权流程主动选择的文件

你遇到的404和空items问题，本质是auth/drive.file权限下，应用默认无法访问用户Drive中的任意文件（包括根文件夹）。

无需变更权限域的解决办法？

没有。谷歌要求迁移至auth/drive.file是强制合规要求，无法绕过权限限制继续使用原逻辑，必须适配新权限规则。

正确访问方式（不使用Picker API）

1. 访问应用创建的文件：调用GET /drive/v3/files时，通过q参数过滤，例如：
   • 筛选应用专属目录文件：q='appDataFolder' in parents
   • 筛选应用创建的文件：q=createdByMe=true
2. 访问用户授权的外部文件：必须先让用户通过系统文件选择器或自定义UI选择文件，获取文件ID后再调用接口。注意选择文件时需触发OAuth增量授权，确保auth/drive.file权限覆盖该文件。

问题2：Android端实现类似Google Picker的文件选择功能 #

官方无原生Android版Google Picker API，可采用以下替代方案：

• 系统文件选择器（SAF）：通过ACTION_OPEN_DOCUMENT或ACTION_OPEN_DOCUMENT_TREE Intent调用系统文件选择器，用户选择Drive文件后，应用可通过ContentResolver访问。该方式无需依赖第三方组件，符合auth/drive.file权限要求。
• 自定义Drive文件选择UI：基于Drive API的files.list接口，结合q参数过滤可访问文件（如q=mimeType='application/vnd.google-apps.folder'筛选文件夹），自行实现文件列表UI。需注意初始仅能看到应用创建的文件，用户需通过授权流程添加外部文件。
• Google Workspace API方案：仅面向Google Workspace用户，可使用Workspace API相关组件，不适用于普通消费者用户。

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