Upload Media

Beberapa metode API mendukung upload media selain isi biasa. Dalam hal ini, metode permintaan reguler kelebihan beban untuk mendapatkan Stream untuk diupload.

Ringkasan

Untuk setiap Stream yang ingin diupload, Anda harus menggunakan resumable upload media, yang memungkinkan {i>stream<i} diupload dalam potongan yang lebih kecil. Ini sangat berguna jika Anda mentransfer file besar, dan kemungkinan gangguan jaringan atau beberapa transmisi lainnya tingkat kegagalannya tinggi. Hal ini juga dapat mengurangi penggunaan {i>bandwidth<i} Anda jika terjadi kegagalan jaringan karena Anda tidak perlu memulai ulang pengunggahan file berukuran besar dari awal.

ResumableMediaUpload

Upload Media yang Dapat Dilanjutkan telah menjadi fitur di library klien .NET Google API sejak versi 1.2.0-beta. Library khusus Google API berisi metode praktis untuk berinteraksi dengan fitur ini.

Protokol upload media yang dapat dilanjutkan dijelaskan, misalnya, di halaman upload media untuk Drive API. Kelas utama yang diminati adalah ResumableUpload Dalam implementasi ini, konten media diupload dalam potongan-potongan.

Ukuran {i>default<i} untuk potongan adalah 10 MB, tetapi Anda dapat mengubahnya dengan menyetel properti ChunkSize pada permintaan ke kelipatan 256 KB. Jika terjadi error server dalam permintaan, maka backoff eksponensial kebijakan digunakan untuk mengirim ulang byte yang tidak berhasil diupload. Secara default, backoff eksponensial diaktifkan untuk setiap permintaan klien. Anda dapat mengubah perilaku {i>default<i} saat Anda membuat objek layanan baru dengan mengubah Properti DefaultExponentialBackOffPolicy di BaseClientService.Initializer dan/atau menetapkan HttpClientInitializer properti ke implementasi IConfigurableHttpClientInitializer Anda sendiri yang menambahkan beberapa kebijakan backoff.

Metode yang mendukung upload media diidentifikasi dalam dokumentasi referensi untuk dokumentasi khusus API. Untuk metode API ini, kemudahan Upload dan Metode UploadAsync ditambahkan. Metode tersebut menggunakan Stream untuk diupload dan jenis kontennya sebagai parameter.

Pastikan posisi streaming yang Anda upload adalah 0. Jika tidak, Anda akan menerima error, seperti "System.InvalidOperationException: Header yang diberikan tidak ditemukan".

Perlu diperhatikan bahwa karena perilaku HttpClient framework jika waktu upload habis, TaskCanceledException akan ditampilkan. Jika Anda melihat pengecualian ini, pertimbangkan untuk meningkatkan properti Timeout secara manual di klien yang digunakan oleh objek layanan Anda.

Kode Contoh

// Create the service using the client credentials.
var service = new DriveService(new BaseClientService.Initializer()
{
    HttpClientInitializer = credential,
    ApplicationName = "Application_Name"
});

using var uploadStream = System.IO.File.OpenRead("Local_File_Name");

// Create the File resource to upload.
Google.Apis.Drive.v3.Data.File driveFile = new Google.Apis.Drive.v3.Data.File
{
    Name = "Drive_File_Name"
};
// Get the media upload request object.
FilesResource.CreateMediaUpload insertRequest = service.Files.Create(
    driveFile, uploadStream, "image/jpeg");

// Add handlers which will be notified on progress changes and upload completion.
// Notification of progress changed will be invoked when the upload was started,
// on each upload chunk, and on success or failure.
insertRequest.ProgressChanged += Upload_ProgressChanged;
insertRequest.ResponseReceived += Upload_ResponseReceived;

await insertRequest.UploadAsync();

static void Upload_ProgressChanged(IUploadProgress progress) =>
    Console.WriteLine(progress.Status + " " + progress.BytesSent);

static void Upload_ResponseReceived(Google.Apis.Drive.v3.Data.File file) =>
    Console.WriteLine(file.Name + " was uploaded successfully");