สร้างและป้อนข้อมูลโฟลเดอร์

โฟลเดอร์คือไฟล์ที่มีเพียงข้อมูลเมตาและใช้จัดระเบียบไฟล์ใน Google ไดรฟ์ได้ โดยมีคุณสมบัติดังนี้

• โฟลเดอร์คือไฟล์ที่มีประเภท MIME application/vnd.google-apps.folder และไม่มีนามสกุล
• คุณสามารถใช้นามแฝง root เพื่ออ้างอิงโฟลเดอร์รูทได้ทุกที่ที่ระบุรหัสไฟล์

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

บทความนี้จะอธิบายวิธีทำงานพื้นฐานบางอย่างที่เกี่ยวข้องกับโฟลเดอร์

สร้างโฟลเดอร์

หากต้องการสร้างโฟลเดอร์ ให้ใช้ files.create() เมธอดที่มี mimeType เป็น application/vnd.google-apps.folder และ name ตัวอย่างโค้ดต่อไปนี้แสดงวิธีสร้างโฟลเดอร์โดยใช้ไลบรารีของไคลเอ็นต์

หมายเหตุ: หากคุณใช้ Drive API v2 เวอร์ชันเก่า ให้ใช้เมธอด files.insert คุณดูตัวอย่างโค้ด ได้ใน GitHub ดูวิธีย้ายข้อมูลไปยัง Drive API v3

Java

drive/snippets/drive_v3/src/main/java/CreateFolder.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.auth.http.HttpCredentialsAdapter;
import com.google.auth.oauth2.GoogleCredentials;
import java.io.IOException;
import java.util.Arrays;

/* Class to demonstrate use of Drive's create folder API */
public class CreateFolder {


  /**
   * Create new folder.
   *
   * @return Inserted folder id if successful, {@code null} otherwise.
   * @throws IOException if service account credentials file not found.
   */
  public static String createFolder() 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 = GoogleCredentials.getApplicationDefault()
        .createScoped(Arrays.asList(DriveScopes.DRIVE_FILE));
    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();
    // File's metadata.
    File fileMetadata = new File();
    fileMetadata.setName("Test");
    fileMetadata.setMimeType("application/vnd.google-apps.folder");
    try {
      File file = service.files().create(fileMetadata)
          .setFields("id")
          .execute();
      System.out.println("Folder ID: " + file.getId());
      return file.getId();
    } catch (GoogleJsonResponseException e) {
      // TODO(developer) - handle error appropriately
      System.err.println("Unable to create folder: " + e.getDetails());
      throw e;
    }
  }
}

Python

drive/snippets/drive-v3/file_snippet/create_folder.py

ดูใน GitHub

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


