Plusieurs méthodes d'API permettent d'importer des contenus multimédias en plus d'un corps standard.
Dans ce cas, la méthode de requête standard est surchargée pour obtenir une valeur
Stream
à importer.
Présentation
Pour chaque Stream
que vous souhaitez importer, vous devez utiliser l'option avec reprise
l'importation de médias, qui permet d'importer
des flux en plus petits morceaux.
Cela est particulièrement utile si vous
transférez des fichiers volumineux,
et la probabilité d'une interruption
du réseau ou d'une autre transmission
le taux d'échec est élevé.
Cela peut également réduire l'utilisation de la bande passante en cas de défaillance du réseau.
car vous n'avez pas besoin de redémarrer
les importations de fichiers volumineux depuis le début.
ResumableMediaUpload
L'importation de fichiers multimédias avec reprise était une fonctionnalité de la bibliothèque cliente .NET des API Google. depuis la version 1.2.0-beta. Les bibliothèques spécifiques à l'API Google contiennent des méthodes pratiques pour interagir avec cette fonctionnalité.
Le protocole d'importation de supports avec reprise est décrit, par exemple, sur le
page d'importation de contenu multimédia pour l'API Drive.
La principale catégorie d'intérêt est
ResumableUpload
Dans cette implémentation, le contenu multimédia est importé par fragments.
La taille de bloc par défaut est de 10 Mo, mais vous pouvez la modifier en définissant la propriété ChunkSize
sur la requête sur un multiple de 256 Ko.
Si une erreur de serveur est détectée dans une requête, la stratégie d'intervalle exponentiel entre les tentatives est utilisée pour renvoyer les octets qui n'ont pas été importés.
Par défaut, l'intervalle exponentiel entre les tentatives est activé pour chaque requête client.
Vous pouvez modifier le comportement par défaut lorsque vous créez un objet de service en modifiant la propriété DefaultExponentialBackOffPolicy
sur BaseClientService.Initializer
et/ou en définissant la propriété HttpClientInitializer
sur votre propre implémentation de IConfigurableHttpClientInitializer
qui ajoute une stratégie de délai avant réessai.
Les méthodes compatibles avec l'importation de médias sont identifiées dans la documentation de référence de la documentation spécifique à l'API.
Pour ces méthodes d'API, les options Upload
et
Ajout de méthodes UploadAsync
.
Ces méthodes prennent un Stream
à importer et son type de contenu comme paramètres.
Assurez-vous que la position du flux que vous importez est 0. Sinon, un message d'erreur s'affiche, par exemple "System.InvalidOperationException: The given header was not found".
Notez qu'en raison du comportement de la classe HttpClient
du framework, si l'importation expire, une exception TaskCanceledException
est générée.
Si cette exception s'affiche, envisagez d'augmenter manuellement la propriété Timeout
dans
au client utilisé par votre objet de service.
Exemple de code
// 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");