GSearchControl()google.search.SearchControl()

新しい検索コントロール オブジェクトを作成します。検索コントロール オブジェクトはサーチャー、つまり GSearchgoogle.search.Search インターフェースを実装するオブジェクトのコンテナです。検索コントロール オブジェクトは、1 つ以上の子サーチャーを持つまで動作しません。検索コントロールは .draw() メソッドを使う HTML コンテナにバインドされています。検索コントロールの draw() メソッドが呼び出されている場合、サーチャー オブジェクトが検索コントロールに追加されない可能性があることに注意してください。

想定される動作順は次のとおりです:

• sc = new GSearchControl()google.search.SearchControl();
• sc.addSearcher();
• sc.draw();

これらの手順が発生すると、検索コントロールはアクティブになり、検索をいつでも実行開始できます。

.addSearcher(searcher, opt_options?)

このメソッドは、検索コントロールにサーチャー オブジェクトを追加します。追加されると、検索コントロールがそのサーチャーのアクティビティを調整します。検索実行の調整、関連検索完了イベントの処理、結果のレンダリング先の提供、検索結果を保持またはクリッピングするための UI の提供を行います。

メソッドは、各種のサーチャー固有のオプションを指定するために使われる GsearcherOptionsgoogle.search.SearchOptions オブジェクト (省略可能) を受け入れます。:

• searcher - サーチャー オブジェクトを指定します。
• opt_options - 指定した場合、このサーチャーのための設定オプションとなります。
• 戻り値 - n/a

.setTimeoutInterval(timeoutInterval)

アプリケーション側で入力コントロールを用意し、それを使うように検索コントロールに依頼する場合、検索コントロールは、入力タイマーを使って、いつ検索を実行するかを決定します。ユーザーが検索コントロールのテキスト入力領域に入力するたびに、カウントダウン タイマーが初期化されます。タイマーが実行されると、検索がリクエストされます。最後のキーストロークから検索開始までの間隔は、この API を使ってプログラムされます。注: コントロールのデフォルト値は GSearchControlgoogle.search.SearchControl.TIMEOUT_MEDIUM (約 500ms) です。

• timeoutInterval - timeoutInterval の値、つまり最後のキーストロークから、それによる検索の実行までの間隔を指定します。有効な値は次のとおりです:
  • GSearchControlgoogle.search.SearchControl.TIMEOUT_SHORT - 非常に短いディレイ（350ms 以下）を指定するために使われます。
  • GSearchControlgoogle.search.SearchControl.TIMEOUT_MEDIUM - 中程度のディレイ（500ms 以下）を指定するために使われます。
  • GSearchControlgoogle.search.SearchControl.TIMEOUT_LONG - 長いディレイ（700ms 以下）を指定するために使われます。
• 戻り値 - n/a

.setOnKeepCallback(object, method, opt_keepLabel?)

このメソッドは、検索コントロールによって管理されている検索結果のいずれかを、ユーザーがコピーのために選択したときに通知されることを呼び出し側が望んでいる、ということを検索コントロールに知らせるために使われます。このメソッドが呼び出されない場合、ユーザーには検索結果をコピーする機会が与えられません。メソッドが呼び出されると、各検索結果の下に、テキスト リンクの注釈が付けられます。このリンクをクリックすると、指定されたオブジェクト上で、検索結果に関連付けられた GResultgoogle.search.Result オブジェクトを経由して、指定されたメソッドが呼び出されます。このメソッドを使うと、呼び出し側では、組み込みシステムによって定義されたラベル値を指定して、ユーザーに結果をコピーするよう促すことができます。また、呼び出し側アプリケーションにとってより有効な情報となるラベルを指定することもできます。システム定義ラベルを使う場合、値は、残りのコントロールが実行されるときに使われる言語に自動的に翻訳されます。

• object - 指定されたメソッドが呼び出されるコンテキストを定義するアプリケーション レベルのオブジェクトを指定します。
• method - 呼び出すメソッドを指定します。たとえば、このメソッドが .setOnKeepCallback(foo, MyObject.prototype.myKeephandler) として呼び出される場合、ユーザーが keep ラベルをクリックすると foo.myKeephandler() の呼び出しが行われます。
• opt_keepLabel - 各検索結果の下にあるオプションのテキスト ラベルを指定します。このラベルがクリックされると、指定されたオブジェクト/メソッドへのコールバックがトリガーされます。有効な値は次のとおりです:
  • GSearchControlgoogle.search.SearchControl.KEEP_LABEL_SAVE - save のラベル値
  • GSearchControlgoogle.search.SearchControl.KEEP_LABEL_KEEP - keep のラベル値
  • GSearchControlgoogle.search.SearchControl.KEEP_LABEL_INCLUDE - include のラベル値
  • GSearchControlgoogle.search.SearchControl.KEEP_LABEL_COPY - copy のラベル値（デフォルト）
  • GSearchControlgoogle.search.SearchControl.KEEP_LABEL_BLANK - 空欄のラベル値が使われます。グラフィック（CSS を経由して選択可能）をコピーするだけの場合に便利です。
  • 他の任意の値 - 渡された値がラベルになります。呼び出し側がローカリゼーションを担当します。
• 戻り値 - n/a

.cancelSearch()

このメソッドは、検索結果完了の受信を無視するよう検索コントロールに指示するのに使われます。このメソッドによって使われる内部状態は、新しい検索がリクエストされるたびに検索できるように、リセットされます。このメソッドの想定される使用法は、検索語句がゆっくり入力された場合に、意図と異なる語句による検索が行われ、それに伴って発生することがある UI の点滅への対応を支援することです。入力が検出されるたびにこのメソッドを使うことによって、入力の一部に基づく前回の検索を容易に無視することができます。

• 戻り値 - n/a

.setLinkTarget(linkTarget)

このメソッドは、検索結果に埋め込まれたリンクで使われるリンク ターゲットを設定するために呼び出されます。デフォルト値は GSearchgoogle.search.Search.LINK_TARGET_BLANK で、リンク先のページが新しいブラウザ ウィンドウに表示されることを示します。このメソッドが呼び出されると、検索コントロールを範囲とするリンクのターゲット設定が確立されます。これは、検索コントロールに現在アタッチされているすべてのサーチャーと、それ以降にコントロールに追加されたすべてのサーチャーに影響します。

• linkTarget - リンク先のページを表示するターゲット フレームを指定します。有効な値は次のとおりです:
  • GSearchgoogle.search.Search.LINK_TARGET_BLANK - リンク先のページを新しいウィンドウに表示します。たとえば <A href=... target=_blank ...>
  • GSearchgoogle.search.Search.LINK_TARGET_SELF - リンク先のページを同じウィンドウおよびフレームに表示します。たとえば <A href=... target=_self ...>
  • GSearchgoogle.search.Search.LINK_TARGET_TOP - リンク先のページを一番上のフレームに表示します。たとえば <A href=... target=_top ...>
  • GSearchgoogle.search.Search.LINK_TARGET_PARENT - リンク先のページを一番上のフレームに表示するか、現在のフレームを置き換えます。例: <A href=... target=_parent ...>
  • その他 - リンク先のページを指定されたフレームまたはウィンドウで表示します。例: <A href=... target=anything-else ...>
• 戻り値 - n/a

.setSearchStartingCallback(object, method)

このメソッドは、検索が開始される直前に通知されることを呼び出し側が望んでいるということを検索コントロールに知らせるために使われます。この呼び出しの粒度は、検索コントロール レベルではなく、サーチャー レベルですので注意してください。つまり、検索コントロールに 5 つのサーチャーがあるときに検索を実行すると、各サーチャーが検索開始を指示されるたびにこのメソッドが呼び出されるということです。

