Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

จัดเก็บข้อมูลเฉพาะแอปพลิเคชัน

โฟลเดอร์ข้อมูลแอปพลิเคชันเป็นโฟลเดอร์พิเศษที่ซ่อนไว้ซึ่งแอปของคุณใช้เก็บข้อมูลเฉพาะของแอปพลิเคชันได้ เช่น ไฟล์การกำหนดค่า ระบบจะสร้างโฟลเดอร์ข้อมูลแอปพลิเคชันโดยอัตโนมัติเมื่อคุณพยายามสร้างไฟล์ในโฟลเดอร์ ใช้โฟลเดอร์นี้เพื่อเก็บไฟล์ที่ผู้ใช้ไม่ควรโต้ตอบด้วยโดยตรง แอปของคุณเท่านั้นที่จะเข้าถึงโฟลเดอร์นี้ได้ และระบบจะซ่อนเนื้อหาของโฟลเดอร์จากผู้ใช้และแอป Google ไดรฟ์อื่นๆ

ระบบจะลบโฟลเดอร์ข้อมูลแอปพลิเคชันเมื่อผู้ใช้ถอนการติดตั้งแอปของคุณออกจากไดรฟ์ของฉัน นอกจากนี้ ผู้ใช้ยังลบโฟลเดอร์ข้อมูลของแอปด้วยตนเองได้ด้วย

ขอบเขตของโฟลเดอร์ข้อมูลแอปพลิเคชัน

คุณต้องขอสิทธิ์เข้าถึงขอบเขต https://www.googleapis.com/auth/drive.appdata ที่ไม่ละเอียดอ่อนก่อนจึงจะเข้าถึงโฟลเดอร์ข้อมูลแอปพลิเคชันได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับขอบเขตและวิธีขอสิทธิ์เข้าถึงได้ที่หัวข้อ เลือกขอบเขต Google Drive API ดูข้อมูลเพิ่มเติมเกี่ยวกับขอบเขต OAuth 2.0 ที่เฉพาะเจาะจงได้ที่หัวข้อขอบเขต OAuth 2.0 สำหรับ Google API

โฟลเดอร์ข้อมูลแอปพลิเคชันแตกต่างจากโฟลเดอร์ข้อมูลสำรองของไดรฟ์อย่างไร

โฟลเดอร์ข้อมูลแอปพลิเคชันจะแยกจากโฟลเดอร์ข้อมูลสำรองของไดรฟ์

โฟลเดอร์ข้อมูลแอปพลิเคชันเป็นโฟลเดอร์การกำหนดค่าที่สร้างขึ้นสำหรับแอปของบุคคลที่สามแต่ละแอป และแอปของบุคคลที่สามแต่ละแอปจะเก็บข้อมูลไว้ในโฟลเดอร์ได้ เฉพาะแอปพลิเคชันที่สร้างข้อมูลใน appDataFolder เท่านั้นที่จะเข้าถึงข้อมูลได้ คุณเข้าถึงโฟลเดอร์โดยใช้อินเทอร์เฟซผู้ใช้ (UI) ของไดรฟ์ไม่ได้

โฟลเดอร์ข้อมูลสำรองของไดรฟ์ เป็นโฟลเดอร์ที่สงวนไว้ซึ่ง ไดรฟ์จะเขียนข้อมูลสำรองของอุปกรณ์ลงในโฟลเดอร์นี้ และโฟลเดอร์นี้จะปรากฏใน UI ของไดรฟ์

ข้อจำกัดของโฟลเดอร์ข้อมูลแอปพลิเคชัน

ระบบจะบังคับใช้ข้อจำกัดต่อไปนี้เมื่อทำงานกับโฟลเดอร์ข้อมูลแอปพลิเคชัน

