JSON の API リファレンス

ブール OR 検索 [ OR ]
説明

OR クエリ語句は、一連の(2 つ以上)のクエリ語句の 1 つを含むドキュメントを取得します。OR クエリ語句を使用するには、一連の各語句の間に検索語句 OR を大文字で挿入します。

リクエスト パラメータ「as_oq」(「as_oq=London+Paris」など)を使用して、一連の用語のうちの任意の用語の検索を送信することもできます。

注: 検索リクエストで「London+OR+Paris」というクエリを指定した場合、検索結果には、この 2 つの単語のうち少なくとも 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

ブール演算子

次のパラメータの値には、ブール演算子を使用できます。

  • cr
  • lr

ブール演算子の定義

注: パラメータ値にスペースを含めることはできません。

ブール値 AND [.]
説明

AND 演算子(.)は、コレクションが交差する結果を . 演算子の両側に返します。

次の例では、フランス語またはイタリア語のすべての結果を削除します。
lr=(-lang_fr).(-lang_it)


ブール値 NOT [-]
説明

NOT 演算子(-)は、マイナス(「-」)演算子の直後にあるコレクション内のすべての結果を削除します。

この例では、フランス語のすべての検索結果を削除します。
lr=-lang_fr

次の例では、フランス語またはイタリア語のすべての結果を削除します。
lr=(-lang_fr).(-lang_it)

注: 上記の 2 番目の例では、ブール演算子 AND を使用して、結果をフランス語またはイタリア語で記述しないことを指定しています。クエリ内のかっこの配置に応じて、ブール AND 演算子またはブール OR 演算子のいずれかを使用してこのクエリを表現できます。これは、ドキュメントがフランス語で記述されている場合、イタリア語で記述されていないためです。したがって、ブールステートメントでは、ドキュメントがフランス語で記述されておらず、かつイタリア語で記述されていないことを明示する必要があります。


ブール値 OR [|]
説明

OR 演算子(|)は、パイプ演算子の左側のコレクションまたは右側のコレクション(「|」)にある結果を返します。

この例では、簡体字中国語または繁体字中国語で書かれたすべての結果を返します。
lr=lang_zh-TW|lang_zh-CN

この例では、フランス語またはイタリア語で記述されていないすべての結果をリクエストしています。ここで、かっこの位置が、ブール AND 演算子のサンプルクエリとは異なる場所に配置されていることに注意してください。
lr=-(lang_fr|lang_it)


ブール括弧 [()]
説明

この演算子を使用すると、かっこの内側にある用語をすべて評価してから、かっこの内側にある用語を評価できます。かっこを使用すると、項が評価される順序を調整できます。

NOT [-] 演算子の例は、フランス語とイタリア語のいずれでも記述されていないリクエスト結果に対して、次の構造を示しています。
lr=(-lang_fr).(-lang_it)

OR (|) 演算子の例は、イタリア語のフランス語で記述されていない結果のリクエストも示します。後者の例では、AND 演算子ではなく OR 演算子を使用しているため、かっこの位置も変更する必要があります。
lr=-(lang_fr|lang_it)

クエリと結果のプレゼンテーションの多言語化

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

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

インターフェース言語

グラフィカル インターフェースの言語を指定するには、「hl」リクエスト パラメータを使用します。特に、言語制限(「lr」パラメータを使用)が明示的に指定されていない国際検索では、"hl" パラメータ値が検索結果に影響する可能性があります。このような場合、「hl」パラメータを使用すると、ユーザーの入力言語と同じ言語で検索結果を昇格させることができます。

Google がクエリごとに最高品質の検索結果を選択できるように、検索結果に「hl」パラメータを明示的に設定することをおすすめします。

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

簡体字中国語と繁体字中国語は、中国語のライティング バリアントです。同じ概念の記述は、バリアントごとに異なる場合があります。一方のパターンのクエリに対して、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 つの手法を使用して、一般的に望ましくないと見なされる検索結果を自動的にフィルタしています。

  • 重複コンテンツ - 複数のドキュメントに同じ情報が含まれている場合、検索結果には最も関連性の高いドキュメントのみが含まれます。

  • ホストのクラウディング - 同じサイトから多数の検索結果がある場合、Google がそのサイトのすべての検索結果を表示できない、またはそうでない場合よりも掲載順位が下がることがあります。

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

