C#에서 REST API를 사용하여 Word 문서에 워터마크 추가

클라우드에서 프로그래밍 방식으로 텍스트 또는 이미지를 워터마크로 Word 문서에 추가할 수 있습니다. 워터마크는 문서의 작성자나 저작권, 로고 등과 같은 기타 정보를 식별하는 데 사용됩니다. 일반적으로 워터마크는 문서 내부에 배치된 이미지, 로고, 패턴 또는 텍스트가 중첩된 형태로 사용됩니다. 이 기사에서는 C#에서 REST API를 사용하여 Word 문서에 워터마크를 추가하는 방법을 배웁니다.

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

• 워터마크 REST API 및 .NET SDK
• C#에서 REST API를 사용하여 Word 문서에 텍스트 워터마크 추가
• REST API를 사용하여 Word 문서에 이미지 워터마크 추가

워터마크 REST API 및 .NET SDK

DOCX 파일에 텍스트 또는 이미지 워터마크를 추가하기 위해 GroupDocs.Watermark Cloud의 .NET SDK API를 사용합니다. PDF, Microsoft Word 및 Powerpoint와 같은 지원되는 파일 형식의 이미지 및 문서에서 프로그래밍 방식으로 워터마크를 추가, 제거, 검색 및 교체할 수 있습니다. 또한 요구 사항에 따라 텍스트 스타일, 글꼴, 크기, 색상 또는 위치를 지정하여 워터마크의 사용자 지정을 제어할 수 있습니다. 현재 Cloud API용 Java SDK도 제공하고 있습니다.

NuGet 패키지 관리자에서 또는 패키지 관리자 콘솔에서 다음 명령을 사용하여 GroupDocs.Watermark Cloud를 Visual Studio 프로젝트에 설치할 수 있습니다.

Install-Package GroupDocs.Watermark-Cloud

언급된 단계를 따르기 전에 대시보드에서 클라이언트 ID와 비밀을 얻으십시오. ID와 시크릿이 있으면 아래와 같이 코드를 추가합니다.

string clientId = "da0c487d-c1c0-45ae-b7bf-43eaf53c5ad5";
string clientSecret = "479db2b01dcb93a3d4d20efb16dea971";
string myStorage = "";

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

C#에서 REST API를 사용하여 Word 문서에 텍스트 워터마크 추가

아래에 언급된 간단한 단계에 따라 프로그래밍 방식으로 Word 문서에 워터마크로 텍스트를 추가할 수 있습니다.

• 업로드 the DOCX file to the Cloud
• C#을 사용하여 DOCX에 텍스트 워터마크 추가
• 다운로드 the watermarked file

문서 업로드

먼저 아래 제공된 코드 예제를 사용하여 Word 문서를 클라우드에 업로드합니다.

// 초기화 API
var fileApi = new FileApi(configuration);

// 파일 열기
var fileStream = File.Open(@"C:\Files\sample.docx", FileMode.Open);

// 파일 업로드 요청 생성
var request = new UploadFileRequest("sample.docx", fileStream, MyStorage);

// 파일 업로드
fileApi.UploadFile(request);
fileStream.Close();

결과적으로 DOCX 파일이 클라우드 저장소에 업로드되고 대시보드의 파일 섹션에서 사용할 수 있습니다.

C#을 사용하여 DOCX에 텍스트 워터마크 추가

아래 단계에 따라 프로그래밍 방식으로 DOCX 파일에 텍스트 워터마크를 추가할 수 있습니다.

• WatermarkApi 인스턴스 생성
• FileInfo의 인스턴스 생성
• DOCX 파일 경로 설정
• WatermarkOptions 생성 및 FileInfo 설정
• TextWatermarkOptions 만들기
• 텍스트, 글꼴 패밀리, 글꼴 크기 및 텍스트 정렬 설정
• 워터마크 텍스트의 전경색 설정
• 워터마크 위치 정의
• WatermarkDetails 정의 및 TextWatermarkOptions 및 위치 설정
• WatermarkOptions로 AddRequest 만들기
• WatermarkApi.add() 메서드를 호출하여 결과 얻기

다음 코드 샘플은 C#에서 REST API를 사용하여 Word 문서에 텍스트를 워터마크로 추가하는 방법을 보여줍니다.

// 초기화 API
var apiInstance = new WatermarkApi(configuration);

// 입력 파일 경로
var fileInfo = new FileInfo
{
    FilePath = "sample.docx"
};

