XML API リファレンスの付録

ブール演算子

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

ブール演算子の定義

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

ブール値 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)


URL エスケープ

HTTP 検索リクエストを実行するには、Google が HTTP リクエストを正しく変換し、適切なレスポンスを生成できるように、特定の規則に従う必要があります。

HTTP URL スキーマでは、HTTP URL リクエストに次の文字のみを含めることが規定されています。

  • 英数字:(a ~ z、A ~ Z、0 ~ 9)
  • 特殊文字: $ - _ . | + ! * ' ( )
  • 予約文字: ; / ? : @ = &

Google では、予約文字を使用して URL をデコードし、一部の特殊文字を使用して検索機能をリクエストします。したがって、検索パラメータ値に出現する英数字以外の文字はすべて URL エスケープする必要があります。

文字列を URL エスケープするには、空白文字の各シーケンスを 1 つの「+」(プラス記号)に変換し、英数字以外の文字をその文字の値を表す 16 進数エンコードに置き換えます。上記の特殊文字と予約文字の 16 進数エンコードを次の表に示します。リクエストのパラメータ値では、これらの各文字を URL エスケープする必要があります。

文字 16 進数
エンコード
$ %24
- %2 日
_ %5F
. %2E
+ %20 億
! %21
* %2A
%22
' %27
( %28
) %29
; %30 億
/ %2F
? %3F
: %3A
@ %40
= %3D
& %26
| %7C

元の文字列 URL エスケープ文字列
パンチ&ジュディ パンチ
オライリー ライリー星

URL のエスケープについて詳しくは、W3CIETF のウェブサイトをご覧ください。

結果を圧縮する

Google では、HTTP gzip 圧縮を使用して検索結果を圧縮できます。gzip アルゴリズムを使用して圧縮されたコンテンツを解凍すると、50 ~ 70% の帯域幅を節約でき、応答時間を改善できます。

Google に圧縮形式で結果を返すようにリクエストするには、次のように HTTP Accept-Encoding ヘッダーを HTTP 検索リクエストに追加します。

Accept-Encoding: gzip

Google が gzip 圧縮を使用して検索結果を返す場合、返される HTTP ヘッダーに次の行を含めます。

Content-Encoding: gzip

注: 上記のように Content-Encoding HTTP ヘッダーがレスポンスに存在しない場合、結果は圧縮されていません。

この動作は HTTP 標準で規定されています。HTTP gzip 圧縮の使用に関する追加情報については、このドキュメントをご覧ください。

国際値

文字エンコードスキーム

次の表に、Google がサポートする文字エンコード スキームを示します。ie パラメータと oe パラメータには、この表の最初の 2 つの列のどちらかの値を割り当てることができます。最初の列の値はエンコード スキームのニックネームです。2 番目の列の値は、エンコード スキームの標準名です。Google は、XML 形式の結果で標準名を返します。標準名は、ドキュメントの HTTP Content-type ヘッダーで使用するのに適しています。

Google の名前 エンコード 関連付けられているサポート言語
latin1 ISO-8859-1 西ヨーロッパ(カタロニア語、デンマーク語、オランダ語、英語、フィンランド語、フランス語、ドイツ語、インドネシア語、イタリア語、ノルウェー語、ポルトガル語、スペイン語、スウェーデン語)
latin2 ISO-8859-2 東ヨーロッパ語(クロアチア語、チェコ語、ハンガリー語、ポーランド語、ルーマニア語、セルビア語、スロバキア語、スロベニア語)
latin3 ISO-8859-3  
latin4 ISO-8859-4 バルト語(エストニア語、ラトビア語、リトアニア語)
キリル文字 ISO-8859-5 ブルガリア語、ロシア語
アラビア語 ISO-8859-6  
ギリシャ人 ISO-8859-7 ギリシャ語
ヘブライ暦 ISO-8859-8 ヘブライ語
latin5 ISO-8859-9  
latin6 ISO-8859-10 アイスランド語
euc-jp EUC-JP 日本語
EUC-KR EUC-KR 韓国語
Sjis Shift_JIS 日本語
big5 Big5 中国語(繁体)
gb GB2312 簡体字中国語
utf8 UTF-8 すべて

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

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

