csharp ppt editing on Document Processing REST APIs | GroupDocs Cloud https://blog-qa.groupdocs.cloud/ja/tag/csharp-ppt-editing/ Recent content in csharp ppt editing on Document Processing REST APIs | GroupDocs Cloud Hugo -- gohugo.io ja Wed, 09 Sep 2026 12:31:52 +0000 C#でPowerPointプレゼンテーションを編集する https://blog-qa.groupdocs.cloud/ja/editor/edit-powerpoint-presentations-in-csharp/ Wed, 09 Sep 2026 12:31:52 +0000 https://blog-qa.groupdocs.cloud/ja/editor/edit-powerpoint-presentations-in-csharp/ C# を使用して GroupDocs.Editor Cloud SDK for .NET で PowerPoint プレゼンテーションを編集します。このガイドでは、セットアップ、コードの実行、cURL REST 呼び出し、およびスライド編集の調整について説明します。 C# で PowerPoint プレゼンテーションを編集することは、動的なスライドデッキを構築する開発者にとって頻繁なニーズです。 GroupDocs.Editor Cloud SDK for .NET は、.NET アプリケーションから直接 PPTX ファイルを変更できる強力な API を提供します。本ガイドでは、SDK のセットアップ方法、プレースホルダー テキストの置換、編集操作の実行、オプションの微調整方法を学び、完全なコードサンプルと対応する cURL REST ワークフローも確認できます。

C# における PowerPoint 自動化に必要なもの

企業は、タイトル、サブタイトル、またはデータフィールドを自動的に更新する必要があるテンプレートからスライドデッキを生成することがよくあります。堅牢なソリューションに必要な要件は次のとおりです：

  • PPTX ファイル内の特定のテキスト文字列を検索して置換する機能。
  • オフィスをインストールせずに、任意のサーバーでコードを実行できるクラウドベースの処理をサポート。
  • 明確なエラーハンドリングと、入力および出力パスの簡単な構成。

手動で編集したり、汎用的なファイルシステムスクリプトを使用したりしても、特にコンテンツが頻繁に変更される場合、数十のプレゼンテーション全体で一貫性を保証することはできません。

アプローチ: クラウドベースのPowerPoint編集

GroupDocs.Editor Cloud SDK for .NET は、これらのニーズに対応するために、完全にクラウド上で動作するREST駆動型APIを提供します。主な機能は次のとおりです：

  • EditDocument - PPTX ファイル全体をダウンロードせずに、テキスト、画像、または図形を置換します。
  • FileInfo - GroupDocs Cloud ストレージに保存されているソース ファイルを指定します。
  • EditDocumentOptions - 出力先とテキスト置換のリストを定義します。

SDKは認証、ファイルストリーミング、フォーマット保持編集を処理し、ビジネスロジックに集中できるようにします。詳細なドキュメントは公式ドキュメントで利用できます。

C# と GroupDocs.Editor Cloud を使用した PowerPoint プレゼンテーションの編集実装

以下はステップバイステップのウォークスルーです。各ステップには、完全な例から直接取得した短いコード抜粋が含まれています。

SDK をインストールし、NuGet パッケージを追加する

まず、ライブラリをプロジェクトに追加します。

dotnet add package GroupDocs.editor-Cloud

最新リリースはダウンロードページからもダウンロードできます。

API資格情報の構成

クライアントIDとシークレットを使用して Configuration オブジェクトを作成します。

var config = new Configuration
{
    ClientId = "YOUR_CLIENT_ID",
    ClientSecret = "YOUR_CLIENT_SECRET"
};

Configuration クラスは API リファレンス に記載されています。

Editor API を初期化する

構成を使用して EditorApi をインスタンス化します。

var editorApi = new EditorApi(config);

このオブジェクトはすべての編集操作を提供します。

編集オプションの定義（プレースホルダー テキストの置換）

ソース ファイル、出力 パス、および必要なテキスト置換を設定します。

var editOptions = new EditDocumentOptions
{
    FileInfo = new FileInfo { FilePath = "sample.pptx" },
    OutputPath = "sample_edited.pptx",
    EditTexts = new List<EditText>
    {
        new EditText { Text = "OldTitle", NewText = "New Title" },
        new EditText { Text = "OldSubtitle", NewText = "Updated Subtitle" }
    }
};

EditTexts コレクションを使用すると、1 回の呼び出しで任意の数のプレースホルダーを置き換えることができます。

編集操作を実行し、レスポンスを処理する

リクエストを作成し、EditDocument を呼び出します。

var request = new EditDocumentRequest(editOptions);
var response = editorApi.EditDocument(request);
Console.WriteLine($"Edited PowerPoint saved to: {response.Path}");

レスポンスには、クラウドストレージ内の編集されたファイルへのパスが含まれます。

完全なコード例：C# で PowerPoint プレゼンテーションを編集する - 完全なワークフロー

以下のコードは、開始から完了までの全プロセスを示しています。