def create_folder():
  """Create a folder and prints the folder ID
  Returns : Folder Id

  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:
    # create drive api client
    service = build("drive", "v3", credentials=creds)
    file_metadata = {
        "name": "Invoices",
        "mimeType": "application/vnd.google-apps.folder",
    }

    # pylint: disable=maybe-no-member
    file = service.files().create(body=file_metadata, fields="id").execute()
    print(f'Folder ID: "{file.get("id")}".')
    return file.get("id")

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


if __name__ == "__main__":
  create_folder()

Node.js

drive/snippets/drive_v3/file_snippets/create_folder.js

ดูใน GitHub

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

/**
 * Creates a new folder in Google Drive.
 * @return {Promise<string|null|undefined>} The ID of the created folder.
 */
async function createFolder() {
  // 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',
  });

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

  // The metadata for the new folder.
  const fileMetadata = {
    name: 'Invoices',
    mimeType: 'application/vnd.google-apps.folder',
  };

  // Create the new folder.
  const file = await service.files.create({
    requestBody: fileMetadata,
    fields: 'id',
  });

  // Print the ID of the new folder.
  console.log('Folder Id:', file.data.id);
  return file.data.id;
}

PHP

drive/snippets/drive_v3/src/DriveCreateFolder.php

ดูใน GitHub

<?php
use Google\Client;
use Google\Service\Drive;
function createFolder()
{
    try {
        $client = new Client();
        $client->useApplicationDefaultCredentials();
        $client->addScope(Drive::DRIVE);
        $driveService = new Drive($client);
        $fileMetadata = new Drive\DriveFile(array(
            'name' => 'Invoices',
            'mimeType' => 'application/vnd.google-apps.folder'));
        $file = $driveService->files->create($fileMetadata, array(
            'fields' => 'id'));
        printf("Folder ID: %s\n", $file->id);
        return $file->id;

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

.NET

drive/snippets/drive_v3/DriveV3Snippets/CreateFolder.cs

ดูใน GitHub

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

namespace DriveV3Snippets
{
    // Class to demonstrate use of Drive create folder API.
    public class CreateFolder
    {
        /// <summary>
        /// Creates a new folder.
        /// </summary>
        /// <returns>created folder id, null otherwise</returns>
        public static string DriveCreateFolder()
        {
            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.Drive);

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

                // File metadata
                var fileMetadata = new Google.Apis.Drive.v3.Data.File()
                {
                    Name = "Invoices",
                    MimeType = "application/vnd.google-apps.folder"
                };

                // Create a new folder on drive.
                var request = service.Files.Create(fileMetadata);
                request.Fields = "id";
                var file = request.Execute();
                // Prints the created folder id.
                Console.WriteLine("Folder 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 -X POST 'https://www.googleapis.com/drive/v3/files' \
 -H 'Authorization: Bearer ACCESS_TOKEN' \
 -H 'Content-Type: application/json' \
 -d '{
   "name": "FOLDER_NAME",
   "mimeType": "application/vnd.google-apps.folder"
 }'

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

• ACCESS_TOKEN: โทเค็น OAuth 2.0 ของแอป
• FOLDER_NAME: ชื่อโฟลเดอร์ที่จะสร้าง

สร้างไฟล์ในโฟลเดอร์ที่เฉพาะเจาะจง

หากต้องการสร้างไฟล์ในโฟลเดอร์ที่เฉพาะเจาะจง ให้ใช้เมธอด files.create() และระบุรหัสโฟลเดอร์ในพร็อพเพอร์ตี้ parents ของไฟล์

พร็อพเพอร์ตี้ parents จะเก็บรหัสของโฟลเดอร์หลักที่มีไฟล์อยู่ คุณสามารถใช้พร็อพเพอร์ตี้ parents เมื่อสร้างไฟล์ในโฟลเดอร์ระดับบนสุดหรือโฟลเดอร์อื่นๆ

ไฟล์จะมีโฟลเดอร์หลักได้เพียงโฟลเดอร์เดียว ระบบไม่รองรับการระบุโฟลเดอร์หลักหลายโฟลเดอร์ หากไม่ได้ระบุช่อง parents ระบบจะวางไฟล์ไว้ในโฟลเดอร์ไดรฟ์ของฉันของผู้ใช้โดยตรง

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

หมายเหตุ: หากคุณใช้ Drive API v2 เวอร์ชันเก่า ให้ใช้เมธอด files.insert คุณดูตัวอย่างโค้ด ได้ใน GitHub ดูวิธีย้ายข้อมูลไปยัง Drive API v3

Java

drive/snippets/drive_v3/src/main/java/UploadToFolder.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 Drive's upload to folder use-case. */
public class UploadToFolder {

  /**
   * Upload a file to the specified folder.
   *
   * @param realFolderId Id of the folder.
   * @return Inserted file metadata if successful, {@code null} otherwise.
   * @throws IOException if service account credentials file not found.
   */
  public static File uploadToFolder(String realFolderId) 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 = GoogleCredentials.getApplicationDefault()
        .createScoped(Arrays.asList(DriveScopes.DRIVE_FILE));
    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();

    // File's metadata.
    File fileMetadata = new File();
    fileMetadata.setName("photo.jpg");
    fileMetadata.setParents(Collections.singletonList(realFolderId));
    java.io.File filePath = new java.io.File("files/photo.jpg");
    FileContent mediaContent = new FileContent("image/jpeg", filePath);
    try {
      File file = service.files().create(fileMetadata, mediaContent)
          .setFields("id, parents")
          .execute();
      System.out.println("File ID: " + file.getId());
      return file;
    } catch (GoogleJsonResponseException e) {
      // TODO(developer) - handle error appropriately
      System.err.println("Unable to upload file: " + e.getDetails());
      throw e;
    }
  }
}

Python

drive/snippets/drive-v3/file_snippet/upload_to_folder.py

ดูใน GitHub

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


def upload_to_folder(folder_id):
  """Upload a file to the specified folder and prints file ID, folder ID
  Args: Id of the folder
  Returns: ID of the file uploaded

  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:
    # create drive api client
    service = build("drive", "v3", credentials=creds)

    file_metadata = {"name": "photo.jpg", "parents": [folder_id]}
    media = MediaFileUpload(
        "download.jpeg", mimetype="image/jpeg", resumable=True
    )
    # pylint: disable=maybe-no-member
    file = (
        service.files()
        .create(body=file_metadata, media_body=media, fields="id")
        .execute()
    )
    print(f'File ID: "{file.get("id")}".')
    return file.get("id")

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


