Loading...

お知らせ:

当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

PDF & Screenshot

PDF & Screenshotは、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

copy

api-domain
URL
Catalyst APIにアクセスするためのDC固有ドメイン

project_id
Numerical
プロジェクトの一意のID

スコープ

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

copy

project_id
Numerical
プロジェクトの一意のID

スコープ

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
copy

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&gt;</span><span class=\title\ style=\float:right&gt;</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%&gt;<span class=\url&gt;</span><div style=\float:right&gt;<span class=\pageNumber&gt;</span> / <span class=\totalPages&gt;</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” } }’

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

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” } }’

View more