ファイル データをアップロードする

Google Drive API を使用すると、File の作成または更新時にファイルデータをアップロードできます。メタデータのみのファイル(フォルダなど)を作成する方法については、メタデータのみのファイルを作成するをご覧ください。

実行できるアップロードには次の 3 種類があります。

  • シンプル アップロード(uploadType=media: このアップロード タイプを使用して、メタデータを指定せずに小さなメディア ファイル(5 MB 以下)を転送します。単純なアップロードを実行するには、単純なアップロードを実行するをご覧ください。

  • マルチパート アップロード(uploadType=multipart: 「このアップロード タイプを使用すると、サイズの小さいファイル(5 MB 以下)と、そのファイルを記述するメタデータを 1 回のリクエストで転送できます。マルチパート アップロードを実行するには、マルチパート アップロードの実行をご覧ください。

  • 再開可能なアップロード(uploadType=resumable: このアップロード タイプは、サイズの大きなファイル(5 MB 超)や、モバイルアプリからファイルを作成する場合など、ネットワークが中断される可能性が高い場合に使用します。ほとんどのアプリケーションに適しています。小さなファイルでも、アップロードごとに HTTP リクエストを 1 回追加するだけで機能するため、再開可能なアップロードが適しています。再開可能なアップロードを実行するには、再開可能なアップロードを実行するをご覧ください。

Google API クライアント ライブラリは、これらのアップロード タイプの少なくとも 1 つを実装しています。各タイプの使用方法について詳しくは、クライアント ライブラリのドキュメントをご覧ください。

PATCHPUT の使用

なお、HTTP 動詞 PATCH はファイル リソースの部分更新をサポートし、HTTP 動詞 PUT はリソースの完全な置換をサポートします。PUT を使用すると、既存のリソースに新しいフィールドを追加するときに破壊的変更が発生する可能性があります。

ファイル リソースをアップロードする際は、次のガイドラインに沿って行ってください。

  • 再開可能なアップロードの最初のリクエスト、または単純なアップロードまたはマルチパート アップロードの唯一のリクエストには、API リファレンスに記載されている HTTP 動詞を使用します。
  • リクエストが開始されたら、再開可能なアップロードの以降のすべてのリクエストに PUT を使用します。これらのリクエストでは、呼び出されたメソッドに関係なくコンテンツがアップロードされます。

シンプル アップロードを実行する

単純なアップロードを実行するには、uploadType=mediafiles.create メソッドを使用します。

シンプル アップロードの実行方法は次のとおりです。

HTTP

  1. クエリ パラメータ uploadType=media を使用して、メソッドの /upload URI に対する POST リクエストを作成します。

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

  2. ファイルのデータをリクエストの本文に追加します。

  3. 次の HTTP ヘッダーを追加します。

    • Content-Type。アップロードされるオブジェクトの MIME メディア タイプに設定します。
    • Content-Length: アップロードするバイト数に設定します。チャンク形式転送エンコードを使用する場合、このヘッダーは必要ありません。
  4. リクエストを送信します。 リクエストが成功すると、サーバーは HTTP 200 OK ステータス コードとファイルのメタデータを返します。{HTTP}

単純なアップロードを行うと、基本的なメタデータが作成され、MIME タイプや modifiedTime などの一部の属性がファイルから推測されます。ファイルが小さく、ファイルのメタデータが重要でない場合は、シンプルなアップロードを使用できます。

マルチパート アップロードを実行する

マルチパート アップロード リクエストを使用すると、同じリクエストでメタデータとデータをアップロードできます。このオプションは、送信するデータが小さく、接続が失敗したときにデータ全体を再アップロードできる場合に使用します。

マルチパート アップロードを実行するには、uploadType=multipartfiles.create メソッドを使用します。

マルチパート アップロードを実行する方法は次のとおりです。

Java

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

  1. uploadType=multipart のクエリ パラメータを使用して、メソッドの /upload URI への POST リクエストを作成します。

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

  2. リクエストの本文を作成します。multipart/related コンテンツ タイプ RFC 2387 に従って本文をフォーマットします。このコンテンツ タイプには次の 2 つの部分があります。

    • メタデータ。メタデータが先頭に配置され、Content-Type ヘッダーが application/json; charset=UTF-8 に設定されている必要があります。ファイルのメタデータを JSON 形式で追加します。
    • メディア。メディアは 2 番目に来て、任意の MIME タイプの Content-Type ヘッダーを持つ必要があります。ファイルのデータをメディア部分に追加します。

    最初の境界文字列の前に 2 個のハイフンを付けて、各部分を区別します。さらに、最後の境界文字列の後に 2 個のハイフンを追加します。

  3. 次のトップレベルの HTTP ヘッダーを追加します。

    • Content-Typemultipart/related に設定し、リクエストの各部分の識別に使用する境界文字列を含めます。例: Content-Type: multipart/related; boundary=foo_bar_baz
    • Content-Length: リクエスト本文の総バイト数に設定します。
  4. リクエストを送信します。

関連するデータなしでメタデータ部分のみを作成または更新するには、POST リクエストまたは PATCH リクエストを標準リソース エンドポイント(https://www.googleapis.com/drive/v3/files)に送信します。リクエストが成功すると、サーバーから HTTP 200 OK ステータス コードとファイルのメタデータが返されます。

ファイルを作成する場合は、ファイルの name フィールドにファイル拡張子を指定する必要があります。たとえば、写真の JPEG ファイルを作成する場合は、メタデータに "name": "photo.jpg" のような値を指定します。その後の files.get の呼び出しでは、name フィールドで最初に指定された拡張を含む読み取り専用の fileExtension プロパティが返されます。

再開可能なアップロードを実行する

再開可能なアップロードを使用すると、通信障害でデータフローが中断した後にアップロード オペレーションを再開できます。大きなファイルのアップロードを最初からやり直す必要がないため、再開可能なアップロードでネットワーク障害が発生した場合に帯域幅の使用量を削減することもできます。

再開可能なアップロードは、ファイルサイズが大きく変動する場合や、リクエスト(モバイル OS のバックグラウンド タスクや特定の App Engine リクエストなど)に一定の制限時間がある場合に役立ちます。アップロードの進行状況バーを表示する必要がある場合は、再開可能なアップロードを使用することもできます。

再開可能なアップロードは、次の大まかな手順で構成されています。

  1. 最初のリクエストを送信して、再開可能なセッション URI を取得します。
  2. データをアップロードし、アップロードのステータスをモニタリングします。
  3. (省略可)アップロードが中断された場合は、アップロードを再開します。

最初のリクエストを送信する

再開可能なアップロードを開始するには、uploadType=resumablefiles.create メソッドを使用します。

HTTP

  1. クエリ パラメータ uploadType=resumable を使用して、メソッドの /upload URI に対する POST リクエストを作成します。

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

    開始リクエストが成功すると、200 OK HTTP ステータス コードが返されます。また、再開可能なセッション 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 は 1 週間後に期限切れになります。

  2. ファイルにメタデータがある場合には、リクエストの本文に JSON 形式でメタデータを追加します。それ以外の場合には、リクエストの本文は空にしておきます。

  3. 次の HTTP ヘッダーを追加します。

    • X-Upload-Content-Type。省略できます。ファイルデータの MIME タイプに設定します。これは、後続のリクエストで転送されます。メタデータで、またはこのヘッダーを介してデータの MIME タイプが指定されていない場合、オブジェクトは application/octet-stream. として提供されます。
    • X-Upload-Content-Length。省略できます。後続のリクエストで転送されるファイルデータのバイト数に設定します。
    • Content-Type。ファイルにメタデータがある場合には必須です。application/json; charset=UTF-8 に設定します。
    • Content-Length。チャンク転送エンコードを使用しない場合は必須です。この開始リクエスト本文のバイト数を設定します。
  4. リクエストを送信します。 セッション開始リクエストが成功すると、レスポンスには 200 OK HTTP ステータス コードが含まれます。また、レスポンスには、再開可能なセッション URI を指定した Location ヘッダーも含まれます。再開可能なセッション URI を使用してファイルデータをアップロードし、アップロード ステータスを確認します。再開可能なセッションの URI は 1 週間後に期限切れになります。

  5. 再開可能なセッションの URL をコピーして保存します。

  6. コンテンツをアップロードに進みます。

コンテンツをアップロードする

再開可能なセッションでファイルをアップロードするには、2 つの方法があります。

  • 1 つのリクエストでコンテンツをアップロードする: 1 つのリクエストでファイルをアップロードできる場合、1 つのリクエストに固定された時間制限がない場合は、この方法を使用します。アップロードの進行状況インジケーターを表示する必要がない場合は、この方法を使用します。この方法は、リクエスト数が少なく、パフォーマンスが向上するため、最適です。
  • コンテンツを複数のチャンクでアップロードする: 1 つのリクエストで転送されるデータ量を削減する必要がある場合は、この方法を使用します。App Engine リクエストの特定のクラスなど、リクエストごとに一定の時間制限がある場合は、転送されるデータ量を減らす必要があります。このアプローチは、アップロードの進行状況を示すカスタム インジケーターを指定する必要がある場合にも便利です。

HTTP - 単一リクエスト

  1. 再開可能なセッションの URI に PUT リクエストを作成します。
  2. ファイルのデータをリクエストの本文に追加します。
  3. Content-Length HTTP ヘッダーを追加し、ファイルのバイト数に設定します。
  4. リクエストを送信します。 アップロード リクエストが中断された場合、または 5xx レスポンスを受信したら、中断されたアップロードを再開するの手順に沿って対応してください。

HTTP - 複数のリクエスト

  1. 再開可能なセッションの URI に PUT リクエストを作成します。

  2. リクエストの本文にチャンクのデータを追加します。サイズが 256 KB(256 x 1,024 バイト)の倍数になるようにチャンクを作成します(アップロードを完了する最後のチャックは除く)。アップロードを効率的に行うため、チャンクサイズはできるだけ大きくしてください。

  3. 次の HTTP ヘッダーを追加します。

    • Content-Length。現在のチャンクのバイト数を設定します。
    • Content-Range。アップロードするファイルの何バイト目から何バイト目までを設定します。たとえば、Content-Range: bytes 0-524287/2000000 は、2, 000,000 バイトのファイルで先頭の 524,288 バイト(256 x 1,024 x 2)をアップロードすることを意味します。
  4. リクエストを送信してレスポンスを処理します。アップロード リクエストが中断された場合、または 5xx レスポンスを受信したら、中断されたアップロードを再開するの手順に沿って対応してください。

  5. ファイルに残っているチャンクごとに手順 1 ~ 4 を繰り返します。レスポンスの Range ヘッダーを使用して、次のチャンクの開始位置を決定します。前のリクエストで送信したデータがすべてサーバーで受信されているとは限りません。

ファイル全体のアップロードが完了すると、200 OK または 201 Created レスポンスと、リソースに関連付けられたメタデータが返されます。

中断されたアップロードを再開する

レスポンスを受信する前にアップロード リクエストが終了した場合や、503 Service Unavailable レスポンスを受け取った場合は、中断されたアップロードを再開する必要があります。

HTTP

  1. アップロードのステータスを取得するため、再開可能なセッションの URI に空の PUT リクエストを作成します。

  2. ファイルの現在の位置が不明であることを示す Content-Range ヘッダーを追加します。たとえば、ファイルの合計サイズが 2,000,000 バイトの場合は、Content-Range*/2000000 に設定します。ファイル全体のサイズがわからない場合は、Content-Range*/* に設定します。

  3. リクエストを送信します。

  4. レスポンスを処理します。

    • 200 OK または 201 Created が返された場合、アップロードは完了しています。これ以上の操作は必要ありません。
    • 308 Resume Incomplete が返された場合、ファイルのアップロードを続行する必要があります。
    • 404 Not Found が返された場合、アップロード セッションが期限切れになり、アップロードを最初からやり直す必要があります。
  5. 308 Resume Incomplete レスポンスを受け取った場合は、レスポンスの Range ヘッダーを処理して、サーバーが受信したバイト数を特定します。レスポンスに Range ヘッダーがない場合、バイトは受信されていません。たとえば、Range ヘッダーが bytes=0-42 の場合、ファイルの最初の 43 バイトが受信され、次にアップロードするチャンクがバイト 44 から始まります。

  6. アップロードを再開する場所がわかったので、次のバイトからファイルのアップロードを続行します。送信するファイルの部分を示す 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 をリクエストして再開する必要があることを示します。アップロード セッションも、使用しない状態が 1 週間続くと期限切れになります。

Google ドキュメントの種類にインポート

ドライブでファイルを作成するときに、そのファイルを Google Workspace のファイル形式(Google ドキュメントやスプレッドシートなど)に変換できます。たとえば、お気に入りのワード プロセッサのドキュメントを Google ドキュメントに変換して、その機能を活用したい場合があります。

ファイルを特定の Google Workspace ファイル形式に変換するには、ファイルの作成時に Google Workspace の mimeType を指定します。

次の手順では、CSV ファイルを Google Workspace シートに変換する方法について説明します。

Java

drive/snippets/drive_v3/src/main/java/UploadWithConversion.java
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
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
/**
 * 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
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
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 配列を確認します。サポートされているコンバージョンは、この配列で動的に使用できます。一般的なインポート形式は次のとおりです。

From終了日
Microsoft Word、OpenDocument Text、HTML、RTF、書式なしテキストGoogle ドキュメント
Microsoft Excel、OpenDocument スプレッドシート、CSV、TSV、書式なしテキストGoogle スプレッドシート
Microsoft PowerPoint、OpenDocument プレゼンテーションGoogle スライド
JPEG、PNG、GIF、BMP、PDFGoogle ドキュメント(ドキュメントに画像を埋め込む)
プレーンテキスト(特別な MIME タイプ)、JSONGoogle Apps Script

update リクエスト中にドキュメント、スプレッドシート、スライドのファイルにメディアをアップロードして変換すると、ドキュメントのコンテンツ全体が置き換えられます。

画像をドキュメントに変換すると、ドライブは光学式文字認識(OCR)を使用して画像をテキストに変換します。ocrLanguage パラメータで該当する BCP 47 言語コードを指定すると、OCR アルゴリズムの品質を向上させることができます。抽出されたテキストが、埋め込まれた画像の横にドキュメントに表示されます。

事前に生成された ID を使用してファイルをアップロードする

Drive API を使用すると、リソースのアップロードと作成に使用される、事前に生成されたファイル ID のリストを取得できます。アップロード リクエストとファイル作成リクエストでは、これらの事前生成された ID を使用できます。ファイル メタデータの id フィールドを設定します。

事前生成された ID を作成するには、作成する ID の数を指定して files.generateIds を呼び出します。

サーバーエラーやタイムアウトが原因で原因が特定できない場合は、事前に生成された ID を使用してアップロードを安全に再試行できます。ファイルが正常に作成された場合、その後の再試行は HTTP 409 エラーを返します。重複するファイルは作成されません。

不明なファイル形式のインデックス登録テキストを定義する

ユーザーはドライブの UI を使用してドキュメント コンテンツを見つけることができます。files.list フィールドと fullText フィールドを使用してアプリのコンテンツを検索することもできます。詳しくは、ファイルとフォルダを検索するをご覧ください。

ドライブは、テキスト ドキュメント、PDF、テキスト付きの画像、その他の一般的な形式のファイル形式を認識すると、検索対象のドキュメントを自動的にインデックスに登録します。アプリが他の種類のファイル(描画、動画、ショートカットなど)を保存する場合は、ファイルの contentHints.indexableText フィールドにインデックス登録可能なテキストを指定することで、検出可能性を高めることができます。

インデックス登録可能なテキストの詳細については、ファイル メタデータを管理するをご覧ください。