คุณแชร์ไฟล์หรือโฟลเดอร์ภายในโฟลเดอร์ข้อมูลแอปพลิเคชันไม่ได้ การพยายามดำเนินการดังกล่าวจะทำให้เกิดข้อผิดพลาด notSupportedForAppDataFolderFiles พร้อมข้อความแสดงข้อผิดพลาดต่อไปนี้ "Method not supported for files within the Application Data folder."
คุณย้ายไฟล์ใน appDataFolder ระหว่างตำแหน่งที่เก็บข้อมูล (พื้นที่เก็บข้อมูล) ไม่ได้ การพยายามดำเนินการดังกล่าวจะทำให้เกิดข้อผิดพลาด notSupportedForAppDataFolderFiles พร้อมข้อความแสดงข้อผิดพลาดต่อไปนี้ "Method not supported for files within the Application Data folder." ดูข้อมูลเพิ่มเติมได้ที่หัวข้อการจัดระเบียบไฟล์
คุณย้ายไฟล์หรือโฟลเดอร์ภายในโฟลเดอร์ข้อมูลแอปพลิเคชันไปที่ถังขยะไม่ได้ การพยายามดำเนินการดังกล่าวจะทำให้เกิดข้อผิดพลาด notSupportedForAppDataFolderFiles พร้อมข้อความแสดงข้อผิดพลาดต่อไปนี้ "Files within the Application Data folder cannot be trashed."

สร้างไฟล์ในโฟลเดอร์ข้อมูลแอปพลิเคชัน

หากต้องการสร้างไฟล์ในโฟลเดอร์ข้อมูลแอปพลิเคชัน ให้ระบุ appDataFolder ใน parents พร็อพเพอร์ตี้ของไฟล์ แล้วใช้ files.create เมธอดเพื่อสร้างไฟล์ใน โฟลเดอร์

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีแทรกไฟล์ลงในโฟลเดอร์โดยใช้ไลบรารีของไคลเอ็นต์และคำสั่ง curl

Java

drive/snippets/drive_v3/src/main/java/UploadAppData.java

ดูใน GitHub

import com.google.api.client.googleapis.json.GoogleJsonResponseException;
import com.google.api.client.http.FileContent;
import com.google.api.client.http.HttpRequestInitializer;
import com.google.api.client.http.javanet.NetHttpTransport;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.services.drive.Drive;
import com.google.api.services.drive.DriveScopes;
import com.google.api.services.drive.model.File;
import com.google.auth.http.HttpCredentialsAdapter;
import com.google.auth.oauth2.GoogleCredentials;
import java.io.IOException;
import java.util.Arrays;
import java.util.Collections;

/**
 * Class to demonstrate use-case of create file in the application data folder.
 */
public class UploadAppData {

  /**
   * Creates a file in the application data folder.
   *
   * @return Created file's Id.
   */
  public static String uploadAppData() throws IOException {
        /*Load pre-authorized user credentials from the environment.
        TODO(developer) - See https://developers.google.com/identity for
        guides on implementing OAuth2 for your application.*/
    GoogleCredentials credentials = null;
    try {
      credentials = GoogleCredentials.getApplicationDefault()
          .createScoped(Arrays.asList(DriveScopes.DRIVE_APPDATA));
    } catch (IOException e) {
      e.printStackTrace();
    }
    HttpRequestInitializer requestInitializer = new HttpCredentialsAdapter(
        credentials);

    // Build a new authorized API client service.
    Drive service = new Drive.Builder(new NetHttpTransport(),
        GsonFactory.getDefaultInstance(),
        requestInitializer)
        .setApplicationName("Drive samples")
        .build();
    try {
      // File's metadata.
      File fileMetadata = new File();
      fileMetadata.setName("config.json");
      fileMetadata.setParents(Collections.singletonList("appDataFolder"));
      java.io.File filePath = new java.io.File("files/config.json");
      FileContent mediaContent = new FileContent("application/json", filePath);
      File file = service.files().create(fileMetadata, mediaContent)
          .setFields("id")
          .execute();
      System.out.println("File ID: " + file.getId());
      return file.getId();
    } catch (GoogleJsonResponseException e) {
      // TODO(developer) - handle error appropriately
      System.err.println("Unable to create file: " + e.getDetails());
      throw e;
    }
  }

}

