تحميل وسائط
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتيح العديد من طرق واجهة برمجة التطبيقات إمكانية تحميل الوسائط بالإضافة إلى نص عادي.
وفي هذه الحالة، يتم تحميل طريقة الطلب العادية بشكل زائد للحصول على نسخة
Stream للتحميل.
نظرة عامة
يجب استخدام حقل قابل للاستئناف مع أي Stream تريد تحميله.
تحميل الوسائط، الذي يسمح بتحميل مجموعات البث في مجموعات أصغر.
يعد ذلك مفيدًا بشكل خاص إذا كنت تنقل ملفات كبيرة،
واحتمال حدوث انقطاع في الشبكة أو إجراء أي عملية بث أخرى
كان الفشل مرتفعًا.
وقد يقلل أيضًا استخدام معدّل نقل البيانات في حال حدوث مشاكل في الشبكة.
لأنك لست مضطرًا إلى إعادة تشغيل عمليات تحميل الملفات الكبيرة من البداية.
ميزة "تحميل الوسائط القابلة للاستئناف" هي ميزة في مكتبة برامج .NET من Google API
منذ الإصدار 1.2.0 التجريبي.
تحتوي المكتبات الخاصة بواجهة Google API على طرق ملائمة
التفاعل مع هذه الميزة.
يتم وصف بروتوكول تحميل الوسائط القابل للاستئناف، على سبيل المثال، في
صفحة تحميل الوسائط لواجهة برمجة تطبيقات Drive.
الفئة الرئيسية من الاهتمام هي
ResumableUpload
وفي هذه الحالة، يتم تحميل محتوى الوسائط إلى أجزاء.
يبلغ حجم المقطع الافتراضي 10 ميغابايت، ولكن يمكنك تغييره
لضبط السمة ChunkSize في الطلب على أي مضاعفات بحجم 256 كيلوبايت.
في حال مواجهة خطأ في الخادم في أحد الطلبات، سيحدث رقود أسي
يُستخدم لإعادة إرسال وحدات البايت التي لم يتم تحميلها بنجاح.
بشكل تلقائي، يتم تفعيل الرقود الأسي لكل طلب عميل.
يمكنك تغيير السلوك الافتراضي عند إنشاء
عنصر خدمة جديد من خلال تغيير
فندق DefaultExponentialBackOffPolicy على BaseClientService.Initializer
و/أو تعيين
HttpClientInitializer
إلى تنفيذك الخاص لـ IConfigurableHttpClientInitializer
تضيف بعض سياسات التراجع.
يتم تحديد الطرق التي تتيح تحميل الوسائط
في المستندات المرجعية للمستندات الخاصة بواجهة برمجة التطبيقات.
بالنسبة إلى طُرق واجهة برمجة التطبيقات هذه، يُرجى تسهيل استخدام 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");
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eSome API methods allow uploading media using resumable media upload, enabling the transfer of large files in smaller chunks, reducing bandwidth usage, and minimizing interruptions.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eResumableUpload\u003c/code\u003e class facilitates resumable media uploads with a default chunk size of 10MB, adjustable to multiples of 256KB, and includes exponential backoff for error handling.\u003c/p\u003e\n"],["\u003cp\u003eConvenience methods \u003ccode\u003eUpload\u003c/code\u003e and \u003ccode\u003eUploadAsync\u003c/code\u003e are available for API methods supporting media upload, accepting a stream and its content type as parameters, ensuring the stream's position is at 0 to avoid errors.\u003c/p\u003e\n"],["\u003cp\u003eConsider increasing the \u003ccode\u003eHttpClient\u003c/code\u003e timeout property to prevent \u003ccode\u003eTaskCanceledException\u003c/code\u003e during prolonged uploads, as demonstrated in the provided sample code.\u003c/p\u003e\n"],["\u003cp\u003eResumable media upload functionality is accessible through the Google API .NET client library, offering detailed documentation and progress tracking capabilities.\u003c/p\u003e\n"]]],[],null,["# Upload Media\n\nSeveral API methods support uploading media in addition to a regular body.\nIn that case, the regular request method is overloaded to get an additional\n`Stream` to upload.\n\nOverview\n--------\n\n\nFor any `Stream` you wish to upload, you should use resumable\nmedia upload, which allows streams to be uploaded in smaller chunks.\nThis is especially useful if you are transferring large files,\nand the likelihood of a network interruption or some other transmission\nfailure is high.\nIt can also reduce your bandwidth usage in the event of network failures\nbecause you don't have to restart large file uploads from the beginning.\n\nResumableMediaUpload\n--------------------\n\n\nResumable Media Upload has been a feature in the Google API .NET client library\nsince 1.2.0-beta.\nThe Google API-specific libraries contain convenience methods for\ninteracting with this feature.\n\n\nThe resumable media upload protocol is described, for example, on the\n[media upload page for the Drive API](https://developers.google.com/drive/manage-uploads#resumable).\nThe main class of interest is\n[`ResumableUpload`](https://googleapis.dev/dotnet/Google.Apis/latest/api/Google.Apis.Upload.ResumableUpload.html).\nIn this implementation, the media content is uploaded in chunks.\n\n\nThe default chunk size is 10MB, but you can change it by\nsetting the `ChunkSize` property on the request to any multiple of 256KB.\nIf a server error is encountered in a request then exponential backoff\npolicy is used to resend the bytes that were not successfully uploaded.\nBy default, exponential backoff is enabled for each client request.\nYou can change the default behavior when you construct\na new service object by changing the\n[`DefaultExponentialBackOffPolicy`](https://googleapis.dev/dotnet/Google.Apis/latest/api/Google.Apis.Services.BaseClientService.Initializer.html#Google_Apis_Services_BaseClientService_Initializer_DefaultExponentialBackOffPolicy) property on `BaseClientService.Initializer`\nand/or setting the\n[`HttpClientInitializer`](https://googleapis.dev/dotnet/Google.Apis/latest/api/Google.Apis.Services.BaseClientService.Initializer.html#Google_Apis_Services_BaseClientService_Initializer_HttpClientInitializer)\nproperty to your own implementation of `IConfigurableHttpClientInitializer`\nthat adds some backoff policy.\n\n\nThe methods that support media upload are identified\nin the reference documentation for the API-specific documentation.\nFor these API methods, convenience `Upload` and\n`UploadAsync` methods are added.\nThose methods take a `Stream` to upload and its content type as parameters.\n\n\nMake sure that the position of the stream you upload is 0, otherwise you will receive an error, such as\n\"System.InvalidOperationException: The given header was not found\".\n\n\nNote that due to the behavior of the framework's `HttpClient`\nclass, if the upload times out, a `TaskCanceledException` is thrown.\nIf you see this exception, consider manually increasing the `Timeout` property in\nthe client used by your service object.\n\nSample Code\n-----------\n\n```gdscript\n// Create the service using the client credentials.\nvar service = new DriveService(new BaseClientService.Initializer()\n{\n HttpClientInitializer = credential,\n ApplicationName = \"Application_Name\"\n});\n\nusing var uploadStream = System.IO.File.OpenRead(\"Local_File_Name\");\n\n// Create the File resource to upload.\nGoogle.Apis.Drive.v3.Data.File driveFile = new Google.Apis.Drive.v3.Data.File\n{\n Name = \"Drive_File_Name\"\n};\n// Get the media upload request object.\nFilesResource.CreateMediaUpload insertRequest = service.Files.Create(\n driveFile, uploadStream, \"image/jpeg\");\n\n// Add handlers which will be notified on progress changes and upload completion.\n// Notification of progress changed will be invoked when the upload was started,\n// on each upload chunk, and on success or failure.\ninsertRequest.ProgressChanged += Upload_ProgressChanged;\ninsertRequest.ResponseReceived += Upload_ResponseReceived;\n\nawait insertRequest.UploadAsync();\n\nstatic void Upload_ProgressChanged(IUploadProgress progress) =\u003e\n Console.WriteLine(progress.Status + \" \" + progress.BytesSent);\n\nstatic void Upload_ResponseReceived(Google.Apis.Drive.v3.Data.File file) =\u003e\n Console.WriteLine(file.Name + \" was uploaded successfully\");\n```"]]