セーフサーチによるアダルト コンテンツのフィルタリング

Google ユーザーの多くは、アダルト コンテンツを含むサイトの検索結果を表示したくないと考えています。Google のセーフサーチ フィルタを使用すると、アダルト コンテンツを含む検索結果をスクリーニングし、除外できます。Google のフィルタは、独自の技術を使用してキーワード、フレーズ、URL をチェックします。フィルタは 100% 正確というわけではありませんが、セーフサーチを使用すると、アダルト コンテンツの大部分を検索結果から除外できます。

Google では、ウェブを継続的にクロールし、ユーザーの候補から得たアップデートを組み込むことで、セーフサーチを可能な限り最新で包括的なものにするよう努めています。

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

セーフサーチ レベル 説明
high より厳密なバージョンのセーフサーチを有効にします。
medium ポルノなどの露骨な性的コンテンツを含むウェブページをブロックします。
off 検索結果からアダルト コンテンツを除外しません。

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

国際値

サポートされているインターフェース言語

Google は 80 以上の言語に対応しています。デフォルトのインターフェース言語は英語です。次のリストは、Google がサポートするすべてのインターフェース言語を示しています。

表示言語 hl パラメータ値
アフリカーンス語 af
アルバニア語 sq
アムハラ語 sm
アラビア語 ar
アゼルバイジャン語 az
バスク語 eu
ベラルーシ語 be
ベンガル語 bn
ビハール語 bh
ボスニア語 bs
ブルガリア語 bg
カタロニア語 ca
中国語(簡体) zh-CN
中国語(繁体) zh-TW
クロアチア語 hr
チェコ語 cs
デンマーク語 da
オランダ語 nl
英語 en
エスペラント語 eo
エストニア語 et
フェロー語 fo
フィンランド語 fi
フランス料理 fr
フリジア語 fy
ガリシア語 gl
ジョージア語 ka
ドイツ語 de
ギリシャ語 el
グジャラート語 gu
ヘブライ語 iw
ヒンディー語 hi
ハンガリー語 hu
アイスランド語 is
インドネシア語 id
インターリングア ia
アイルランド語 ga
イタリア語 it
日本語 ja
ジャワ語 jw
カンナダ語 kn
韓国語 ko
ラテン語 la
ラトビア語 lv
リトアニア語 lt
マケドニア語 mk
マレー語 ms
マラヤーム ml
マルタ語 mt
マラーティー語 mr
ネパール語 ne
ノルウェー語 no
ノルウェー語(ニーノシク) nn
オック語 oc
ペルシャ語 fa
ポーランド語 pl
ポルトガル語(ブラジル) pt-BR
ポルトガル語 (ポルトガル) pt-PT
パンジャブ語 pa
ルーマニア語 ro
ロシア語 ru
スコットランド ゲール語 gd
セルビア語 sr
シンハラ語 si
スロバキア語 sk
スロベニア語 sl
スペイン料理 es
スーダン語 su
スワヒリ語 sw
スウェーデン語 sv
タガログ語 tl
タミル文字 ta
テルグ文字 te
タイ料理 th
ティグリニャ語 ti
トルコ語 tr
ウクライナ語 uk
ウルドゥー語 ur
ウズベク語 uz
ベトナム語 vi
ウェールズ語 cy
コーサ語 xh
ズールー語 zu

国別コレクションの値

次の値を使用して、"cr" クエリ パラメータを使用して国のフィルタを指定できます。