if __name__ == "__main__":
  upload_to_folder(folder_id="1s0oKEZZXjImNngxHGnY0xed6Mw-tvspu")

Node.js

drive/snippets/drive_v3/file_snippets/upload_to_folder.js

ดูใน GitHub

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

/**
 * Uploads a file to the specified folder.
 * @param {string} folderId The ID of the folder to upload the file to.
 * @return {Promise<string>} The ID of the uploaded file.
 */
async function uploadToFolder(folderId) {
  // 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',
  });

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

  // The request body for the file to be uploaded.
  const requestBody = {
    name: 'photo.jpg',
    parents: [folderId],
  };

  // The media content to be uploaded.
  const media = {
    mimeType: 'image/jpeg',
    body: fs.createReadStream('files/photo.jpg'),
  };

  // Upload the file to the specified folder.
  const file = await service.files.create({
    requestBody,
    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/DriveUploadToFolder.php

ดูใน GitHub

<?php
use Google\Client;
use Google\Service\Drive;
function uploadToFolder($folderId)
{
    try {
        $client = new Client();
        $client->useApplicationDefaultCredentials();
        $client->addScope(Drive::DRIVE);
        $driveService = new Drive($client);
        $fileMetadata = new Drive\DriveFile(array(
            'name' => 'photo.jpg',
            'parents' => array($folderId)
        ));
        $content = file_get_contents('../files/photo.jpg');
        $file = $driveService->files->create($fileMetadata, array(
            'data' => $content,
            'mimeType' => 'image/jpeg',
            'uploadType' => 'multipart',
            'fields' => 'id'));
        printf("File ID: %s\n", $file->id);
        return $file->id;
    } catch (Exception $e) {
        echo "Error Message: " . $e;
    }
}
require_once 'vendor/autoload.php';
uploadToFolder();

.NET

drive/snippets/drive_v3/DriveV3Snippets/UploadToFolder.cs

ดูใน GitHub

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

namespace DriveV3Snippets
{
    // Class to demonstrate use of Drive upload to folder.
    public class UploadToFolder
    {
        /// <summary>
        /// Upload a file to the specified folder.
        /// </summary>
        /// <param name="filePath">Image path to upload.</param>
        /// <param name="folderId">Id of the folder.</param>
        /// <returns>Inserted file metadata if successful, null otherwise</returns>
        public static Google.Apis.Drive.v3.Data.File DriveUploadToFolder
            (string filePath, string folderId)
        {
            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.Drive);

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

                // Upload file photo.jpg in specified folder on drive.
                var fileMetadata = new Google.Apis.Drive.v3.Data.File()
                {
                    Name = "photo.jpg",
                    Parents = new List<string>
                    {
                        folderId
                    }
                };
                FilesResource.CreateMediaUpload request;
                // Create a new file on drive.
                using (var stream = new FileStream(filePath,
                           FileMode.Open))
                {
                    // Create a new file, with metadata and stream.
                    request = service.Files.Create(
                        fileMetadata, stream, "image/jpeg");
                    request.Fields = "id";
                    request.Upload();
                }
                var file = request.ResponseBody;
                // Prints the uploaded file id.
                Console.WriteLine("File ID: " + file.Id);
                return file;
            }
            catch (Exception e)
            {
                // TODO(developer) - handle error appropriately
                if (e is AggregateException)
                {
                    Console.WriteLine("Credential Not found");
                }
                else if (e is FileNotFoundException)
                {
                    Console.WriteLine("File not found");
                }
                else if (e is DirectoryNotFoundException)
                {
                    Console.WriteLine("Directory Not found");
                }
                else
                {
                    throw;
                }
            }
            return null;
        }
    }
}

