XML API リファレンス

このページでは、XML バージョンの Custom Search JSON API について説明します。この API は、 Google Site Search:

  1. 概要
  2. プログラム可能検索エンジンのリクエスト形式 <ph type="x-smartling-placeholder">
      </ph>
    1. リクエストの概要
    2. クエリ語句
    3. リクエスト パラメータ <ph type="x-smartling-placeholder">
        </ph>
      1. ウェブ検索クエリの例
      2. ウェブ検索のクエリ パラメータの定義
      3. 検索オプション
      4. 詳細検索クエリ パラメータ
      5. 特別なクエリ語句
      6. イメージクエリのサンプル
      7. 画像検索のクエリ パラメータ
      8. リクエストの上限
    4. クエリと結果の国際化のプレゼンテーション <ph type="x-smartling-placeholder">
        </ph>
      1. 文字エンコード
      2. インターフェースの言語
      3. 中国語(簡体字と繁体字)の検索
    5. 結果のフィルタリング <ph type="x-smartling-placeholder">
        </ph>
      1. 検索結果の自動フィルタリング
      2. 言語と国のフィルタリング
      3. セーフサーチを使用したアダルト コンテンツのフィルタリング
  3. XML の結果 <ph type="x-smartling-placeholder">
      </ph>
    1. Google XML 結果 DTD
    2. XML レスポンスについて
    3. Regular、Image、 高度な検索クエリ <ph type="x-smartling-placeholder">
        </ph>
      1. 通常の検索/検索オプション: クエリの例と XML 結果
      2. 通常の検索/検索オプション: XML タグ
      3. 画像検索クエリの XML 検索結果
      4. 画像検索: クエリの例と XML 結果
      5. 画像検索: XML タグ

概要

Google ウェブ検索サービスでは、Google Site Search を 顧客が自社のウェブサイトに Google 検索結果を表示できるようにする。「 WebSearch サービスは、シンプルな HTTP ベースのプロトコルを使用して検索を行います。 表示されます。検索の管理者は、 リクエストする方法と、結果をユーザーに提示する方法 あります。このドキュメントでは、Google Cloud の 検索リクエストと結果形式を指定します。

Google ウェブ検索の結果を取得するには、アプリケーションで Google に送る簡単な HTTP リクエストです。Google は検索結果を XML で返します。 使用できます。XML 形式の結果を使用すると、 検索結果の表示方法を変更できます。

WebSearch リクエスト形式

リクエストの概要

Google 検索リクエストは、標準の HTTP GET コマンドです。これは、 関連するパラメータのコレクションが含まれる 分析できますこれらのパラメータは、name=value としてリクエスト URL に含まれます。 ペアをアンパサンド(&)文字で区切って指定します。パラメータの例 固有のエンジン ID(cx)などのデータが含まれます。 バックエンドサービスと通信しますウェブ検索または画像検索サービスから HTTP リクエストに対するレスポンスの XML 結果。

クエリ語句

ほとんどの検索リクエストには、1 つ以上のクエリ語句が含まれます。クエリ語句 は、検索リクエストのパラメータの値として指定されます。

クエリ語句では、フィルタして表示する複数のタイプの情報を指定できます。 整理する方法を紹介します。クエリで指定できる項目は次のとおりです。

  • 含める、または含める単語またはフレーズ 除外 <ph type="x-smartling-placeholder">
      </ph>
    • 検索クエリ内のすべての単語(デフォルト)
    • 検索クエリに完全に一致するフレーズ
    • 検索クエリ内の任意の単語やフレーズ
  • ドキュメント内の場所 検索語句 <ph type="x-smartling-placeholder">
      </ph>
    • ドキュメントの任意の場所(デフォルト)
    • ドキュメントの本文のみ
    • ドキュメントのタイトルのみ
    • ドキュメントの URL 内のみ
    • ドキュメント内のリンクのみ
  • 書類自体に対する制限 <ph type="x-smartling-placeholder">
      </ph>
    • 特定のファイル形式のドキュメントを追加または除外する (PDF ファイルや Word ドキュメントなど)
  • 結果を返す特別な URL クエリ 検索を実行せずに、特定の URL に関する情報のみを提供する <ph type="x-smartling-placeholder">
      </ph>
    • URL に関する一般的な情報を返すクエリ そのオープン ディレクトリのカテゴリ、スニペット、言語
    • URL にリンクしているウェブページを返すクエリ
    • 指定した URL に似た一連のウェブページを返すクエリ

デフォルトの検索

検索クエリのパラメータ値は、URL エスケープする必要があります。なお、 この場合、 表示されます。これについては、このドキュメントの URL エスケープのセクションをご覧ください。

検索クエリは、 q パラメータ 検索語句の例:

q=horses+cows+pigs

デフォルトでは、Google ウェブ検索サービスは、 検索クエリにすべての語句が含まれる

リクエスト パラメータ

このセクションでは、作成時に使用できるパラメータの一覧 検索できます。パラメータは 2 つのリストに分かれています。最初のリストには、すべての検索リクエストに関連するパラメータが含まれています。2 番目のリストには、次のパラメータが含まれます。 検索オプション リクエストに関係します。

次の 3 つのリクエスト パラメータが必要です。

  • client パラメータは google-csbe に設定する必要があります。
  • output パラメータは、 返される XML 結果の形式。(xml)を使用して結果を返すことができます。 Google の DTD への参照を含めない(xml_no_dtd)。おすすめの方法 xml_no_dtd に設定します。注: このパラメータを指定しない場合、結果は XML ではなく HTML を使用します。
  • cx パラメータ: 一意の エンジンの ID。

以下以外で最もよく使用されるリクエスト パラメータ 次のとおりです。

  • num - リクエストされた検索結果の数
  • q - 検索キーワード
  • start - 結果の開始インデックス

ウェブ検索クエリの例

以下の例は、いくつかの WebSearch HTTP リクエストを さまざまなクエリ パラメータの使用例。定義: さまざまなクエリ パラメータが提供されているので、 パラメータの定義検索オプション パラメータ セクションをご覧ください。

このリクエストは、最初の 10 件の結果(start=0&num=10)を求めています 検索語句「レッドソックス」(q=red+sox)。このクエリは は、検索結果がカナダのウェブサイト(cr=countryCA)から取得されるように指定します フランス語(lr=lang_fr)で記述されていること。最後に、クエリは [client]、[output]、 および cx パラメータのうちの 3 つは必須です。

http://www.google.com/search?
start=0
&num=10
&q=red+sox
&cr=countryCA
&lr=lang_fr
&client=google-csbe
&output=xml_no_dtd
&cx=00255077836266642015:u-scht7a-8i