• object - 指定されたメソッドが呼び出されるコンテキストを定義するアプリケーション レベルのオブジェクトを指定します。
• method - 呼び出すメソッドを指定します。たとえば、このメソッドが .setSearchStartingCallback(foo, MyObject.prototype.mySearchStarting) として呼び出される場合、検索が開始されると foo.mySearchStarting(searchControl, searcher, query) の呼び出しが行われます。コールバックの最初の引数 searchControl は検索コントロールを指定します。2 番目の引数 searcher は検索を開始しようとしているサーチャーを指定します。3 番目の引数 query はクエリを指定します。
• 戻り値 - n/a

.inlineCurrentStyle(node, opt_deep?)

このユーティリティ関数は、指定された HTML ノード（または、opt_deep が指定されていればツリー）のために、現在計算されているスタイルをクローニングし、現在のスタイルをノードにインライン化するために使われます。この関数は特定の場合に便利です。主に、アプリケーション間で HTML の一部を受け渡す際に、一連の HTML スタイルを維持したいが、関連付けられたスタイルシートが受け取り側のアプリケーションにない場合に、keep ハンドラと組み合わせて使います。このシナリオの最も単純な例はメール アプリケーションです。たとえば、ユーザーは Google AJAX Search API を使って検索結果をメッセージ作成ウィンドウにクリッピングし、そのメッセージが別のユーザーに HTML として送信されます。受信者のメール アプリケーションによっては、Google AJAX Search API に対応しておらず、そのスタイルシートがないことがあります。このメソッドはそのような場合も考慮しています。発信側のメール アプリケーションが現在のスタイルシートをインライン化できるようにすることにより、意図どおりの形で受信者にメッセージが表示されるようにしています。

• node - スタイルがインライン化される HTML ノードを指定します。
• opt_deep - 指定される場合、インライン操作は現在のノードとその子孫に対してスタイルを回帰的にインライン化します。
• 戻り値 - n/a

このメソッドは、Safari ウェブ ブラウザ上では現在実装されていませんので注意してください。

GSearchFormgoogle.search.SearchForm(enableClear, element)