表示言語 hl パラメータ値
アフリカーンス語 af
アルバニア語 sq
アムハラ語 am
アラビア語 ar
アルメニア語 hy
アゼルバイジャン語 az
ベンガル語 bn
ブルガリア語 bg
ビルマ語 my
カタロニア語 ca
中国語(簡体) zh-CN
中国語(繁体) zh-TW
クロアチア語 時間
チェコ語 cs
デンマーク語 da
オランダ語 nl
英語 (イギリス) en-GB
英語 en
エストニア語 et
フィリピン語 fil
フィンランド語 fi
フランス語(カナダ) fr-CA
フランス料理 fr
ジョージア語 ka
ドイツ語 de
ギリシャ語 el
グジャラート語 gu
ヘブライ語 iw
ヒンディー語 hi
ハンガリー語 hu
アイスランド語 is
インドネシア語 id
イタリア語 it
日本語 ja
カンナダ語 kn
カザフ語 kk
クメール語 km
韓国語 ko
キルギス語 ky
ラオス語 lo
ラトビア語 lv
リトアニア語 lt
マケドニア語 mk
マレー語 ミリ秒
マラヤーム ml
マラーティー語 mr
モンゴル語 mn
ネパール語 ne
ノルウェー語(ブークモール) ×
ペルシャ語 fa
ポーランド語 pl
ポルトガル語(ブラジル) pt-BR
ポルトガル語(ポルトガル) pt-PT
パンジャブ語 pa
ルーマニア語 ro
ロシア語 ru
セルビア語(ラテン文字) sr-Latn
セルビア語 sr
シンハラ語 si
スロバキア語 sk
スロベニア語 sl
スペイン語(ラテンアメリカ) es-419
スペイン料理 es
スワヒリ語 sw
スウェーデン語 sv
タミル文字 ta
テルグ語 te
タイ料理 th
トルコ語 tr
ウクライナ語 uk
ウルドゥー語 ur
ウズベク語 uz
ベトナム語 vi
ウェールズ語 cy

言語コレクションの値

lr クエリ パラメータを使用して言語フィルタを指定するには、次の値を使用します。

言語 lr パラメータ値
アラビア語 lang_ar
ブルガリア語 lang_bg
カタロニア語 lang_ca
中国語(簡体) lang_zh-CN
中国語(繁体字) lang_zh-TW
クロアチア語 lang_hr
チェコ語 lang_cs
デンマーク語 lang_da
オランダ語 lang_nl
英語 lang_en
エストニア語 lang_et
フィンランド語 lang_fi
フランス料理 lang_fr
ドイツ語 lang_de
ギリシャ語 lang_el
ヘブライ語 lang_iw
ハンガリー語 lang_hu
アイスランド語 lang_is
インドネシア語 lang_id
イタリア語 lang_it
日本語 lang_ja
韓国語 lang_ko
ラトビア語 lang_lv
リトアニア語 lang_lt
ノルウェー語 lang_no
ポーランド語 lang_pl
ポルトガル語 lang_pt
ルーマニア語 lang_ro
ロシア語 lang_ru
セルビア語 lang_sr
スロバキア語 lang_sk
スロベニア語 lang_sl
スペイン料理 lang_es
スウェーデン語 lang_sv
トルコ語 lang_tr

国別コレクションの値

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 文字の国コードを示します。