// 워터마크 옵션 생성
var options = new WatermarkOptions()
{
    FileInfo = fileInfo,
    
    // 워터마크 세부 정보 정의
    WatermarkDetails = new List<WatermarkDetails>
    {
        new WatermarkDetails
        {
            // 텍스트 워터마크 정의
            TextWatermarkOptions = new TextWatermarkOptions
            {
                Text = "Copyright© 2021",
                FontFamilyName = "Arial",
                FontSize = 22d,
                TextAlignment = "Center",
                ForegroundColor = new Color()
                {
                    Name = "Red"
                }
            },

            // 워터마크 위치 설정
            Position = new Position()
            {
                X = 230.0,
                Y = 500.0
            }
        }
    }
};

// 추가 요청 생성
var request = new AddRequest(options);

// 워터 마크를 추가
var response = apiInstance.Add(request);

Console.WriteLine("Resultant file path: " + response.DownloadUrl);

업데이트된 파일 다운로드

위의 코드 샘플은 텍스트 워터마크가 있는 Word 파일을 클라우드에 저장합니다. 다음 코드 샘플을 사용하여 다운로드할 수 있습니다.

// 초기화 API
var fileApi = new FileApi(configuration);

// 클라우드의 기본 파일 경로
var file = "watermark/added_watermark/sample_docx/sample.docx";

// 다운로드 파일 요청 생성
var downloadRequest = new DownloadFileRequest(file, myStorage);

// 파일 다운로드
Stream downloadResponse = fileApi.DownloadFile(downloadRequest);

// 작업 디렉토리에 파일 저장
using (var fileStream = System.IO.File.Create("C:\\Files\\DownloadedFile.docx"))
{
    downloadResponse.Seek(0, SeekOrigin.Begin);
    downloadResponse.CopyTo(fileStream);
}

REST API를 사용하여 Word 문서에 이미지 워터마크 추가

아래 제공된 단계에 따라 프로그래밍 방식으로 이미지 또는 로고를 워터마크로 Word 문서에 추가할 수 있습니다.

• WatermarkApi 인스턴스 생성
• FileInfo의 인스턴스 생성
• DOCX 파일 경로 설정
• WatermarkOptions 생성 및 FileInfo 설정
• ImageWatermarkOptions 만들기
• PNG 이미지의 FilePath를 워터마크로 설정
• 워터마크 위치 정의
• 워터마크 만들기Details
• ImageWatermarkOptions 및 위치 설정
• WatermarkDetails를 목록으로 설정
• WatermarkOptions로 AddRequest 만들기
• WatermarkApi.add() 메서드를 호출하여 결과 얻기

다음 코드 샘플은 C#에서 REST API를 사용하여 이미지를 워터마크로 DOCX에 추가하는 방법을 보여줍니다. 앞에서 언급한 단계에 따라 파일을 업로드하고 다운로드하십시오.

// 초기화 API
var apiInstance = new WatermarkApi(configuration);

// 입력 파일 경로
var fileInfo = new FileInfo
{
    FilePath = "sample.docx"
};

// 워터마크 옵션 생성
var options = new WatermarkOptions()
{
    FileInfo = fileInfo,
    // 워터마크 세부 정보 정의
    WatermarkDetails = new List<WatermarkDetails>
    {
        new WatermarkDetails
        {
            // 이미지 워터마크 정의
            ImageWatermarkOptions = new ImageWatermarkOptions()
            {
                Image = new FileInfo { 
                    FilePath = "logo.png" 
                }
            },

            // 워터마크 위치 설정
            Position = new Position()
            {
                X = 180.0,
                Y = 280.0
            }
        }
    }
};

// 추가 요청 생성
var request = new AddRequest(options);

// 워터 마크를 추가
var response = apiInstance.Add(request);

Console.WriteLine("Resultant file path: " + response.DownloadUrl);

온라인 시도

위의 API를 사용하여 개발된 다음 무료 온라인 워터마크 도구를 사용해 보십시오. https://products.groupdocs.app/watermark/docx

결론

결론적으로 클라우드의 Word 문서에 텍스트 또는 이미지 워터마크를 추가하는 방법을 배웠습니다. 프로그래밍 방식으로 DOCX 파일을 클라우드에 업로드한 다음 클라우드에서 업데이트된 파일을 다운로드하는 방법도 배웠습니다. 문서에서 GroupDocs.Watermark Cloud API에 대해 자세히 알아볼 수 있습니다. 또한 브라우저를 통해 직접 API를 시각화하고 상호 작용할 수 있는 API 참조 섹션을 제공합니다. 모호한 점이 있으면 언제든지 support에 문의하십시오.

또한보십시오

• REST API를 사용하여 문서에서 워터마크 찾기 및 바꾸기
• 문서 보안을 위한 워터마크 클라우드 API 및 SDK