Python에서 REST API를 사용하여 Word 문서를 PDF로 변환

PDF는 업계에서 널리 사용되는 문서 공유 형식이기 때문에 Word 문서를 PDF 형식으로 공유하는 것이 일반적입니다. Microsoft Office에서 제공하는 내장 기능을 사용하여 Word를 PDF로 쉽게 변환할 수 있지만 프로그래밍 방식으로 Word 문서(DOC 또는 DOCX)를 PDF로 변환해야 할 수도 있습니다. 이 기사에서는 Python에서 REST API를 사용하여 Word 문서를 PDF로 변환하는 방법을 배웁니다.

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

• Word를 PDF로 변환 REST API 및 Python SDK
• Python에서 REST API를 사용하여 Word 문서를 PDF로 변환
• 고급 옵션으로 Word를 PDF로 변환
• Python에서 DOCX에서 PDF로 페이지 범위 변환
• Python에서 DOCX의 특정 페이지를 PDF로 변환
• Python을 사용하여 워터마크를 사용하여 Word를 PDF로 변환
• Cloud Storage를 사용하지 않고 DOCX에서 PDF로 변환
• DOCX를 PDF로 변환하고 직접 다운로드

Word를 PDF로 변환 REST API 및 Python SDK

DOCX를 PDF로 변환하기 위해 GroupDocs.Conversion Cloud의 Python SDK API를 사용합니다. 플랫폼 독립적인 문서/이미지 변환 솔루션이며 도구나 소프트웨어에 의존하지 않습니다. 지원되는 파일 형식의 이미지와 문서를 필요한 형식으로 빠르고 안정적으로 변환할 수 있습니다.

콘솔에서 다음 명령을 사용하여 Python 애플리케이션에 GroupDocs.Conversion Cloud를 설치할 수 있습니다.

pip install groupdocs_conversion_cloud

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

client_id = "659fe7da-715b-4744-a0f7-cf469a392b73"
client_secret = "b377c36cfa28fa69960ebac6b6e36421"

configuration = groupdocs_conversion_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"
my_storage = ""

Python에서 REST API를 사용하여 Word 문서를 PDF로 변환

아래의 간단한 단계에 따라 클라우드에서 프로그래밍 방식으로 Word 문서를 PDF로 변환할 수 있습니다.

1. 업로드 DOCX 파일을 클라우드로
2. Python을 사용하여 DOCX를 PDF로 변환
3. 다운로드 변환된 PDF 파일

DOCX 파일 업로드

먼저 다음 코드 샘플을 사용하여 DOCX 파일을 클라우드에 업로드합니다.

# API 인스턴스 생성
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)

# 파일 요청 업로드
request = groupdocs_conversion_cloud.UploadFileRequest("sample.docx", "C:\\Files\\Conversion\\sample.docx", my_storage)

# 샘플 파일 업로드
response = file_api.upload_file(request)

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

Python을 사용하여 DOCX를 PDF로 변환

아래 언급된 단계에 따라 프로그래밍 방식으로 DOCX를 PDF 문서로 쉽게 변환할 수 있습니다.

• 먼저 ConvertApi의 인스턴스를 만듭니다.
• 이제 ConvertSettings의 인스턴스를 만듭니다.
• 그런 다음 입력 DOCX 파일 경로를 제공하십시오.
• 형식을 “pdf"로 설정합니다.
• 출력 파일 경로를 제공하십시오.
• 이제 ConvertSettings로 ConvertDocumentRequest를 생성합니다.
• 마지막으로 ConvertDocumentRequest로 convert\document() 메서드를 호출하여 DOCX를 변환합니다.

다음 코드 예제는 Python에서 REST API를 사용하여 DOCX를 PDF로 변환하는 방법을 보여줍니다.

# API 인스턴스 생성
convert_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# 변환 설정 정의
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.docx"
settings.format = "pdf"
settings.output_path = "converted"

# 변환 문서 요청 생성
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)

# 문서 변환
result = convert_api.convert_document(request)

# 완료
print("Document converted: " + result[0].path)

변환된 파일 다운로드

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

# API 초기화
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)

# 다운로드 파일 요청 생성
request = groupdocs_conversion_cloud.DownloadFileRequest("converted\\sample.pdf", my_storage)

# 파일 다운로드
response = file_api.download_file(request)