curl

curl -X POST 'https://www.googleapis.com/drive/v3/files' \
 -H 'Authorization: Bearer ACCESS_TOKEN' \
 -H 'Content-Type: application/json' \
 -d '{
   "name": "photo.jpg",
   "parents": [
     "FOLDER_ID"
   ]
 }'

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

• ACCESS_TOKEN: โทเค็น OAuth 2.0 ของแอป
• FOLDER_ID: รหัสของโฟลเดอร์ที่จะสร้างไฟล์

ย้ายไฟล์ระหว่างโฟลเดอร์

หากต้องการย้ายไฟล์ คุณต้องอัปเดตรหัสของพร็อพเพอร์ตี้ parents

หากต้องการเพิ่มหรือนำโฟลเดอร์หลักของไฟล์ที่มีอยู่ออก ให้ใช้เมธอด files.update() พร้อมกับพารามิเตอร์การค้นหา addParents และ removeParents

ไฟล์จะมีโฟลเดอร์หลักได้เพียงโฟลเดอร์เดียว ระบบไม่รองรับการระบุโฟลเดอร์หลักหลายโฟลเดอร์

คำเตือน: แม้ว่าโฟลเดอร์จะเป็นไฟล์ประเภทหนึ่ง แต่คุณจะย้ายโฟลเดอร์จากไดรฟ์ของฉันไปยังไดรฟ์ที่แชร์โดยการอัปเดตพารามิเตอร์ addParents ไม่ได้ การพยายามดำเนินการดังกล่าวจะแสดงการตอบกลับรหัสสถานะ HTTP teamDrivesFolderMoveInNotSupported ดูข้อมูลเพิ่มเติมและวิธีแก้ปัญหาที่เป็นไปได้ได้ที่แก้ไข ข้อผิดพลาด

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

Java

drive/snippets/drive_v3/src/main/java/MoveFileToFolder.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.auth.http.HttpCredentialsAdapter;
import com.google.auth.oauth2.GoogleCredentials;
import java.io.IOException;
import java.util.Arrays;
import java.util.List;

/* Class to demonstrate use case for moving file to folder.*/
public class MoveFileToFolder {


  /**
   * @param fileId   Id of file to be moved.
   * @param folderId Id of folder where the fill will be moved.
   * @return list of parent ids for the file.
   */
  public static List<String> moveFileToFolder(String fileId, String folderId)
      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 = GoogleCredentials.getApplicationDefault()
        .createScoped(Arrays.asList(DriveScopes.DRIVE_FILE));
    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();

