הורדת מדיה שניתנת לחידוש היא תכונה בספריית הלקוח .NET של Google API מגרסת בטא 1.4.0. הספריות הספציפיות ל-Google API מכילות שיטות נוחות לאינטראקציה עם התכונה הזו.
הפרוטוקול להורדת מדיה שניתן לחידוש, דומה לפרוטוקול של העלאת מדיה שניתן לחידוש, שמתואר למשל בדף העלאת המדיה עבור ה-API של Drive.
המחלקה העיקרית שמעניינת אותך היא
MediaDownloader
.
ביישום זה של הורדת מדיה שניתנת לחידוש, תוכן המדיה מורד במקטעים (גודל הגוש ניתן להגדרה).
קוד לדוגמה
אם שיטות בספריות ספציפיות ל-API מכילות את הפרמטר "supportsMediaDownload
" במסמך Discovery,
שיטות הנוחות Download
ו-DownloadAsync
זמינות במחלקה של הבקשה.
השיטות האלה מורידות את נתוני המדיה לאובייקט Stream
שאתם מספקים. לדוגמה:
{ // Create the service using the client credentials. var storageService = new StorageService(new BaseClientService.Initializer() { HttpClientInitializer = credential, ApplicationName = "APP_NAME_HERE" }); // Get the client request object for the bucket and desired object. var getRequest = storageService.Objects.Get("BUCKET_HERE", "OBJECT_HERE"); using (var fileStream = new System.IO.FileStream( "FILE_PATH_HERE", System.IO.FileMode.Create, System.IO.FileAccess.Write)) { // Add a handler which will be notified on progress changes. // It will notify on each chunk download and when the // download is completed or failed. getRequest.MediaDownloader.ProgressChanged += Download_ProgressChanged; getRequest.Download(fileStream); } } static void Download_ProgressChanged(IDownloadProgress progress) { Console.WriteLine(progress.Status + " " + progress.BytesDownloaded); }