C#에서 REST API를 사용하여 PDF 파일의 메타데이터 편집

문서 메타데이터는 문서 내부에 저장된 작성자, 편집 시간 등과 같은 문서에 대한 정보입니다. C# 개발자는 클라우드에서 프로그래밍 방식으로 PDF 문서의 메타데이터 정보를 쉽게 편집할 수 있습니다. 이 기사에서는 C#에서 REST API를 사용하여 PDF 파일의 메타데이터를 편집하는 방법을 배웁니다.

이 문서에서는 다음 항목을 다룹니다.

• 문서 메타데이터 조작 REST API 및 .NET SDK
• REST API를 사용하여 PDF 문서의 메타데이터 편집

문서 메타데이터 조작 REST API 및 .NET SDK

PDF 문서의 메타데이터를 편집하기 위해 GroupDocs.Metadata Cloud의 .NET SDK API를 사용합니다. 거의 모든 산업 표준 파일 형식에서 메타데이터를 추가, 편집, 검색 및 제거할 수 있습니다. PDF, Microsoft Word, Excel 스프레드시트, PowerPoint 프레젠테이션, Outlook 이메일, Visio, OneNote, Project, 오디오, 비디오, AutoCAD, 아카이브, JPEG, BMP, PNG 및 TIFF에서 이러한 작업을 수행할 수 있습니다. 또한 Cloud API용 문서 메타데이터 조작 제품군으로 Java SDK를 제공합니다.

아래와 같이 NuGet 패키지 관리자에서 .NET용 GroupDocs.Metadata Cloud SDK를 Visual Studio 프로젝트에 설치할 수 있습니다.

패키지 관리자 콘솔에서 다음 명령을 사용하여 NuGet 패키지를 설치할 수도 있습니다.

Install-Package GroupDocs.Metadata-Cloud

단계와 사용 가능한 코드 예제를 시작하기 전에 대시보드에서 클라이언트 ID와 클라이언트 암호를 얻으십시오. 클라이언트 ID와 시크릿이 있으면 아래와 같이 코드를 추가합니다.

string clientID = "112f0f38-9dae-42d5-b4fc-cc84ae644972";
string clientSecret = "16ad3fe0bdc39c910f57d2fd48a5d618";
string myStorage = "";

Configuration configuration = new Configuration(clientID, clientSecret);
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";

C#에서 REST API를 사용하여 PDF 파일의 메타데이터 편집

아래의 간단한 단계에 따라 PDF 문서의 메타데이터를 설정할 수 있습니다.

• 업로드 PDF 파일을 클라우드에
• C#을 사용하여 PDF 문서의 메타데이터 업데이트
• 다운로드 결과 파일

문서 업로드

먼저 아래 제공된 코드 샘플을 사용하여 PDF 파일을 클라우드에 업로드합니다.

# API 초기화
FileApi fileApi = new FileApi(configuration);
string path = @"C:\Files";

var file = Directory.GetFiles(path, "input.pdf", SearchOption.AllDirectories).FirstOrDefault();
if (file.Length != 0)
{
    var relativeFilePath = file.Replace(path, string.Empty).Trim(Path.DirectorySeparatorChar);

    var fileStream = File.Open(file, FileMode.Open);

    fileApi.UploadFile(new UploadFileRequest(relativeFilePath, fileStream, myStorage));
    fileStream.Close();
}

결과적으로 업로드된 PDF 파일(input.pdf)은 클라우드 대시보드의 파일 섹션에서 사용할 수 있습니다.

C#을 사용하여 PDF 파일의 메타데이터 업데이트

아래 제공된 단계에 따라 프로그래밍 방식으로 PDF 파일의 메타데이터를 업데이트할 수 있습니다.

• MetadataApi 인스턴스 만들기
• FileInfo 모델에서 PDF 파일 경로 설정
• SetOption 정의
• SetPropert에 대한 NewValue 및 Type 제공
• SearchCriteria를 정의하고 값을 업데이트할 NameOptions를 제공합니다.
• SetOptions로 SetRequest 만들기
• MetadataApi.Set() 메서드를 호출하여 결과 얻기

다음 코드 샘플은 REST API를 사용하여 PDF 문서의 속성 이름으로 메타데이터를 설정하는 방법을 보여줍니다.

# API 초기화
var apiInstance = new MetadataApi(configuration);

try
{
    var fileInfo = new GroupDocs.Metadata.Cloud.Sdk.Model.FileInfo
    {
        FilePath = "input.pdf",
        StorageName = myStorage
    };
    
    // 설정 옵션 정의
    var options = new SetOptions
    {
        FileInfo = fileInfo,
        Properties = new List<SetProperty>
        {
            new SetProperty
            {
                NewValue = "hello",
                Type = "String",
                SearchCriteria = new SearchCriteria
                {
                    NameOptions = new NameOptions
                    {
                        Value = "Keywords"
                    }
                },
            }
        }
    };
    
    // 세트 요청 정의
    var request = new SetRequest(options);

    var response = apiInstance.Set(request);
    Console.WriteLine($"Count of changes: {response.SetCount}");
    Console.WriteLine("Resultant file path: " + response.Path);
}
catch (Exception e)
{
    Console.WriteLine("Exception while calling MetadataApi: " + e.Message);
}

