本頁面由 Cloud Translation API 翻譯而成。

上傳檔案資料

您可以使用 Google 雲端硬碟 API，在建立或更新 File 時上傳檔案資料。如要瞭解如何建立僅含中繼資料的檔案 (例如資料夾)，請參閱「建立僅含中繼資料的檔案」。

你可以執行三種上傳作業：

簡單上傳 (uploadType=media)：使用這類上傳方式，無須提供中繼資料，即可轉移小型媒體檔案 (5 MB 以下)。如要執行簡單上傳作業，請參閱「執行簡單上傳作業」。
多部分上傳 (uploadType=multipart)：「使用這類上傳方式，可透過單一要求傳輸小型檔案 (5 MB 以下)，以及描述檔案的中繼資料。如要執行多部分上傳作業，請參閱「執行多部分上傳作業」。
可續傳的上傳作業 (uploadType=resumable)：如果檔案很大 (超過 5 MB)，且網路中斷的機率很高 (例如透過行動應用程式建立檔案時)，請使用這類上傳作業。可續傳的上傳作業也適用於大多數應用程式，因為這類作業也適用於小型檔案，且每次上傳作業只會額外產生一次 HTTP 要求，成本極低。如要執行支援續傳的上傳作業，請參閱「執行支援續傳的上傳作業」。

Google API 用戶端程式庫會實作至少其中一種上傳類型。如要進一步瞭解如何使用各個類型，請參閱用戶端程式庫說明文件。

使用 `PATCH` 與 `PUT`

提醒您，HTTP 動詞 PATCH 支援部分檔案資源更新，而 HTTP 動詞 PUT 支援完整資源取代。請注意，為現有資源新增欄位時，PUT 可能會造成重大變更。

上傳檔案資源時，請遵守下列規範：

針對可續傳上傳的初始要求，或簡單/多部分上傳的唯一要求，請使用 API 參考資料中記錄的 HTTP 動詞。
要求啟動後，所有後續的可續傳上傳要求都應使用 PUT。無論呼叫的方法為何，這些要求都會上傳內容。

執行簡易上傳作業

如要執行簡單的上傳作業，請使用 files.create 方法搭配 uploadType=media。

以下說明如何執行簡單的上傳作業：

HTTP

向方法的 /upload URI 發出 POST 要求，並加入 uploadType=media 查詢參數：

POST https://www.googleapis.com/upload/drive/v3/files?uploadType=media
將檔案資料新增到要求主體。
新增下列 HTTP 標頭：
- Content-Type：請設為要上傳物件的 MIME 媒體類型。
- Content-Length：請設為您上傳的位元組數。如果使用區塊轉移編碼，則不需要這個標頭。
傳送要求。如果要求成功，伺服器會傳回 HTTP 200 OK 狀態碼，以及檔案的中繼資料。{HTTP}

執行簡單上傳作業時，系統會建立基本中繼資料，並從檔案推斷某些屬性，例如 MIME 類型或 modifiedTime。如果檔案很小，且檔案中繼資料不重要，可以使用簡單的上傳方式。

執行多部分上傳作業

您可以在同一項要求中，透過多部分上傳要求上傳中繼資料和資料。如果要傳送的資料小到足以在連線失敗時再完整上傳一次，請使用這個選項。

如要執行多部分上傳作業，請使用 files.create 方法搭配 uploadType=multipart。

以下說明如何執行多部分上傳：

Java

drive/snippets/drive_v3/src/main/java/UploadBasic.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;

/* Class to demonstrate use of Drive insert file API */
public class UploadBasic {

  /**
   * Upload new file.
   *
   * @return Inserted file metadata if successful, {@code null} otherwise.
   * @throws IOException if service account credentials file not found.
   */
  public static String uploadBasic() 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();
    // Upload file photo.jpg on drive.
    File fileMetadata = new File();
    fileMetadata.setName("photo.jpg");
    // File's content.
    java.io.File filePath = new java.io.File("files/photo.jpg");
    // Specify media type and file-path for file.
    FileContent mediaContent = new FileContent("image/jpeg", filePath);
    try {
      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 upload file: " + e.getDetails());
      throw e;
    }
  }
}