    // Retrieve the existing parents to remove
    File file = service.files().get(fileId)
        .setFields("parents")
        .execute();
    StringBuilder previousParents = new StringBuilder();
    for (String parent : file.getParents()) {
      previousParents.append(parent);
      previousParents.append(',');
    }
    try {
      // Move the file to the new folder
      file = service.files().update(fileId, null)
          .setAddParents(folderId)
          .setRemoveParents(previousParents.toString())
          .setFields("id, parents")
          .execute();

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

Python

drive/snippets/drive-v3/file_snippet/move_file_to_folder.py

ดูใน GitHub

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


def move_file_to_folder(file_id, folder_id):
  """Move specified file to the specified folder.
  Args:
      file_id: Id of the file to move.
      folder_id: Id of the folder
  Print: An object containing the new parent folder and other meta data
  Returns : Parent Ids for the file

  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
    # Retrieve the existing parents to remove
    file = service.files().get(fileId=file_id, fields="parents").execute()
    previous_parents = ",".join(file.get("parents"))
    # Move the file to the new folder
    file = (
        service.files()
        .update(
            fileId=file_id,
            addParents=folder_id,
            removeParents=previous_parents,
            fields="id, parents",
        )
        .execute()
    )
    return file.get("parents")

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


if __name__ == "__main__":
  move_file_to_folder(
      file_id="1KuPmvGq8yoYgbfW74OENMCB5H0n_2Jm9",
      folder_id="1jvTFoyBhUspwDncOTB25kb9k0Fl0EqeN",
  )

Node.js

drive/snippets/drive_v3/file_snippets/move_file_to_folder.js

ดูใน GitHub

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

/**
 * Moves a file to a new folder in Google Drive.
 * @param {string} fileId The ID of the file to move.
 * @param {string} folderId The ID of the folder to move the file to.
 * @return {Promise<number>} The status of the move operation.
 */
async function moveFileToFolder(fileId, folderId) {
  // 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',
  });

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

  // Get the file's metadata to retrieve its current parents.
  const file = await service.files.get({
    fileId,
    fields: 'parents',
  });

  // Get the current parents as a comma-separated string.
  const previousParents = (file.data.parents ?? []).join(',');

  // Move the file to the new folder.
  const result = await service.files.update({
    fileId,
    addParents: folderId,
    removeParents: previousParents,
    fields: 'id, parents',
  });

  // Print the status of the move operation.
  console.log(result.status);
  return result.status;
}

PHP

drive/snippets/drive_v3/src/DriveMoveFileToFolder.php

ดูใน GitHub

<?php
use Google\Client;
use Google\Service\Drive;
use Google\Service\Drive\DriveFile;
function moveFileToFolder($fileId,$folderId)
{
    try {
        $client = new Client();
        $client->useApplicationDefaultCredentials();
        $client->addScope(Drive::DRIVE);
        $driveService = new Drive($client);
        $emptyFileMetadata = new DriveFile();
        // Retrieve the existing parents to remove
        $file = $driveService->files->get($fileId, array('fields' => 'parents'));
        $previousParents = join(',', $file->parents);
        // Move the file to the new folder
        $file = $driveService->files->update($fileId, $emptyFileMetadata, array(
            'addParents' => $folderId,
            'removeParents' => $previousParents,
            'fields' => 'id, parents'));
        return $file->parents;
    } catch(Exception $e) {
        echo "Error Message: ".$e;
    }
}

.NET

drive/snippets/drive_v3/DriveV3Snippets/MoveFileToFolder.cs

ดูใน GitHub

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

namespace DriveV3Snippets
{
    // Class to demonstrate use-case of Drive move file to folder.
    public class MoveFileToFolder
    {
        /// <summary>
        /// Move specified file to the specified folder.
        /// </summary>
        /// <param name="fileId">Id of file to be moved.</param>
        /// <param name="folderId">Id of folder where the fill will be moved.</param>
        /// <returns>list of parent ids for the file, null otherwise.</returns>
        public static IList<string> DriveMoveFileToFolder(string fileId,
            string folderId)
        {
            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.Drive);

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

                // Retrieve the existing parents to remove
                var getRequest = service.Files.Get(fileId);
                getRequest.Fields = "parents";
                var file = getRequest.Execute();
                var previousParents = String.Join(",", file.Parents);
                // Move the file to the new folder
                var updateRequest =
                    service.Files.Update(new Google.Apis.Drive.v3.Data.File(),
                        fileId);
                updateRequest.Fields = "id, parents";
                updateRequest.AddParents = folderId;
                updateRequest.RemoveParents = previousParents;
                file = updateRequest.Execute();

                return file.Parents;
            }
            catch (Exception e)
            {
                // TODO(developer) - handle error appropriately
                if (e is AggregateException)
                {
                    Console.WriteLine("Credential Not found");
                }
                else if (e is GoogleApiException)
                {
                    Console.WriteLine("File or Folder not found");
                }
                else
                {
                    throw;
                }
            }
            return null;
        }
    }
}

curl

curl -X PATCH 'https://www.googleapis.com/drive/v3/files/FILE_ID?addParents=NEW_PARENT_ID&removeParents=PREVIOUS_PARENT_ID' \
 -H 'Authorization: Bearer ACCESS_TOKEN' \
 -H 'Accept: application/json'

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

• FILE_ID: รหัสของไฟล์ที่จะย้าย
• NEW_PARENT_ID: รหัสของโฟลเดอร์ที่จะย้ายไฟล์ ไป
• PREVIOUS_PARENT_ID: รายการโฟลเดอร์หลักที่คั่นด้วยคอมมาเพื่อนำไฟล์ออกจากโฟลเดอร์
• ACCESS_TOKEN: โทเค็น OAuth 2.0 ของแอป

หมายเหตุ: หากคุณใช้ Drive API v2 เวอร์ชันก่อนหน้า ทรัพยากร children และ parents ก็ช่วยในการจัดระเบียบไฟล์และโฟลเดอร์ใหม่ได้เช่นกัน

ขีดจำกัดของไฟล์และโฟลเดอร์

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

ขีดจำกัดรายการต่อผู้ใช้

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

ออบเจ็กต์ที่นับรวมในขีดจำกัดนี้ ได้แก่

• รายการที่ผู้ใช้สร้างหรืออัปโหลดในไดรฟ์
• รายการที่ผู้ใช้สร้างแต่ตอนนี้มีเจ้าของเป็นบุคคลอื่น
• รายการในถังขยะ
• ทางลัด
• ทางลัดของบุคคลที่สาม

ออบเจ็กต์ที่ไม่นับรวมในขีดจำกัดนี้ ได้แก่

• รายการที่ลบอย่างถาวร
• รายการที่แชร์กับผู้ใช้แต่มีเจ้าของเป็นบุคคลอื่น
• รายการที่ผู้ใช้เป็นเจ้าของแต่สร้างโดยบุคคลอื่น

การพยายามเพิ่มรายการมากกว่า 500 ล้านรายการจะแสดงการตอบกลับรหัสสถานะ HTTP activeItemCreationLimitExceeded

โปรดทราบว่าบัญชีบริการไม่สามารถเป็นเจ้าของไฟล์ใดๆ ได้ แต่ต้องอัปโหลดไฟล์และโฟลเดอร์ลงในไดรฟ์ที่แชร์ หรือใช้ OAuth 2.0 เพื่ออัปโหลดรายการในนามของผู้ใช้จริง

ขีดจำกัดรายการต่อโฟลเดอร์

โฟลเดอร์แต่ละโฟลเดอร์ในไดรฟ์ของฉันของผู้ใช้มีขีดจำกัด 500,000 รายการ โดยขีดจำกัดดังกล่าวจะไม่มีผลกับโฟลเดอร์รูทในไดรฟ์ของฉัน รายการที่นับรวมในขีดจำกัดนี้ ได้แก่

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับขีดจำกัดของโฟลเดอร์ได้ที่ขีดจำกัดของโฟลเดอร์ใน Google ไดรฟ์

ขีดจำกัดความลึกของโฟลเดอร์

ไดรฟ์ของฉันของผู้ใช้มีโฟลเดอร์ซ้อนกันได้ไม่เกิน 100 ระดับ ซึ่งหมายความว่าคุณจะจัดเก็บโฟลเดอร์ย่อยไว้ในโฟลเดอร์ที่มีความลึกมากกว่า 99 ระดับไม่ได้ ข้อจำกัดนี้ใช้กับโฟลเดอร์ย่อยเท่านั้น ไฟล์ย่อย ที่มีประเภท MIME อื่นที่ไม่ใช่ application/vnd.google-apps.folder จะได้รับการยกเว้นจากข้อจำกัดนี้

ตัวอย่างเช่น ในแผนภาพต่อไปนี้ คุณสามารถซ้อนโฟลเดอร์ใหม่ไว้ในโฟลเดอร์หมายเลข 99 ได้ แต่จะซ้อนไว้ในโฟลเดอร์หมายเลข 100 ไม่ได้ อย่างไรก็ตาม โฟลเดอร์หมายเลข 100 สามารถจัดเก็บไฟล์ได้เหมือนกับโฟลเดอร์อื่นๆ ในไดรฟ์

การพยายามเพิ่มโฟลเดอร์มากกว่า 100 ระดับจะแสดงการตอบกลับรหัสสถานะ myDriveHierarchyDepthLimitExceeded HTTP

หมายเหตุ: Google Drive API ไม่มีช่อง files ที่แสดงความลึกของโฟลเดอร์ได้ หากต้องการทราบความลึกของโฟลเดอร์ คุณต้องเลื่อนขึ้นตามลำดับชั้นของโฟลเดอร์ด้วยตนเอง

หัวข้อที่เกี่ยวข้อง

• สร้างและจัดการไฟล์
• จัดการข้อมูลเมตาของไฟล์
• ขีดจำกัดของไฟล์และโฟลเดอร์ในไดรฟ์ที่แชร์