このページは Cloud Translation API によって翻訳されました。

Dynamic Links

Google ブックスの Dynamic Links 機能を使用すると、パートナー様のサイトから Google ブックスへの、カスタマイズ性と信頼性に優れたリンクを作成できます。たとえば、書籍が Google のインデックスに登録された場合のみ表示される「スマート」リンクを生成したり、Google ブックスで書籍をプレビューできるかどうかをユーザーに示すリンクを表示したりできます。Dynamic Links では、Google ブックスへのリンクにサムネイル画像を含めることもできます。このドキュメントでは、この機能をサイトに簡単に追加する方法について説明します。

注: この機能は、以前は Book Viewability API と呼ばれていました。

プレビューウィザードは Dynamic Links 上に構築されたツールです。数行のコードをコピーするだけで、サイトから簡単に書籍のプレビューをリンクすることができます。このドキュメントは、ブック検索へのリンク設定をカスタマイズすることを検討している上級開発者を対象としています。

視聴者

ダイナミックリンクに関するドキュメントは、Google ブックス内の書籍にリンクするウェブアプリケーションを作成するプログラマーを対象としています。このドキュメントは、HTTP プロトコルと基本的な JavaScript に精通していることを前提としています。

ブック検索の用語

Google ブックスでは、ユーザーの地域における著作権の制限を尊重しているため、地域によっては一部の書籍のプレビューや全表示をご利用いただけない場合があります。視認性は次のクラスに分類されます。

全体表示: 書籍全体を表示できます。該当する書籍はパブリックドメインである可能性があります。
限定的な使用: 書籍の一部は閲覧できます。この書籍は著作権で保護されているため、Google ブックスはユーザーがこれらのページにアクセスできるようにする許可を得ています。これらの書籍はスニペット表示の書籍と異なり、ユーザーはページ全体を表示できます。
スニペット表示とプレビューなし: ユーザーには [書籍について] ページのみが表示されます。多くても、書籍の抜粋のみ利用できます。この書籍はスキャンされていないか、著作権で保護されているため、ユーザーの検索キーワードに関連する少数の「スニペット」を Google ブックスで公開する許可を得ていません。

はじめに

静的リンクのドキュメントでは、Google ブックスの特定の書籍のページへの URL を生成するとても簡単な方法について説明しています。残念ながら、特定の書籍が Google ブックスのインデックスに登録されていない場合や、特定の地域のユーザーにプレビューが利用できない場合があります。静的リンクは「盲目的」であるため、意図した効果が得られないことがあります。

Dynamic Links は、JavaScript を使用して書籍の視認性をクエリするための、プログラマティックなクライアントサイドの代替メソッドです。これにより、ブック検索へのリンクの信頼性と予測可能性が高まるため、ユーザーエクスペリエンスの一貫性が向上します。視認性はエンドユーザーの所在地によって異なるため、ダイナミックリンクのインターフェースはサーバーサイドまたはオフラインのクエリ向けには設計されていません。

Dynamic Links の機能を理解するには、このドキュメントの最後にあるコードサンプルに進んでください。

ブランドの取り扱いガイドライン

Dynamic Links をレンダリングするときは、Google ブックス API ファミリーを規定しているブランドの取り扱いガイドラインに従う必要があります。特に、

帰属情報および Google ブックスへのリンクは維持されなければなりません。
Google ブックスでプレビューにリンクする際は、承認済みの Google プレビューボタンのみを使用する必要があります。
テキストリンク、ボタン、ドキュメント、説明テキストは、承認された命名規則に従う必要があります。たとえば、Google ブックスのプレビューにリンクする際に「ダウンロード」や「読む」という動詞は使用しないでください。これはパブリックドメインの作品しかダウンロードできないためです。

ブランディングの例

フリーコノミクス: ローグエコノミストが秘めたあらゆる側面を探る

執筆者: Steven Levitt、Stephen Dubner

このドキュメントの最後にあるサンプルセクションでは、現在のブランディングガイドラインに準拠している他の例を紹介しています。

クライアントサイド API

クライアントサイドのダイナミックリンクの中核にあるのは、1 冊以上の書籍に関する情報をリクエストする URL を作成し、<script> タグを使用して Google ブックスにリクエストを送信できる URL 形式です。

構文の例:: <script src="https://books.google.com/books?bibkeys=ISBN:0451526538&jscmd=viewapi&callback=mycallback"></script>

リクエストの形式

この URL の形式は、書籍にリンクするために使用される URL 構文に似ていますが、書籍 ID フィールドには複数の書籍 ID をカンマ区切りで指定し、「jscmd」と「callback」パラメータを追加することができます。必要に応じて、追加の引数を指定して、視認性フィルタを制御することもできます。

Dynamic Links は、書籍を特定するさまざまな方法（ISBN、OCLC 番号、LCCN キー）をサポートしています。この API では、GET リクエストの最大サイズまでのバッチクエリを実行できます。

ISBN: &bibkeys=ISBN:0451526538（API は ISBN 10 と 13 の両方をサポートしています）
オフラインコンバージョンアクション: &bibkeys=OCLC:36792831
LCCN: &bibkeys=LCCN:96072233

JSON の結果の形式

この呼び出しからのレスポンスは、リクエストされた書籍に関する情報で、1 つ以上の JSON オブジェクトとして返されます。JSON オブジェクトの構造は次のとおりです。

JsonSearchResult {
    string bib_key;
    string info_url;
    string preview_url;
    string thumbnail_url;
    string preview;
};

これらのフィールドには次の情報が表示されます。

bib_key: この書籍のクエリに使用される識別子。
info_url: Google ブックス内の書籍に関する情報を含むページ（この書籍の概要ページ）の URL。
preview_url: 書籍のプレビューへの URL。ユーザーは書籍の表紙に直接移動できます。リクエストで取得できる書籍が「スニペット表示」または「プレビューなし」のみの場合、プレビュー URL は返されません。
thumbnail_url: 書籍の表紙のサムネイルへの URL。
プレビュー: 書籍の視認性状態を示す値。full（完全表示の書籍の場合）、partial（限定プレビューの書籍の場合）、noview（スニペットまたはプレビューなしの書籍の場合）です。
埋め込み可能: ブック検索の埋め込みビューアを使用してサードパーティのページに書籍を埋め込むことができる場合、このブール値は true です。

Dynamic Links

目次

視聴者

ブック検索の用語

はじめに

ブランドの取り扱いガイドライン

ブランディングの例

クライアントサイド API

リクエストの形式

JSON の結果の形式

パラメータと追加フィールド

同期モードと非同期モード

非同期モード

同期モード

よくある質問

コードサンプル