Upload Media

Selain metode biasa, beberapa metode API mendukung upload media. Dalam hal ini, metode permintaan reguler kelebihan beban untuk mendapatkan Stream tambahan untuk diupload.

Ringkasan

Untuk Stream yang ingin diupload, Anda harus menggunakan upload media yang dapat dilanjutkan, yang memungkinkan streaming diupload dalam potongan yang lebih kecil. Hal ini sangat berguna jika Anda mentransfer file besar, dan kemungkinan gangguan jaringan atau beberapa kegagalan transmisi lainnya cukup tinggi. Pilihan ini juga dapat mengurangi penggunaan bandwidth jika terjadi kegagalan jaringan, karena Anda tidak perlu memulai ulang upload file besar dari awal.

UploadDapat Dilanjutkan

Media Resumable telah menjadi fitur yang ada 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. Class utama yang menarik adalah ResumableUpload. Dalam implementasi ini, konten media diupload dalam potongan.

Ukuran potongan default adalah 10 MB, tetapi Anda dapat mengubahnya dengan mengatur properti ChunkSize pada permintaan ke kelipatan 256 KB. Jika terjadi error server dalam permintaan, kebijakan backoff eksponensial akan digunakan untuk mengirim ulang byte yang tidak berhasil diupload. Secara default, backoff eksponensial diaktifkan untuk setiap permintaan klien. Anda dapat mengubah perilaku default saat membuat objek layanan baru dengan mengubah properti DefaultExponentialBackOffPolicy di BaseClientService.Initializer dan/atau menetapkan properti HttpClientInitializer 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, metode Upload dan UploadAsync yang praktis akan ditambahkan. Metode tersebut memerlukan 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".

Perhatikan bahwa karena perilaku class HttpClient framework, jika waktu upload habis, TaskCanceledException akan ditampilkan. Jika melihat pengecualian ini, sebaiknya tingkatkan 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");