上传媒体

除了常规正文之外，一些 API 方法还支持上传媒体内容。 在这种情况下，常规请求方法会过载，以获取额外的 Stream即可上传。

概览

对于您要上传的任何 Stream，您都应使用可续传 媒体上传，允许以较小的数据块上传视频流。 如果您要传输大型文件 以及出现网络中断或其他情况 也会很低 还可以减少网络故障时对带宽的占用 因为您不必从头开始重新上传大型文件。

ResumableMediaUpload

可续传媒体上传是 Google API .NET 客户端库中的一项功能 从 1.2.0-beta 开始。 Google API 特定的库包含 此功能的交互方式。

例如， Drive API 的媒体上传页面。 感兴趣的主要类是 ResumableUpload。 在此实现中，媒体内容以数据块的形式上传。

默认数据块大小为 10MB，但您可以通过 将请求中的 ChunkSize 属性设置为 256KB 的任意倍数。 如果请求遇到服务器错误，则使用指数退避算法 政策用于重新发送未成功上传的字节。 默认情况下，系统会为每个客户端请求启用指数退避算法。 您可以在构建 创建新的 Service 对象 <ph type="x-smartling-placeholder"></ph> BaseClientService.Initializer上的DefaultExponentialBackOffPolicy房源 和/或设置 HttpClientInitializer 属性添加到您自己的 IConfigurableHttpClientInitializer 实现中 添加了一些退避政策

明确了支持媒体上传的方法 。 对于这些 API 方法，使用 Upload 和 添加了 UploadAsync 方法。 这些方法接受上传 Stream 及其内容类型作为参数。

请确保您上传的信息流的位置为 0，否则您会收到错误消息，例如 “System.InvalidOperationException：未找到指定的标头”。

请注意，由于框架的 HttpClient 的行为， 类，如果上传超时，则会抛出 TaskCanceledException。 如果您看到此异常，请考虑手动增加 Timeout 属性， 您的服务对象使用的客户端。

示例代码

// 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");