다음 코드 스니펫은 ExactPhrase 속성을 True로 설정하여 정확한 속성 이름을 일치시키는 방법을 보여줍니다.

# API 초기화
var apiInstance = new MetadataApi(configuration);
var fileInfo = new GroupDocs.Metadata.Cloud.Sdk.Model.FileInfo
{
    FilePath = "input.pdf",
    StorageName = myStorage
};

// 설정 옵션 정의
var options = new SetOptions
{
    FileInfo = fileInfo,
    Properties = new List<SetProperty>
    {
        new SetProperty
        {
            NewValue = "This is title",
            Type = "String",
            SearchCriteria = new SearchCriteria
            {
                NameOptions = new NameOptions
                {
                    Value = "Title",
                    MatchOptions = new MatchOptions
                    {
                        ExactPhrase = true
                    }
                }
            },
        }
    }
};

// 세트 요청 정의
var request = new SetRequest(options);

var response = apiInstance.Set(request);

다음 코드 스니펫은 정규식을 사용하여 MatchOptions를 제공하는 검색 기준을 정의하는 방법을 보여줍니다.

# API 초기화
var apiInstance = new MetadataApi(configuration);
var fileInfo = new GroupDocs.Metadata.Cloud.Sdk.Model.FileInfo
{
    FilePath = "input.pdf",
    StorageName = myStorage
};

// 설정 옵션 정의
var options = new SetOptions
{
    FileInfo = fileInfo,
    Properties = new List<SetProperty>
    {
        new SetProperty
        {
            NewValue = "new value",
            Type = "String",
            SearchCriteria = new SearchCriteria
            {
                NameOptions = new NameOptions
                {
                    Value = "^Tit.*",
                    MatchOptions = new MatchOptions
                    {
                        IsRegex = true
                    }
                }
            },
        }
    }
};

// 세트 요청 정의
var request = new SetRequest(options);

var response = apiInstance.Set(request);

다음 코드 스니펫은 속성 값을 제공하여 메타데이터를 업데이트하는 방법을 보여줍니다.

# API 초기화
var apiInstance = new MetadataApi(configuration);
var fileInfo = new GroupDocs.Metadata.Cloud.Sdk.Model.FileInfo
{
    FilePath = "input.pdf",
    StorageName = myStorage
};

// 설정 옵션 정의
var options = new SetOptions
{
    FileInfo = fileInfo,
    Properties = new List<SetProperty>
    {
        new SetProperty
        {
            NewValue = "Simply set by Property Value",
            Type = "String",
            SearchCriteria = new SearchCriteria
            {
                ValueOptions = new ValueOptions
                {
                    Value = "Windows User",
                    Type = "String"
                }
            },
        }
    }
};

// 세트 요청 정의
var request = new SetRequest(options);

var response = apiInstance.Set(request);

업데이트된 파일 다운로드

위의 코드 샘플은 업데이트된 PDF 파일을 클라우드에 저장하며 다음 코드 샘플을 사용하여 다운로드할 수 있습니다.

# API 초기화
var fileApi = new FileApi(configuration);
var file = "metadata\\set_metadata\\input_pdf\\input.pdf";
var downloadRequest = new DownloadFileRequest(file, myStorage);

Stream downloadResponse = fileApi.DownloadFile(downloadRequest);
using (var fileStream = File.Create("C:\\Files\\sample_input.pdf"))
{
    downloadResponse.Seek(0, SeekOrigin.Begin);
    downloadResponse.CopyTo(fileStream);
}

온라인 시도

위의 API를 사용하여 개발된 다음 무료 온라인 PDF 메타데이터 조작 도구를 사용해 보십시오.

https://products.groupdocs.app/metadata/pdf

결론

이 기사에서는 클라우드에서 PDF 문서의 메타데이터를 편집하는 방법을 배웠습니다. 이 문서에서는 프로그래밍 방식으로 클라우드에 PDF 파일을 업로드한 다음 클라우드에서 업데이트된 파일을 다운로드하는 방법도 설명했습니다. 문서를 사용하여 GroupDocs.Metadata Manipulation Cloud API에 대해 더 자세히 알아볼 수 있습니다. 또한 브라우저를 통해 직접 API를 시각화하고 상호 작용할 수 있는 API 참조 섹션을 제공합니다. 모호한 점이 있으면 언제든지 포럼으로 문의해 주십시오.

또한보십시오

• Java 및 .NET을 사용하여 문서의 메타데이터 관리