国別コレクション名
アフガニスタン countryAF
アルバニア countryAL
アルジェリア countryDZ
米領サモア countryAS
アンドラ countryAD
アンゴラ countryAO
アンギラ countryAI
南極 countryAQ
アンティグア バーブーダ countryAG
アルゼンチン countryAR
アルメニア countryAM
アルバ countryAW
オーストラリア countryAU
オーストリア countryAT
アゼルバイジャン countryAZ
バハマ countryBS
バーレーン countryBH
バングラデシュ countryBD
バルバドス countryBB
ベラルーシ countryBY
ベルギー countryBE
ベリーズ countryBZ
ベナン countryBJ
バミューダ countryBM
ブータン countryBT
ボリビア countryBO
ボスニア ヘルツェゴビナ countryBA
ボツワナ countryBW
ブーベ島 countryBV
ブラジル countryBR
英領インド洋地域 countryIO
ブルネイ ダルサラーム国 countryBN
ブルガリア countryBG
ブルキナファソ countryBF
ブルンジ countryBI
カンボジア countryKH
カメルーン countryCM
カナダ countryCA
カーボベルデ countryCV
ケイマン諸島 countryKY
中央アフリカ countryCF
チャド countryTD
チリ countryCL
中国 countryCN
クリスマス諸島 countryCX
ココス(キーリング)諸島 countryCC
コロンビア countryCO
コモロ countryKM
コンゴ countryCG
コンゴ民主共和国 countryCD
クック諸島 countryCK
コスタリカ countryCR
コートジボワール countryCI
クロアチア(Hrvatska) countryHR
Cuba countryCU
キプロス countryCY
チェコ共和国 countryCZ
デンマーク countryDK
ジブチ countryDJ
ドミニカ国 countryDM
ドミニカ共和国 countryDO
東ティモール countryTP
エクアドル countryEC
エジプト countryEG
エルサルバドル countrySV
赤道ギニア countryGQ
エリトリア countryER
エストニア countryEE
エチオピア countryET
EU countryEU
フォークランド諸島(マルビナス) countryFK
フェロー諸島 countryFO
フィジー countryFJ
フィンランド countryFI
フランス countryFR
フランス、メトロポリタン countryFX
仏領ギアナ countryGF
仏領ポリネシア countryPF
仏領南方、南極地域 countryTF
ガボン countryGA
ガンビア countryGM
グルジア countryGE
ドイツ countryDE
ガーナ countryGH
ジブラルタル countryGI
ギリシャ countryGR
グリーンランド countryGL
グレナダ countryGD
グアダループ countryGP
グアム countryGU
グアテマラ countryGT
ギニア countryGN
ギニアビサウ countryGW
ガイアナ countryGY
ハイチ countryHT
ハード島、マクドナルド諸島 countryHM
ローマ教皇庁(バチカン市国) countryVA
ホンジュラス countryHN
香港 countryHK
ハンガリー countryHU
アイスランド countryIS
インド countryIN
インドネシア countryID
イラン countryIR
イラク countryIQ
アイルランド countryIE
イスラエル countryIL
イタリア countryIT
ジャマイカ countryJM
日本 countryJP
ヨルダン countryJO
カザフスタン countryKZ
ケニア countryKE
キリバス countryKI
朝鮮民主主義人民共和国 countryKP
韓国 countryKR
クウェート countryKW
キルギスタン countryKG
ラオス人民民主共和国 countryLA
ラトビア countryLV
レバノン countryLB
レソト countryLS
リベリア countryLR
リビア アラブ ジャマーヒリーヤ国 countryLY
リヒテンシュタイン countryLI
リトアニア countryLT
ルクセンブルク countryLU
マカオ countryMO
マケドニア旧ユーゴサルブ共和国 countryMK
マダガスカル countryMG
マラウイ countryMW
マレーシア countryMY
モルディブ countryMV
マリ countryML
マルタ countryMT
マーシャル諸島 countryMH
マルチニーク countryMQ
モーリタニア countryMR
モーリシャス countryMU
マイヨット島 countryYT
メキシコ countryMX
ミクロネシア連邦 countryFM
モルドバ countryMD
モナコ countryMC
モンゴル countryMN
モントセラト countryMS
モロッコ countryMA
モザンビーク countryMZ
ミャンマー countryMM
ナミビア countryNA
ナウル countryNR
ネパール countryNP
オランダ countryNL
オランダ領アンティル countryAN
ニューカレドニア countryNC
ニュージーランド countryNZ
ニカラグア countryNI
ニジェール countryNE
ナイジェリア countryNG
ニウエ countryNU
ノーフォーク島 countryNF
北マリアナ諸島 countryMP
ノルウェー countryNO
オマーン countryOM
パキスタン countryPK
パラオ countryPW
パレスチナ自治区 countryPS
パナマ countryPA
パプアニューギニア countryPG
パラグアイ countryPY
ペルー countryPE
フィリピン countryPH
ピトケアン島 countryPN
ポーランド countryPL
ポルトガル countryPT
プエルトリコ countryPR
カタール countryQA
レユニオン countryRE
ルーマニア countryRO
ロシア連邦 countryRU
ルワンダ countryRW
セントヘレナ countrySH
セントクリストファー ネーヴィス countryKN
セントルシア countryLC
サンピエール ミクロン countryPM
セントヴィンセントおよびグレナディーン countryVC
サモア countryWS
サンマリノ countrySM
サントメ プリンシペ countryST
サウジアラビア countrySA
セネガル countrySN
セルビア モンテネグロ countryCS
セイシェル countrySC
シエラレオネ countrySL
シンガポール countrySG
スロバキア countrySK
スロベニア countrySI
ソロモン諸島 countrySB
ソマリア countrySO
南アフリカ countryZA
サウスジョージア・サウスサンドウィッチ諸島 countryGS
スペイン countryES
スリランカ countryLK
スーダン countrySD
スリナム countrySR
スヴァールバル諸島およびヤンマイエン島 countrySJ
スワジランド countrySZ
スウェーデン countrySE
スイス countryCH
シリア countrySY
台湾 countryTW
タジキスタン countryTJ
タンザニア countryTZ
タイ countryTH
トーゴ countryTG
トケラウ諸島 countryTK
トンガ countryTO
トリニダード トバゴ countryTT
チュニジア countryTN
トルコ countryTR
トルクメニスタン countryTM
タークス カイコス諸島 countryTC
ツバル countryTV
ウガンダ countryUG
ウクライナ countryUA
アラブ首長国連邦 countryAE
イギリス countryUK
アメリカ合衆国 countryUS
合衆国周辺離島 countryUM
ウルグアイ countryUY
ウズベキスタン countryUZ
バヌアツ countryVU
ベネズエラ countryVE
ベトナム countryVN
英領バージン諸島 countryVG
米領バージン諸島 countryVI
ウォリス フツナ諸島 countryWF
西サハラ countryEH
イエメン countryYE
ユーゴスラビア連邦共和国 countryYU
ザンビア countryZM
ジンバブエ countryZW