この例では、検索オプション パラメータを使用して、検索クエリをさらにカスタマイズします。このリクエストでは as_q を使用し、 パラメータ(as_q=red+sox)を q パラメータの代わりに使用することをおすすめします。また、 as_eq パラメータで「Yankees」という単語を含むドキュメントを除外取得 検索結果(as_eq=yankees

http://www.google.com/search?
start=0
&num=10
&as_q=red+sox
&as_eq=Yankees
&client=google-csbe
&output=xml_no_dtd
&cx=00255077836266642015:u-scht7a-8i

ウェブ検索のクエリ パラメータの定義

c2coff
説明

(省略可)c2coff パラメータは、簡易 URL 検証を有効または無効にします。 中国語(繁体)検索機能を使用できます。

このパラメータのデフォルト値は 0(ゼロ)です。つまり、 機能が有効になっていることを確認します。c2coff パラメータの値は次のとおりです。

アクション
1 無効
0 有効
q=google&c2coff=1

クライアント
説明

必須client パラメータは google-csbe に設定する必要があります。

q=google&client=google-csbe

cr
説明

(省略可)cr パラメータは、検索結果を、 特定できますブール値の 演算子cr パラメータの あります。

Google ウェブ検索では、 分析:

  • ドキュメントの URL のトップレベル ドメイン(TLD)
  • ウェブサーバーの IP アドレスの地理的位置

国(cr)パラメータ 値のセクションをご覧ください。

q=Frodo&cr=countryNZ

cx
説明

必須cx パラメータは、一意の ID を カスタム イベントを識別するコード できます。cx パラメータを使用してプログラム可能検索エンジンを指定し、そのエンジンから検索結果を取得する必要があります。

cx パラメータの値を確認するには、[コントロール パネル] >コード タブを開くと、テキスト領域に [検索ボックスを配置するページにこのコードを貼り付ける] で、 表示されます。検索結果は、Google がホストするページに表示されます。'

q=Frodo&cx=00255077836266642015:u-scht7a-8i

フィルタ
説明

(省略可)filter パラメータは、サービス アカウントの Google 検索の検索結果の自動フィルタリングを無効にします。詳しくは、 ドキュメントをご覧ください。

filter パラメータのデフォルト値は 1 です。 機能が有効であることを示します。この パラメータは次のとおりです。

アクション
1 無効
0 有効

注: デフォルトでは、すべての 検索結果の質を高めることができます。

q=google&filter=0

gl
説明

(省略可)gl パラメータ値は、 2 文字の国コード。ウェブ検索結果の場合、gl パラメータを指定すると、検索を行ったユーザーの国が パラメータ値を設定します。有効な値の一覧については国コードのセクションをご覧ください。

WebSearch リクエストで gl パラメータ値を指定する 結果の関連性が高まりますこれは特に これは海外の顧客にも当てはまります 米国以外の英語圏の国のお客様が対象。

このリクエストにより、英国で書かれた書類が ウェブ検索結果:
q=pizza&gl=uk


hl
説明

(省略可)hl パラメータは、 インターフェース言語(ホスト言語)。カスタマー サービスの 検索結果のパフォーマンスと品質を このパラメータは明示的に設定することを強くおすすめします。

詳しくは、クエリの多言語化のインターフェース言語セクションをご覧ください。 および結果の表示の詳細およびサポートされているインターフェース言語 をご覧ください。

このリクエストは、フランス語のワインの広告を対象としています。(Vin は (フランス語ではワインを意味する)

q=vin&ip=10.10.10.10&ad=w5&hl=fr

hq
説明

(省略可)hq パラメータは、指定されたクエリ語句を AND 論理演算子で結合されたかのようにクエリを表現できます。

このリクエストは「ピザ」を検索する「チーズ」です。この式は q=pizza+cheese と同じです。

q=pizza&hq=cheese


ie
説明

(省略可)ie パラメータは文字を クエリ文字列の解釈に使用するエンコード スキームを定義します。「 ie のデフォルト値は latin1 です。

このパラメータを使用する必要がある場合については、文字エンコード セクションをご覧ください。

詳細は、文字エンコード 使用可能な ie 値のリストの Schemes セクション

q=google&ie=utf8&oe=utf8
lr
説明

(省略可)lr(言語制限)パラメータは、検索結果をドキュメントに制限します。 特定の言語で書かれたものになります

Google WS はドキュメントの言語を 分析:

  • ドキュメントの URL のトップレベル ドメイン(TLD)
  • ドキュメント内の言語メタタグ
  • ドキュメントの本文で使用される主な言語
  • ドキュメントの本文で使用されている二次言語(該当する場合)

言語(lr)をご覧ください。 コレクション値のセクションをご覧ください。 パラメータを指定します。

q=Frodo&lr=lang_en

num
説明

(省略可)num パラメータは、 返される検索結果の数。

num のデフォルト値は 10 で、 値は 20 です。20 件を超える結果をリクエストする場合は、20 件のみ 結果が返されます。

注: 検索結果の総数がそれより少ない場合は、 リクエストした結果の数を超えた場合、利用可能なすべての検索結果が 返されます。

q=google&num=10

oe
説明

(省略可)oe パラメータは文字を XML 結果のデコードに使用するエンコーディング スキームを指定します。「 oe のデフォルト値は latin1 です。

このパラメータを使用する必要がある場合については、文字エンコード セクションをご覧ください。

詳細は、文字エンコード 使用可能な oe 値のリストの Schemes セクション

q=google&ie=utf8&oe=utf8

output
説明

必須output パラメータは、XML の結果の形式を指定します。有効な唯一の このパラメータの値は xmlxml_no_dtd です。「 以下の表は、これらのパラメータ値の違いを示しています。

出力形式
xml_no_dtd XML の結果には !DOCTYPE ステートメントです。(推奨)
xml XML 結果には、Google 検索の DTD リファレンス。結果の 2 行目で、ドキュメントを識別する 定義タイプ(DTD)を指定します。
    <!DOCTYPE GSP SYSTEM "google.dtd">
output=xml_no_dtd
output=xml

q
説明

(省略可)q パラメータは、検索を指定します。 結果を返します。このパラメータは省略可能ですが、 クエリ パラメータ(as_epqas_lqas_oqas_q)のうち少なくとも 1 つに値を指定する必要があります。 検索結果が表示されます。

使用できる特別なクエリ語句も数多くあります。 q パラメータの一部として使用されます。 あります。これらの用語の一覧と定義については、特殊なクエリ用語をご覧ください。

Google 検索のコントロール パネルには、 q パラメータを使用して送信されるクエリ。

注: q パラメータには指定された値が URL エスケープする必要があります。

q=vacation&as_oq=london+paris

安全性
説明

(省略可)safe パラメータは、検索結果をアダルト コンテンツとしてどのようにフィルタするかを示します。 ポルノ コンテンツ。safe パラメータのデフォルト値は off です。有効なパラメータ値 次のとおりです。

アクション
off セーフサーチを無効にする
medium セーフサーチを有効にする
high セーフサーチの厳密なバージョンを有効にする

詳細については、アダルト コンテンツのフィルタリング セーフサーチの使用に関するセクションをご覧ください。

q=adult&safe=high

start
説明

(省略可)start パラメータは、最初に含めるべき結果を示します。 表示されます。start パラメータはゼロベースのインデックスを使用します。つまり、最初の結果は 0、 2 は 1 などです。

start パラメータは、次の環境で使用できます。 num パラメータと組み合わせて 返すことができますクエリに一致するドキュメントが 1,000 個を超えても、1,000 件を超える結果が返されることはありません。そのため、start を 1,000 以上に設定しても、結果は返されません。

start=10

並べ替え
説明

(省略可)sort パラメータは、指定された式に従って結果を並べ替えることを指定します。たとえば、日付順に並べ替えることができます。

sort=date


UD
説明

(省略可)ud パラメータは、 XML レスポンスに、IDN でエンコードされた検索結果の URL を含めるかどうか。 IDN(国際ドメイン名)エンコードを使用すると、ローカル サービスを使用してドメインを 例:

http://www.花井鮨.com

このパラメータの有効な値は 1(デフォルト)です。つまり、XML の結果は IDN でエンコードされた URL、0 が含まれます。つまり、XML の結果に IDN でエンコードされた URL が含まれていてはなりません。 できます。ud パラメータが 1 に設定されている場合、IDN でエンコードされた URL は XML 結果の UD タグ内に挿入します。

ud パラメータが 0 に設定されている場合、上記の例の URL は次のようになります。 次のように表示されます。

http://www.xn--elq438j.com.

注: これはベータ版の機能です。

q=google&ud=1

画像の下にリストされている追加のクエリ パラメータは、検索オプションに関連するものです。 検索オプションを送信するときに、複数のパラメータの値(as_eqas_epqas_oq など)はすべてクエリで考慮されます。 表示されます。この画像は、Google の検索オプションページを示しています。この画像では、各 Pod の名前が 検索オプション パラメータは、内部または横にのテキストで記述されています。 そのパラメータが対応するページのフィールドです



高度な検索クエリ パラメータ

as_dt
説明

(省略可)as_dt パラメータは、 as_sitesearch パラメータで指定したサイトの検索結果を含める、または除外する。「 値 ie は、それぞれ包含と除外を示します。

as_dt=i,as_dt=e

as_epq
説明

(省略可)as_epq パラメータは、 というフレーズを使用します。Google Chat では フレーズ検索の検索語句も使用して、 検索します。

as_epq=abraham+lincoln

as_eq
説明

(省略可)as_eq パラメータは単語を識別します。 または検索するドキュメントに含めてはならない語句 表示されます。また、exclude クエリを使用して、 特定の単語やフレーズが 一連の検索結果でドキュメントが表示されます

q=bass&as_eq=music


as_lq
説明

(省略可)as_lq パラメータは、 すべての検索結果には、特定の URL へのリンクが含まれている必要があります。また、 このタイプのクエリでは link: クエリ語句を使用する。

as_lq=www.google.com


as_nlo
説明

(省略可)as_nlo パラメータは、サービスの開始値を指定します。 検索範囲を入力します。as_nloas_nhi を使用してインクルーシブ検索を追加する as_nlo...as_nhi の範囲をクエリに追加します。

次の例では、検索範囲を 5 ~ 10 に設定しています。

as_nlo=5&as_nhi=10

as_nhi
説明

(省略可)as_nhi パラメータは、 検索範囲の終了値。as_nloas_nhi を使用して クエリに対する as_nlo...as_nhi の両端を含む検索範囲。

次の例では、検索範囲を 5 ~ 10 に設定しています。

as_nlo=5&as_nhi=10

as_oq
説明

(省略可)as_oq パラメータを使用すると、 ドキュメント内で照合する追加の検索キーワードです。 少なくとも 1 つの追加の単語が少なくとも 1 つ含まれている必要があります。 表示されます。また、ブール値 OR クエリ語句 おすすめします

q=vacation&as_oq=London+Paris


as_q
説明

(省略可)as_q パラメータは検索を行います。 確認しましょう。このパラメータは、コンテナ イメージの セット内で検索する追加の用語をユーザーが指定できるようにする できます。

q=president&as_q=John+Adams


as_qdr
説明

(省略可)as_qdr パラメータは検索をリクエストします。 指定した期間の結果が表示されます。サポートされる値は次のとおりです。

d[number] は、指定された過去の日数の結果をリクエストします。
w[number] は、指定された過去の週数の結果をリクエストします。
m[number] は、指定された過去の月数の結果をリクエストします。
y[number] は、指定された過去の年数の結果をリクエストします。

次の例では、過去 1 年の結果をリクエストします。

as_qdr=y

次の例では、過去 10 日間の結果をリクエストします。

as_qdr=d10

as_sitesearch
説明

(省略可)as_sitesearch パラメータを使用すると、すべての検索結果に特定のサイトのページが表示されるように指定できます。as_dt パラメータを設定すると、指定したサイトのページを検索結果から除外することもできます。

q=vacation&as_sitesearch=www.google.com


特別なクエリ語句

Google ウェブ検索では、特別な検索キーワードを使用でき、 Google 検索エンジンの追加機能にアクセスする。これらの 特別なクエリ語句を q リクエスト パラメータの値に含める必要があります。他の検索用語と同様に、 特殊なクエリ語句は URL エスケープする必要があります。 コロン(:)が含まれている特殊なクエリ語句の数。このキャラクター URL エスケープされる必要もあります。URL エスケープされた値は %3A です。

バックリンク [link:]
説明

link: クエリ語句でウェブページのセットを取得します。 特定の URL にリンクします検索クエリは、link: クエリ語句と URL の間にスペースを入れずに link:URL の形式で指定する必要があります。

link: の URL エスケープされたバージョンは link%3A です。

また、as_lq リクエストを使用して、 パラメータを使用して link: リクエストを送信します。

注: 追加する場合、他のクエリ語句を指定することはできません。 link: を使用します。

http://www.google.com/search?q=link%3Awww.example.com


ブール値 OR 検索 [または ]
説明

OR クエリ語句は、いずれかを含むドキュメントを取得します。 連続する(2 つ以上)の検索キーワードを使用できます。OR クエリを使用する この場合、検索キーワード OR を大文字で挿入します。 英字で表記する必要があります。

また、as_oq リクエストを使用して、 パラメータを使用して、一連の語句の任意の語句の検索を送信します。

注: 検索リクエストが クエリ「London+OR+Paris」を指定した場合、 これらの単語のうち少なくとも 1 つを含むドキュメントのみが返されます。場合によっては 両方の単語が含まれている可能性があります。

ロンドンまたはパリを検索:

ユーザー入力:london OR paris クエリ語句:q=london+OR+paris

「休暇」と「ロンドン」か「パリ」のいずれかを検索します。

クエリ語句:q=vacation+london+OR+paris

「休暇」と「ロンドン」、「パリ」、または「チョコレート」を検索します。

クエリ語句:  q=vacation+london+OR+paris+OR+chocolates

「休暇」と「チョコレート」と「ロンドン」か「パリ」で検索し、 チョコレートに与える重みが最小になります。

クエリ語句:  q=vacation+london+OR+paris+chocolates

次の内容が含まれるドキュメントで休暇、チョコレート、花を検索 さらに、ロンドンまたはパリのいずれかが含まれている:

クエリ語句:  q=vacation+london+OR+paris+chocolates+flowers

ロンドンまたはパリの休暇を検索し、さらに検索します チョコレートか花の場合:

クエリ語句:  q=vacation+london+OR+paris+chocolates+OR+flowers

検索語句を除外 [-]
説明

除外(-)クエリ語句は、 特定の検索リクエスト(特定の検索リクエストを含む)を含まない 検索します。除外クエリ語句は、次のように使用します。 一致するドキュメントから除外する単語またはフレーズの前に付けます。 「-」付き(マイナス記号)を使用します。

- の URL エスケープされたバージョンは %2D です。

検索語句の除外は、検索語句に 意味があります。たとえば「低音」という単語は結果を返すことができます 魚と音楽のどちらかです。こちらに関するドキュメントをお探しの場合: 検索結果から音楽に関するドキュメントを除外できます 除外クエリキーワードを使用します

また、as_eq リクエストを使用して、 パラメータを使用して、特定の単語またはフレーズに一致するドキュメントを除外します 検索結果から除外します

ユーザー入力: bass -music
クエリ語句: q=bass+%2Dmusic

ファイル形式の除外 [ -filetype:]
説明

-filetype: クエリ語句では、 「.pdf」などの特定のファイル拡張子または「.doc」検索から 表示されます。検索クエリは -filetype:EXTENSION の形式で、-filetype: 検索クエリと 表示されます。

-filetype: の URL エスケープされたバージョンは %2Dfiletype%3A です。

注: 複数の -filetype: クエリを追加して検索結果内のファイル形式 追加することもできます-filetype: クエリ語句を 1 つ指定する必要があります 除外するファイル拡張子ごとに、検索クエリに含める 表示されます。

Google がサポートしているファイル形式は次のとおりです。

  • Adobe Portable Document Format(PDF)
  • Adobe PostScript(ps)
  • ロータス 1-2-3(wk1、wk2、wk3、wk4、wk5、wki、wks、wku)
  • Lotus WordPro(lwp)
  • Macwrite(mw)
  • Microsoft Excel(xls)
  • Microsoft PowerPoint(ppt)
  • Microsoft Word(ドキュメント)
  • Microsoft Works(wks、wps、wdb)
  • Microsoft Write(wri)
  • リッチテキスト形式(rtf)
  • Shockwave Flash(swf)
  • テキスト(ans、txt)。

今後、他のファイル形式が追加される可能性があります。最新の Google のファイル形式に関するよくある質問でいつでも確認できます。

この例では、「Google」に言及しているドキュメントが返されます。しかし、 PDF ドキュメントではありません:
q=Google+%2Dfiletype%3Apdf

この例では、「Google」に言及しているドキュメントが返されます。 PDF と Word の両方のドキュメントを除外します。
q=Google+%2Dfiletype%3Apdf+%2Dfiletype%3Adoc


ファイル形式のフィルタリング [ filetype: ]
説明

filetype: クエリ語句は、検索結果を次に制限します: 特定のファイル拡張子(「.pdf」など)のドキュメント「.doc」ファイルなどです。 検索クエリは filetype:EXTENSION の形式で、 filetype: クエリ語句と指定された あります。

filetype: の URL エスケープされたバージョンは filetype%3A です。

検索を制限したり 検索結果を複数のファイル拡張子のいずれかに一致するドキュメントに クエリに filetype: 個のクエリ語句を追加します。検索結果に含めるファイル拡張子ごとに、検索クエリに filetype: クエリ語句を 1 つ含める必要があります。複数の filetype: クエリ語句を区切るには、OR クエリ語句を使用する必要があります。

デフォルトでは、検索結果には 任意のファイル拡張子のドキュメントを含めるようにします

Google がサポートしているファイル形式は次のとおりです。

  • Adobe Portable Document Format(PDF)
  • Adobe PostScript(ps)
  • ロータス 1-2-3(wk1、wk2、wk3、wk4、wk5、wki、wks、wku)
  • Lotus WordPro(lwp)
  • Macwrite(mw)
  • Microsoft Excel(xls)
  • Microsoft PowerPoint(ppt)
  • Microsoft Word(ドキュメント)
  • Microsoft Works(wks、wps、wdb)
  • Microsoft Write(wri)
  • リッチテキスト形式(rtf)
  • Shockwave Flash(swf)
  • テキスト(ans、txt)。

今後、他のファイル形式が追加される可能性があります。最新の Google のファイル形式に関するよくある質問でいつでも確認できます。

この例では、「Google」という単語を含む PDF ドキュメントを返します。
q=Google+filetype%3Apdf

この例では、名前リンクを含む PDF と Word ドキュメントを返します。 "Google":
q=Google+filetype%3Apdf+OR+filetype%3Adoc


検索語句を含める [+]
説明

include(+)クエリ語句は、その単語またはフレーズが含まれる 検索結果に含まれるすべてのドキュメントに出現する必要があります。 検索語を含める場合は、検索対象の語句の先頭に、 すべての検索結果に「+」が表示される(プラス記号)を入力します。

+ の URL エスケープ版(プラス記号)は %2B です。

Google でよく使われる単語の前に + を付ける必要があります。 は、通常は検索結果を識別する前に破棄されます。

ユーザー入力: Star Wars Episode +I
クエリ語句: q=Star+Wars+Episode+%2BI

リンクのみ検索、すべての用語 [allinlinks: ]
説明

allinlinks: クエリ語句には、次の場所にあるドキュメントが必要です: 検索すると、URL の検索クエリに含まれるすべての単語が検索結果に表示されます。 リンクをご覧ください。検索クエリは、allinlinks: の後に検索クエリ内の単語を続けた形式にする必要があります。

検索クエリに「allinlinks:」というクエリが含まれている場合 ドキュメント内の URL リンクで ドキュメント内の他のテキストを無視して、 各ドキュメントのタイトルと URL などです。なお、このドキュメントには、 URL が、ドキュメントに含まれている URL リンクと異なります。

allinlinks: の URL エスケープされたバージョンは allinlinks%3A です。

ユーザー入力:allinlinks: Google search
クエリ語句:q=allinlinks%3A+Google+search

フレーズ検索
説明

フレーズ一致(")を使用すると、 フレーズを引用符で囲むか、 ハイフンでつなぎます。

"(引用符)の URL エスケープ版は %22 です。

フレーズ検索は 調べられます。

また、as_epq リクエストを使用して、 パラメータを使用してフレーズ検索を送信します。

ユーザー入力:"Abraham Lincoln"
クエリ語句: q=%22Abraham+Lincoln%22

テキストのみの検索、すべての語句 [allintext:]
説明

allintext: クエリ語句では、 すべての単語が検索結果に含まれるように、 あります。allintext: の形式で、その後に検索クエリ内の単語を続けます。

検索クエリに「allintext:」というクエリが含まれている場合 キーワードが使用されている場合、Google はドキュメントの本文で これらのドキュメント内のリンクを無視して ドキュメント URL などです。

allintext: の URL エスケープされたバージョンは allintext%3A です。

この例では、単語に「?」が 「Google」「search」を使用します。記載するすべての書類の本文に記載が必要 表示されます。
ユーザー入力:allintext:Google search
クエリ語句:q=allintext%3AGoogle+search

タイトル検索、単一語句 [intitle:]
説明

intitle: クエリ語句は、検索結果を次に制限します: ドキュメントのタイトルに特定の単語を含むドキュメントを検索します。「 検索クエリは、スペースなしの intitle:WORD の形式で入力してください を、intitle: の検索語句と次の単語の間に挿入します。

注: これ以外の ドキュメントのタイトルに 1 つ以上の単語を含める場合は、 各単語の前に intitle: クエリ語句を追加します。Google Chat では また、「allintitle:」というクエリ語句も使用して すべてのクエリ語句をタイトルに含めるように 検出することもあります

intitle: の URL エスケープされたバージョンは intitle%3A です。

この例では、「Google」という単語が必ず 検索結果のドキュメントのタイトル、 「検索」タイトル、URL、リンク、本文のいずれかの場所に記述する必要があります。 次のドキュメントのうち:
ユーザー入力:intitle:Google search
クエリ語句:q=intitle%3AGoogle+search


タイトル検索、すべての用語 [allintitle:]
説明

allintitle: クエリ語句は、検索結果を次に制限します: ドキュメントのタイトルにクエリ語句をすべて含むドキュメント。宛先 allintitle: クエリ語句を使用し、「allintitle:」を含めます。 手動で入力することもできます。

注: 検索クエリの先頭に allintitle: を付けると、各単語の前に intitle: を付けるのと同じ結果になります。 なります。

allintitle: の URL エスケープ版は allintitle%3A です。

この例では、「Google」という単語が「search」を使用します。 検索結果に表示されるすべてのドキュメントのタイトルに出現する必要があります。
ユーザー入力: allintitle: Google search
クエリ語句: q=allintitle%3A+Google+search


URL 検索、単一語句 [inurl:]
説明

inurl: クエリ語句は、検索結果を次に制限します: ドキュメント URL に特定の単語を含むドキュメントを検索します。「 検索クエリは、スペースなしの inurl:WORD の形式で入力してください を、inurl: の検索語句と次の単語の間に挿入します。

inurl: クエリ キーワードは句読点を無視し、inurl: 演算子に続く最初の単語のみを使用します。キーワードに含まれる複数の単語を指定できます。 ドキュメントの URL の前に inurl: クエリ語句を付けます 単語を予測します。また、検索キーワード「allinurl:」を使用して、すべての検索キーワードを URL に含めるように指定することもできます。 特定することもできます

inurl: の URL エスケープされたバージョンは inurl%3A です。

この例では、「Google」という単語が必ず 検索結果に含まれるドキュメントの URL、および「search」という単語 広告のタイトル、URL、リンク、本文のいずれかに表示する必要があります。 ドキュメント:
ユーザー入力: inurl:Google search
クエリ語句: q=inurl%3AGoogle+search


URL 検索、すべての語句 [allinurl:]
説明

allinurl: クエリ語句は、検索結果を次に制限します: ドキュメント URL のすべてのクエリ語句を含むドキュメント。宛先 allinurl: クエリ語句を使用し、先頭に allinurl: を含めます。 表示されます。

allinurl: というクエリ語句では句読点が無視されるため、単語に対してのみ作用し、URL に対しては作用しません。 説明します。たとえば、allinurl: uk/scotland は結果を制限します。 「uk」という単語を含むドキュメントを検索「scotland」URL で この 2 つの単語が特定の特定の単語に スラッシュで区切る必要があります

allinurl: の URL エスケープされたバージョンは allinurl%3A です。

この例では、「Google」という単語が「search」を使用します。 検索結果に表示されるすべてのドキュメントの URL に出現する必要があります。
ユーザー入力: allinurl: Google search
クエリ語句: q=allinurl%3A+Google+search



ウェブ ドキュメント情報 [info:]
説明

info: クエリ キーワードは、一般的な情報を取得します。 その URL が Google の検索インデックスに含まれている限り、その URL に関するコンテンツを宣伝できます。 検索クエリは、スペースなしの info:URL 形式にする必要があります が info: のクエリ語句と URL の間にある。

info: の URL エスケープされたバージョンは info%3A です。

注: 追加する場合、他のクエリ語句を指定することはできません。 info: を使用します。

ユーザー入力: info:www.google.com
クエリ語句: q=info%3Awww.google.com

画像クエリの例

以下の例では、画像 HTTP リクエストをいくつか紹介して、さまざまなクエリ パラメータの使用例を示しています。各クエリ パラメータの定義は、このドキュメントの「画像クエリ パラメータの定義」セクションで説明しています。

検索語句「monkey」に対する最初の 5 件の結果(start=0&num=5)が要求されます。(q=monkey)、ファイル形式 .png。最後に、このクエリでは client パラメータ、output パラメータ、cx パラメータの値を指定します。この 3 つはすべて必須です。

http://www.google.com/cse?
  searchtype=image
  start=0
  &num=5
  &q=monkey
  &as_filetype=png
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

画像検索のクエリ パラメータ

as_filetype
説明

(省略可)指定されたタイプの画像を返します。使用できる値は、bmpgifpngjpgsvg です。

q=google&as_filetype=png

imgsz
説明

(省略可)指定されたサイズの画像を返します。サイズは次のいずれかです。

  • icon(小)
  • small|medium|large|xlarge(中)
  • xxlarge(大)
  • huge(特大)

q=google&as_filetype=png&imgsz=icon

imgtype
説明

(省略可)次のタイプの画像を返します。

  • clipart(クリップアート)
  • face(顔)
  • lineart(線形)
  • news(ニュース)
  • photo(写真)

q=google&as_filetype=png&imgtype=photo

imgc
説明

(省略可)白黒、グレースケール、またはカラーの画像を返します。

  • mono(白黒)
  • gray(グレースケール)
  • color(カラー)

q=google&as_filetype=png&imgc=gray

imgcolor
説明

(省略可)特定のドミナント カラーの画像を返します。

  • yellow
  • green
  • teal
  • blue
  • purple
  • pink
  • white
  • gray
  • black
  • brown
q=google&as_filetype=png&imgcolor=yellow

as_rights
説明

(省略可)ライセンスに基づくフィルタ。サポートされている値は次のとおりです。

  • cc_publicdomain
  • cc_attribute
  • cc_sharealike
  • cc_noncommercial
  • cc_nonderived

q=cats&as_filetype=png&as_rights=cc_attribute

リクエストの上限

下の表は、検索リクエストに適用される制限事項を示しています。 Google に送信します。

コンポーネント 上限 コメント
検索リクエストの長さ 2,048 バイト  
クエリ語句の数 10 次のパラメータに用語を含める: qas_epqas_eqas_lqas_oqas_q
検索結果の表示件数 20 num パラメータを 20 より大きい数値に設定すると、20 件の結果のみが返されます。宛先 より多くの結果を得るには、複数のリクエストを送信して start パラメータの値を できます。

クエリと結果の表示の国際化

Google ウェブ検索サービスを使用すると、 複数の言語に対応できます。メッセージに含める文字エンコードを指定できます。 HTTP リクエストの解釈と XML レスポンスのエンコードに使用できる (ieoe の検索を使用 あります。ドキュメントのみが含まれるように結果をフィルタすることもできます。 特定の言語で書かれています

以下のセクションでは、Google Chat 内での検索に関する問題について説明します。 複数の言語:

文字エンコード

サーバーはウェブページなどのデータを エンコードされたバイトのシーケンスとして表されます。その後、ユーザー エージェントは、 バイトを文字のシーケンスに変換します。リクエストを 使用する場合、両方の検索エンジンのエンコード スキームを 返される XML レスポンスに応じて異なります。

ie リクエスト パラメータを使用すると、 HTTP リクエスト内の文字のエンコード メカニズムです。Google Chat では また、oe パラメータを使用して、エンコード XML レスポンスをエンコードするために Google が使用する必要があるスキームを指定します。もし ISO-8859-1(または latin1)以外のエンコード スキームを使用している場合、正しい値を指定するようにしてください ie パラメータと oe パラメータに対して追加のフィールドを指定することができます。

注: 複数のサービスで検索機能を提供する場合は、 エンコード値として utf8(UTF-8)を使用することをおすすめします。 ie パラメータと oe パラメータの両方で同じ値を宣言します。

詳細については、P-MAX の エンコード スキームの付録を ie パラメータと oe パラメータに使用できます。

文字エンコードに関する一般的な情報については、http://www.w3.org/TR/REC-html40/charset.html をご覧ください。

インターフェース言語

hl リクエスト パラメータを使用すると、 グラフィカルインターフェースの言語を指定しますhl パラメータ値は、特に 言語制限(lr パラメータを使用)が明示的に指定されていない場合、国際的なクエリが実行されます。このような hl パラメータで検索結果をプロモーションする場合があります。 ユーザーが入力した言語と同じ言語で表示されます。

hl パラメータを明示的に設定することをおすすめします 検索結果で常に最も品質の高い広告が 表示することもできます。

詳しくは、サポートされているインターフェース hl パラメータの有効な値の完全なリストについては、言語 セクションをご覧ください。

特定の言語で書かれたドキュメントの検索

lr リクエスト パラメータを使用すると、 検索結果を、特定の言語で作成されたドキュメントに限定 指定することもできます。

lr パラメータはブール演算子をサポートしており、 検索に含める(または除外する)複数の言語 表示されます。

次の例は、ブール演算子を使用して あります。

日本語で書かれたドキュメントの場合:

lr=lang_jp

イタリア語またはドイツ語で書かれたドキュメントの場合:

lr=lang_it|lang_de

ハンガリー語またはチェコ語で記述されていないドキュメントの場合:

lr=(-lang_hu).(-lang_cs)

詳しくは、Language Collections をご覧ください。 値のセクションにある、lr パラメータとブール値で指定できる値の一覧をご覧ください。 演算子のセクションで、これらの演算子の使用に関する あります。

簡体字中国語と繁体字中国語の 2 つの表記法 記述します。同じ概念を、 テストします。いずれかのパターンで検索語句が決まると、Google 検索では ウェブ検索サービスは、両方のページを含む検索結果を返すことができます。 あります。

この機能を使用するには:

  1. c2coff リクエスト パラメータを 0 に設定します。
    および
  2. 次のいずれかを行います。
    • リクエスト パラメータ lr を設定しない
      または
    • lr リクエスト パラメータを lr=lang_zh-TW|lang_zh-CN に設定します

次の例は、結果のリクエストに含めるクエリ パラメータを示しています。 中国語の簡体字中国語と繁体字中国語の両方が使用されています。( クライアントとして指定されたものは、この例には含まれていません)。

search?hl=zh-CN
    &lr=lang_zh-TW|lang_zh-CN
    &c2coff=0

結果のフィルタリング

Google ウェブ検索では、さまざまな方法で検索結果を絞り込むことができます 結果:

検索結果の自動フィルタリング

Google では、できる限り最適な検索結果を表示するため、 次の 2 つの手法を使用して、検索結果を 望ましくないと判断されることが多い:

  • 重複コンテンツ - 複数のドキュメントに、 そのセット内で最も関連性の高いドキュメントのみが 表示されます。

  • ホスト クラウディング - ホストのクラウディング そのサイトのすべての検索結果が表示されないことや、
    の下位の結果を表示 結果に直結します

一般的な検索リクエストでは、これらのフィルタをオンにしておくことをおすすめします フィルタによって大半の検索の質が大幅に向上するためです。 表示されます。ただし、filter クエリ パラメータを 0 に設定すると、このような自動フィルタをバイパスできます。 検索できます。

言語と国のフィルタリング

Google ウェブ検索サービスは、次のサイトのマスター インデックスから検索結果を返します。 すべてのウェブドキュメントを検索します。マスター インデックスには、 言語などの特定の属性でグループ化されたドキュメント 特定できます

リクエスト パラメータの lrcr を使用すると、検索結果を次のサブコレクションに限定できます。 特定の言語で書かれた文書や 国によって異なります。

Google WS はドキュメントの言語を次の方法で分析します。

  • ドキュメントの URL のトップレベル ドメイン(TLD)
  • ドキュメント内の言語メタタグ
  • ドキュメントの本文で使用される主な言語


lr パラメータの定義の 特定の言語で記述されたドキュメントと、言語コレクション値 lr パラメータの値として使用されます。 言語に基づいて検索結果を制限する方法について解説しています。

Google ウェブ検索では、次の情報を分析してドキュメントの国を特定します。

  • ドキュメントの URL のトップレベル ドメイン(TLD)
  • ウェブサーバーの IP アドレスの地理的位置

cr パラメータとCountry Collection の定義もご覧ください。 cr パラメータの値として使用できる値は、 含まれます。

注: 言語は 値と国の値を使用して、検索結果をカスタマイズします。対象 たとえば フランス語で書かれた フランスまたはカナダから送られてくる場合や、 オランダ語で書かれた 英語ではありませんlr パラメータと cr パラメータはどちらもブール演算子をサポートしています。

セーフサーチを使用したアダルト コンテンツのフィルタリング

Google のお客様の多くは、 サイト 制限しますセーフサーチ フィルタを使用すると、 できます。 Google のフィルタは、独自のテクノロジーを使用してキーワードやフレーズをチェックします できます。100% 正確なフィルタはありませんが、セーフサーチは 大多数のアダルト コンテンツを検索結果から除外する 表示されます。

Google は、セーフサーチを常に最新かつ包括的なものにするように努めています。 ウェブを継続的にクロールし、更新内容を組み込むことで、 分析できます。

セーフサーチは、次の言語でご利用いただけます。

オランダ語
英語
フランス語
ドイツ語
イタリア語
ポルトガル語(ブラジル)
スペイン語
繁体字中国語

Google が検索結果をフィルタする度合いを調整できます safe クエリ パラメータを使用してアダルト コンテンツを除外できます。 次の表に、Google のセーフサーチ設定と、その設定について説明します。 設定は検索結果に影響します。

セーフサーチのレベル 説明
より厳密なバージョンを有効にします いくつかあります。
次を含むウェブページをブロックします: ポルノなどの露骨な性的コンテンツ
オフ アダルト コンテンツを除外しない おすすめします。

* デフォルトのセーフサーチ設定はオフです。

セーフサーチを有効にしていても、 不適切なコンテンツが検索結果に含まれている場合は、そのサイトの URL を safesearch@google.com までメールでお知らせください。 がサイトを調査します。

XML の結果

Google XML 結果 DTD

Google では、同じ DTD を使用して、すべてのタイプの XML 形式を記述します。 表示されます。タグと属性の多くは、 あります。ただし、一部のタグは特定の あります。そのため、DDD での定義は 本ドキュメントでの定義より厳密な制限があります。

このドキュメントでは、関連する DTD の側面について説明します。 サポートしています。DTD を見ると 含まれていないタグや属性は無視して構いません。 こちらのドキュメントをご覧ください。DTD と この点については、このドキュメントに記載しています。

Google は、 取得されます。DTD は、Google 検索、 XML パーサーが Google の XML 結果を認識します。Google の XML は 文法は随時変更される可能性があります。 DTD を使用して各 XML 結果を検証できます。

また、XML パーサーを設定して、 検索リクエストを送信するたびに DTD が返されます。Google が DTD を更新する 頻度が低く、これらのリクエストにより不要な遅延と帯域幅が 提供します。

XML の結果を取得するには、xml_no_dtd 出力形式を使用することをおすすめします。 検索リクエストで xml output 形式を指定した場合は、 唯一の違いは、XML の結果に次の行が含まれる点です。

<!DOCTYPE GSP SYSTEM "google.dtd">

最新の DTD には、 http://www.google.com/google.dtd.

現時点で DTD のすべての機能が利用可能な、またはサポートされているわけではないことに注意してください。

XML レスポンスについて

  • すべての要素値が、表示に適した有効な HTML であること(ただし、 XML タグ定義内で特に指定されていない属性を指定します。
  • 一部の要素値は URL であり、リクエストする前に HTML エンコードする必要がある 表示されます。
  • XML パーサーは、ドキュメント化されていない属性とタグを無視する必要があります。 これにより、アプリケーションを変更せずに動作を継続できます XML 出力にさらに機能が追加された場合。
  • 特定の文字を XML タグ。XML プロセッサは、これらのエンティティを 使用します。エンティティを適切に変換しないと、 たとえば、ブラウザは「&」をレンダリングし、「&amp;」と置き換えます。 XML Standard では、次の文字を文書化します。これらの文字は、 以下の表に再現方法を示します。

    キャラクター エスケープ フォーム エンティティ 文字コード
    アンパサンド & &amp; &#38;
    一重引用符 ' &apos; &#39;
    二重引用符 " &quot; &#34;
    不等記号(より大) > &gt; &#62;
    不等記号(より小) < &lt; &#60;

通常の検索クエリと高度な検索クエリの XML 結果

通常の検索/検索オプション: クエリ例と XML 結果

このサンプルの WebSearch リクエストでは 10 件の結果(num=10)を要求しています 検索語句「Socer」について(q=socer)になります。これは、 「サッカー」(この例では「スペルミス」が意図的に間違って入力されています)。

http://www.google.com/search?
q=socer
&hl=en
&start=10
&num=10
&output=xml
&client=google-csbe
&cx=00255077836266642015:u-scht7a-8i

このリクエストにより、以下の XML 結果が生成されます。なお、 XML 結果にいくつかのコメントがあり、特定のタグが 表示されます。

<?xml version="1.0" encoding="ISO-8859-1" standalone="no" ?>

<GSP VER="3.2">
<TM>0.452923</TM>
<Q>socer</Q>
<PARAM name="cx" value="00255077836266642015:u-scht7a-8i" original_value="00255077836266642015%3Au-scht7a-8i"/>
<PARAM name="hl" value="en" original_value="en"/>
<PARAM name="q" value="socer" original_value="socer"/>
<PARAM name="output" value="xml" original_value="xml"/>
<PARAM name="client" value="google-csbe" original_value="google-csbe"/>
<PARAM name="num" value="10" original_value="10"/>
<Spelling>
<Suggestion q="soccer"><b><i>soccer</i></b></Suggestion>
</Spelling>
<Context>
<title>Sample Vacation CSE</title>
<Facet>
<FacetItem>
<label>restaurants</label>
<anchor_text>restaurants</anchor_text>
</FacetItem>
<FacetItem>
<label>wineries</label>
<anchor_text>wineries</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>golf_courses</label>
<anchor_text>golf courses</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>hotels</label>
<anchor_text>hotels</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>nightlife</label>
<anchor_text>nightlife</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>soccer_sites</label>
<anchor_text>soccer sites</anchor_text>
</FacetItem>
</Facet>
</Context>
<RES SN="1" EN="10">
<M>6080</M>
/*
* The FI tag after the comment indicates that the result
* set has been filtered. If the number of results were exact, the
* FI tag would be replaced by an XT tag in the same format.
*/
<FI />
<NB>
/*
* Since the request is for the first page of results, the PU tag,
* which contains a link to the previous page of search results,
* is not included in this XML result. If the sample result did include
* a previous page of results, it would be listed here, in the same format
* as the NU tag on the following line
*/
<NU>/search?q=socer&hl=en&lr=&ie=UTF-8&output=xml&client=test&start=10&sa=N</NU>
</NB>
<R N="1">
<U>http://www.soccerconnection.net/</U>
<UE>http://www.soccerconnection.net/</UE>
<T>SoccerConnection.net</T>
<CRAWLDATE>May 21, 2007</CRAWLDATE>
<S><b>soccer</b>; players; coaches; ball; world cup;<b>...</b></S>
<Label>transcodable_pages</Label>
<Label>accessible</Label>
<Label>soccer_sites</Label>
<LANG>en</LANG>
<HAS>
<DI>
<DT>SoccerConnection.net</DT>
<DS>Post your <b>soccer</b> resume directly on the Internet.</DS>
</DI>
<L/>
<C SZ="8k" CID="kWAPoYw1xIUJ"/>
<RT/>
</HAS>
</R>
/*
* The result includes nine more results, each enclosed by an R tag.
*/
</RES>
</GSP>

通常の検索/高度な検索: XML タグ

通常の検索リクエストと詳細検索の XML レスポンス どちらのリクエストも同じ XML タグのセットを使用します。これらの XML タグは、 下の表で説明されています。

以下の XML タグは、タグ名のアルファベット順であり、 タグの定義には、タグの説明が含まれます。例: XML 形式の結果でタグがどのように表示されるか、またタグの 説明します。タグが別の XML タグのサブタグの場合、またはタグが 独自のサブタグや属性を使用するとき、その情報は タグの定義テーブル。

ページの一部のサブタグの横に特定の記号が表示されることがあります。 ご覧ください。表示される記号とその意味は次のとおりです。

をご存じですか?= 省略可能なサブタグ
* = 0 個以上のサブタグのインスタンス
+ = サブタグの 1 つ以上のインスタンス
A B C D F G H I L M N P Q R S T U X

anchor_text
定義

&lt;anchor_text&gt; タグは、表示するテキストを指定する 絞り込み ラベル。絞り込みラベルは 英数字以外の文字をアンダースコアに置き換えてください。つまり、 <label> タグの値をユーザー インターフェースに表示します。代わりに、値を表示する代わりに &lt;anchor_text&gt; タグ。

<anchor_text>ゴルフ コース</anchor_text>
FacetItem
コンテンツの形式 テキスト

ブロック
定義

このタグは、プロモーション結果の本文内にブロックの内容をカプセル化します。各ブロックには、サブタグ TUL があります。空でない T タグは、ブロックにテキストが含まれていることを示します。空でない U タグと L タグは、リンク(U サブタグで URL を指定し、L サブタグにアンカー テキストを指定)が含まれていることを示します。

サブタグ TUL
BODY_LINE
コンテンツの形式

BODY_LINE
定義

このタグは、プロモートされた結果の本文内の行の内容をカプセル化します。本文の各行は複数の BLOCK タグで構成されます。このタグにはテキストか、URL を含むリンクとアンカー テキストが含まれます。

サブタグ ブロック*
SL_MAIN
コンテンツの形式

C
定義

&lt;C&gt; タグは、ウェブ検索サービスが この検索結果 URL のキャッシュ バージョンを取得できます。できないこと XML API を使用してキャッシュ ページを取得しますが、ユーザーをリダイレクトできます。 www.google.com にアクセスする 説明します。

属性
名前 形式 説明
SZ テキスト(整数 +「k」) キャッシュ バージョンのサイズを提供する をキロバイト(k)単位で指定します。
お客様 ID テキスト Google のキャッシュ内のドキュメントを識別します。 キャッシュからドキュメントを取得するには、 次のようになります。
cache:CIDtext:escapedURL

エスケープされた URL は UE タグで使用できます。

<C SZ="6,000"CID=&quot;kvOXK_cYSSgJ&quot;/
次を含む
コンテンツの形式

C2C
定義 <C2C> タグは、 検索結果は繁体字中国語のページを参照しています。このタグ 簡易型と従来のバージョンの場合にのみ表示されます。 中国語検索が有効になっています。有効化と有効化の詳細については、c2coff クエリ パラメータの定義をご覧ください。 この機能を無効にすることができます。
コンテンツの形式 テキスト

コンテキスト
定義

&lt;Context&gt; タグは、リソース コンテキストの 一連の検索結果に関連付けられた絞り込みラベル。

&lt;Context&gt;
サブタグ titleFacet+
コンテンツの形式 コンテナ

作成日
定義

&lt;CRAWLDATE&gt; タグは、 が最後にクロールされました。CRAWLDATE は、すべての検索結果ページで返されるわけではありません。

<CRAWLDATE>5 月 21 日 2005 年</CRAWLDATE>
R
コンテンツの形式 テキスト

DI
定義

&lt;DI&gt; タグは Open Directory プロジェクトをカプセル化します。 (ODP)カテゴリ情報。

&lt;DI&gt;
サブタグ DT?、DS ですか?
次を含む
コンテンツの形式

DS
定義

&lt;DS&gt; タグは、発生した要約を表します。 カテゴリは 1 つだけであるべきです。

<DS> &lt;b&gt;サッカー&lt;/b&gt;Google Chat で直接 実現しました。</DS>
DI
コンテンツの形式 テキスト(HTML を含む場合もあります)

DT
定義

&lt;DT&gt; タグは、単一の画像のタイトルを指定します。 カテゴリ。

&lt;DT&gt;SoccerConnection.net&lt;/DT&gt;
DI
コンテンツの形式 テキスト(HTML を含む場合もあります)

ファセット
定義

<Facet> タグには、&lt;FacetItem&gt; タグの論理グループが含まれます。Google Chat では 作成する プログラム可能検索エンジンを使用してグループ化し、 Engine の XML 仕様の形式をご覧ください。これらを results_xml_tag_Context><Context> は、タグが 隔離 最大 4 つの <Facet> タグを作成できます。各 <Facet> タグ内のアイテムは、表示のためにグループ化されますが、論理的でない場合もあります。 あります。

<ファセット>
サブタグ FacetItem+、title+
コンテキスト
コンテンツの形式 コンテナ

FacetItem
定義

&lt;FacetItem&gt; タグで情報をカプセル化する 一連の検索結果に関連付けられた絞り込みラベルについて。

&lt;FacetItem&gt;
サブタグ labelanchor_text+
Facet
コンテンツの形式 FacetItem

FI
定義 &lt;FI&gt; タグはフラグとして機能します。 検索でドキュメント フィルタリングが実行されたかどうかを示します。 自動フィルタリングのセクションをご覧ください。 Google 検索結果の詳細については、このドキュメントの フィルタできます。
<FI />
解決
コンテンツの形式

GSP
定義

&lt;GSP&gt; タグ Google XML 検索結果で返されるすべてのデータをカプセル化します。「GSP」 「Google 検索プロトコル」の略称です。

属性
名前 形式 説明
バージョン テキスト(整数) VER 属性は、検索結果出力のバージョンを指定します。「 現在の出力バージョンは「3.2」です。
<GSP VER="3.2">
サブタグ PARAM+、QRES?、TM
コンテンツの形式

HAS
定義 &lt;HAS&gt; タグは 任意の特別な検索に関する情報 リクエスト パラメータを確認できます。

注: Google Cloud コンソールの <HAS> の定義は、 WebSearch は DTD よりも制限が厳しくなっています。

サブタグ DI?、L?、C?、RT:
R

ISURL
定義 Google が &lt;ISURL&gt; タグを返します。 検索クエリが URL の場合。
GSP
コンテンツの形式

L
定義 &lt;L&gt; タグの有無 は、WebSearch サービスが この検索結果 URL。そのようなサイトを見つけるには、特別なクエリ語句 link: を使用します。
次を含む
コンテンツの形式

label
定義

<label> タグでは絞り込みラベルを指定します。 を使用して検索結果を絞り込むことができます。用途 絞り込みラベルの場合は、文字列 more:[[ラベルタグの値]] を HTTP リクエストの q パラメータの値を Google に 表示されます。この値は 0 または 1、 Google にクエリを送信する前に URL エスケープされます。

This example uses the refinement label golf_courses to
filter search results about Palm Springs:
q=Palm+Springs+more:golf_courses

The URL-escaped version of this query is:
q=Palm+Springs+more%3Agolf_courses

注: <label> タグは &lt;Label&gt; タグ: 絞り込みラベルを識別します。 検索結果で特定の URL と関連付けられた

&lt;label&gt;golf_courses&lt;/label&gt;
FacetItem
コンテンツの形式 テキスト

LANG
定義

&lt;LANG&gt; タグには、Google が推測した最も可能性が高いものが 検索結果の言語です。

<LANG>ja</LANG>
R
コンテンツの形式 テキスト

M
定義

&lt;M&gt; タグは、推定合計額を示します。 検索結果の数。

注: この推定値は正確でない可能性があります。

<M>1,620,000</M>
解決
コンテンツの形式 テキスト

新生児
定義

&lt;NB&gt; タグはナビゲーション情報(検索結果の次のページまたは前のページへのリンク)をカプセル化します 指定することもできます。

注: このタグは クリックします

&lt;NB&gt;
サブタグ NU?、PU
解決
コンテンツの形式

NU
定義

&lt;NU&gt; タグには、サーバー リソースへの相対リンクが 表示されます。

<NU>/search?q=花&num=10&hl=ja&ie=UTF-8
&output=xml&client=test&start=10</NU>
コンテンツの形式 テキスト(相対 URL)

PARAM
定義

&lt;PARAM&gt; タグ HTTP リクエストで送信された入力パラメータを識別し、 XML の結果と結合しますパラメータに関する情報は タグ属性(name、value、original_value)があり、 HTTP リクエストで送信されるパラメータごとに 1 つの PARAM タグ。

属性
名前 形式 説明
name テキスト 入力パラメータ名。
value HTML 入力の HTML 形式バージョン パラメータ値を設定します。
original_value テキスト 入力パラメータ値の元の URL エスケープ バージョン。
<PARAM name="cr"value=&quot;countryNZ&quot; 元の値="countryNZ"/
GSP
コンテンツの形式 複雑

PU
定義

&lt;PU&gt; タグは、リソースへの相対リンクを提供します。 検索結果の前のページ

<PU>/search?q=flowers&num=10&hl=ja&output=xml
&client=test&start=10</PU>
コンテンツの形式 テキスト(相対 URL)

Q
定義

&lt;Q&gt; タグは検索クエリを識別する XML 結果に関連付けられた HTTP リクエストで送信されます。

<Q>ピザ</Q>

GSP
コンテンツの形式 テキスト

R
定義

&lt;R&gt; タグは、指定されたリソースの詳細を 表示されます。

注: google_compute_network ブロックの <R> タグの定義は、 WebSearch は DTD よりも制限が厳しくなっています。

属性
名前 形式 説明
N テキスト(整数) このオブジェクトのインデックス(1 から始まり) 表示されます。
MIME テキスト 検索の MIME タイプを示します。 表示されます。
サブタグ UUET?、CRAWLDATES?、LANG?、次を含む
解決

RES
定義

&lt;RES&gt; タグは、個々の ID のセットをカプセル化します。 その検索結果の詳細が表示されます。

属性
名前 形式 説明
SN テキスト(整数) 各 URL のインデックス(1 から始まり) この結果セットで返された最初の検索結果です。
EN テキスト(整数) 最後のキーのインデックス(1 から始まり) 返されます。
<RES SN="1"EN="10">
サブタグ MFI?、XT?、NB:R*
GSP
コンテンツの形式

S
定義

&lt;S&gt; タグには、検索の抜粋が含まれます 太字でハイライト表示された結果が表示されます。改行は 適切にラップするため、抜粋部分に含まれています。

<S>ワシントン(CNN) -- 大統領に対する上院の対抗戦 <ブッシュ>裁判関連の選考が 5 名の候補者が最終投票に進める &lt;b&gt;...&lt;b&gt;...&lt;/b&gt;<S>
R
コンテンツの形式 テキスト(HTML)

SL_MAIN
定義

このタグは、プロモーション結果のコンテンツをカプセル化します。プロモーションの解析に使用します。タイトルリンクのアンカー テキストと URL は、それぞれ T サブタグと U サブタグに含まれます。本文とリンクの行は BODY_LINE サブタグに含まれます。

サブタグ BODY_LINE*、TU
SL_RESULTS
コンテンツの形式

SL_RESULTS
定義

プロモートする結果用のコンテナタグ。検索結果にプロモーションがある場合は、このいずれかが表示されます。SL_MAIN サブタグには、メインの結果データが含まれます。

サブタグ SL_MAIN*
R
コンテンツの形式

スペル
定義

<スペルチェック> タグは、代替の 送信されたクエリのスペル候補。このタグは 検索結果の最初のページで表示されます。スペルの候補は、 英語、中国語、日本語、韓国語に対応しています。

注: スペル候補は、 gl パラメータ値が 小文字で表記されます。

<スペル>
サブタグ 候補
GSP
コンテンツの形式

候補
定義 &lt;Suggestion&gt; タグには 送信されたクエリの別のスペル候補。こちらの タグのコンテンツを検索して、検索ユーザーに別のつづりを提案します。 q 属性の値は、 検索語句として使用できる、URL エスケープされたスペル候補。
属性
名前 形式 説明
q テキスト q 属性では、 URL エスケープ版のスペル候補。
<提案 q=&quot;soccer&quot;&gt;&amp;lt;b&amp;gt;&amp;lt;i&amp;gt;soccer&amp;lt;/i&amp;gt;&amp;lt;/b&amp;gt;&lt;/Suggestion&gt;
スペル
コンテンツの形式 テキスト(HTML)

T
定義 &lt;T&gt; タグにはタイトルが含まれます。 返されます。
<T>アミシズ イースト コースト ピザ屋</T>
R
コンテンツの形式 テキスト(HTML)

title
定義

&lt;Context&gt; の子要素である &lt;Context&gt; タグは、プログラム可能検索エンジンの名前を格納します。

<Facet> の子として、<title> タグはファセットのセットのタイトルを指定します。

<Context> の子として: <title>My Search Engine&lt;/title&gt;

<Facet> の子として: <title>facet タイトル</title>

コンテキストファセット
コンテンツの形式 テキスト

TM
定義

&lt;TM&gt; タグはサーバーの合計時間を示します。 検索結果を返すのに必要な時間(秒単位)です。

<TM>0.100445</TM>
GSP
コンテンツの形式 テキスト(浮動小数点数)

TikTok
定義 &lt;TT&gt; タグは検索を行う チップ。
<TT><t;i&gt;ヒント: Return キーを押しても、 [検索] ボタンをクリックします。<TT>
GSP

U
定義 &lt;U&gt; タグは URL を示します。 表示されます。
&lt;U&gt;http://www.dominos.com/&lt;/U&gt;
R
コンテンツの形式 テキスト(絶対 URL)

UD
定義

&lt;UD&gt; タグは、IDN エンコードの (国際ドメイン名)検索結果の URL。この値により、 ドメインの言語を使用して表示できます。たとえば、 IDN でエンコードされた URL「http://www.%E8%8A%B1%E4%BA%95.com」は、デコードして「http://www.花井居酒屋%95.com」と表示できます。 この &lt;UD&gt; タグは、 ud パラメータを含むリクエスト。

注: これはベータ版の機能です。

&lt;UD&gt;http://www.%E8%8A%B1%E4%BA%95.com/&lt;/UD&gt;
R
コンテンツの形式 テキスト(IDN でエンコードされた URL)

UE
定義 &lt;UE&gt; タグは URL を示します。 表示されます。適切な値になるように、値が URL エスケープされます。 URL でクエリ パラメータとして渡す場合)。
&lt;UE&gt;http://www.dominos.com/&lt;/UE&gt;
R
コンテンツの形式 テキスト(URL エスケープされた URL)

XT
定義 &lt;XT&gt; タグは、 M タグで指定される検索結果の推定合計数は、 結果の総数です詳しくは、自動 フィルタリングのセクションをご覧ください。
<XT />
解決
コンテンツの形式


画像検索クエリの XML 結果

このサンプル画像リクエストでは、「サル」という検索キーワードについて 5 件の結果(num=5)を求めています(q=サル)。

http://www.google.com/cse?
  searchtype=image
  &num=2
  &q=monkey
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

このリクエストにより、以下の XML 結果が生成されます。


<GSP VER="3.2">
  <TM>0.395037</TM>
  <Q>monkeys</Q>

  <PARAM name="cx" value="011737558837375720776:mbfrjmyam1g" original_value="011737558837375720776:mbfrjmyam1g" url_<escaped_value="011737558837375720776%3Ambfrjmyam1g" js_escaped_value="011737558837375720776:mbfrjmyam1g"/>
  <PARAM name="client" value="google-csbe" original_value="google-csbe" url_escaped_value="google-csbe" js_escaped_value="google-csbe"/>
  <PARAM name="q" value="monkeys" original_value="monkeys" url_escaped_value="monkeys" js_escaped_value="monkeys"/>
  <PARAM name="num" value="2" original_value="2" url_escaped_value="2" js_escaped_value="2"/>
  <PARAM name="output" value="xml_no_dtd" original_value="xml_no_dtd" url_escaped_value="xml_no_dtd" js_escaped_value="xml_no_dtd"/>
  <PARAM name="adkw" value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" original_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" url_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" js_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A"/>
  <PARAM name="hl" value="en" original_value="en" url_escaped_value="en" js_escaped_value="en"/>
  <PARAM name="oe" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/>
  <PARAM name="ie" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/>
  <PARAM name="boostcse" value="0" original_value="0" url_escaped_value="0" js_escaped_value="0"/>

  <Context>
    <title>domestigeek</title>
  </Context>

  <ARES/>
  <RES SN="1" EN="2">
    <M>2500000</M>
    <NB>
      <NU>/images?q=monkeys&num=2&hl=en&client=google-csbe&cx=011737558837375720776:mbfrjmyam1g&boostcse=0&output=xml_no_dtd
        &ie=UTF-8&oe=UTF-8&tbm=isch&ei=786oTsLiJaaFiALKrPChBg&start=2&sa=N
      </NU>
    </NB>
    <RG START="1" SIZE="2"/>
      <R N="1" MIME="image/jpeg">
        <RU>http://www.flickr.com/photos/fncll/135465558/</RU>
        <U>
          http://farm1.static.flickr.com/46/135465558_123402af8c.jpg
        </U>
        <UE>
          http://farm1.static.flickr.com/46/135465558_123402af8c.jpg
        </UE>
        <T>Computer <b>Monkeys</b> | Flickr - Photo Sharing!</T>
        <RK>0</RK>
        <BYLINEDATE>1146034800</BYLINEDATE>
        <S>Computer <b>Monkeys</b> | Flickr</S>
        <LANG>en</LANG>
        <IMG WH="500" HT="305" IID="ANd9GcQARKLwzi-t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs">
          <SZ>88386</SZ>
          <IN/>
        </IMG>
        <TBN TYPE="0" WH="130" HT="79" URL="http://t0.gstatic.com/images?q=tbn:ANd9GcQARKLwzi-
t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs"/>
      </R>
      <R N="2" MIME="image/jpeg">
        <RU>
          http://www.flickr.com/photos/flickerbulb/187044366/
        </RU>
        <U>
          http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg
        </U>
        <UE>
          http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg
        </UE>
        <T>
          one. ugly. <b>monkey</b>. | Flickr - Photo Sharing!
        </T>
        <RK>0</RK>
        <BYLINEDATE>1152514800</BYLINEDATE>
        <S>one. ugly. <b>monkey</b>.</S>
        <LANG>en</LANG>
        <IMG WH="400" HT="481" IID="ANd9GcQ3Qom0bYbee4fThCQVi96jMEwMU6IvVf2b8K5vERKVw-
           EF4tQQnDDKOq0"><SZ>58339</SZ>
          <IN/>
        </IMG>
        <TBN TYPE="0" WH="107" HT="129" URL="http://t1.gstatic.com/images?q=tbn:ANd9GcQ3Qom0bYbee4fThCQ
          Vi96jMEwMU6IvVf2b8K5vERKVw-EF4tQQnDDKOq0"/>
      </R>
  </RES>
</GSP>

画像検索: XML タグ

次の表に、画像検索クエリの XML レスポンスで使用されるその他の XML タグを示します。

ページの一部のサブタグの横に特定の記号が表示されることがあります。 ご覧ください。表示される記号とその意味は次のとおりです。

をご存じですか?= 省略可能なサブタグ
* = 0 個以上のサブタグのインスタンス
+ = サブタグの 1 つ以上のインスタンス

RG
定義

&lt;RG&gt; タグには、個々の画像検索結果の詳細が含まれます。

属性
名前 形式 説明
N テキスト(整数) このオブジェクトのインデックス(1 から始まり) 表示されます。
MIME テキスト 検索の MIME タイプを示します。 表示されます。
解決
RU
定義

<RU tag> タグには、各画像検索結果の詳細が含まれます。

R