using System;
using System.Collections.Generic;
using GroupDocs.Editor.Cloud.Sdk.Api;
using GroupDocs.Editor.Cloud.Sdk.Client;
using GroupDocs.Editor.Cloud.Sdk.Model;
using GroupDocs.Editor.Cloud.Sdk.Model.Requests;

namespace GroupDocsEditorDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // Configure API credentials
            var config = new Configuration
            {
                ClientId = "YOUR_CLIENT_ID",
                ClientSecret = "YOUR_CLIENT_SECRET"
            };

// Initialize the Editor API
            var editorApi = new EditorApi(config);

// Define input and output PowerPoint files
            string inputFilePath = "sample.pptx";
            string outputFilePath = "sample_edited.pptx";

// Set up editing options (replace placeholder texts)
            var editOptions = new EditDocumentOptions
            {
                FileInfo = new FileInfo { FilePath = inputFilePath },
                OutputPath = outputFilePath,
                EditTexts = new List<EditText>
                {
                    new EditText { Text = "OldTitle", NewText = "New Title" },
                    new EditText { Text = "OldSubtitle", NewText = "Updated Subtitle" }
                }
            };

// Create the request
            var request = new EditDocumentRequest(editOptions);

try
            {
                // Perform the edit operation
                var response = editorApi.EditDocument(request);
                Console.WriteLine($"Edited PowerPoint saved to: {response.Path}");
            }
            catch (ApiException apiEx)
            {
                Console.WriteLine($"API error ({apiEx.ErrorCode}): {apiEx.Message}");
            }
            catch (Exception ex)
            {
                Console.WriteLine($"Unexpected error: {ex.Message}");
            }
        }
    }
}

注意: このコード例はコア機能を示しています。プロジェクトで使用する前に、ファイルパスや設定値が実際の環境に合わせて更新されていることを確認し、必要な依存関係がすべて正しくインストールされているか検証し、開発環境で十分にテストしてください。問題が発生した場合は、公式ドキュメント または サポートチーム にお問い合わせください。

cURL と REST API を使用した PowerPoint 編集

言語に依存しないアプローチを好む場合は、cURL 呼び出しで同じ編集操作を実行できます。

  1. 認証してアクセストークンを取得する
curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'
  1. ソース PPTX ファイルをアップロード
curl -X POST "https://api.groupdocs.cloud/v2.0/storage/upload/sample.pptx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@sample.pptx"
  1. 編集操作を実行する
curl -X POST "https://api.groupdocs.cloud/v2.0/editor/edit" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "sample.pptx" },
           "outputPath": "sample_edited.pptx",
           "editTexts": [
               { "text": "OldTitle", "newText": "New Title" },
               { "text": "OldSubtitle", "newText": "Updated Subtitle" }
           ]
         }'
  1. 編集済みの PPTX ファイルをダウンロード
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/download/sample_edited.pptx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o sample_edited.pptx

リクエスト ペイロードの詳細については、API リファレンスをご覧ください。

PowerPoint 編集オプションの微調整

SDK は調整できる追加パラメータを提供します:

  • OutputPath - 編集されたプレゼンテーション用に別のフォルダーまたはファイル名を選択します。
  • EditTexts - 複数のプレースホルダーを置き換えるために必要なだけの EditText オブジェクトを追加します。
  • FileInfo.StorageName - 複数のクラウドストレージを使用する場合は、カスタムストレージ場所を指定します。

これらのオプションは、API リファレンスで参照されている EditDocumentOptions クラスの一部です。

Conclusion

C# で PowerPoint プレゼンテーションを編集することは、GroupDocs.Editor Cloud SDK for .NET を使用するとシンプルになります。このライブラリは認証、ファイル管理、テキスト置換を処理し、ビジネスロジックに集中できるようにします。本番環境で使用するには適切なライセンスを取得することを忘れないでください。一時ライセンスページ から一時ライセンスで開始できます。提供されたコードサンプルと cURL ワークフローを使用すれば、任意の .NET アプリケーションに動的スライド編集を統合する準備が整います。

FAQs

C# で GroupDocs.Editor Cloud を使用して PowerPoint プレゼンテーションを編集するにはどうすればよいですか？
EditDocument メソッドを使用します。その前に、ソース ファイル、出力パス、および EditText 置換のリストを指定して EditDocumentOptions を構成します。完全な例はこのガイドの前半で示されています。

単一のPowerPointファイルで複数のプレースホルダーを置換できますか？
はい。必要なだけの EditText オブジェクトを EditTexts コレクションに追加してください；SDK は 1 つのリクエストで全ての置換を処理します。

編集されたファイルが生成されない場合はどうすればよいですか？
OutputPath が正しく設定されているか、API のレスポンスに有効な Path が含まれているかを確認してください。また、GroupDocs ポータルで資格情報とストレージ権限を確認してください。

本番環境でのデプロイにライセンスは必要ですか？
本番環境では有効なライセンスが必要です。SDKを評価中は一時ライセンスページから一時ライセンスを取得できます。

もっと読む

]]>