# 다운로드한 파일을 작업 디렉토리로 이동
shutil.move(response, "C:\\Files\\Conversion\\")

고급 옵션으로 Word를 PDF로 변환

아래 단계에 따라 몇 가지 고급 설정을 사용하여 Word 문서를 PDF 파일로 변환할 수 있습니다.

• 먼저 ConvertApi의 인스턴스를 만듭니다.
• 이제 ConvertSettings의 인스턴스를 만듭니다.
• 그런 다음 DOCX 파일 경로를 제공합니다.
• 형식으로 “pdf"를 설정합니다.
• 출력 파일 경로를 제공하십시오.
• 이제 DocxLoadOptions의 인스턴스를 생성합니다.
• 옵션으로 hide\comments, hide\word\tracked\changes 등과 같은 다양한 로드 옵션을 설정합니다.
• 이제 PdfConvertOptions의 인스턴스를 만듭니다.
• 그런 다음 display\doc\title, margins(top, left, right, bottom) 등 다양한 변환 옵션을 설정합니다.
• 이제 ConvertSettings로 ConvertDocumentRequest를 생성합니다.
• 마지막으로 ConvertDocumentRequest로 convert\document() 메서드를 호출하여 DOCX를 변환합니다.

다음 코드 예제는 고급 변환 옵션을 사용하여 Word 문서를 PDF 문서로 변환하는 방법을 보여줍니다. 앞에서 언급한 단계에 따라 파일을 업로드하고 다운로드하십시오.

# API 인스턴스 생성
convert_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# 변환 설정 정의
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.docx"
settings.format = "pdf"
settings.output_path = "converted"

# DOCX 로드 옵션
loadOptions = groupdocs_conversion_cloud.DocxLoadOptions()
loadOptions.hide_comments = True              # Hide comments
loadOptions.hide_word_tracked_changes = True  # Hide tracked changes

# PDF 변환 옵션
convertOptions = groupdocs_conversion_cloud.PdfConvertOptions()
convertOptions.center_window = True
convertOptions.compress_images = False
convertOptions.display_doc_title = True
convertOptions.dpi = 1024.0
convertOptions.fit_window = False
convertOptions.from_page = 1
convertOptions.grayscale = False
convertOptions.image_quality = 100
convertOptions.linearize = False
convertOptions.margin_top = 5
convertOptions.margin_left = 5
convertOptions.unembed_fonts = True
convertOptions.remove_unused_streams = True
convertOptions.remove_unused_objects = True
convertOptions.remove_pdfa_compliance = False

settings.convert_options = convertOptions

# 문서 요청 변환
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)

# 문서 변환
result = convert_api.convert_document(request)

# 완료
print("Document converted: " + result[0].path)

Python에서 DOCX에서 PDF로 페이지 범위 변환

아래 언급된 단계에 따라 프로그래밍 방식으로 Word 문서의 페이지 범위를 PDF 파일로 변환할 수 있습니다.

• 먼저 ConvertApi의 인스턴스를 만듭니다.
• 이제 ConvertSettings의 인스턴스를 만듭니다.
• 그런 다음 입력 DOCX 파일 경로를 제공하십시오.
• 형식에 “pdf” 할당
• 출력 파일 경로 제공
• 이제 PdfConvertOptions의 인스턴스를 만듭니다.
• 그런 다음 변환할 시작 페이지 번호와 변환할 총 페이지 수에서 변환할 페이지 범위를 제공합니다.
• 이제 PdfConvertOptions를 ConvertSettings에 할당합니다.
• 그런 다음 ConvertSettings를 사용하여 ConvertDocumentRequest를 생성합니다.
• 마지막으로 ConvertDocumentRequest로 convert\document() 메서드를 호출하여 변환합니다.

다음 코드 샘플은 Python에서 REST API를 사용하여 DOCX에서 PDF로 페이지 범위를 변환하는 방법을 보여줍니다. 앞에서 언급한 단계에 따라 파일을 업로드하고 다운로드하십시오.

# API 인스턴스 생성
convert_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# 변환 설정 정의
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.docx"
settings.format = "pdf"
settings.output_path = "converted"

# PDF 변환 옵션
convertOptions = groupdocs_conversion_cloud.PdfConvertOptions()
convertOptions.from_page = 1;    # start page number
convertOptions.pages_count = 2;  # total pages to convert

