Importer du contenu multimédia

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