Intégration d'Aspose.Slides avec Google Slides

Introduction

Aspose.Slides propose désormais une intégration avec Google Slides et Google Drive via son SaaS Integration API. Cette intégration permet aux applications .NET de convertir, modifier, télécharger et téléverser des présentations Google Slides.

Qu’est‑ce que Google Slides ?

Google Slides est un logiciel de présentation gratuit basé sur le Web, développé par Google. Il permet aux utilisateurs de créer, modifier et partager des présentations de diapositives en ligne, de façon similaire à Microsoft PowerPoint. Il prend en charge la collaboration en temps réel, le stockage cloud et fonctionne sur tout appareil disposant d’un accès Internet.

API Google

Avant de commencer à travailler avec votre présentation Google Slides via Aspose.Slides, vous devez créer un projet Google API et créer un Google Cloud project, puis activer les API souhaitées.

Ensuite, vous devez choisir la méthode d’accès à l’API Google : l’Aspose.Slides Google Integration prend en charge deux façons d’accéder à l’API Google :

Google Service Account
OAuth 2.0 avec interaction utilisateur via un navigateur.

Compte de service Google

Un compte de service est un compte Google spécial utilisé par des applications ou des serveurs pour accéder aux API Google de façon programmatique sans interaction utilisateur. Il est couramment utilisé pour les systèmes back‑end ou les tâches automatisées. Les comptes de service sont authentifiés à l’aide d’un fichier de clé JSON et disposent de leur propre adresse e‑mail. Ils peuvent se voir attribuer des autorisations spécifiques via Google Cloud IAM et sont souvent utilisés avec des API telles que Google Drive, Sheets ou BigQuery pour un accès sécurisé et automatisé aux ressources.

OAuth 2.0

Une autre méthode courante d’accès aux API Google consiste à utiliser OAuth 2.0 avec interaction utilisateur via un navigateur. Dans ce flux, l’utilisateur est redirigé vers une page de connexion Google où il accorde les autorisations à l’application. Après approbation, l’application reçoit un code d’autorisation, qu’elle échange contre un jeton d’accès et un jeton d’actualisation.

Le jeton d’accès permet un accès temporaire aux API Google, tandis que le jeton d’actualisation peut être stocké et réutilisé pour obtenir de nouveaux jetons d’accès sans que l’utilisateur ait besoin de se reconnecter. Cela signifie que l’interaction avec le navigateur n’est requise qu’une seule fois, les accès API suivants étant entièrement automatisés. Cette méthode est généralement utilisée pour les applications qui doivent accéder aux données d’un utilisateur (comme Gmail, Calendar ou Drive) avec le consentement de ce dernier.

Passons au code

Tout d’abord, ajoutez le Aspose.Slides SaaS Integration NuGet package à votre projet :

dotnet add package Aspose.Slides.SaaSIntegrations

Exemple 1

Dans l’exemple suivant, nous téléchargerons une présentation Google Slides depuis Google Drive et l’enregistrerons sur le disque local au format PDF. Nous utiliserons un compte de service Google pour l’autorisation, en supposant que le fichier JSON du compte de service contenant les informations d’identification a déjà été téléchargé.

// Créer un HttpClient géré en externe
HttpClient httpClient = new HttpClient();

// Créer un fournisseur d'autorisation à l'aide d'un fichier JSON de compte de service
IGoogleAuthorizationProvider account = new GoogleServiceAccountAuthProvider(@"service_account_json_file.json", httpClient);

// Initialiser le service d'intégration Google Slides avec le fournisseur d'autorisation
GoogleSlidesIntegration googleSlidesIntegration = new GoogleSlidesIntegration(account, httpClient);

// Charger une présentation depuis Google Drive à l'aide de son ID de fichier dans une instance IPresentation d'Aspose.Slides
using IPresentation pres = await googleSlidesIntegration.LoadPresentationAsync("1A2B3C4D5E6F7G8H9I0J");

// Modifier la présentation si nécessaire (par ex., supprimer la deuxième diapositive)
pres.Slides.RemoveAt(1);

// Enregistrer la présentation localement au format PDF
pres.Save(@"GoogleDriveDownload.pdf", SaveFormat.Pdf);

Pour plus de commodité, Aspose.Slides SaaS Integration fournit une méthode permettant de lister tous les fichiers accessibles à l’utilisateur. Les données retournées comprennent le nom du fichier, le type MIME et l’ID du fichier.

// Obtenir la liste des fichiers disponibles pour le compte de service fourni
var availableFiles = await googleSlidesIntegration.GetDriveFileInfosAsync();

foreach (GoogleDriveFileInfo googleDriveFileInfo in availableFiles)
{
    Console.WriteLine($"File name: {googleDriveFileInfo.Name}, File ID: {googleDriveFileInfo.Id}, MIME type: {googleDriveFileInfo.MimeType}");
}

Une autre façon de trouver l’ID du fichier consiste à ouvrir la présentation dans l’application web Google Slides et à le repérer dans l’URL.

Par exemple, dans l’URL suivante :

https://docs.google.com/presentation/d/1A2B3C4D5E6F7G8H9I0J/edit

L’ID du fichier est :

1A2B3C4D5E6F7G8H9I0J

Exemple 2

Dans l’exemple suivant, nous créerons une présentation PowerPoint à partir de zéro et la téléverserons sur Google Drive au format Google Slides. Pour l’autorisation, nous utiliserons OAuth 2.0.

// Créer un HttpClient géré en externe
HttpClient httpClient = new HttpClient();

// Créer un fournisseur d'autorisation en utilisant OAuth avec l'ID client et le secret client
IGoogleAuthorizationProvider account = new GoogleOAuthProvider("clientId", "clientSecret", httpClient);