settings.convert_options = convertOptions

# 문서 요청 변환
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)

# 문서 변환
result = convert_api.convert_document(request)

# 완료
print("Document converted: " + result[0].path)

Python에서 DOCX의 특정 페이지를 PDF로 변환

아래 언급된 단계에 따라 프로그래밍 방식으로 Word 문서의 특정 페이지를 PDF 파일로 변환할 수 있습니다.

• 먼저 ConvertApi의 인스턴스를 만듭니다.
• 이제 ConvertSettings의 인스턴스를 만듭니다.
• 그런 다음 입력 DOCX 파일 경로를 제공하십시오.
• 형식에 “pdf” 할당
• 출력 파일 경로 제공
• 이제 PdfConvertOptions의 인스턴스를 만듭니다.
• 그런 다음 변환할 특정 페이지 번호를 쉼표로 구분된 배열로 제공합니다.
• 이제 PdfConvertOptions를 ConvertSettings에 할당합니다.
• 그런 다음 ConvertSettings를 사용하여 ConvertDocumentRequest를 생성합니다.
• 마지막으로 ConvertDocumentRequest로 convert\cocument() 메서드를 호출하여 변환합니다.

다음 코드 예제는 Python에서 REST API를 사용하여 Word 문서의 특정 페이지를 PDF로 변환하는 방법을 보여줍니다. 앞에서 언급한 단계에 따라 파일을 업로드하고 다운로드하십시오.

# API 인스턴스 생성
convert_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# 변환 설정 정의
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.docx"
settings.format = "pdf"
settings.output_path = "converted"

# PDF 변환 옵션
convertOptions = groupdocs_conversion_cloud.PdfConvertOptions()
convertOptions.pages = [1,2];  # page numbers to convert

settings.convert_options = convertOptions

# 문서 요청 변환
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)

# 문서 변환
result = convert_api.convert_document(request)

# 완료
print("Document converted: " + result[0].path)

Python을 사용하여 워터마크를 사용하여 Word를 PDF로 변환

아래 단계에 따라 Word 문서를 PDF 문서로 변환하고 프로그래밍 방식으로 변환된 문서에 워터마크를 추가할 수 있습니다.

• 먼저 ConvertApi의 인스턴스를 만듭니다.
• 이제 ConvertSettings의 인스턴스를 만듭니다.
• 그런 다음 입력 DOCX 파일 경로를 제공하십시오.
• 형식에 “pdf” 할당
• 출력 파일 경로 제공
• 이제 WatermarkOptions의 인스턴스를 생성합니다.
• 그런 다음 워터마크 텍스트, 색상, 너비, 높이, 왼쪽, 위쪽 등을 설정합니다.
• 이제 PdfConvertOptions를 정의하고 WatermarkOptions를 할당합니다.
• 이제 ConvertSettings로 ConvertDocumentRequest를 생성합니다.
• 마지막으로 ConvertDocumentRequest로 convert\document() 메서드를 호출하여 DOCX를 변환합니다.

다음 코드 예제는 Word 문서를 PDF 문서로 변환하고 Python에서 REST API를 사용하여 변환된 PDF 문서에 워터마크를 추가하는 방법을 보여줍니다. 앞에서 언급한 단계에 따라 파일을 업로드하고 다운로드하십시오.

# API 초기화
convert_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# 변환 설정 정의
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.docx"
settings.format = "pdf"
settings.output_path = "converted"

# 워터마크 옵션 정의
watermark = groupdocs_conversion_cloud.WatermarkOptions()
watermark.text = "THIS IS SAMPLE WATERMARK"
watermark.bold = True;
watermark.font_size = 34;
watermark.color = "Gray";
watermark.background = False;
watermark.rotation_angle = 30;
watermark.left = 90;
watermark.top = 500;

# PDF 변환 옵션 정의
convertOptions = groupdocs_conversion_cloud.PdfConvertOptions()
convertOptions.watermark_options = watermark

settings.convert_options = convertOptions

# 변환 문서 요청 생성
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)

# 문서 변환
result = convert_api.convert_document(request)
print("Document converted successfully: " + result[0].url)

Cloud Storage를 사용하지 않고 DOCX에서 PDF로 변환