Python

drive/snippets/drive-v3/app_data_snippet/upload_appdata.py

ดูใน GitHub

import google.auth
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError
from googleapiclient.http import MediaFileUpload


def upload_appdata():
  """Insert a file in the application data folder and prints file Id.
  Returns : ID's of the inserted files

  Load pre-authorized user credentials from the environment.
  TODO(developer) - See https://developers.google.com/identity
  for guides on implementing OAuth2 for the application.
  """
  creds, _ = google.auth.default()

  try:
    # call drive api client
    service = build("drive", "v3", credentials=creds)

    # pylint: disable=maybe-no-member
    file_metadata = {"name": "abc.txt", "parents": ["appDataFolder"]}
    media = MediaFileUpload("abc.txt", mimetype="text/txt", resumable=True)
    file = (
        service.files()
        .create(body=file_metadata, media_body=media, fields="id")
        .execute()
    )
    print(f'File ID: {file.get("id")}')

  except HttpError as error:
    print(f"An error occurred: {error}")
    file = None

  return file.get("id")


if __name__ == "__main__":
  upload_appdata()

Node.js

drive/snippets/drive_v3/appdata_snippets/upload_appdata.js

ดูใน GitHub

import fs from 'node:fs';
import {GoogleAuth} from 'google-auth-library';
import {google} from 'googleapis';

/**
 * Uploads a file to the application data folder.
 * @return {Promise<string>} The ID of the uploaded file.
 */
async function uploadAppdata() {
  // Authenticate with Google and get an authorized client.
  // TODO (developer): Use an appropriate auth mechanism for your app.
  const auth = new GoogleAuth({
    scopes: 'https://www.googleapis.com/auth/drive.appdata',
  });

  // Create a new Drive API client (v3).
  const service = google.drive({version: 'v3', auth});

  // The metadata for the file to be uploaded.
  const fileMetadata = {
    name: 'config.json',
    parents: ['appDataFolder'],
  };

  // The media content to be uploaded.
  const media = {
    mimeType: 'application/json',
    body: fs.createReadStream('files/config.json'),
  };

  // Upload the file to the application data folder.
  const file = await service.files.create({
    requestBody: fileMetadata,
    media,
    fields: 'id',
  });

  // Print the ID of the uploaded file.
  console.log('File Id:', file.data.id);
  if (!file.data.id) {
    throw new Error('File ID not found.');
  }
  return file.data.id;
}

PHP

drive/snippets/drive_v3/src/DriveUploadAppData.php

ดูใน GitHub

<?php
use Google\Client;
use Google\Service\Drive;
function uploadAppData()
{
   try {
    $client = new Client();
    $client->useApplicationDefaultCredentials();
    $client->addScope(Drive::DRIVE);
    $client->addScope(Drive::DRIVE_APPDATA);
    $driveService = new Drive($client);
    $fileMetadata = new Drive\DriveFile(array(
        'name' => 'config.json',
        'parents' => array('appDataFolder')
    ));
    $content = file_get_contents('../files/config.json');
    $file = $driveService->files->create($fileMetadata, array(
        'data' => $content,
        'mimeType' => 'application/json',
        'uploadType' => 'multipart',
        'fields' => 'id'));
    printf("File ID: %s\n", $file->id);
    return $file->id;

   } catch(Exception $e) {
     echo "Error Message: ".$e;
   }  
}

.NET

drive/snippets/drive_v3/DriveV3Snippets/UploadAppData.cs

ดูใน GitHub

using Google.Apis.Auth.OAuth2;
using Google.Apis.Drive.v3;
using Google.Apis.Services;

