---
title: "HTMLまたはURLを入力とするPDFとスクリーンショット"
url: https://docs.catalyst.zoho.com/ja/api/code-reference/smartbrowz/generate-pdfnscreenshoturl/
description: "このAPIを使用すると、Catalyst SmartBrowzヘッドレスブラウザサービスを通じてブラウザテスト用のPDFとスクリーンショットを生成できます。"
last_updated: 2026-03-30T08:10:30Z
service: SmartBrowz
type: api
---

# PDF & Screenshot

[PDF & Screenshot](https://docs.catalyst.zoho.com/ja/smartbrowz/help/pdfnscreenshot/introduction/)は、WebサイトやWebアプリケーションのビジュアルドキュメントを生成できるSmartBrowzのコンポーネントです。WebページのPDF変換、UIデバッグ時の使用、エンドユーザーの視点からのビジュアルコンポーネントの理解、許可されたクロール操作の実行など、さまざまな用途に活用できる強力なツールです。

以下のAPIを使用して、この機能をCatalystアプリケーションに導入できます。

## HTML/URLを使用したPDF生成

### PDFの説明

このAPIを使用すると、HTMLコードまたはURLを入力として使用し、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

#### リクエストヘッダー
 **Authorization:** Zoho-oauthtoken {oauth_token} 

 **Content-Type:** application/json 

#### リクエストJSONプロパティ

- **display_header_footer** (boolean, optional): ヘッダーとフッターを表示するには、値を`true`として渡します。
 デフォルト: `false`。   

- **footer_template** (string, optional):  印刷フッターのHTMLテンプレート。`PDFOptions.headerTemplate`と同じ制約と特殊クラスのサポートがあります。 

- **format** (PaperFormat, optional):  用紙のサイズ。例: A4、A3。 

- **header_template** (string, optional): 印刷ヘッダーのHTMLテンプレート。以下のクラスを持つ有効なHTMLで、値を注入できます:

- 
- **date** (string, optional): フォーマットされた印刷日 

- 
- **title** (string, mandatory): ドキュメントのタイトル 

- 
- **url** (string, mandatory): ドキュメントのURL 

- 
- **page_number** (string, optional): 現在のページ番号 

- 
- **total_pages** (string, optional): ドキュメントの総ページ数 

- **landscape** (boolean, optional): 横向きで印刷するには、値を`true`として渡します 

- **margin** (PDFMargin, 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):  

### PDFレスポンス詳細

レスポンスとして生成されたPDFドキュメントが返されます。

## HTML/URLを使用したスクリーンショット生成

### スクリーンショットの説明

このAPIを使用すると、HTMLコードまたはURLを入力として使用し、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): 画像の品質。**.png**画像には適用されません。許容値: `0`から`100`の間。ミリ秒単位の最大待機時間。タイムアウトを無効にするには、値を`0`として渡します。 

- **wait_until** (string | number, optional): 

- **password** (string, optional): PDFドキュメントを保護するパスワードの値を保持します。

### スクリーンショットレスポンス詳細

レスポンスとして生成されたスクリーンショットが返されます。

> **注意:** Browser Logic関数を使用してコーディングするブラウザアクションや操作、または**Catalyst SmartBrowz**のいずれかのコンポーネントを使用して実行するブラウザ自動化やWebスクレイピングタスクは、すべてご自身の責任で行ってください。SmartBrowzコンポーネントは、アクションを許可するドメインで操作を実行するか、適切な承認を得て使用することを強くお勧めします。また、Catalystはコードを実行するための安全なインフラストラクチャを提供していますが、Catalyst関数を使用してコーディングするロジックの結果については、すべてご自身の責任となります。

**CURLリクエスト - HTML/URLから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 '{
    "url": "https://www.example.com",
    "output_options": {
        "output_type": "pdf"
    },
    "pdf_options" : {
        "scale" : 1,
        "display_header_footer" : true,
        "header_template" : "<style> #header, #footer { margin: 0 !important; padding: 0 !important; font-size: 9px; -webkit-print-color-adjust: exact;}</style><div style=\width:100%><span class=\date\></span><span class=\title\ style=\float:right\></span</div>",
        "footer_template" : "<style> #header, #footer { margin: 0 !important; padding: 0 !important; font-size: 9px; -webkit-print-color-adjust: exact;}</style><div style=\width:100%\><span class=\url\></span><div style=\float:right\><span class=\pageNumber\></span> / <span class=\totalPages\></span></div></div>",
        "print_background" : false,
        "landscape" : false,
        "page_ranges" : "1",
        "format" : "A4",
        "width" : "100",
        "height" : "100",
        "margin" :
            {
                "top" : "1cm",
                "bottom" : "1cm",
                "left" : "1cm",
                "right": "1cm"
            },     
        "omit_background" :  false
    },
    "page_options":{
        "css" : {
            "content" : "body{background: lightgrey}"
        },
        "viewport" : {
            "width": 1440,
            "height": 900
        },
        "javascript_enabled" : true
    },
    "navigation_options":{
        "timeout" : 5000,
        "wait_until" : "networkidle0"
    }
}'

```

**CURLリクエスト - HTML/URLからスクリーンショット**

```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'{
    "url": "https://www.example.com",
    "output_options": {
        "output_type": "screenshot"
    },
    "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/)