Python

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

前往 GitHub 查看

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


def upload_basic():
  """Insert new file.
  Returns : Id's 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": "download.jpeg"}
    media = MediaFileUpload("download.jpeg", mimetype="image/jpeg")
    # 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")}')

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

  return file.get("id")


if __name__ == "__main__":
  upload_basic()

Node.js

drive/snippets/drive_v3/file_snippets/upload_basic.js

前往 GitHub 查看

/**
 * Insert new file.
 * @return{obj} file Id
 * */
async function uploadBasic() {
  const fs = require('fs');
  const {GoogleAuth} = require('google-auth-library');
  const {google} = require('googleapis');

  // Get credentials and build service
  // TODO (developer) - Use appropriate auth mechanism for your app
  const auth = new GoogleAuth({
    scopes: 'https://www.googleapis.com/auth/drive',
  });
  const service = google.drive({version: 'v3', auth});
  const requestBody = {
    name: 'photo.jpg',
    fields: 'id',
  };
  const media = {
    mimeType: 'image/jpeg',
    body: fs.createReadStream('files/photo.jpg'),
  };
  try {
    const file = await service.files.create({
      requestBody,
      media: media,
    });
    console.log('File Id:', file.data.id);
    return file.data.id;
  } catch (err) {
    // TODO(developer) - Handle error
    throw err;
  }
}

PHP

drive/snippets/drive_v3/src/DriveUploadBasic.php

前往 GitHub 查看

<?php
use Google\Client;
use Google\Service\Drive;
# TODO - PHP client currently chokes on fetching start page token
function uploadBasic()
{
    try {
        $client = new Client();
        $client->useApplicationDefaultCredentials();
        $client->addScope(Drive::DRIVE);
        $driveService = new Drive($client);
        $fileMetadata = new Drive\DriveFile(array(
        'name' => 'photo.jpg'));
        $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;
    } 

}

.NET

drive/snippets/drive_v3/DriveV3Snippets/UploadBasic.cs

前往 GitHub 查看

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

namespace DriveV3Snippets
{
    // Class to demonstrate use of Drive insert file API
    public class UploadBasic
    {
        /// <summary>
        /// Upload new file.
        /// </summary>
        /// <param name="filePath">Image path to upload.</param>
        /// <returns>Inserted file metadata if successful, null otherwise.</returns>
        public static string DriveUploadBasic(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.Drive);

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

                // Upload file photo.jpg on drive.
                var fileMetadata = new Google.Apis.Drive.v3.Data.File()
                {
                    Name = "photo.jpg"
                };
                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.Id;
            }
            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
                {
                    throw;
                }
            }
            return null;
        }
    }
}

HTTP

向方法的 /upload URI 發出 POST 要求，並加入 uploadType=multipart 查詢參數：

POST https://www.googleapis.com/upload/drive/v3/files?uploadType=multipart
建立要求主體。請依據 multipart/related 內容類型 RFC 2387 設定主體格式，當中包含兩個部分：
- 中繼資料。中繼資料必須是要求的第一個部分，且必須將標頭設為 application/json; charset=UTF-8。Content-Type以 JSON 格式新增檔案的中繼資料。
- 媒體。媒體必須是要求的第二個部分，且必須有任何 MIME 類型的 Content-Type 標頭。將檔案資料新增至媒體部分。
以邊界字串識別每個部分，並在前面加上兩個連字號。此外，請在最後一個邊界字串後方加上兩個連字號。
新增下列頂層 HTTP 標頭：
- Content-Type：請設為 multipart/related，並加入要用來辨識各個要求部分的邊界字串。例如：Content-Type: multipart/related; boundary=foo_bar_baz
- Content-Length：請設定為要求主體中的位元組總數。
傳送要求。

如要建立或更新中繼資料部分，而不上傳相關資料，請將 POST 或 PATCH 要求傳送至標準資源端點：https://www.googleapis.com/drive/v3/files 如果要求成功，伺服器會傳回 HTTP 200 OK 狀態碼和檔案的中繼資料。

建立檔案時，檔案的 name 欄位應指定副檔名。舉例來說，建立相片 JPEG 檔案時，您可能會在中繼資料中指定 "name": "photo.jpg"。後續對 files.get 的呼叫會傳回唯讀的 fileExtension 屬性，其中包含 name 欄位中原始指定的擴充功能。

執行支援續傳的上傳作業

如因通訊問題導致資料傳輸過程遭到中斷，之後可透過可續傳的上傳作業繼續執行上傳作業。由於您不需要從頭開始上傳大型檔案，因此如果發生網路問題，支援續傳的上傳作業也能減少頻寬用量。

如果檔案大小差異很大，或要求有固定時間限制 (例如行動作業系統背景工作和特定 App Engine 要求)，就適合使用可續傳上傳功能。您也可以在想顯示上傳進度列的情況下，使用支援續傳的上傳作業。

支援續傳的上傳作業包含下列高階步驟：

傳送初始要求，並擷取可續傳的工作階段 URI。
上傳資料並監控上傳狀態。
(選用) 如果上傳作業中斷，請繼續上傳。

傳送初始要求

如要啟動支援續傳的上傳作業，請使用 files.create 方法和 uploadType=resumable。

HTTP

向方法的 /upload URI 發出 POST 要求，並加入 uploadType=resumable 查詢參數：

POST https://www.googleapis.com/upload/drive/v3/files?uploadType=resumable

如果啟動要求成功，回應會包含 200 OK HTTP 狀態碼。此外，API 伺服器還會提供指定續傳工作階段 URI 的 Location 標頭：
```
HTTP/1.1 200 OK
Location: https://www.googleapis.com/upload/drive/v3/files?uploadType=resumable&upload_id=xa298sd_sdlkj2
Content-Length: 0
```
儲存續傳工作階段 URI，以便上傳檔案資料及查詢上傳狀態。續傳工作階段 URI 會在一週後失效。

注意： 如要更新現有檔案，請使用 PUT。
如有檔案中繼資料，請以 JSON 格式將中繼資料新增至要求主體。否則，請將要求主體保留空白。
新增下列 HTTP 標頭：
- X-Upload-Content-Type。選用。設定為要在後續要求中移轉的檔案資料 MIME 類型。如果中繼資料或這個標頭未指定資料的 MIME 類型，系統會以 application/octet-stream. 形式提供物件。
- X-Upload-Content-Length。選用。設定為要在後續要求中移轉的檔案資料位元組數。
- Content-Type。如果檔案有中繼資料，則為必填。設為 application/json; charset=UTF-8。
- Content-Length。除非使用區塊傳輸編碼，否則為必填欄位。設定為這項初始要求主體中的位元組數。
傳送要求。如果工作階段啟動要求成功，回應會包含 200 OK HTTP 狀態碼。此外，回應還包含指定可續傳工作階段 URI 的 Location 標頭。使用支援續傳的工作階段 URI 上傳檔案資料，並查詢上傳狀態。續傳工作階段 URI 會在一週後失效。
複製並儲存續傳工作階段網址。
繼續上傳內容。

上傳內容

如要透過可續傳的工作階段上傳檔案，有兩種方式：

在單一要求中上傳內容：如果檔案可在單一要求中上傳、單一要求沒有固定時間限制，或不需要顯示上傳進度指標，請使用這個方法。這種做法最為合適，因為需要的請求較少，成效也較好。
將內容分成多個區塊上傳：如要減少單一要求中傳輸的資料量，請使用這個方法。當個別要求有固定的時間限制時，您可能需要減少傳輸的資料量，對某些類別的 App Engine 要求而言也是如此。如果您必須提供自訂指標來顯示上傳進度，這種做法也很有用。

HTTP - 單一要求

對可續傳的工作階段 URI 建立 PUT 要求。
將檔案資料新增到要求主體。
新增 Content-Length HTTP 標頭，並設為檔案中的位元組數。
傳送要求。如果上傳要求中斷，或是收到 5xx 回應，請按照「繼續執行中斷的上傳作業」一節所述的程序進行。

HTTP - 多個要求

對可續傳的工作階段 URI 建立 PUT 要求。
將區塊的資料新增至要求主體。建立的區塊大小必須是 256 KB 的倍數 (256 x 1024 位元組)，但會完成上傳作業的最後一個區塊除外。請盡可能將區塊設為較大，以保持上傳效率。
新增下列 HTTP 標頭：
- Content-Length：請設定為目前區塊中的位元組數。
- Content-Range：設定要在上傳的檔案中顯示哪些位元組。舉例來說，Content-Range: bytes 0-524287/2000000 代表您要上傳 2,000,000 位元組檔案中的前 524,288 個位元組 (256 x 1024 x 2)。
傳送要求並處理回應。如果上傳要求中斷，或是收到 5xx 回應，請按照「繼續執行中斷的上傳作業」一節所述的程序進行。
針對檔案中剩餘的每個區塊，重複步驟 1 到 4。請使用回應中的 Range 標頭，決定下一個區塊的起始位置。請勿假設伺服器已收到在前一個要求中傳送的所有位元組。

整個檔案上傳完畢後，您會收到 200 OK 或 201 Created 回應，以及與資源相關聯的所有中繼資料。

繼續執行中斷的上傳作業

如果上傳要求在收到回應前就終止，或者您收到 503 Service Unavailable 回應，那麼就需要繼續處理中斷的上傳作業。

HTTP

如要要求上傳狀態，請對可繼續上傳的工作階段 URI 建立空白的 PUT 要求。
新增 Content-Range 標頭，指出目前在檔案中的位置不明。舉例來說，如果檔案總長度為 2,000,000 個位元組，請將 Content-Range 設為 */2000000。如果不知道檔案完整大小，請將 Content-Range 設為 */*。
傳送要求。
處理回應：
- 如果收到 200 OK 或 201 Created 回應，表示上傳作業已完成，不需採取任何行動。
- 308 Resume Incomplete 回應表示您必須繼續上傳檔案。
- 404 Not Found 回應表示上傳工作階段已過期，必須從頭開始上傳。
如果收到 308 Resume Incomplete 回應，請處理回應的 Range 標頭，判斷伺服器已收到哪些位元組。如果回應沒有 Range 標頭，表示尚未收到任何位元組。舉例來說，如果 Range 標頭是 bytes=0-42，代表伺服器已接收到檔案的前 43 個位元組，下一個要上傳的區塊會從第 44 個位元組開始。
既然您已經知道要從哪裡繼續上傳，請從下一個位元組開始繼續上傳檔案。加入 Content-Range 標頭，指出要傳送檔案的哪個部分。舉例來說，Content-Range: bytes 43-1999999 表示您傳送的位元組為 44 到 2,000,000。

處理媒體上傳錯誤

上傳媒體時，請遵循下列最佳做法來處理錯誤：

如果發生 5xx 錯誤，請繼續或重新執行因連線中斷導致失敗的上傳作業。如要進一步瞭解如何處理 5xx 錯誤，請參閱「500、502、503、504 錯誤」一文。
如果發生 403 rate limit 錯誤，請重試上傳。如要進一步瞭解如何處理 403 rate limit 錯誤，請參閱403 錯誤：rateLimitExceeded。
如果可續傳上傳作業期間發生任何 4xx 錯誤 (包括 403)，請重新啟動上傳作業。這類錯誤表示上傳工作階段已過期，必須要求新的工作階段 URI 才能重新啟動。上傳工作階段也會在閒置一週後失效。

匯入 Google 文件類型

在雲端硬碟中建立檔案後，您可能想將檔案轉換為 Google Workspace 檔案類型，例如 Google 文件或試算表。舉例來說，您可能想將慣用文書處理器中的文件轉換為 Google 文件，以便使用 Google 文件的功能。

如要將檔案轉換為特定 Google Workspace 檔案類型，請在建立檔案時指定 Google Workspace mimeType。

以下說明如何將 CSV 檔案轉換為 Google Workspace 試算表：

Java

drive/snippets/drive_v3/src/main/java/UploadWithConversion.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;

/* Class to demonstrate Drive's upload with conversion use-case. */
public class UploadWithConversion {

  /**
   * Upload file with conversion.
   *
   * @return Inserted file id if successful, {@code null} otherwise.
   * @throws IOException if service account credentials file not found.
   */
  public static String uploadWithConversion() 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("My Report");
    fileMetadata.setMimeType("application/vnd.google-apps.spreadsheet");

    java.io.File filePath = new java.io.File("files/report.csv");
    FileContent mediaContent = new FileContent("text/csv", filePath);
    try {
      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 move file: " + e.getDetails());
      throw e;
    }
  }
}

Python

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

前往 GitHub 查看

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


def upload_with_conversion():
  """Upload file with conversion
  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": "My Report",
        "mimeType": "application/vnd.google-apps.spreadsheet",
    }
    media = MediaFileUpload("report.csv", mimetype="text/csv", resumable=True)
    # pylint: disable=maybe-no-member
    file = (
        service.files()
        .create(body=file_metadata, media_body=media, fields="id")
        .execute()
    )
    print(f'File with ID: "{file.get("id")}" has been uploaded.')

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

  return file.get("id")