namespace DriveV3Snippets
{
    // Class of demonstrate the use of Drive upload app data. 
    public class UploadAppData
    {
        /// <summary>
        /// Insert a file in the application data folder and prints file Id.
        /// </summary>
        /// <param name="filePath">File path to upload.</param>
        /// <returns>ID's of the inserted files, null otherwise.</returns>
        public static string DriveUploadAppData(string filePath)
        {
            try
            {
                /* Load pre-authorized user credentials from the environment.
                 TODO(developer) - See https://developers.google.com/identity for
                 guides on implementing OAuth2 for your application. */
                GoogleCredential credential = GoogleCredential.GetApplicationDefault()
                    .CreateScoped(DriveService.Scope.DriveAppdata);

                // Create Drive API service.
                var service = new DriveService(new BaseClientService.Initializer
                {
                    HttpClientInitializer = credential,
                    ApplicationName = "Drive API Snippets"
                });
                var fileMetadata = new Google.Apis.Drive.v3.Data.File()
                {
                    Name = "config.json",
                    Parents = new List<string>()
                    {
                        "appDataFolder"
                    }
                };
                FilesResource.CreateMediaUpload request;
                using (var stream = new FileStream(filePath,
                           FileMode.Open))
                {
                    request = service.Files.Create(
                        fileMetadata, stream, "application/json");
                    request.Fields = "id";
                    request.Upload();
                }

                var file = request.ResponseBody;
                // Prints the file id.
                Console.WriteLine("File ID: " + file.Id);
                return file.Id;
            }
            catch (Exception e)
            {
                // TODO(developer) - handle error appropriately
                if (e is AggregateException)
                {
                    Console.WriteLine("Credential Not found");
                }
                else
                {
                    throw;
                }
            }
            return null;
        }
    }
}

curl

คำขอ:

curl --request POST \
'https://content.googleapis.com/drive/v3/files' \
    -H 'authorization: Bearer ACCESS_TOKEN' \
    -H 'content-type: application/json' \
    -H 'x-origin: https://explorer.apis.google.com' \
    --data-raw '{"name": "config.json", "parents":["appDataFolder"]}'

แทนที่ ACCESS_TOKEN ด้วยโทเค็น OAuth 2.0 ของแอป

การตอบกลับ:

{
    "kind": "drive#file",
    "id": FILE_ID,
    "name": "config.json",
    "mimeType": "application/json"
}

ดูข้อมูลเพิ่มเติมเกี่ยวกับการสร้างไฟล์ในโฟลเดอร์ได้ที่หัวข้อสร้างและ เพิ่มข้อมูลในโฟลเดอร์

ค้นหาไฟล์ในโฟลเดอร์ข้อมูลแอปพลิเคชัน

หากต้องการค้นหาไฟล์ในโฟลเดอร์ข้อมูลแอปพลิเคชัน ให้ตั้งค่าฟิลด์ spaces เป็น appDataFolder แล้วใช้เมธอด files.list

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีค้นหาไฟล์ในโฟลเดอร์ข้อมูลแอปพลิเคชันโดยใช้ไลบรารีของไคลเอ็นต์และคำสั่ง curl

Java

drive/snippets/drive_v3/src/main/java/ListAppData.java

ดูใน GitHub

import com.google.api.client.googleapis.json.GoogleJsonResponseException;
import com.google.api.client.http.HttpRequestInitializer;
import com.google.api.client.http.javanet.NetHttpTransport;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.services.drive.Drive;
import com.google.api.services.drive.DriveScopes;
import com.google.api.services.drive.model.File;
import com.google.api.services.drive.model.FileList;
import com.google.auth.http.HttpCredentialsAdapter;
import com.google.auth.oauth2.GoogleCredentials;
import java.io.IOException;
import java.util.Arrays;

/**
 * Class to demonstrate use-case of list 10 files in the application data folder.
 */
public class ListAppData {