国コード
アフガニスタン af
アルバニア アル
アルジェリア dz
米領サモア as
アンドラ 広告
アンゴラ ao
アンギラ ai
南極 水質
アンティグア バーブーダ ag
アルゼンチン ar
アルメニア am
アルバ aw
オーストラリア au
オーストリア  
アゼルバイジャン az
バハマ bs
バーレーン bh
バングラデシュ bd
バルバドス bb
ベラルーシ これを
ベルギー 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
コンゴ 消費電力
コンゴ民主共和国 cd
クック諸島 ck
コスタリカ cr
コートジボワール ci
クロアチア 時間
Cuba cu
キプロス cy
チェコ共和国 cz
デンマーク dk
ジブチ dj
ドミニカ dm
ドミニカ共和国 含まれている
エクアドル ec
エジプト eg
エルサルバドル sv
赤道ギニア GQ
エリトリア er
エストニア ee
エチオピア et
フォークランド諸島(マルビナス) FK
フェロー諸島 fo
フィジー fj
フィンランド fi
フランス fr
仏領ギアナ 得点
仏領ポリネシア pf
仏領南方、南極地域 tf
ガボン ga
ガンビア gm
ジョージア ge
ドイツ de
ガーナ gh
ジブラルタル
ギリシャ gr
グリーンランド gl
グレナダ gd
グアドループ gp
グアム gu
グアテマラ gt
ギニア gn
ギニアビサウ gw
ガイアナ Gy
ハイチ ht
ハード島、マクドナルド諸島 時間、分
ローマ教皇庁(バチカン市国) va
ホンジュラス hn
香港 hk
ハンガリー hu
アイスランド =
インド in
インドネシア id
イラン イスラム共和国 IR
イラク iq
アイルランド ie
イスラエル il
イタリア 送信できます
ジャマイカ JM
日本 jp
ヨルダン jo
カザフスタン kz
ケニア ke
キリバス ki
朝鮮民主主義人民共和国 kp
韓国 kr
クウェート kw
キルギス kg
ラオス人民民主共和国 la
ラトビア lv
レバノン lb
レソト ls
リベリア lr
リビア アラブ ジャマーヒリーヤ国 ly
リヒテンシュタイン li
リトアニア lt
ルクセンブルク lu
マカオ 5 割
マケドニア旧ユーゴサルブ共和国 mk
マダガスカル mg
マラウイ mw
マレーシア my
モルディブ mv
マリ ml
マルタ mt
マーシャル諸島 mh
マルチニーク mq
モーリタニア mr
モーリシャス mu
マイヨット島 yt
メキシコ mx
ミクロネシア連邦 fm
モルドバ共和国 md
モナコ mc
モンゴル mn
モントセラト ミリ秒
モロッコ ma
モザンビーク mz
ミャンマー mm
ナミビア なし
ナウル なし
ネパール np
オランダ nl
オランダ領アンティル  
ニューカレドニア nc
ニュージーランド nz
ニカラグア ni
ニジェール ne
ナイジェリア ng
ニウエ Nu
ノーフォーク島 nf
北マリアナ諸島 mp
ノルウェー ×
オマーン om
パキスタン pk
パラオ pw
パレスチナ自治区 ps
パナマ pa
パプア ニューギニア ページ
パラグアイ py
ペルー pe
フィリピン ph
ピトケアン島 PN
ポーランド pl
ポルトガル pt
プエルトリコ pr
カタール qa
レユニオン
ルーマニア ro
ロシア連邦 ru
ルワンダ rw
セントヘレナ sh
セントクリストファー ネービス kn
セントルシア lc
サンピエール ミクロン pm
セントビンセントおよびグレナディーン諸島 vc
サモア ws
サンマリノ sm
サントメ プリンシペ民主共和国 st
サウジアラビア sa
セネガル sn
セルビアモンテネグロ cs
セイシェル sc
シエラレオネ sl
シンガポール sg
スロバキア sk
スロベニア si
ソロモン諸島 sb
ソマリア まず、
南アフリカ za
サウスジョージア・サウスサンドウィッチ諸島 gs
スペイン es
スリランカ lk
スーダン sd
スリナム sr
スバールバル諸島およびヤンマイエン島 SJ
スワジランド sz
スウェーデン se
スイス ch
シリアアラブ共和国 sy
台湾 tw
タジキスタン TJ
タンザニア連合共和国 tz
タイ th
東ティモール tl
トーゴ tg
トケラウ tk
トンガ たとえば
トリニダード トバゴ tt
チュニジア tn
トルコ tr
トルクメニスタン tm
タークス カイコス諸島 tc
ツバル tv
ウガンダ ug
ウクライナ ua
アラブ首長国連邦 ae
英国 uk
米国 us
合衆国周辺離島 うーん
ウルグアイ uy
ウズベキスタン uz
バヌアツ vu
ベネズエラ ve
ベトナム社会主義共和国 vn
英領バージン諸島 vg
米領バージン諸島 vi
ウォリス フツナ wf
西サハラ えっ
イエメン イェイ
ザンビア ゾーンタイム(分)
ジンバブエ ZW