if __name__ == "__main__":
  upload_with_conversion()

Node.js

drive/snippets/drive_v3/file_snippets/upload_with_conversion.js

前往 GitHub 查看

/**
 * Upload file with conversion
 * @return{obj} file Id
 * */
async function uploadWithConversion() {
  const fs = require('fs');
  const {GoogleAuth} = require('google-auth-library');
  const {google} = require('googleapis');
  // Get credentials and build service
  // TODO (developer) - Use appropriate auth mechanism for your app
  const auth = new GoogleAuth({
    scopes: 'https://www.googleapis.com/auth/drive',
  });
  const service = google.drive({version: 'v3', auth});
  const fileMetadata = {
    name: 'My Report',
    mimeType: 'application/vnd.google-apps.spreadsheet',
  };
  const media = {
    mimeType: 'text/csv',
    body: fs.createReadStream('files/report.csv'),
  };

  try {
    const file = await service.files.create({
      requestBody: fileMetadata,
      media: media,
      fields: 'id',
    });
    console.log('File Id:', file.data.id);
    return file.data.id;
  } catch (err) {
    // TODO(developer) - Handle error
    throw err;
  }
}

PHP

drive/snippets/drive_v3/src/DriveUploadWithConversion.php

前往 GitHub 查看

<?php
use Google\Client;
use Google\Service\Drive;
function uploadWithConversion()
{
    try {
        $client = new Client();
        $client->useApplicationDefaultCredentials();
        $client->addScope(Drive::DRIVE);
        $driveService = new Drive($client);
        $fileMetadata = new Drive\DriveFile(array(
            'name' => 'My Report',
            'mimeType' => 'application/vnd.google-apps.spreadsheet'));
        $content = file_get_contents('../files/report.csv');
        $file = $driveService->files->create($fileMetadata, array(
            'data' => $content,
            'mimeType' => 'text/csv',
            '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/UploadWithConversion.cs

前往 GitHub 查看

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

namespace DriveV3Snippets
{
    // Class to demonstrate Drive's upload with conversion use-case.
    public class UploadWithConversion
    {
        /// <summary>
        /// Upload file with conversion.
        /// </summary>
        /// <param name="filePath">Id of the spreadsheet file.</param>
        /// <returns>Inserted file id if successful, null otherwise.</returns>
        public static string DriveUploadWithConversion(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.Drive);

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

                // Upload file My Report on drive.
                var fileMetadata = new Google.Apis.Drive.v3.Data.File()
                {
                    Name = "My Report",
                    MimeType = "application/vnd.google-apps.spreadsheet"
                };
                FilesResource.CreateMediaUpload request;
                // Create a new drive.
                using (var stream = new FileStream(filePath,
                           FileMode.Open))
                {
                    // Create a new file, with metadata and stream.
                    request = service.Files.Create(
                        fileMetadata, stream, "text/csv");
                    request.Fields = "id";
                    request.Upload();
                }

                var file = request.ResponseBody;
                // Prints the uploaded 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 if (e is FileNotFoundException)
                {
                    Console.WriteLine("File not found");
                }
                else
                {
                    throw;
                }
            }
            return null;
        }
    }
}

如要查看是否有可用的轉換，請在建立檔案前檢查 about 資源的 importFormats 陣列。這個陣列會動態提供支援的轉換。常見的匯入格式包括：

寄件者	收件者
Microsoft Word、OpenDocument 文字檔、HTML、RTF、純文字	Google 文件
Microsoft Excel、OpenDocument 試算表、CSV、TSV、純文字	Google 試算表
Microsoft PowerPoint、OpenDocument 簡報	Google 簡報
JPEG、PNG、GIF、BMP、PDF	Google 文件 (將圖片嵌入文件中)
純文字 (特殊 MIME 類型)、JSON	Google Apps Script

在對 Google 文件、試算表或簡報檔案發出 update 要求時，如果上傳並轉換媒體，系統會取代文件的完整內容。

將圖片轉換為 Google 文件時，雲端硬碟會使用光學字元辨識 (OCR) 技術將圖片轉換為文字。您可以在 ocrLanguage 參數中指定適用的 BCP 47 語言代碼，提升 OCR 演算法的品質。擷取的文字會顯示在 Google 文件中，與內嵌圖片並列。

使用預先產生的 ID 上傳檔案

您可以使用 Drive API 擷取預先產生的檔案 ID 清單，這些 ID 用於上傳及建立資源。上傳和檔案建立要求可以使用這些預先產生的 ID。在檔案中繼資料中設定 id 欄位。

如要建立預先產生的 ID，請呼叫 files.generateIds，並提供要建立的 ID 數量。

如果發生不明伺服器錯誤或逾時，您可以安全地使用預先產生的 ID 重試上傳。如果檔案建立成功，後續重試會傳回 HTTP 409 錯誤，且不會建立重複檔案。

為不明檔案類型定義可建立索引的文字

使用者可以透過雲端硬碟使用者介面尋找文件內容。你也可以使用 files.list 和 fullText 欄位搜尋應用程式中的內容。詳情請參閱「搜尋檔案和資料夾」。

雲端硬碟會自動為文件建立索引，以便搜尋。系統會辨識檔案類型，包括文字文件、PDF、含有文字的圖片和其他常見類型。如果應用程式會儲存其他類型的檔案 (例如繪圖、影片和捷徑)，您可以在檔案的 contentHints.indexableText 欄位中提供可建立索引的文字，提高檔案的曝光度。

如要進一步瞭解可建立索引的文字，請參閱「管理檔案中繼資料」。

上傳檔案資料 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

使用 PATCH 與 PUT

執行簡易上傳作業

HTTP

執行多部分上傳作業

Java

Python

Node.js

PHP

.NET

HTTP

執行支援續傳的上傳作業

傳送初始要求

HTTP

上傳內容

HTTP - 單一要求

HTTP - 多個要求

繼續執行中斷的上傳作業

HTTP

處理媒體上傳錯誤

匯入 Google 文件類型

Java

Python

Node.js

PHP

.NET

使用預先產生的 ID 上傳檔案

為不明檔案類型定義可建立索引的文字

上傳檔案資料

使用 `PATCH` 與 `PUT`