  /**
   * list down files in the application data folder.
   *
   * @return list of 10 files.
   */
  public static FileList listAppData() throws IOException {
        /*Load pre-authorized user credentials from the environment.
        TODO(developer) - See https://developers.google.com/identity for
        guides on implementing OAuth2 for your application.*/
    GoogleCredentials credentials = null;
    try {
      credentials = GoogleCredentials.getApplicationDefault()
          .createScoped(Arrays.asList(DriveScopes.DRIVE_APPDATA));
    } catch (IOException e) {
      e.printStackTrace();
    }
    HttpRequestInitializer requestInitializer = new HttpCredentialsAdapter(
        credentials);

    // Build a new authorized API client service.
    Drive service = new Drive.Builder(new NetHttpTransport(),
        GsonFactory.getDefaultInstance(),
        requestInitializer)
        .setApplicationName("Drive samples")
        .build();
    try {
      FileList files = service.files().list()
          .setSpaces("appDataFolder")
          .setFields("nextPageToken, files(id, name)")
          .setPageSize(10)
          .execute();
      for (File file : files.getFiles()) {
        System.out.printf("Found file: %s (%s)\n",
            file.getName(), file.getId());
      }

      return files;
    } catch (GoogleJsonResponseException e) {
      // TODO(developer) - handle error appropriately
      System.err.println("Unable to list files: " + e.getDetails());
      throw e;
    }
  }

}

Python

drive/snippets/drive-v3/app_data_snippet/list_appdata.py

ดูใน GitHub

import google.auth
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError


def list_appdata():
  """List all files inserted in the application data folder
  prints file titles with Ids.
  Returns : List of items

  Load pre-authorized user credentials from the environment.
  TODO(developer) - See https://developers.google.com/identity
  for guides on implementing OAuth2 for the application.
  """
  creds, _ = google.auth.default()

  try:
    # call drive api client
    service = build("drive", "v3", credentials=creds)

    # pylint: disable=maybe-no-member
    response = (
        service.files()
        .list(
            spaces="appDataFolder",
            fields="nextPageToken, files(id, name)",
            pageSize=10,
        )
        .execute()
    )
    for file in response.get("files", []):
      # Process change
      print(f'Found file: {file.get("name")}, {file.get("id")}')

  except HttpError as error:
    print(f"An error occurred: {error}")
    response = None

  return response.get("files")


if __name__ == "__main__":
  list_appdata()

Node.js

drive/snippets/drive_v3/appdata_snippets/list_appdata.js

ดูใน GitHub

/**
 * Copyright 2022 Google LLC
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     https://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */


import {GoogleAuth} from 'google-auth-library';
import {google} from 'googleapis';

/**
 * Lists all files in the application data folder.
 * @return {Promise<object[]>} A list of files.
 */
async function listAppdata() {
  // Authenticate with Google and get an authorized client.
  // TODO (developer): Use an appropriate auth mechanism for your app.
  const auth = new GoogleAuth({
    scopes: 'https://www.googleapis.com/auth/drive.appdata',
  });

  // Create a new Drive API client (v3).
  const service = google.drive({version: 'v3', auth});

  // List the files in the application data folder.
  const result = await service.files.list({
    spaces: 'appDataFolder',
    fields: 'nextPageToken, files(id, name)',
    pageSize: 100,
  });

  // Print the name and ID of each file.
  (result.data.files ?? []).forEach((file) => {
    console.log('Found file:', file.name, file.id);
  });

  return result.data.files ?? [];
}

export {listAppdata};

PHP

drive/snippets/drive_v3/src/DriveListAppData.php

ดูใน GitHub

<?php
use Google\Client;
use Google\Service\Drive;
function listAppData()
{
    try {
        $client = new Client();
        $client->useApplicationDefaultCredentials();
        $client->addScope(Drive::DRIVE);
        $driveService = new Drive($client);
        $response = $driveService->files->listFiles(array(
            'spaces' => 'appDataFolder',
            'fields' => 'nextPageToken, files(id, name)',
            'pageSize' => 10
        ));
        foreach ($response->files as $file) {
            printf("Found file: %s (%s)", $file->name, $file->id);
        }
        return $response->files;

    }catch(Exception $e) {
        echo "Error Message: ".$e;
    }

}

