--- title: "テンプレートを入力とするPDFとスクリーンショット" url: https://docs.catalyst.zoho.com/ja/api/code-reference/smartbrowz/generate-pdfnscreenshottemplate/ description: "このAPIを使用すると、PDFとスクリーンショットを生成できます。" last_updated: 2026-03-30T08:10:30Z service: SmartBrowz type: api --- ## テンプレートを使用したPDF生成 > **注意:** このAPIを使用するには、コンソールで[テンプレートを作成](https://docs.catalyst.zoho.com/ja/smartbrowz/help/templates/create-templates/)する必要があります。 ### 説明 このAPIを使用すると、[テンプレート](https://docs.catalyst.zoho.com/ja/smartbrowz/help/templates/create-templates/)を入力として使用し、WebページのPDFドキュメントを生成できます。 ### PDFリクエスト詳細 #### リクエストURL `POST` {api-domain}/browser360/v1/project/{project_id}/convert - **api-domain** (URL): Catalyst APIにアクセスするためのDC固有ドメイン - **project_id** (Numerical): プロジェクトの[一意のID](https://docs.catalyst.zoho.com/ja/getting-started/set-up-a-catalyst-project/general-settings/) #### スコープ ZohoCatalyst.pdfshot.EXECUTE #### リクエストJSONプロパティ - **display_header_footer** (boolean, optional): ヘッダーとフッターを表示するには、値を`true`として渡します。 デフォルト: `false`。 - **format** (PaperFormat, optional): 用紙のサイズ。例: A4、A3。 - **landscape** (boolean, optional): 横向きで印刷するには、値を`true`として渡します。 - **password** (string, optional): PDFドキュメントのパスワード値を渡します。 - **omit_background** (boolean, optional): デフォルトの白い背景を非表示にし、透明な背景でPDFを生成できるようにします。 - **page_ranges** (string, optional): 印刷するページ範囲。例: 1-5, 8, 11-13。 - **prefer_css_pageSize** (boolean, optional): ページで宣言されたCSS @pageサイズを、width、height、またはformatオプションで宣言されたものより優先するには、値を`true`として渡します - **print_background** (boolean, optional): 背景グラフィックスを印刷するには、値を`true`として渡します - **scale** (number, optional): Webページのレンダリングをスケーリングします。許容値: 0.1から2の間。 - **timeout** (number, optional): ミリ秒単位のタイムアウト。タイムアウトを無効にするには、値を`0`として渡します。 - **width** (string | number, optional): 用紙の幅を設定します。数値または単位付きの文字列を渡すことができます。 - **timeout** (number, optional): ミリ秒単位の最大待機時間。タイムアウトを無効にするには、値を`0`として渡します。 デフォルト値は `page.set_default_timeout()`または`page.set_default_navigation_timeout()`メソッドを使用して変更できます。 - **wait_until** (string | number, optional): - **password** (string, optional): PDFドキュメントを保護するパスワードの値を保持します。 ### PDFレスポンス詳細 レスポンスとして生成されたPDFが返されます。 > **注意:** * このAPIを使用するには、コンソールで[テンプレートを作成](https://docs.catalyst.zoho.com/ja/smartbrowz/help/templates/create-templates/)する必要があります。 * *SmartBrowz Templates*では、テンプレートを使用して生成するPDFドキュメントにパスワードを設定するオプションが提供されています。**パスワードを手動で設定**オプションを使用する場合、このAPIを使用できます。*パスワードを動的に設定*オプションを使用する場合、このAPIは使用できません。 ## テンプレートを使用したスクリーンショット生成 ### スクリーンショットの説明 このAPIを使用すると、[テンプレート](https://docs.catalyst.zoho.com/ja/smartbrowz/help/templates/create-templates/)を入力として使用し、Webページのスクリーンショットを生成できます。 ### スクリーンショットリクエスト詳細 #### リクエストURL `POST` {api-domain}/browser360/v1/project/{project_id}/convert - **project_id** (Numerical): プロジェクトの[一意のID](https://docs.catalyst.zoho.com/ja/getting-started/set-up-a-catalyst-project/general-settings/) #### スコープ ZohoCatalyst.pdfshot.EXECUTE #### リクエストJSONプロパティ - **capture_beyond_viewport** (boolean, mandatory): ビューポートを超えたスクリーンショットをキャプチャするには、値を`true`として渡します - **clip** (screenshot_clip, mandatory): ページのクリッピング領域を指定するオブジェクト - **encoding** ('base64' | 'binary', mandatory): 画像のエンコーディング - **from_surface** (boolean, mandatory): ビューではなくサーフェスからスクリーンショットをキャプチャするには、値を`true`として渡します - **full_page** (boolean, mandatory): ページ全体のスクリーンショットを撮るには、値を`true`として渡します - **omit_background** (boolean, mandatory): デフォルトの白い背景を非表示にし、透明な背景でスクリーンショットをキャプチャできるようにします - **quality** (number, optional): ミリ秒単位の最大待機時間。タイムアウトを無効にするには、値を`0`として渡します。 デフォルト値は `page.set_default_timeout()`または`page.set_default_navigation_timeout()`メソッドを使用して変更できます。 - **wait_until** (string | number, optional): ### スクリーンショットレスポンス詳細 レスポンスとして生成されたスクリーンショットが返されます。 > **注意:** Browser Logic関数を使用してコーディングするブラウザアクションや操作、または**Catalyst SmartBrowz**のいずれかのコンポーネントを使用して実行するブラウザ自動化やWebスクレイピングタスクは、すべてご自身の責任で行ってください。SmartBrowzコンポーネントは、アクションを許可するドメインで操作を実行するか、適切な承認を得て使用することを強くお勧めします。また、Catalystはコードを実行するための安全なインフラストラクチャを提供していますが、Catalyst関数を使用してコーディングするロジックの結果については、すべてご自身の責任となります。 **CURLリクエスト - テンプレートからPDF** ```json curl -X POST \'https://api.catalyst.zoho.com/browser360/v1/project/10470000000272001/convert' -H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57" \ -H 'Content-Type: application/json' --d '{ "template_id":"367000000044001", "template_data":{}, "output_options": { "output_type": "pdf" }, "pdf_options" : { "scale" : 1, "display_header_footer" : true, "print_background" : false, "landscape" : false, "page_ranges" : "1", "format" : "A4", "width" : "100", "height" : "100", "omit_background" : false, "password": "Demo$" }, "page_options":{ "css" : { "content" : "body{background: lightgrey}" }, "viewport" : { "width": 1440, "height": 900 }, "javascript_enabled" : true }, "navigation_options":{ "timeout" : 5000, "wait_until" : "networkidle0" } }' ``` **CURLリクエスト - テンプレートからスクリーンショット** ```json curl -X POST \ 'https://api.catalyst.zoho.com/browser360/v1/project/10470000000272001/convert' -H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57" \ -H 'Content-Type: application/json' -d '{ "template_id":"367000000044001", "template_data":{}, "output_options": { "output_type": "pdf" }, "screenshot_options" : { "type" : "jpeg", "quality" : 100, "full_page" : false, "omit_background" : false, "capture_beyond_viewport" : true, "clip" :{ "x" : 50, "y" : 100, "width" : 1000, "height": 100 } }, "page_options":{ "css" : { "content" : "body{background: lightgrey}" }, "viewport" : { "width": 1440, "height": 900 }, "javascript_enabled" : true }, "navigation_options":{ "timeout" : 5000, "wait_until" : "networkidle0" } }' ``` ### SDK Documentation [Generate PDF & Screenshot- Java SDK](https://docs.catalyst.zoho.com/ja/sdk/java/v1/smartbrowz/generate-pdfnscreenshot/) [Generate PDF & Screenshot- Node.js SDK](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/smartbrowz/generate-pdfnscreenshot/) [Generate PDF & Screenshot- Python SDK](https://docs.catalyst.zoho.com/ja/sdk/python/v1/smartbrowz/generate-pdfnscreenshot/)