電子署名は、電子文書に名前を入力するのと同じくらい簡単です。これらは、電子商取引や規制当局への申請でますます使用されています。電子署名は、署名者が文書に電子的に署名するために使用するデータを視覚的にエンコードされた形式で表します。 Python 開発者は、署名済み PDF ドキュメントの署名をクラウド上でプログラム的に電子的に編集できます。この記事では、Python の REST API を使用して署名済み PDF ドキュメントの署名を編集する方法に焦点を当てます。
この記事では次のトピックについて説明します。
ドキュメント署名 REST API および Python SDK
PDF ドキュメント内の電子署名を編集するには、GroupDocs.Signature Cloud の Python SDK API を使用します。テキスト、スタンプ、QR コード、バーコード、画像、デジタル署名を適用することで、サポートされているファイル形式のドキュメントと画像を電子的に保護できます。さまざまな種類の署名を簡単に作成、検証、削除、検索することもできます。また、クラウド API の ドキュメント署名ファミリー メンバー として、.NET、Java、PHP、Android、Ruby、および Node.js SDK も提供します。
コンソールで次のコマンドを使用して、pip (Python 用パッケージ インストーラー) を使用して GroupDocs.Signature Cloud を Python プロジェクトにインストールできます。
pip install groupdocs_signature_cloud
手順と利用可能なコード例を開始する前に、ダッシュボード からクライアント ID とクライアント シークレットを取得してください。以下に示すように、コードに ID とシークレットを追加します。
client_id = "112f0f38-9dae-42d5-b4fc-cc84ae644972"
client_secret = "16ad3fe0bdc39c910f57d2fd48a5d618"
configuration = groupdocs_signature_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"
my_storage = ""
Python の REST API を使用して署名済み PDF ドキュメントの署名を編集する
以下の簡単な手順に従って、署名済み PDF ドキュメントの署名を編集できます。
- 署名済み PDF ファイルをクラウドに アップロード
- Python を使用して署名済み PDF ドキュメントの署名を更新
- ダウンロード 結果のファイル
ドキュメントをアップロードする
まず、以下のコード例を使用して、署名された PDF ドキュメントをクラウドにアップロードします。
# APIの初期化
file_api = groupdocs_signature_cloud.FileApi.from_config(configuration)
# サンプルファイルをアップロードする
request = groupdocs_signature_cloud.UploadFileRequest("signed.pdf", "C:\\Files\\signed.pdf", my_storage)
response = file_api.upload_file(request)
その結果、アップロードされた PDF ファイル (signed.pdf) は、クラウド上のダッシュボードの ファイル セクション で利用できるようになります。
Python を使用して署名済み PDF ドキュメントの署名を更新する
以下の手順に従って、署名済み PDF ファイルの署名をプログラムで更新できます。
- SignApi のインスタンスを作成する
- 署名付き PDF ファイルへのパスを設定します
- SearchQRCodeOptions と SearchSettings を提供して QR コードを検索します
- SearchSignatureRequest の作成
- SignApi.search\signatures() メソッドを呼び出して結果を取得します
- UpdateOptions の定義
- 更新設定を設定する
- UpdateOptions を UpdateSettings に割り当てる
- UpdateSignaturesRequest の作成
- SignApi.update\signatures() メソッドを呼び出して結果を取得します
次のコード スニペットは、REST API を使用して署名済み PDF ドキュメント内の QR コード署名を更新する方法を示しています。
# APIの初期化
api = groupdocs_signature_cloud.SignApi.from_keys(client_id, client_secret)
# 署名されたドキュメントのパス
fileInfo = groupdocs_signature_cloud.FileInfo()
fileInfo.file_path = "signed.pdf"
# QRコードを検索
opts = groupdocs_signature_cloud.SearchQRCodeOptions()
opts.page = 1
opts.signature_type = 'QRCode'
settings = groupdocs_signature_cloud.SearchSettings()
settings.options = [opts]
settings.file_info = fileInfo
request = groupdocs_signature_cloud.SearchSignaturesRequest(settings)
response = api.search_signatures(request)
# QRコードを更新
opts = groupdocs_signature_cloud.UpdateOptions()
opts.page = 1
opts.signature_type = 'QRCode'
opts.signature_id = response.signatures[0].signature_id
opts.left = 450
opts.top = 600
opts.width = 90
opts.height = 90
opts.is_signature = True
settings = groupdocs_signature_cloud.UpdateSettings()
settings.options = [opts]
settings.file_info = fileInfo
request = groupdocs_signature_cloud.UpdateSignaturesRequest(settings)
response = api.update_signatures(request)
Python を使用して署名済み PDF ドキュメントの署名を更新する
署名付きファイルをダウンロードする
上記のコード サンプルは、更新された PDF ファイルをクラウドに保存します。このファイルは、次のコード サンプルを使用してダウンロードできます。
# APIの初期化
file_api = groupdocs_signature_cloud.FileApi.from_config(configuration)
request = groupdocs_signature_cloud.DownloadFileRequest("signed.pdf", my_storage)
response = file_api.download_file(request)
# ダウンロードしたファイルを作業ディレクトリに移動します
shutil.move(response, "C:\\Files\\")
Python を使用した電子署名の検索と置換
以下の手順に従って、署名済み PDF ドキュメント内の署名をプログラムで検索および置換できます。
- SignApi のインスタンスを作成する
- 署名付き PDF ファイルへのパスを設定します
- QRコードを検索
- SearchQRCodeOptions と SearchSettings を定義する
- SearchSignatureRequest の作成
- SignApi.search\signatures() メソッドを呼び出して結果を取得します
- 検索したQRコードを削除する
- DeleteOptions と DeleteSettings を定義する
- DeleteSignatureRequest の作成
- SignApi.delete\signatures() メソッドを呼び出して結果を取得します
- バーコードで署名する
- SignBarcodeOptions の定義
- バーコードのサイズと位置を設定する
- 署名設定の定義
- SignBarcodeOptions と SaveOptions を SignSettings に割り当てる
- CreateSignaturesRequest の作成
- SignApi.create\signatures() メソッドを呼び出して結果を取得します
次のコード スニペットは、REST API を使用して署名済み PDF ドキュメント内の QR コード署名を検索し、バーコード署名に置き換える方法を示しています。前述の手順に従って、更新されたファイルをダウンロードしてください。
# APIの初期化
api = groupdocs_signature_cloud.SignApi.from_keys(client_id, client_secret)
# QR コード署名済みドキュメントのパス
fileInfo = groupdocs_signature_cloud.FileInfo()
fileInfo.file_path = "signed.pdf"
# QRコードを検索
opts = groupdocs_signature_cloud.SearchQRCodeOptions()
opts.page = 1
opts.signature_type = 'QRCode'
settings = groupdocs_signature_cloud.SearchSettings()
settings.options = [opts]
settings.file_info = fileInfo
request = groupdocs_signature_cloud.SearchSignaturesRequest(settings)
response = api.search_signatures(request)
# QRコードを削除
opts = groupdocs_signature_cloud.DeleteOptions()
opts.page = 1
opts.signature_type = 'QRCode'
opts.signature_id = response.signatures[0].signature_id
settings = groupdocs_signature_cloud.DeleteSettings()
settings.options = [opts]
settings.file_info = fileInfo
request = groupdocs_signature_cloud.DeleteSignaturesRequest(settings)
response = api.delete_signatures(request)
# バーコードで署名する
opts = groupdocs_signature_cloud.SignBarcodeOptions()
opts.signature_type = 'Barcode'
opts.text = '123456789012'
opts.barcode_type = 'Code128'
opts.code_text_alignment = 'None'
# ページ上のバーコード署名の位置を設定する
opts.left = 250
opts.top = 0
opts.width = 300
opts.height = 90
opts.location_measure_type = "Pixels"
opts.size_measure_type = "Pixels"
opts.stretch = "None"
opts.rotation_angle = 0
opts.horizontal_alignment = "None"
opts.vertical_alignment = "None"
opts.margin = groupdocs_signature_cloud.Padding()
opts.margin.all = 5
opts.margin_measure_type = "Pixels"
opts.inner_margins = groupdocs_signature_cloud.Padding()
opts.inner_margins.all = 2
opts.page = 1
settings = groupdocs_signature_cloud.SignSettings()
settings.options = [opts]
settings.save_options = groupdocs_signature_cloud.SaveOptions()
settings.save_options.output_file_path = "Output\\signedBarCode_sample.pdf"
settings.file_info = fileInfo
request = groupdocs_signature_cloud.CreateSignaturesRequest(settings)
response = api.create_signatures(request)
Python を使用して署名済み PDF ドキュメント内の署名を検索および置換する
オンラインで試す
上記の API を使用して開発された、次の無料のオンライン PDF 署名ツールをお試しください。 https://products.groupdocs.app/signature/pdf
結論
この記事では、署名された PDF ドキュメントの署名を更新する方法を学習しました。また、クラウド上で署名済み PDF ドキュメント内の署名を検索して置換する方法も学習しました。この記事では、プログラムによって PDF ファイルをクラウドにアップロードし、署名されたファイルをクラウドからダウンロードする方法についても説明しました。 GroupDocs.Signature Cloud API の詳細については、ドキュメント を使用して学習できます。また、ブラウザーを通じて API を直接視覚化し操作できるようにする API リファレンス セクションも提供しています。不明な点がある場合は、フォーラム でお気軽にお問い合わせください。