// Initialiser le service d'intégration Google Slides avec le fournisseur d'autorisation
GoogleSlidesIntegration googleSlidesIntegration = new GoogleSlidesIntegration(account, httpClient);

// Créer une présentation d'exemple
using (var presentation = new Presentation())
{
    var shape = presentation.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 300, 200);
    shape.TextFrame.Text = "Hello from Google Drive!";
    
    // Enregistrer la présentation dans le dossier racine de Google Drive au format Google Slides
    // Vous pouvez également choisir tout autre format d'exportation pris en charge par Aspose.Slides
    var newFileId = await googleSlidesIntegration.SavePresentationAsync(presentation, "New presentation", GoogleSaveFormatType.GoogleSlides);
    Console.WriteLine($"Uploaded file ID: {newFileId}");
}

Si vous utilisez ce type d’autorisation dans votre application, interaction with the browser is required. Vous devrez sélectionner votre compte et confirmer que vous autorisez l’application à accéder à votre API Google Drive. C’est tout — cette opération n’est requise que lors de la première exécution.

Exemple 3

Dans l’exemple suivant, nous utiliserons un jeton d’accès pré‑obtenu. GoogleAccessTokenAuthProvider est une implémentation de l’interface IGoogleAuthorizationProvider qui utilise un jeton d’accès OAuth 2.0 existant pour autoriser les requêtes aux API Google. Contrairement aux fournisseurs qui initient ou gèrent le flux OAuth, cette classe repose sur l’appelant pour fournir un jeton d’accès valide.

Ce fournisseur est utile dans les systèmes où le jeton d’accès est obtenu à l’extérieur — typiquement par une application front‑end ou un autre service — et transmis au back‑end. Il convient particulièrement aux environnements distribués où la gestion des jetons d’actualisation côté serveur introduit de la complexité ou le risque d’invalidation du jeton en raison de tentatives d’actualisation concurrentes.

Cet exemple montre comment remplacer un fichier et mettre à jour son nom sur Google Drive tout en conservant son ID de fichier.

// Créer un client HTTP pour effectuer des requêtes
using HttpClient httpClient = new HttpClient();

// Configurer l'authentification Google Drive avec un jeton d'accès
GoogleAccessTokenAuthProvider accessTokenAuthProvider = new GoogleAccessTokenAuthProvider("access_token");

// Initialiser l'intégration avec Google Slides/Drive en utilisant l'authentification et le client HTTP
GoogleSlidesIntegration googleSlidesIntegration =
    new GoogleSlidesIntegration(accessTokenAuthProvider, httpClient);

// Create a sample presentation using Aspose.Slides
using (var presentation = new Presentation())
{
    // Ajouter une forme rectangle à la première diapositive et définir son texte
    var shape = presentation.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 300, 200);
    shape.TextFrame.Text = "Hello from Google Drive!";

    // Définir les options d'enregistrement PDF avec des paramètres de qualité et de conformité spécifiques
    ISaveOptions saveOptions = new PdfOptions()
    {
        JpegQuality = 50,
        Compliance = PdfCompliance.PdfA1b
    };

    // Enregistrer (remplacer) le fichier existant sur Google Drive par ID de fichier, mettre à jour son nom et exporter en PDF
    await googleSlidesIntegration.SavePresentationToExistingFileAsync(
        presentation,
        "1A2B3C4D5E6F7G8H9I0J",            // ID du fichier existant sur Google Drive
        GoogleSaveFormatType.Pdf,         // Format souhaité pour l'enregistrement
        saveOptions,           
        "NewFileName.pdf"                 // Nouveau nom à attribuer au fichier
    );
}

Résumé

Aspose.Slides prend désormais en charge un format de fichier supplémentaire pour la gestion, simplifiant l’automatisation des flux de travail cloud pour la création, le partage et la modification de présentations.

Cet article a couvert les fonctionnalités de base. Vous pouvez également enregistrer des fichiers dans des sous‑dossiers, remplacer des fichiers existants et exporter vers Google Drive dans divers formats — pas uniquement des présentations Google Slides.

Aspose.Slides SaaS Integration continuera d’élargir la prise en charge des plateformes SaaS de présentation, alors revenez régulièrement pour les futures mises à jour.

FAQ

Do I need a Google Workspace account to use this integration?
Non. Vous pouvez utiliser soit un compte Google gratuit, soit un compte Google Workspace. L’accès requis dépend de vos autorisations sur Google Drive et Slides.

Which authentication method should I choose—Service Account or OAuth 2.0?
Utilisez un Service Account pour les flux back‑end ou automatisés sans interaction utilisateur.
Utilisez OAuth 2.0 si vous devez accéder aux fichiers Google Slides ou Drive d’un utilisateur spécifique avec son consentement.

Can I work with formats other than Google Slides?
Oui. Aspose.Slides permet d’enregistrer des présentations dans divers formats (par ex., PDF, PPTX, HTML) avant de les téléverser sur Google Drive.

How can I get the file ID of a Google Slides presentation?
Vous pouvez le récupérer à l’aide de la méthode GetDriveFileInfosAsync() ou en le copiant depuis l’URL de la présentation dans Google Slides.

Does the integration support replacing an existing file on Google Drive?
Oui. Utilisez la méthode SavePresentationToExistingFileAsync pour mettre à jour un fichier tout en conservant son ID.

Is browser interaction required every time when using OAuth 2.0?
Non. L’interaction avec le navigateur n’est requise que lors de la première autorisation. Par la suite, les jetons d’actualisation stockés permettent un accès automatisé.

Extraction de texte depuis PPT, PPTX, ODP