요청 본문에 문서를 전달하고 API 응답에서 출력 파일을 수신하여 클라우드 스토리지를 사용하지 않고도 Word 문서를 PDF로 변환할 수 있습니다. 클라우드 스토리지를 사용하지 않고 DOCX를 PDF로 변환하려면 아래 언급된 단계를 따르십시오.

• 먼저 ConvertApi의 인스턴스를 만듭니다.
• 로컬 경로에서 입력 DOCX 파일 읽기
• 이제 ConvertDocumentDirectRequest를 생성합니다.
• 그런 다음 대상 형식을 “pdf"로 제공하고 입력 파일 경로를 입력 매개변수로 제공합니다.
• ConvertDocumentDirectRequest로 convert\document\direct() 메서드를 호출하여 결과 얻기
• 마지막으로 FileStream.writeFile() 메서드를 사용하여 출력 파일을 로컬 경로에 저장합니다.

다음 코드 예제는 클라우드 저장소를 사용하지 않고 Word 문서를 PDF로 변환하는 방법을 보여줍니다.

# API 인스턴스 생성
convert_api = groupdocs_conversion_cloud.전환하다Api.from_keys(client_id, client_secret)

# 변환 요청 만들기
request = groupdocs_conversion_cloud.전환하다DocumentDirectRequest("pdf", "C:\\Files\\Conversion\\sample.docx")

# 전환하다
result = convert_api.convert_document_direct(request)

# 다운로드한 파일을 작업 디렉토리로 이동
shutil.move(result, "C:\\Files\\Conversion\\")

DOCX를 PDF로 변환하고 직접 다운로드

프로그래밍 방식으로 DOCX를 PDF 문서로 변환하고 아래 단계에 따라 변환된 파일을 직접 다운로드할 수 있습니다.

• 먼저 ConvertApi 인스턴스를 만듭니다.
• 이제 ConvertSettings의 인스턴스를 만듭니다.
• 그런 다음 DOCX 파일 경로를 설정하십시오.
• 형식에 “pdf” 할당
• 출력 경로에 “없음"을 설정합니다.
• 이제 ConvertSettings로 ConvertDocumentRequest를 생성합니다.
• 그런 다음 convert\document\download() 메서드를 호출하여 결과를 얻습니다.
• 선택적으로 shutil.move() 메서드를 사용하여 출력 파일을 로컬 경로에 저장합니다.

다음 코드 예제는 DOCX 파일을 PDF 문서로 변환하고 Python에서 REST API를 사용하여 직접 다운로드하는 방법을 보여줍니다. API는 변환된 PDF 파일을 응답으로 반환합니다. 앞에서 언급한 단계에 따라 파일을 업로드하십시오.

# 필요한 API 인스턴스 생성
convert_api = groupdocs_conversion_cloud.전환하다Api.from_keys(client_id, client_secret)

# 변환 설정 정의
settings = groupdocs_conversion_cloud.전환하다Settings()
settings.file_path = "sample.docx"
settings.format = "pdf"

settings.output_path = None    # leave OutputPath will result the output as document IOStream

# 변환 요청 만들기
request = groupdocs_conversion_cloud.전환하다DocumentRequest(settings)

# 전환하다
response = convert_api.convert_document_download(request)

# 다운로드한 파일을 작업 디렉토리로 이동
shutil.move(response, "C:\\Files\\Conversion\\")

온라인 시도

위의 API를 사용하여 개발된 다음 무료 온라인 DOCX to PDF 변환 도구를 사용해 보십시오. https://products.groupdocs.app/conversion/docx-to-pdf

결론

이 기사에서는 클라우드에서 Word 문서를 PDF 파일로 변환하는 방법을 배웠습니다. 또한 Python을 사용하여 특정 페이지 또는 페이지 범위를 DOCX에서 PDF로 변환하는 방법도 살펴보았습니다. 이 기사에서는 프로그래밍 방식으로 DOCX 파일을 클라우드에 업로드한 다음 변환된 PDF 파일을 클라우드에서 다운로드하는 방법도 설명했습니다. 그 외에도 문서를 사용하여 GroupDocs.Conversion Cloud API에 대해 자세히 알아볼 수 있습니다. 또한 브라우저를 통해 직접 API를 시각화하고 상호 작용할 수 있는 API 참조 섹션을 제공합니다. 모호한 점이 있으면 언제든지 포럼에 문의해 주십시오.

또한보십시오

• Python에서 REST API를 사용하여 HTML을 PDF로 변환