문서 메타데이터는 문서 내부에 저장된 작성자, 편집 시간 등과 같은 문서에 대한 정보입니다. C# 개발자는 클라우드에서 프로그래밍 방식으로 PDF 문서의 메타데이터 정보를 쉽게 편집할 수 있습니다. 이 기사에서는 C#에서 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 패키지 관리자를 통해 GroupDocs.Metadata Cloud 설치
패키지 관리자 콘솔에서 다음 명령을 사용하여 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 참조 섹션을 제공합니다. 모호한 점이 있으면 언제든지 포럼으로 문의해 주십시오.