国コード

次の表に、「gl」パラメータの値として使用できる 2 文字の国コードを示します。

Country Code
アフガニスタン af
アルバニア al
アルジェリア dz
米領サモア as
アンドラ ad
アンゴラ ao
アンギラ ai
南極 aq
アンティグア バーブーダ ag
アルゼンチン ar
アルメニア am
アルバ aw
オーストラリア au
オーストリア at
アゼルバイジャン az
バハマ bs
バーレーン bh
バングラデシュ bd
バルバドス bb
ベラルーシ by
ベルギー be
ベリーズ bz
ベナン bj
バミューダ bm
ブータン bt
ボリビア bo
ボスニア ヘルツェゴビナ ba
ボツワナ bw
ブーベ島 bv
ブラジル br
英領インド洋地域 io
ブルネイ ダルサラーム国 bn
ブルガリア bg
ブルキナファソ bf
ブルンジ bi
カンボジア kh
カメルーン cm
カナダ ca
カーボベルデ cv
ケイマン諸島 ky
中央アフリカ cf
チャド td
チリ cl
中国 cn
クリスマス諸島 cx
ココス(キーリング)諸島 cc
コロンビア co
コモロ km
コンゴ cg
コンゴ民主共和国 cd
クック諸島 ck
コスタリカ cr
コートジボワール ci
クロアチア hr
Cuba cu
キプロス cy
チェコ共和国 cz
デンマーク dk
ジブチ dj
ドミニカ国 dm
ドミニカ共和国 do
エクアドル ec
エジプト eg
エルサルバドル sv
赤道ギニア gq
エリトリア er
エストニア ee
エチオピア et
フォークランド諸島(マルビナス諸島) fk
フェロー諸島 fo
フィジー fj
フィンランド fi
フランス fr
仏領ギアナ gf
仏領ポリネシア pf
仏領南方、南極地域 tf
ガボン ga
ガンビア gm
グルジア ge
ドイツ de
ガーナ gh
ジブラルタル gi
ギリシャ gr
グリーンランド gl
グレナダ gd
グアダループ gp
グアム gu
グアテマラ gt
ギニア gn
ギニアビサウ gw
ガイアナ gy
ハイチ ht
ハード島、マクドナルド諸島 hm
ローマ教皇庁(バチカン市国) va
ホンジュラス hn
香港 hk
ハンガリー hu
アイスランド is
インド in
インドネシア id
イラン ir
イラク iq
アイルランド ie
イスラエル il
イタリア it
ジャマイカ jm
日本 jp
ヨルダン jo
カザフスタン kz
ケニア ke
キリバス ki
朝鮮民主主義人民共和国 kp
韓国 kr
クウェート kw
キルギスタン kg
ラオス人民民主共和国 la
ラトビア lv
レバノン lb
レソト ls
リベリア lr
リビア アラブ ジャマーヒリーヤ国 ly
リヒテンシュタイン li
リトアニア lt
ルクセンブルク lu
マカオ mo
マケドニア旧ユーゴサルブ共和国 mk
マダガスカル mg
マラウイ mw
マレーシア my
モルディブ mv
マリ ml
マルタ mt
マーシャル諸島 mh
マルチニーク mq
モーリタニア mr
モーリシャス mu
マイヨット島 yt
メキシコ mx
ミクロネシア連邦 fm
モルドバ md
モナコ mc
モンゴル mn
モントセラト ms
モロッコ ma
モザンビーク mz
ミャンマー mm
ナミビア na
ナウル nr
ネパール np
オランダ nl
オランダ領アンティル an
ニューカレドニア nc
ニュージーランド nz
ニカラグア ni
ニジェール ne
ナイジェリア ng
ニウエ nu
ノーフォーク島 nf
北マリアナ諸島 mp
ノルウェー no
オマーン om
パキスタン pk
パラオ pw
パレスチナ自治区 ps
パナマ pa
パプアニューギニア pg
パラグアイ py
ペルー pe
フィリピン ph
ピトケアン島 pn
ポーランド pl
ポルトガル pt
プエルトリコ pr
カタール qa
レユニオン re
ルーマニア ro
ロシア連邦 ru
ルワンダ rw
セントヘレナ sh
セントクリストファー ネーヴィス kn
セントルシア lc
サンピエール ミクロン pm
セントヴィンセントおよびグレナディーン vc
サモア ws
サンマリノ sm
サントメ プリンシペ st
サウジアラビア sa
セネガル sn
セルビア モンテネグロ cs
セイシェル sc
シエラレオネ sl
シンガポール sg
スロバキア sk
スロベニア si
ソロモン諸島 sb
ソマリア so
南アフリカ za
サウスジョージア・サウスサンドウィッチ諸島 gs
スペイン es
スリランカ lk
スーダン sd
スリナム sr
スヴァールバル諸島およびヤンマイエン島 sj
スワジランド sz
スウェーデン se
スイス ch
シリア sy
台湾 tw
タジキスタン tj
タンザニア tz
タイ th
東ティモール tl
トーゴ tg
トケラウ諸島 tk
トンガ to
トリニダード トバゴ tt
チュニジア tn
トルコ tr
トルクメニスタン tm
タークス カイコス諸島 tc
ツバル tv
ウガンダ ug
ウクライナ ua
アラブ首長国連邦 ae
イギリス uk
アメリカ合衆国 us
合衆国周辺離島 um
ウルグアイ uy
ウズベキスタン uz
バヌアツ vu
ベネズエラ ve
ベトナム社会主義共和国 vn
英領バージン諸島 vg
米領バージン諸島 vi
ウォリス フツナ諸島 wf
西サハラ eh
イエメン ye
ザンビア zm
ジンバブエ zw