新しい検索フォーム オブジェクトを作成します。検索フォーム オブジェクトは、ユーザー インターフェース要素、メソッド、プロパティ、アプリケーションから GSearchgoogle.search.Search() オブジェクトのコレクションを制御するために設計されたコールバックを提供します。ユーザー インターフェースと機能は、GSearchControlgoogle.search.SearchControl()) を使って、アプリケーションが使用できるものを一致させます (実際、GSearchControlgoogle.search.SearchControl() は内部的にこのオブジェクトに基づいています。

想定される動作順は次のとおりです:

• sf = new GSearchFormgoogle.search.SearchForm(true/false, container);
• sf.setOnSubmitCallback(object, method);
• オプション - sf.setOnClearCallback(object, method);

これらの手順が発生すると、検索フォームはアクティブになり、ユーザー入力の受け取りをいつでも開始して処理できます。

メソッドは、必須の enableClear 引数と必須の element 引数を受け入れます。

• enableClear - true の場合、検索フォームはクリア ボタンを含みます。それ以外の場合、クリア ボタンは作成されません。
• element - このフォームのコンテナとなる HTML ノードを指定します。

.setOnSubmitCallback(object, method)

このメソッドは、検索フォームが送信されたときに呼び出されるオブジェクト/メソッドの組み合わせを登録します。このイベントは、ユーザーが検索ボタンをクリックするか、テキスト入力要素にフォーカスがある間にユーザーが Enter キーを押すと発生します。発生すると、指定されたオブジェクトはアクティブ オブジェクトになり、指定されたメソッドが呼び出されます。メソッドに渡される引数はこの検索フォームです。

典型的にはメソッドは以下のようになります:

App.prototype.onSubmit = function(form) {
  if (form.input.value) {
    this.localSearcher.execute(form.input.value);
  }
  return false;
}
                

上の例では、検索フォームがメソッドに渡され、メソッドは false を戻して、送信イベントを処理したことを示すことに注意してください。

• object - 指定されたメソッドが呼び出されるコンテキストを定義するアプリケーション レベルのオブジェクトを指定します。
• method - 呼び出すメソッドを指定します。メソッドはこのフォームへの参照を渡されます。false を戻す必要があります。

.execute(opt_string?)

このメソッドを使うと、アプリケーションからフォームを送信できます。これにはオプションで、フォームのテキスト入力要素の設定と、続いて .setOnSubmitCallback() を使って確立された、登録済みの送信時コールバック メソッドを呼び出す処理を含みます。

• opt_string - 存在する場合、送信時コールバック メソッドを呼び出す前に、フォームのテキスト入力要素に入力された状態になっている文字列値を指定します。
• 戻り値 - n/a

.input

このプロパティはフォームのテキスト入力要素です。アプリケーションはこのプロパティを自由に読み書きできます。一般的には、送信時コールバック ハンドラで使用されます。コントロールの下にあるサーチャー上で form.input.value を呼び出すことによって、アプリケーションは .execute() を読んでからこの文字列を処理します。

.userDefinedCell

検索フォームの内部構造は 1 対の HTML テーブルです。上のテーブルには、テキスト入力要素、ローカライズされた検索ボタン、およびオプションのクリア ボタンが含まれています。下のテーブルには、テーブル内の左側セルであるアプリケーション固有の自由なセルと、テキストと画像を含む Google ブランド表示が含まれます。このプロパティ、.userDefinedCell プロパティは、アプリケーション固有のコンテンツを持つように作成されたテーブル セルの DOM ノードです。アプリケーションはこの空間を自由に使って、検索フォームに密接な関係がある情報を、標準の Google ブランド表示と揃えて配置することができます。

GSearchgoogle.search.Search()

新しいサーチャー オブジェクトを作成します。注: これは基本クラスなので、アプリケーションがこのコンストラクタを直接使う可能性は高くなく、アプリケーションはその代わりにコンストラクタをサービス固有のサーチャー オブジェクト作成の副作用として使います (例: GwebSearchgoogle.search.WebSearch)。

.setResultSetSize(indicator)

このメソッドは、この特定のサーチャーによって戻される結果の数を選択するために呼び出されます。ただし、これはスカラーではありません。少数の結果と多数の結果のいずれかを示す列挙です。将来的には、このメソッドは中規模、および非常に大規模な結果セットをサポートするように拡張される可能性があります。

• indicator - 戻す検索結果の数を示す列挙を指定します。有効な値は次のとおりです。
  • GSearchgoogle.search.Search.LARGE_RESULTSET - 多数（通常は 8 件）の結果をリクエストします。
  • GSearchgoogle.search.Search.SMALL_RESULTSET - 少数（通常は 4 件）の結果をリクエストします。
• 戻り値 - n/a

.clearResults()

検索が正常に完了すると、サーチャー オブジェクトは、特定の検索から得られたものを記述する検索結果のコレクションを維持します。このメソッドは、サーチャーをリセットするために使われ、結果をすべてクリアします。このメソッドは、新しい検索の実行前に暗黙のうちに呼び出されます。

• 戻り値 - n/a

.setSearchCompleteCallback(object, method, opt_arguments?)

このメソッドは、検索完了時に通知するオブジェクトとメソッドを登録するために使われます。アプリケーションは、オプションで、opt_arguments を使ってコンテキスト引数を渡すことがあります。続いて引数は指定されたメソッドに渡されます。

• object - 指定されたメソッドが呼び出されるコンテキストを定義するアプリケーション レベルのオブジェクトを指定します。
• method - 呼び出すメソッドを指定します。たとえば、このメソッドが .setSearchCompleteCallback(foo, MyObject.prototype.mySearchCompleteHandler) として呼び出される場合、このサーチャーでの検索が完了すると foo.mySearchCompleteHandler(opt_arguments?) の呼び出しが行われます。
• 戻り値 - n/a

.setUserDefinedClassSuffix(classSuffix)

このメソッドは、検索結果セクションと、このサーチャーが検索コントロールで取得した検索結果コレクションの、ユーザー定義のクラス接尾辞を設定するために使われます。このメソッドを使う目的は、アプリケーションが、個別の検索結果セットの結果とヘッダーに特有のスタイルを設定できるようにすることです。このメソッドが「siteSearch」という値とともに呼び出されると想定すると、gsc-resultsRoot-siteSearch のクラスが、このサーチャーに関連するヘッダーと結果をラップする DIV 要素に適用されます。これは汎用 gsc-resultsRoot クラスへの追加であることに注意してください。

• classSuffix - gsc-resultsRoot- に付加されるユーザー定義のクラス接尾辞を指定します。このクラスは、このサーチャーに関連するヘッダーと結果をラップする DIV 要素に追加されます。
• 戻り値 - n/a

.setNoHtmlGeneration()

アプリケーションが検索コントロールを使っておらず、検索結果のプロパティの一部を使い、高度にカスタマイズされたフォーマットでそれを表示している場合があります。そのような場合は、アプリケーションで小規模な最適化を行うことができます。サーチャーは .html プロパティを生成しないようにプログラムできます。その場合、結果で有効な未加工のプロパティだけを利用できます。

• n/a - 入力引数なし
• 戻り値 - n/a

.setQueryAddition(term)

このメソッドは、サーチャーを介したすべてのクエリに不可される、省略可能な追加のクエリ語句を呼び出し側が設定（またはクリア）することを可能にします。これを使うと通常、オリジナルの検索語句と多少異なる結果を提供できます。たとえば、GwebSearchgoogle.search.WebSearch() ベースのサーチャーが、この関数を search.setQueryAddition("filetype:pdf"); として呼び出し、「google」のクエリを実行すると、「google filetype: pdf」のクエリを実行した場合と同じ結果が得られます。この API を使う場合は、ユーザーのクエリが変更されたことを示せるように、.setUserDefinedLabel() を使うことを強くおすすめします。これは .setSiteRestriction() の使用時と同じ、一般的なアドバイスです。詳細はサンプルをご覧ください。

• term - このサーチャーを介した各クエリに付加される式を指定します (スペースを指定する必要はありません)。term の値が "" の場合、この API の効果はキャンセルされ、クエリは変更されません。
• 戻り値 - n/a

.gotoPage(page)

検索が完了した後、cursor プロパティがサーチャー オプション上に表示されることがあります。これは、利用できる検索結果数の関数で、サーチャーの基礎となる機能です。cursor プロパティが存在する場合、このメソッドを使うと、別の検索結果群をフェッチできます。アプリケーションは page 引数を使うことによってどのページかを指定します。次にこの値が cursor.pages 配列をインデックス化するため、そして最終的には &start URL 引数の値を計算するために使われます。

• page - アプリケーションが求める結果のページ番号を指定します。この値は .cursor.pages プロパティに相対的にチェックされる範囲で、ページが範囲外であったり、基礎をなしているサーチャーに cursor プロパティがなかったりする場合、処理が行われません。
• 戻り値 - n/a

.scaleImage(width, height, imageScaler, opt_img)

このメソッドは、縦横比を変えずに画像の大きさをスケールするために使用される、静的ヘルパー関数です。現在の画像の縦と横の長さ、および imageScaler オブジェクト（.width プロパティと .height プロパティを含む）を渡すと、縦横比を保ってスケールされた imageScaler オブジェクトを関数が計算して戻します。戻されたオブジェクトの .height プロパティと .width プロパティを使って画像要素を作ることができます。

内部的には、GvideoSearchgoogle.search.VideoSearch オブジェクトが、サムネイルをスケールするために使う画像スケーラを定義します。アスペクト比 4 × 3 を維持するよう設計されており、次のように定義されています。

// imageScaling defaults 4x3 100x75 image
this.imageScaler = {width:100,height:75};
                

サムネイルの img 要素の作成時に、次のようにサムネイル画像のスケール後の縦と横の長さを計算します:

// scale the thumbnail image using the searcher's .imageScaler.
// By default this is a 4x3 100x75 image,
// but its settable using .setVideoResultsTbHeight as well
var scaled = GSearchgoogle.search.Search.scaleImage(result.tbWidth,
                                result.tbHeight,  this.imageScaler);

// scaled.height and scaled.width now contain
// the values needed to proportionally scale the thumbnail
                

• width - 画像の元の横幅
• height - 画像の元の縦の長さ
• imageScaler - .height プロパティと .width プロパティで画像スケール後の縦と横の長さを指定する imageScaler オブジェクト。
• opt_img - オプションの img オブジェクトを指定します。指定されると、.height プロパティと .width プロパティがこの呼び出しによって設定されます。
• 戻り値 - .height プロパティと .width プロパティに縦横比を維持してスケールされた画像の寸法を含む imageScaler オブジェクト

.setOnLoadCallback(handler)^New!

このメソッドは、この呼び出しが含まれているドキュメントがロードされると呼び出される、指定されたハンドラ関数を登録する静的なヘルパー関数です。以前のドキュメントでは、ボディ要素の onload 属性（例: <body onload="OnLoad()">）の使用をおすすめしていました。ページと、ページによってロードされるすべてのコードを完全に制御しているときはそれでもよいのですが、この手法は、一部のランタイムで body.onload ハンドラが壊される問題の原因になることがあります。setOnLoadCallback() にはこの問題はないので、Google では、ドキュメント ロード時 (AJAX Search API が完全にロードされ、使用できる状態になったとき) にコードを呼び出すコールバックを登録する場合に、この方法をおすすめします。

• handler - これを含むドキュメントがロードされ、Search API が使用できる状態になると呼び出される必須の関数。
• 戻り値 - n/a

.results[]

このプロパティは、検索結果 1 件につき 1 つの検索結果オブジェクトの配列を含んでいます。このプロパティは検索を実行するたびにクリアされ、検索が完了するごとに配列に値が入れられます。レポートする結果がない場合、この配列の .length プロパティは 0 に設定されます。

GwebSearchgoogle.search.WebSearch()

このコンストラクタは、Google ウェブ検索サービスからの検索結果を提供するために設計されたサーチャー オブジェクトのインスタンスを作成するために使われます。

.setSiteRestriction(site, opt_refinement, opt_moreResultsTemplate)

このメソッドは、このサーチャーによって戻されるウェブ検索の結果を制限するために使われます。検索結果を www.amazon.com 上のものに制限するには、単にこのメソッドを呼び出して値「www.amazon.com」を渡します。サイト制限をクリアするには、null の値を渡します。次のスニペットは、「amazon.com」へのサイト制限を設定する例を示します。より完成度の高いサンプルを、サイト制限のサンプルで参照できます。

var siteSearch = new GwebSearchgoogle.search.WebSearch();
siteSearch.setSiteRestriction("amazon.com");
                

このメソッドを使うと、呼び出し側で検索を Google のカスタム検索エンジンに制限することができます。このメソッドに URL パスを指定する代わりに、カスタム検索エンジン ID を渡します。次のスニペットは、ID が 000455696194071821846:reviews であるカスタム検索エンジンへのサイト制限設定の例を示します。より完成度の高いサンプルを、カスタム検索エンジン サンプルで参照できます。

var siteSearch = new GwebSearchgoogle.search.WebSearch();
siteSearch.setSiteRestriction("000455696194071821846:reviews");
                

このように使われる場合、opt_refinementを使って、省略可能なカスタム検索エンジン リファインメントを指定できます。このメカニズムを使って、検索エンジンのサブセットに対し、サイトを制限することができます。opt_refinement で指定された値は、指定された検索エンジンと関連付けられているカスタム検索エンジン リファインメント ラベルと一致する必要があります (下のコード スニペットを参照してください)。より完成度の高いサンプルを、カリキュラム検索エンジンのサンプルで参照できます。

var cseId = "017576662512468239146:omuauf_lfve";
var siteSearch = new GwebSearchgoogle.search.WebSearch();
siteSearch.setSiteRestriction(cseId, "Lectures");
                

カスタム検索エンジンには、カスタマイズされた検索結果の表示ページが含まれることがあります。これをサポートするために、カスタム検索エンジン サイト制限が設定されている場合、オプションの opt_moreResultsTemplate 値が指定されることがあります。これは、[その他の結果] リンクを検索結果セットの一番下に生成するために使われる URL テンプレートを指定します。URL テンプレートは、プレースホルダ「__QUERY__」および「__HL__」を含む必要があります。[その他の結果] リンクを生成するとき、システムはこれらのプレースホルダを現在のクエリ語句と UI 言語に置き換えます。このサンプルは、メインおよび左側のタブにおけるこのメカニズムの使用法を示しています: カリキュラム検索のサンプル。

カスタム検索エンジンの最新の拡張が、リンク済みカスタム検索エンジンです。これをサポートするために、サイト制限を指定する新しい匿名オブジェクト モードに加えて、上に示したオプションとモードのすべてをサポートするように、site 引数が拡張されました。site 引数がオブジェクトの場合、次のプロパティのいずれかが存在することがあります（優先順位順。つまり、複数のプロパティを指定した場合、下のリストで先に記載されているプロパティが優先されます）。

• siteUrl - 検索は指定された URL に相対的です。
• cseId - 検索は、指定されたカスタム検索エンジン ID（例: 000455696194071821846:reviews）に相対的です。
• crefUrl - 検索は、指定された URL によって参照されるリンク済みカスタム検索エンジンに相対的です。詳細は、このサンプルを参照してください。

cseId または crefUrl が指定される場合、opt_refinement を使って、省略可能なカスタム検索エンジン リファインメントを指定できます。このメカニズムを使って、検索エンジンのサブセットに対し、サイトを制限することができます。opt_refinement で指定された値は、指定された検索エンジンと関連付けられているカスタム検索エンジン リファインメント ラベルと一致する必要があります (下のコード スニペットを参照してください)。

searcher = new google.search.WebSearch();
searcher.setSiteRestriction(
  {
    crefUrl : "http://www.google.com/cse/samples/vegetarian.xml"
  },
  "recipes");
                

• site - 部分的な URL（例: 「www.amazon.com」、「google.com」など）、またはカスタム検索エンジン ID（例: "000455696194071821846:reviews"、"000455696194071821846:shopping" など）の形式でサイト制限設定を指定します。他の方法として、上で説明したように、匿名のオブジェクトを含めることができます。
• opt_refinement - site がカスタム検索エンジンを参照するとき、この省略可能な引数の値はカスタム検索エンジン リファインメントを指定します。
• opt_moreResultsTemplate - site がカスタム検索エンジンを参照するとき、この省略可能な引数の値は、検索コントロールで検索結果セットの下に表示される [その他の結果] リンクを作成するために使われる URL テンプレートを指定します。URL テンプレートは、プレースホルダ「__QUERY__」および「__HL__」を含む必要があります。[その他の結果] リンクを生成するとき、システムはこれらのプレースホルダを現在のクエリ語句と UI 言語に置き換えます。
• 戻り値 - n/a

GlocalSearchgoogle.search.LocalSearch()

このコンストラクタは、Google ローカル検索サービスからの検索結果を提供するために設計されたサーチャー オブジェクトのインスタンスを作成するために使われます。

.setCenterPoint(location)

このメソッドは、検索結果のスコープを設定するために使われる中心点を決定します。1 つのバリアントを受け入れます。これには文字列、GMap2google.maps.Map2、または GLatLnggoogle.maps.LatLng を指定できます。文字列の場合、文字列を GLatLnggoogle.maps.LatLng に解決しようとします。

• location - ローカル検索にスコープを設定するために使われる中心点を指定します。この引数はバリアントで、次を指定できます:
  • GMap2google.maps.Map2 プロパティがあることによって認識される getCenter()。この場合、指定されたマップの中心点がキャプチャされ、検索結果をスコープするために使われます。
  • x プロパティがあることによって認識される GLatLnggoogle.maps.LatLng。この場合、この点の値がキャプチャされ、ローカル検索のスコープを設定するための中心点として使用されます。
  • 名前によって住所を指定する string。この引数がある場合、検索式の一部として location の近くを指定し、ユーザーが Google ローカル検索を実行したかのように検索のスコープが設定されます。注: 文字列 location は非同期で GLatLnggoogle.maps.LatLng に解決されるため、このメソッドを使った場合、ジオコーディング処理が正常に完了すると、検索はこの場所に相対的に行われます。
• 戻り値 - n/a

.setRestriction(type, opt_value)

このメソッドは、このサーチャーによって戻される結果セットへの制限を指定またはクリアするために使われます。制限を確立するには、type と opt_value の両方が指定され、有効である必要があります。制限をクリアするには、type に有効な値を指定し、opt_value の値として null を指定するか、何も指定しません。

この API は、現在次の制限タイプをサポートします:

• GSearchgoogle.search.Search.RESTRICT_TYPE - これが type の値として指定される場合、次のタイプの opt_value を指定できます。
  • GlocalSearchgoogle.search.LocalSearch.TYPE_BLENDED_RESULT - KML の結果および通常のローカル検索結果とジオコードの両方が返されます。
  • GlocalSearchgoogle.search.LocalSearch.TYPE_KMLONLY_RESULTS - KML の結果とジオコードの結果のみが返されます。
  • GlocalSearchgoogle.search.LocalSearch.TYPE_LOCALONLY_RESULTS - ローカル検索結果とジオコードの結果のみが返されます（注: これはデフォルト設定で、API の従来の動作と同じです）。

このメソッドは次の引数を受け取ります。

• type - 確立する制限のタイプを指定します。
  • GSearchgoogle.search.Search.RESTRICT_TYPE
• opt_value - 指定された制限タイプの値を指定します。値が null の場合、指定された制限はクリアされ、デフォルト設定に戻ります。それ以外の場合、値は type の値に相対的に有効である必要があります。その場合、制限が確立されます。上を参照してください。

.resizeStaticMapUrl(result, height, width, opt_zoom?)

このユーティリティ関数は、指定された結果の staticMapUrl プロパティに関連付けられた画像のサイズを変更するようにできています。このプロパティは、完了時に、サイズを変更された静的なマップ画像を表す新しい値に置き換えられます。省略可能なズーム パラメータを渡して、サイズとズーム レベルの両方をこのメソッドで操作することができます。静的なマップ画像のデフォルト サイズは、中程度のズーム レベル GlocalSearchgoogle.search.LocalSearch.STATIC_MAP_ZOOM_DEFAULT で 150 × 100 ピクセルです。静的マップ タイルのサンプルはこのメソッドを使う方法の 1 つを示しています (次のスニペットを参照してください)。

var img = document.createElement("img");
google.search.LocalSearch.resizeStaticMapUrl(result, 80, 120);
img.src = result.staticMapUrl;
img.title = result.titleNoFormatting;
                

• result - サイズ変更される静的なマップ画像を持つ結果オブジェクトを指定します。完了時に、この結果オブジェクトの staticMapUrl プロパティが変更されます。
• height - 新しい画像の縦の長さを指定します（単位はピクセル）。デフォルトの縦の長さは 100 ピクセルです。
• width - 新しい画像の横の長さを指定します（単位はピクセル）。デフォルトの横の長さは 150 ピクセルです。
• opt_zoom - マップのズーム レベルを指定します (省略可能)。ズーム レベルが指定されない場合、値は変更されず、デフォルト値の GlocalSearchgoogle.search.LocalSearch.STATIC_MAP_ZOOM_DEFAULT のままです。有効な値は GlocalSearchgoogle.search.LocalSearch.STATIC_MAP_ZOOM_CLOSEST から GlocalSearchgoogle.search.LocalSearch.STATIC_MAP_ZOOM_FARTHEST までです。
• 戻り値 - staticMapUrl の新しい値が戻されます。

ytchannel: の述部を使用すると、アプリケーションは検索を実行して、指定したチャンネルのみから動画結果を取得できます。たとえば、ytchannel:BarackObamadotcom という検索式は、BarackObamadotcom YouTube チャンネルから動画コレクションを返します。ytchannel ディレクティブの直後に式（省略可能）を追加すると、アプリケーションは指定したチャンネル（例: ytchannel:BarackObamadotcom oil）でその式を検索できます。

ytfeed:most_viewed と ytfeed:recently_featured の述部は、ytfeed:top_rated の述部と同じです。これらは、異なる YouTube の特別フィードを対象としているという点で異なります。

GvideoSearchgoogle.search.VideoSearch()

このコンストラクタは、Google ウェブ検索サービスからの検索結果を提供するために設計されたサーチャー オブジェクトのインスタンスを作成するために使われます。

.setResultOrder(orderBy)

このサーチャーのデフォルトの挙動は、関連度順に結果を戻すことです。場合により、日付順に結果を表示しても便利なことがあります。このメソッドは、結果の順序を変更するために使えます。

• orderBy - 目的の結果順を指定します:
  • GSearchgoogle.search.Search.ORDER_BY_RELEVANCE - デフォルト。結果が関連度順に戻されることを示します。
  • GSearchgoogle.search.Search.ORDER_BY_DATE - この値は、結果が公開日順に戻されることを示します。
• 戻り値 - n/a

GblogSearchgoogle.search.BlogSearch()

このコンストラクタは、Google ブログ検索サービスからの検索結果を提供するために設計されたサーチャー オブジェクトのインスタンスを作成するために使われます。

.setSiteRestriction(site)

このメソッドは、このサーチャーによって戻されるブログ検索の結果セットを制限するために使われます。結果を blogspot.com 上のすべてのブログ結果に制限するには、値を「blogspot.com」にしてこのメソッドを呼び出します。結果を Live Journal 上の Nintendo DS ブログに制限するには、「http://community.livejournal.com/nintendo_ds/」で呼び出します。サイト制限をクリアするには、null の値を渡します。

• site - サイト制限設定を指定します。例: 「blogspot.com」、「http://community.livejournal.com/nintendo_ds/」など
• 戻り値 - n/a

GnewsSearchgoogle.search.NewsSearch()

このコンストラクタは、Google ニュース サービスからの検索結果を提供するために設計されたサーチャー オブジェクトのインスタンスを作成するために使われます。

.setSiteRestriction(site)

このメソッドは、このサーチャーによって戻されるニュース検索の結果セットを制限するために使われます。結果を、Seattle Times からのすべてのニュース結果に制限するには、値を「Seattle Times」にしてこのメソッドを呼び出します。結果を、CNN からの結果に制限するには、「CNN」で呼び出します。ニュース ソースのタイトルが、スペースまたはアンダースコア（「_」）で分割されているパターンです。サイト制限をクリアするには、null の値を渡します。

• site - サイト制限設定を指定します。例: 「Seattle Times」、「CNN」などです。
• 戻り値 - n/a

.setRestriction(type, value)^New!

このメソッドは、通常のサイト制限を超えてこのサーチャーが返すニュース検索の結果を制限するために使用します。最初の引数 type には必要な制限のタイプを指定し、値はタイプによって異なります。null 値を指定すると、指定されている制限がクリアされます。

• type - 制限のタイプを指定します。現在サポートされている唯一の値は GSearchgoogle.search.Search.RESTRICT_EXTENDED_ARGS です。
• value - 制限のための値または null を指定して制限をクリアします。GSearchgoogle.search.Search.RESTRICT_EXTENDED_ARGS の type では、この引数は名前値のペアを含むオブジェクトを指定し、名前は geo, qsid, topic, or ned のいずれかで、それぞれの値は、前のセクションで説明されているように、CGI 引数に関連付けられた値です。

  たとえば、次のコードでは、ニュース サーチャーは Google ニュースのドイツ版のビジネス トピックに制限されます。

  searcher = new google.search.NewsSearch()
  searcher.setRestriction(google.search.Search.RESTRICT_EXTENDED_ARGS,
                          { "topic" : "b", "ned" : "de"});
                    

• 戻り値 - n/a

GbookSearchgoogle.search.BookSearch()

このコンストラクタは、Google ブック検索サービスからの検索結果を提供するために設計されたサーチャー オブジェクトのインスタンスを作成するために使われます。

.setRestriction(type, opt_value)

このメソッドは、このサーチャーによって戻される結果セットへの制限を指定またはクリアするために使われます。制限を確立するには、type と opt_value の両方が指定され、有効である必要があります。制限をクリアするには、type に有効な値を指定し、opt_value の値として null を指定するか、何も指定しません。

この API は、現在次の制限タイプをサポートします:

• GSearchgoogle.search.Search.RESTRICT_TYPE - これを type の値として指定する際に GbookSearchgoogle.search.BookSearch.TYPE_FULL_VIEW_BOOKS の opt_value を指定すると、結果が「全体表示」のみに制限されます。GbookSearchgoogle.search.BookSearch.TYPE_ALL_BOOKS の値を指定すると、サーチャーはすべての書籍を戻すことがあります。ただし、GSearchgoogle.search.Search.RESTRICT_TYPE 制限がクリアされたとき、これは有効なデフォルトおよび挙動です。
• GSearchgoogle.search.BookSearch.USER_LIST - type の値としてこれが指定された場合、opt_value の値が、ユーザーのライブラリを指定するために使われます。クエリは、このライブラリに存在する書籍のみに制限されます。null の値を指定するとこの制限がクリアされ、すべてのライブラリのすべての書籍が検索対象になります。ただし、これがデフォルトの挙動です。

• タイプ - 確立する制限のタイプを指定します:
  • GSearchgoogle.search.Search.RESTRICT_TYPE
  • GSearchgoogle.search.BookSearch.USER_LIST
• opt_value - 指定された制限タイプの値を指定します。値が null の場合、指定された制限はクリアされます。それ以外の場合、値は type の値に相対的に有効である必要があります。その場合、制限が確立されます。上を参照してください。

GimageSearchgoogle.search.ImageSearch()

このコンストラクタは、Google 画像検索サービスからの検索結果を提供するために設計されたサーチャー オブジェクトのインスタンスを作成するために使われます。

.setRestriction(type, opt_value)

このメソッドは、このサーチャーによって戻される結果セットへの制限を指定またはクリアするために使われます。制限を確立するには、type と opt_value の両方が指定され、有効である必要があります。制限をクリアするには、type に有効な値を指定し、opt_value の値として null を指定するか、opt_value 引数を指定しません。

この API は、現在次の制限タイプをサポートします:

• GSearchgoogle.search.Search.RESTRICT_SAFESEARCH - これが type の値として指定されているとき、画像検索の結果は safesearch 値に基づく画像に制限されます。このタイプの省略可能な有効値は次のとおりです:
  • GSearchgoogle.search.Search.SAFESEARCH_STRICT - 明示的なテキストと明示的な画像を除外する厳格なフィルタリングを適用します。
  • GSearchgoogle.search.Search.SAFESEARCH_MODERATE - 明示的な画像を除外するフィルタリングを適用します（デフォルトの挙動）。
  • GSearchgoogle.search.Search.SAFESEARCH_OFF - セーフサーチ フィルタリングを適用しません。
  次のコード スニペットは、セーフサーチ フィルタリングをオフにする方法を示しています。

  var searcher = new google.search.ImageSearch();
  searcher.setRestriction(google.search.Search.RESTRICT_SAFESEARCH,
                          google.search.Search.SAFESEARCH_OFF);
                  

• GimageSearchgoogle.search.ImageSearch.RESTRICT_IMAGESIZE - これが type の値として指定されているとき、画像検索の結果は、ピクセル単位で指定された寸法を持つ画像に制限されます。このタイプの省略可能な有効値は次のとおりです:
  • GimageSearchgoogle.search.ImageSearch.IMAGESIZE_SMALL - 小さい正方形の寸法、アイコン
  • GimageSearchgoogle.search.ImageSearch.IMAGESIZE_MEDIUM - 2.5k ～ 16k ピクセルの画像
  • GimageSearchgoogle.search.ImageSearch.IMAGESIZE_LARGE - 16k ～ 480k ピクセルの画像
  • GimageSearchgoogle.search.ImageSearch.IMAGESIZE_EXTRA_LARGE - 480k ピクセル以上の画像
  次のコード スニペットは、アイコン サイズの画像のみを検索する方法を示します。

  var searcher = new google.search.ImageSearch();
  searcher.setRestriction(google.search.ImageSearch.RESTRICT_IMAGESIZE,
                          google.search.ImageSearch.IMAGESIZE_SMALL);
                  

• GimageSearchgoogle.search.ImageSearch.RESTRICT_COLORIZATION - これが type の値として指定されているとき、画像検索の結果は、一定の色を持つ画像に制限されます。このタイプの省略可能な有効値は次のとおりです:
  • GimageSearchgoogle.search.ImageSearch.COLORIZATION_BLACK_AND_WHITE - 白黒（淡色）の画像に制限します。
  • GimageSearchgoogle.search.ImageSearch.COLORIZATION_GRAYSCALE - グレースケールの画像に制限します。
  • GimageSearchgoogle.search.ImageSearch.COLORIZATION_COLOR - カラーの画像に制限します。
  次のコード スニペットは、グレースケールの画像のみを検索する方法を示します。

  var searcher = new google.search.ImageSearch();
  searcher.setRestriction(google.search.ImageSearch.RESTRICT_COLORIZATION,
                          google.search.ImageSearch.COLORIZATION_GRAYSCALE);
                  

• GimageSearchgoogle.search.ImageSearch.RESTRICT_FILETYPE - これが type の値として指定されているとき、画像検索の結果は、一定のファイル タイプの画像（JPGなど）に制限されます。このタイプの省略可能な有効値は次のとおりです:
  • GimageSearchgoogle.search.ImageSearch.FILETYPE_JPG - 画像を jpeg のみに制限します。
  • GimageSearchgoogle.search.ImageSearch.FILETYPE_PNG - 画像を png のみに制限します。
  • GimageSearchgoogle.search.ImageSearch.FILETYPE_GIF - 画像を gif のみに制限します。
  • GimageSearchgoogle.search.ImageSearch.FILETYPE_BMP - 画像を bmp のみに制限します。
  次のコード スニペットは、タイプが PNG の画像のみを検索する方法を示します。

  var searcher = new google.search.ImageSearch();
  searcher.setRestriction(google.search.ImageSearch.RESTRICT_FILETYPE,
                          google.search.ImageSearch.FILETYPE_PNG);
                  

• GimageSearchgoogle.search.ImageSearch.RESTRICT_IMAGETYPE - これが type の値として指定されているとき、画像検索の結果は、一定のタイプの画像に制限されます。このタイプの省略可能な有効値は次のとおりです:
  • GimageSearchgoogle.search.ImageSearch.IMAGETYPE_FACES - 顔が含まれている画像に制限します。
  • GimageSearchgoogle.search.ImageSearch.IMAGETYPE_PHOTO - 写真に制限します^New!
  • GimageSearchgoogle.search.ImageSearch.IMAGETYPE_CLIPART - クリップアート画像に制限します^New!
  • GimageSearchgoogle.search.ImageSearch.IMAGETYPE_LINEART - 線描画画像に制限します^New!
  次のコード スニペットは顔の画像を検索する方法を示します。

  var searcher = new google.search.ImageSearch();
  searcher.setRestriction(google.search.ImageSearch.RESTRICT_IMAGETYPE,
                          google.search.ImageSearch.IMAGETYPE_FACES);
                  

var searcher = new google.search.ImageSearch();
searcher.setRestriction(google.search.ImageSearch.RESTRICT_IMAGETYPE,
                        google.search.ImageSearch.IMAGETYPE_FACES);
searcher.setRestriction(google.search.ImageSearch.RESTRICT_FILETYPE,
                        google.search.ImageSearch.FILETYPE_JPG);
searcher.setRestriction(google.search.ImageSearch.RESTRICT_COLORIZATION,
                        google.search.ImageSearch.COLORIZATION_GRAYSCALE);
searcher.execute('Carmen Electra');
                

GpatentSearchgoogle.search.PatentSearch()

このコンストラクタは、Google 特許検索サービスからの検索結果を提供するために設計されたサーチャー オブジェクトのインスタンスを作成するために使われます。

.setRestriction(type, opt_value)

このメソッドは、このサーチャーによって戻される結果セットへの制限を指定またはクリアするために使われます。制限を確立するには、type と opt_value の両方が指定され、有効である必要があります。制限をクリアするには、type に有効な値を指定し、opt_value の値として null を指定するか、何も指定しません。

この API は、現在次の制限タイプをサポートします:

• GSearchgoogle.search.Search.RESTRICT_TYPE - これを type の値として指定する際に GpatentSearchgoogle.search.PatentSearch.TYPE_ISSUED_PATENTS の opt_value を指定すると、結果が公開された特許のみに制限されます。GpatentSearchgoogle.search.PatentSearch.TYPE_APPLICATIONS の値を指定すると、サーチャーはファイルされた未公開の特許も返します。最後に、GpatentSearchgoogle.search.PatentSearch.TYPE_ANY_STATUS の値を指定すると、サーチャーは公開済特許および出願された特許の両方を返します。ただし、GSearchgoogle.search.Search.RESTRICT_TYPE 制限がクリアされたとき、これは有効なデフォルトおよび挙動です。

• type - 確立する制限のタイプを指定します:
  • GSearchgoogle.search.Search.RESTRICT_TYPE
• opt_value - 指定された制限タイプの値を指定します。値が null の場合、指定された制限はクリアされます。それ以外の場合、値は type の値に相対的に有効である必要があります。その場合、制限が確立されます。上を参照してください。

.GsearchResultClass

結果のタイプを示します。

• GwebSearchgoogle.search.WebSearch.RESULT_CLASS - 次を示します: GwebResult
• GlocalSearchgoogle.search.LocalSearch.RESULT_CLASS - 次を示します: GlocalResult
• GvideoSearchgoogle.search.VideoSearch.RESULT_CLASS - 次を示します: GvideoResult
• GblogSearchgoogle.search.BlogSearch.RESULT_CLASS - 次を示します: GblogResult
• GnewsSearchgoogle.search.NewsSearch.RESULT_CLASS - 次を示します: GnewsResult
• GbookSearchgoogle.search.BookSearch.RESULT_CLASS - 次を示します: GbookResult
• GimageSearchgoogle.search.ImageSearch.RESULT_CLASS - 次を示します: GimageResult
• GpatentSearchgoogle.search.PatentSearch.RESULT_CLASS - 次を示します: GpatentResult^New!

.html

クローニングして、アプリケーション DOM 階層構造内のいずれかの場所にアタッチできる HTML 要素のルートを指定します。これはアプリケーションが関与するプライマリ プロパティであり、その典型的な対話処理に、このノードをクローニングして DOM 階層構造内にアタッチすることが含まれると想定されます。それらは CSS を使ってスタイル設定と表示される要素を制御すると想定されます。たとえば、次のフラグメントは、Google AJAX SEARCH API を介して得られた検索結果をコピーして渡すすべてのアプリケーションを通じて共通であると想定されます。

// clone the .html node from the result
var node = result.html.cloneNode(true);

// attach the node into my dom
container.appendChild(node);

.unescapedUrl

結果の直接の URL を指定します。。

.visibleUrl

結果に関連付けられている URL の短縮バージョンを指定します。通常は、プロトコルとパスを除去され、緑色で表示されます。

.titleNoFormatting

タイトルを指定します。ただし .title と異なり、このプロパティでは HTML マークアップ（<b>、<i> など）が除去されます。

.cacheUrl

この結果を生成したページの Google キャッシュの URL を指定します。このプロパティは null であることがあり、その場合キャッシュはありません。また、検索結果が保存され、その間にキャッシュが古くなっていることがあります。最適な結果を得るには、このプロパティを維持しないことをおすすめします。

.title

結果のタイトルを指定します。場合によっては、title と streetAddress が同じです。これは、検索語句が「1231 Lisa Lane, Los Altos, CA」などの番地である場合によく起こります。

.url

検索結果に関連付けられている Google Maps 詳細ページの URL を指定します。

.lng

結果の longitude 値を指定します。これは、次のコード スニペットを使って GPoint を構築するために使えます:
p = new GPoint(parseFloat(result.lng), parseFloat(result.lat));

.city

結果の都市名を指定します。注: 場合によって、このプロパティが "" に設定されることがあります。

.country

結果の国名を指定します。注: 場合によって、このプロパティが "" に設定されることがあります。

.addressLines[]

["1600 Amphitheatre Pky", "Mountain View, CA 94043"]、["Via del Corso, 330", "00186 Roma (RM), Italy"] など、この結果の住所の行の配列を指定します。結果に関連付けられている住所を正しくレンダリングするには、直接結果の .html プロパティを使用するか、またはこの配列を反復処理して各 addressLine を順次表示します。

.ddUrlToHere

ユーザーが指定した場所からこの検索結果への経路検索を提供する URL を指定します。ただし、このプロパティが欠落していたり、null であったりすることがあります。アクセスは必ず if (result.ddUrlToHere && result.ddUrlToHere != null) のテスト内でラップしてください。

.staticMapUrl^New!

現在の結果の静的なマップ画像表現を参照する URL を指定します。画像は、現在の場所を表す 1 つのマーカーを持ち、横が 150 ピクセル、縦が 100 ピクセルです。想定される使用法は、url プロパティを使って、この画像へのハイパーリンクを設定することです。画像は、GlocalSearchgoogle.search.LocalSearch.resizeStaticMapUrl() を使ってサイズを変更されることがあります。静的マップ タイルのサンプルはこのプロパティを使う方法の 1 つを示しています。

.content^New!

「kml」の結果の場合、このプロパティには KML の結果に関連付けられたコンテンツ スニペットが含まれます。「local」の結果の場合、このプロパティは空の文字列です。

.title

動画結果のタイトルを指定します。

.content

動画クリップのスニペット スタイルの説明を指定します。

.published

動画の公開日を指定します（rfc-822 フォーマット）。

.duration

動画の概算の長さ (単位は秒)。

.tbHeight

動画サムネイルの縦の長さを指定します（単位はピクセル）。

.playUrl

存在する場合、ページ上でインライン再生できる動画の Flash バージョンの URL を指定します。この動画を再生するには、この値を src 属性として、application/x-shockwave-flash を type 属性として使用して、ページ上に <embed> 要素を作成します。動画をすぐ再生する場合、URL に &autoPlay=true を付加してください。

.viewCount^New!

このプロパティが存在する場合は、この動画の再生回数を指定します。

.title

検索結果として戻されたブログ記事のタイトルを指定します。

.postUrl

この検索結果で参照されているブログ記事の URL を指定します。

.author

ブログ記事の執筆者の名前を指定します。

.publishedDate

この検索結果が参照しているブログ記事の公開日 (rfc-822 フォーマット) を指定します。

.title

検索結果として戻されたニュース記事のタイトルを指定します。

.unescapedUrl

結果の未加工の URL を指定します。

.clusterUrl

ニュース結果に関連する一連の記事がある場合、この URL が利用可能で、非 null になります。この状況では、URL は関連するすべての記事へのリンクが掲載されたページを参照します。

.publisher

ニュース記事の出版社の名前を指定します。

.publishedDate

この検索結果が参照しているニュース記事の公開日 (rfc-822 フォーマット) を指定します。

.image{}^New!

このプロパティは省略可能です。この結果に関連する一連のニュース記事を適切に表す画像がある場合のみ結果に表示されます。その画像は、この結果の主要な記事だけでなく、一連のニュース記事に関連する画像であることは重要です。したがって、関連するユーザー インターフェースが正しい画像を表示することが重要です。記事の新しい情報源および画像は頻繁に更新されるので、それらを常に表示する必要があります。Google ニュースでは、情報源を最大限に尊重して画像を端に表示し、現在の結果に関連付けられている記事ではなく、画像に関連付けられている記事にハイパーリンクされます。

このプロパティは省略可能です。必ず存在するわけではありません。プロパティとやり取りする前に、.image == undefined を確認するのが最善の方法です。プロパティがある場合は、次のサブプロパティが含まれます。

• .title - 画像に関連付けられている記事のタイトルを指定します。
• .titleNoFormatting - 上と同じですが、HTML 書式は除外されます。
• .url - この画像の URL を記事に記載されている URL で指定します。
• .originalContextUrl - この画像を含む記事の URL を指定します。画像が表示されると、通常はこの URL にリンクされます。
• .publisher - 画像を含むニュース記事の発行者を指定します。推奨されるユーザー インターフェースは、この画像を表示するためか、またはそれに近いユーザー インターフェースで、上記の .url プロパティを使用してハイパーリンクされています。
• .tbUrl - 画像のサムネイルの URL を指定します。
• .tbWidth - 上記の画像の幅を指定します。この画像の標準サイズは、幅 80 ピクセル、高さ 50 ピクセルです。
• .tbHeight - 上記の画像の高さを指定します。この画像の標準サイズは、幅 80 ピクセル、高さ 50 ピクセルです。

.GsearchResultClass

GnewsSearch.quote の値は、この結果に標準のニュース結果のプロパティではなく、引用に関するプロパティが含まれることを示します。この 2 つの結果形式に設定されるプロパティは大きく異なるので、標準ベースと引用ベースのニュース クエリを混在させる場合は、十分な注意を払うことをおすすめします。

.url

上記の URL のエスケープしたバージョンを指定します。

.content

引用を含むニュース記事からコンテンツのスニペットを指定します。

.title

書籍のタイトルを指定します。

.unescapedUrl

結果の未加工の URL を指定します。

.authors

書籍の作者の一覧を指定します。

.publishedYear

書籍の出版年を指定します。

.thumbnailHtml

書籍の表紙のサムネイル画像を表す HTML DOM ノードを指定します。このプロパティを正しく使用するには、ノードをクローニングする必要があります（例: var cover = res.thumbnailHtml.cloneNode(true);）。HTML 生成を抑制した場合（.setNoHtmlGeneration() を使用）、このプロパティを利用できないことに注意してください。

.title

画像のタイトルを指定します。これは通常、基本ファイル名です。

.unescapedUrl

画像の未加工の URL を指定します。

.visibleUrl

結果に関連付けられた URL の短縮バージョンを指定します。通常は緑で表示され、プロトコルとパスが除去されています。

.width

画像の横幅を指定します（単位はピクセル）。

.tbWidth

画像サムネイルの横幅を指定します（単位はピクセル）。

.tbUrl

サムネイル画像の URL を指定します。

.contentNoFormatting

.content と同じ情報を、HTML 書式のみを除去して指定します。

.title

特許結果のタイトルを指定します。

.content

特許のスニペット スタイルの説明を指定します。

.url

上記の URL のエスケープしたバージョンを指定します。

.patentNumber

公開された特許の特許番号および出願済で未公開の特許の出願番号を指定します。

.assignee

特許の譲受人を指定します。

callbackFunction(
  {"responseData" : {
      "results" : [],
      "cursor" : {}
    },
    "responseDetails" : null | string-on-error,
    "responseStatus" : 200 | error-code
});
      

• safe=active - セーフサーチ フィルタリング（強）を有効にします。
• safe=moderate - セーフサーチ フィルタリング（中）を有効にします（デフォルト）。
• safe=off - セーフサーチ フィルタリングを無効にします。

• blended - KML、地域のビジネス情報、およびジオコードの結果
• kmlonly - KML およびジオコードの結果
• localonly - 地域のビジネス情報およびジオコードの結果

• us - US 版
• uk - UK 版
• fr_ca - カナダ（フランス語）版
• その他

• safe=active - セーフサーチ フィルタリング（強）を有効にします。
• safe=moderate - セーフサーチ フィルタリング（中）を有効にします（デフォルト）。
• safe=off - セーフサーチ フィルタリングを無効にします。

• imgc=mono - 白黒（モノクロ）の画像に制限します。
• imgc=gray - グレースケールの画像に制限します。
• imgc=color - カラーの画像に制限します。

• imgtype=face - 顔の画像に制限します。
• imgtype=photo - 写真に制限します^New!
• imgtype=clipart - クリップアート画像に制限します^New!
• imgtype=lineart - 線描画画像に制限します^New!

GsearcherOptionsgoogle.search.SearcherOptions()

コンストラクタは、サーチャー オプション オブジェクトのインスタンスを作成するために使われます。このオブジェクトは、検索コントロールによって使われる各種の設定を提供します。

.setExpandMode(expandMode)

このメソッドは、検索完了時に、結果に関する拡張モードをサーチャーに通信するために使われます。

• expandMode - 関連付けられているサーチャー結果セクションの拡張モードを指定します。有効な値は次のとおりです:
  • GSearchControlgoogle.search.SearchControl.EXPAND_MODE_CLOSED - 結果セクションには結果がなく、閉じられています。トグルをクリックすると、ユーザーは結果セクションを開き、現在の検索に対して戻されたすべての結果を参照できます。
  • GSearchControlgoogle.search.SearchControl.EXPAND_MODE_OPEN - 結果セクションが開いて、すべての結果が表示されます。
  • GSearchControlgoogle.search.SearchControl.EXPAND_MODE_PARTIAL - 結果セクションは部分的に開いていて、わずかな結果だけが表示されます。通常これは、1 件の結果だけが表示されることを意味します。
• 戻り値 - n/a

.setVideoResultsTbHeight(height)

このメソッドを使うと、検索コントロールによって表示されるときに動画検索の結果に適用される代替のデフォルト スケーリング ファクターを呼び出し側が指定できます。ただし、指定された縦の長さは、その結果として決まる動画の横幅にも影響を与えます。システムにより、動画のアスペクト比が 4 × 3 に保たれるため、動画の横幅は縦の長さの 1.33 倍になります。結果は imageScaler オブジェクト（GSearchgoogle.search.Search.scaleImage を参照）です。この関数を使うと gsearch.css 内 .gs-videoResult td div.gs-image-box CSS ルールに影響が及ぶため、動画サイズを調節するときは、このルールのオーバーライドと互換性のある変更をするようにしてください。

• height - 検索コントロールがレンダリングする前に動画のサムネイルがスケーリングされるサイズの縦の最大値を指定します（単位はピクセル）。API によって適用される最大値は 100 ピクセルです。
• 戻り値 - n/a

.setImageResultsTbHeight(height)

このメソッドを使うと、検索コントロールによって表示されるときに画像検索の結果に適用される代替のデフォルト スケーリング ファクターを呼び出し側が指定できます。ただし、指定された縦の長さは、その結果として決まる画像の横幅にも影響を与えます。システムにより、画像のアスペクト比が 4 × 3 に保たれるため、画像の横幅は縦の長さの 1.33 倍になります。結果は、imageScaler オブジェクト（GSearch.scaleImage を参照）です。この関数を使うと、.gs-imageResult CSS ルール（width プロパティ）と .gs-imageResult .gs-image-box CSS ルール (height プロパティ) に影響が及びます。デフォルトの画像寸法は 112 × 84 なので、CSS ルールでは 114 × 86 となります (境界分の 1 ピクセルを見込んで 2 ピクセル大きくなります)。画像サイズを調節するときは、このルールのオーバーライドと互換性のある変更をするようにしてください。

• height - 検索コントロールがレンダリングする前に画像のサムネイルがスケーリングされるサイズの縦の最大値を指定します（単位はピクセル）。API によって適用される最大値は 100 ピクセルです。
• 戻り値 - n/a

GdrawOptionsgoogle.search.DrawOptions()

コンストラクタは、描画オプション オブジェクトのインスタンスを作成するために使われます。このオブジェクトは、描画フェーズで検索コントロールによって使われる各種の設定を提供します。特に、タブ モードとリニア モードの切り替えを制御できるほか、入力要素を検索コントロールに引き渡す方法をアプリケーションに用意しています。新しく作られた描画オプション オブジェクトのデフォルト設定は、検索コントロールにより所有または作成されたテキスト入力要素を持つリニア モードです。

.setInput(inputElement)

このメソッドは、検索コントロールに入力要素を引き渡すために使われます。検索クエリをキャプチャするためのテキスト入力要素を独自に作成する代わりに、コントロールでは、アプリケーションによって提供された入力要素を使います。

このオプションが指定されると、検索コントロールは onkeyup イベントおよび onpaste イベントを掌握して、入力要素を制御します。時間の経過に伴い、コントロールが関わるイベントのリストは変化することがあります。入力要素を検索コントロールに渡すことにより、アプリケーションは、要素の配置とスタイル設定だけを担当するようになります。入力要素がコントロールに渡されたら、アプリケーションは、必要に応じてその値を読み取る意外にその要素と相互作用しないようにします。

• inputElement - 検索コントロールによって使われる入力要素を指定します。
• 戻り値 - n/a

.setSearchFormRoot(element)

このメソッドは、検索フォームをデフォルトの位置、つまり検索結果の近くに置くのでなく、element で指定された DOM コンテナに置くよう指示するために使われます。

例を表示（searchformroot.html）

• element - 検索フォームが置かれるコンテナを指定します。
• 戻り値 - n/a