.NET

drive/snippets/drive_v3/DriveV3Snippets/ListAppData.cs

ดูใน GitHub

using Google.Apis.Auth.OAuth2;
using Google.Apis.Drive.v3;
using Google.Apis.Drive.v3.Data;
using Google.Apis.Services;

namespace DriveV3Snippets
{
    // Class to demonstrate use-case of Drive's list files in the application data folder.
    public class ListAppData
    {
        /// <summary>
        /// List down files in the application data folder.
        /// </summary>
        /// <returns>list of 10 files, null otherwise.</returns>
        public static FileList DriveListAppData()
        {
            try
            {
                /* Load pre-authorized user credentials from the environment.
                 TODO(developer) - See https://developers.google.com/identity for
                 guides on implementing OAuth2 for your application. */
                GoogleCredential credential = GoogleCredential.GetApplicationDefault()
                    .CreateScoped(DriveService.Scope.DriveAppdata);

                // Create Drive API service.
                var service = new DriveService(new BaseClientService.Initializer
                {
                    HttpClientInitializer = credential,
                    ApplicationName = "Drive API Snippets"
                });

                var request = service.Files.List();
                request.Spaces = "appDataFolder";
                request.Fields = "nextPageToken, files(id, name)";
                request.PageSize = 10;
                var result = request.Execute();
                foreach (var file in result.Files)
                {
                    // Prints the list of 10 file names.
                    Console.WriteLine("Found file: {0} ({1})", file.Name, file.Id);
                }
                return result;
            }
            catch (Exception e)
            {
                // TODO(developer) - handle error appropriately
                if (e is AggregateException)
                {
                    Console.WriteLine("Credential Not found");
                }
                else
                {
                    throw;
                }
            }
            return null;
        }
    }
}

curl

คำขอ:

curl \
    -X GET \
    -H "Authorization: Bearer ACCESS_TOKEN" \
    "https://www.googleapis.com/drive/v3/files?spaces=appDataFolder&fields=files(id,name,mimeType,size,modifiedTime)"

แทนที่ ACCESS_TOKEN ด้วยโทเค็น OAuth 2.0 ของแอป

การตอบกลับ:

{
    "files": [
        {
            "mimeType": "application/json",
            "size": "256",
            "id": FILE_ID,
            "name": "config.json",
            "modifiedTime": "2025-04-03T23:40:05.860Z"
        },
        {
            "mimeType": "text/plain",
            "size": "128",
            "id": FILE_ID,
            "name": "user_settings.txt",
            "modifiedTime": "2025-04-02T17:52:29.020Z"
        }
    ]
}

ดาวน์โหลดไฟล์จากโฟลเดอร์ข้อมูลแอปพลิเคชัน

หากต้องการดาวน์โหลดไฟล์จากโฟลเดอร์ข้อมูลแอปพลิเคชัน ให้ใช้เมธอด files.get กับพารามิเตอร์ URL alt=media เพื่อ ดึงเนื้อหาไฟล์ในเนื้อหาการตอบกลับ ดูข้อมูลเพิ่มเติมและดูตัวอย่างโค้ดได้ที่หัวข้อดาวน์โหลดเนื้อหาไฟล์ Blob

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีดาวน์โหลดไฟล์ในโฟลเดอร์ข้อมูลแอปพลิเคชันโดยใช้คำสั่ง curl เนื้อหาการตอบกลับจะแตกต่างกันไปตามสิ่งที่บันทึกไว้

curl

คำขอ:

curl \
    -X GET \
    -H "Authorization: Bearer ACCESS_TOKEN" \
    "https://www.googleapis.com/drive/v3/files/FILE_ID?alt=media"

แทนที่ค่าต่อไปนี้

ACCESS_TOKEN: โทเค็น OAuth 2.0 ของแอป
FILE_ID: รหัสของไฟล์ที่ต้องการดาวน์โหลด