Search

カスタム検索リクエストへのレスポンス。

JSON 表現
{
  "kind": string,
  "url": {
    "type": string,
    "template": string
  },
  "queries": {
    "previousPage": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ],
    "request": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ],
    "nextPage": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ]
  },
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "context": {
    object
  },
  "searchInformation": {
    "searchTime": number,
    "formattedSearchTime": string,
    "totalResults": string,
    "formattedTotalResults": string
  },
  "spelling": {
    "correctedQuery": string,
    "htmlCorrectedQuery": string
  },
  "items": [
    {
      object (Result)
    }
  ]
}
フィールド
kind

string

現在のオブジェクトのタイプの一意の識別子。この API では、customsearch#search です。

url

object

この API のテンプレートを定義する OpenSearch URL 要素。

url.type

string

Custom Search JSON API の OpenSearch URL テンプレートの MIME タイプ。

url.template

string

この API の実際の OpenSearch テンプレート

queries

object

ロール名をキーとした 1 つ以上のクエリ メタデータのセットが含まれます。利用可能なロール名には、OpenSearch クエリロールで定義された request と、nextPagepreviousPage の 2 つのカスタムロールが含まれます。

queries.previousPage[]

object

結果の前のページを表すメタデータ(該当する場合)。

queries.previousPage[].title

string

クエリの説明。

queries.previousPage[].totalResults

string (int64 format)

検索結果の推定総数。正確でない可能性があります。

queries.previousPage[].searchTerms

string

ユーザーが入力した検索キーワード。

queries.previousPage[].count

integer

このセットで返される検索結果の数。

queries.previousPage[].startIndex

integer

結果セット全体に対する現在の検索結果セットのインデックス。最初の結果のインデックスは 1 です。

queries.previousPage[].startPage

integer

この結果セットのページ番号。ページの長さは count プロパティによって設定されます。

queries.previousPage[].language

string

検索結果の言語。

queries.previousPage[].inputEncoding

string

検索リクエストでサポートされる文字エンコード。

queries.previousPage[].outputEncoding

string

検索結果でサポートされている文字エンコード。

queries.previousPage[].safe

string

アダルト関連の検索結果を除外するために使用するセーフサーチ レベルを指定します。これは、OpenSearch の仕様で定義されていないカスタム プロパティです。有効なパラメータ値は次のとおりです。

  • "off": セーフサーチを無効にする

  • "active": セーフサーチを有効にする

queries.previousPage[].cx

string

プログラム可能検索エンジンのコントロール パネルを使用して作成されたエンジンの識別子。これは、OpenSearch の仕様で定義されていないカスタム プロパティです。このパラメータは必須です。

queries.previousPage[].sort

string

指定した式に従って結果を並べ替えるよう指定します。たとえば、日付で並べ替えます。

queries.previousPage[].filter

string

Google 検索の検索結果の自動フィルタリングを有効または無効にします。Google の検索結果フィルタについて詳しくは、自動フィルタリングをご覧ください。このパラメータの有効な値は次のとおりです。

  • 0: 無効

  • 1: 有効(デフォルト)

: 検索結果の品質を高めるため、デフォルトではすべての検索結果にフィルタが適用されます。

queries.previousPage[].gl

string

元の国がパラメータ値と一致する検索結果をブーストします。有効な値のリストについては、国コードをご覧ください。

WebSearch リクエストで gl パラメータ値を指定すると、結果の関連性が向上するはずです。これは特に海外のお客様、さらに具体的には米国以外の英語圏のお客様に当てはまります。

queries.previousPage[].cr

string

検索結果を、特定の国で作成されたドキュメントに限定します。cr パラメータの値にはブール演算子を使用できます。

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

  • ドキュメントの URL のトップレベル ドメイン(TLD)。

  • ウェブサーバーの IP アドレスの地理的位置

このパラメータの有効な値の一覧については、Country(cr)パラメータ値をご覧ください。

queries.previousPage[].googleHost

string

検索を絞り込む Google ドメイン(google.com、google.de、google.fr など)を指定します。

queries.previousPage[].disableCnTwTranslation

string

中国語(簡体字、繁体字)の検索機能を有効または無効にします。

サポートされている値は次のとおりです。

  • 0: 有効(デフォルト)

  • 1: 無効

queries.previousPage[].hq

string

指定したクエリ語句を、AND 論理演算子で結合されているかのようにクエリに追加します。

queries.previousPage[].hl

string

ユーザー インターフェースのインターフェース言語(ホスト言語)を指定します。このパラメータを明示的に設定すると、検索結果のパフォーマンスと品質が向上します。

詳しくは、クエリと結果の表示の国際化インターフェース言語のセクションをご覧ください。サポートされている言語の一覧については、サポートされているインターフェース言語をご覧ください。

queries.previousPage[].siteSearch

string

検索結果を指定のサイトの URL に限定します。

queries.previousPage[].siteSearchFilter

string

sitesearch パラメータで指定したサイトの結果を含めるか除外するかを指定します。サポートされている値は次のとおりです。

  • i: サイトのコンテンツを含める

  • e: サイトからコンテンツを除外

queries.previousPage[].exactTerms

string

検索結果内のすべてのドキュメントに含まれるフレーズを識別します。

queries.previousPage[].excludeTerms

string

検索結果のどのドキュメントにも表示すべきではない単語またはフレーズを識別します。

queries.previousPage[].linkSite

string

すべての結果に特定の URL へのリンクを含めるよう指定します。

queries.previousPage[].orTerms

string

ドキュメント内をチェックする追加の検索キーワードを指定します。検索結果の各ドキュメントには、追加の検索キーワードが 1 つ以上含まれている必要があります。このタイプのクエリには、Boolean OR クエリ用語を使用することもできます。

queries.previousPage[].relatedSite

string

指定した URL に関連するページの検索結果がすべて表示されるように指定します。パラメータ値には URL を指定する必要があります。

queries.previousPage[].dateRestrict

string

日付に基づいて、検索結果を URL に制限します。次の値がサポートされています。

  • d[number]: 指定した過去の日数の結果をリクエストします。

  • w[number]: 指定した過去の週数の結果をリクエストします。

  • m[number]: 指定した過去の月数の結果をリクエストします。

  • y[number]: 指定した過去数年の結果をリクエストします。

queries.previousPage[].lowRange

string

検索範囲の開始値を指定します。cse:lowRangecse:highrange を使用して、lowRange...highRange の包括的な検索範囲をクエリに追加します。

queries.previousPage[].highRange

string

検索範囲の終了値を指定します。cse:lowRangecse:highrange を使用して、lowRange...highRange の包括的な検索範囲をクエリに追加します。

queries.previousPage[].fileType

string

結果を指定した拡張子のファイルに制限します。Google でサポートされているファイル形式は次のとおりです。

  • Adobe Portable Document Format(pdf

  • Adobe PostScript(ps

  • ロータス 1-2-3(wk1wk2wk3wk4wk5wkiwkswku

  • ロータス WordPro(lwp

  • Macwrite(mw

  • Microsoft Excel(xls

  • Microsoft PowerPoint(ppt

  • Microsoft Word(doc

  • Microsoft Works(wkswpswdb

  • Microsoft Write(wri

  • リッチテキスト形式(rtf

  • ShockWave Flash(swf

  • テキスト(anstxt)。

今後、ファイル形式が追加される可能性があります。最新のリストについては、Google のファイル形式に関するよくある質問をご覧ください。

queries.previousPage[].rights

string

ライセンスに基づくフィルタ。次の値がサポートされています。

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.previousPage[].searchType

string

指定できる値は web または image です。指定しない場合、検索結果はウェブページに制限されます。

queries.previousPage[].imgSize

string

結果を指定したサイズの画像に制限します。サポートされている値は次のとおりです。

  • icon(小)

  • small | medium | large | xlarge(中)

  • xxlarge(大)

  • huge(特大)

queries.previousPage[].imgType

string

結果を指定したタイプの画像に制限します。サポートされている値は次のとおりです。

  • clipart(クリップアート)

  • face(顔)

  • lineart(線画)

  • photo(写真)

  • animated(アニメーション)

  • stock(在庫)

queries.previousPage[].imgColorType

string

結果を指定した色タイプの画像に制限します。指定できる値は次のとおりです。

  • mono(モノクロ)

  • gray(グレースケール)

  • color(色)

queries.previousPage[].imgDominantColor

string

結果を特定のドミナント カラーの画像に限定します。サポートされている値は次のとおりです。

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

queries.request[]

object

現在のリクエストを表すメタデータ。

queries.request[].title

string

クエリの説明。

queries.request[].totalResults

string (int64 format)

検索結果の推定総数。正確でない可能性があります。

queries.request[].searchTerms

string

ユーザーが入力した検索キーワード。

queries.request[].count

integer

このセットで返される検索結果の数。

queries.request[].startIndex

integer

結果セット全体に対する現在の検索結果セットのインデックス。最初の結果のインデックスは 1 です。

queries.request[].startPage

integer

この結果セットのページ番号。ページの長さは count プロパティによって設定されます。

queries.request[].language

string

検索結果の言語。

queries.request[].inputEncoding

string

検索リクエストでサポートされる文字エンコード。

queries.request[].outputEncoding

string

検索結果でサポートされている文字エンコード。

queries.request[].safe

string

アダルト関連の検索結果を除外するために使用するセーフサーチ レベルを指定します。これは、OpenSearch の仕様で定義されていないカスタム プロパティです。有効なパラメータ値は次のとおりです。

  • "off": セーフサーチを無効にする

  • "active": セーフサーチを有効にする

queries.request[].cx

string

プログラム可能検索エンジンのコントロール パネルを使用して作成されたエンジンの識別子。これは、OpenSearch の仕様で定義されていないカスタム プロパティです。このパラメータは必須です。

queries.request[].sort

string

指定した式に従って結果を並べ替えるよう指定します。たとえば、日付で並べ替えます。

queries.request[].filter

string

Google 検索の検索結果の自動フィルタリングを有効または無効にします。Google の検索結果フィルタについて詳しくは、自動フィルタリングをご覧ください。このパラメータの有効な値は次のとおりです。

  • 0: 無効

  • 1: 有効(デフォルト)

: 検索結果の品質を高めるため、デフォルトではすべての検索結果にフィルタが適用されます。

queries.request[].gl

string

元の国がパラメータ値と一致する検索結果をブーストします。有効な値のリストについては、国コードをご覧ください。

WebSearch リクエストで gl パラメータ値を指定すると、結果の関連性が向上するはずです。これは特に海外のお客様、さらに具体的には米国以外の英語圏のお客様に当てはまります。

queries.request[].cr

string

検索結果を、特定の国で作成されたドキュメントに限定します。cr パラメータの値にはブール演算子を使用できます。

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

  • ドキュメントの URL のトップレベル ドメイン(TLD)。

  • ウェブサーバーの IP アドレスの地理的位置

このパラメータの有効な値の一覧については、Country(cr)パラメータ値をご覧ください。

queries.request[].googleHost

string

検索を絞り込む Google ドメイン(google.com、google.de、google.fr など)を指定します。

queries.request[].disableCnTwTranslation

string

中国語(簡体字、繁体字)の検索機能を有効または無効にします。

サポートされている値は次のとおりです。

  • 0: 有効(デフォルト)

  • 1: 無効

queries.request[].hq

string

指定したクエリ語句を、AND 論理演算子で結合されているかのようにクエリに追加します。

queries.request[].hl

string

ユーザー インターフェースのインターフェース言語(ホスト言語)を指定します。このパラメータを明示的に設定すると、検索結果のパフォーマンスと品質が向上します。

詳しくは、クエリと結果の表示の国際化インターフェース言語のセクションをご覧ください。サポートされている言語の一覧については、サポートされているインターフェース言語をご覧ください。

queries.request[].siteSearch

string

検索結果を指定のサイトの URL に限定します。

queries.request[].siteSearchFilter

string

sitesearch パラメータで指定したサイトの結果を含めるか除外するかを指定します。サポートされている値は次のとおりです。

  • i: サイトのコンテンツを含める

  • e: サイトからコンテンツを除外

queries.request[].exactTerms

string

検索結果内のすべてのドキュメントに含まれるフレーズを識別します。

queries.request[].excludeTerms

string

検索結果のどのドキュメントにも表示すべきではない単語またはフレーズを識別します。

queries.request[].linkSite

string

すべての結果に特定の URL へのリンクを含めるよう指定します。

queries.request[].orTerms

string

ドキュメント内をチェックする追加の検索キーワードを指定します。検索結果の各ドキュメントには、追加の検索キーワードが 1 つ以上含まれている必要があります。このタイプのクエリには、Boolean OR クエリ用語を使用することもできます。

queries.request[].relatedSite

string

指定した URL に関連するページの検索結果がすべて表示されるように指定します。パラメータ値には URL を指定する必要があります。

queries.request[].dateRestrict

string

日付に基づいて、検索結果を URL に制限します。次の値がサポートされています。

  • d[number]: 指定した過去の日数の結果をリクエストします。

  • w[number]: 指定した過去の週数の結果をリクエストします。

  • m[number]: 指定した過去の月数の結果をリクエストします。

  • y[number]: 指定した過去数年の結果をリクエストします。

queries.request[].lowRange

string

検索範囲の開始値を指定します。cse:lowRangecse:highrange を使用して、lowRange...highRange の包括的な検索範囲をクエリに追加します。

queries.request[].highRange

string

検索範囲の終了値を指定します。cse:lowRangecse:highrange を使用して、lowRange...highRange の包括的な検索範囲をクエリに追加します。

queries.request[].fileType

string

結果を指定した拡張子のファイルに制限します。Google でサポートされているファイル形式は次のとおりです。

  • Adobe Portable Document Format(pdf

  • Adobe PostScript(ps

  • ロータス 1-2-3(wk1wk2wk3wk4wk5wkiwkswku

  • ロータス WordPro(lwp

  • Macwrite(mw

  • Microsoft Excel(xls

  • Microsoft PowerPoint(ppt

  • Microsoft Word(doc

  • Microsoft Works(wkswpswdb

  • Microsoft Write(wri

  • リッチテキスト形式(rtf

  • ShockWave Flash(swf

  • テキスト(anstxt)。

今後、ファイル形式が追加される可能性があります。最新のリストについては、Google のファイル形式に関するよくある質問をご覧ください。

queries.request[].rights

string

ライセンスに基づくフィルタ。次の値がサポートされています。

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.request[].searchType

string

指定できる値は web または image です。指定しない場合、検索結果はウェブページに制限されます。

queries.request[].imgSize

string

結果を指定したサイズの画像に制限します。サポートされている値は次のとおりです。

  • icon(小)

  • small | medium | large | xlarge(中)

  • xxlarge(大)

  • huge(特大)

queries.request[].imgType

string

結果を指定したタイプの画像に制限します。サポートされている値は次のとおりです。

  • clipart(クリップアート)

  • face(顔)

  • lineart(線画)

  • photo(写真)

  • animated(アニメーション)

  • stock(在庫)

queries.request[].imgColorType

string

結果を指定した色タイプの画像に制限します。指定できる値は次のとおりです。

  • mono(モノクロ)

  • gray(グレースケール)

  • color(色)

queries.request[].imgDominantColor

string

結果を特定のドミナント カラーの画像に限定します。サポートされている値は次のとおりです。

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

queries.nextPage[]

object

結果の次のページを表すメタデータ(該当する場合)。

queries.nextPage[].title

string

クエリの説明。

queries.nextPage[].totalResults

string (int64 format)

検索結果の推定総数。正確でない可能性があります。

queries.nextPage[].searchTerms

string

ユーザーが入力した検索キーワード。

queries.nextPage[].count

integer

このセットで返される検索結果の数。

queries.nextPage[].startIndex

integer

結果セット全体に対する現在の検索結果セットのインデックス。最初の結果のインデックスは 1 です。

queries.nextPage[].startPage

integer

この結果セットのページ番号。ページの長さは count プロパティによって設定されます。

queries.nextPage[].language

string

検索結果の言語。

queries.nextPage[].inputEncoding

string

検索リクエストでサポートされる文字エンコード。

queries.nextPage[].outputEncoding

string

検索結果でサポートされている文字エンコード。

queries.nextPage[].safe

string

アダルト関連の検索結果を除外するために使用するセーフサーチ レベルを指定します。これは、OpenSearch の仕様で定義されていないカスタム プロパティです。有効なパラメータ値は次のとおりです。

  • "off": セーフサーチを無効にする

  • "active": セーフサーチを有効にする

queries.nextPage[].cx

string

プログラム可能検索エンジンのコントロール パネルを使用して作成されたエンジンの識別子。これは、OpenSearch の仕様で定義されていないカスタム プロパティです。このパラメータは必須です。

queries.nextPage[].sort

string

指定した式に従って結果を並べ替えるよう指定します。たとえば、日付で並べ替えます。

queries.nextPage[].filter

string

Google 検索の検索結果の自動フィルタリングを有効または無効にします。Google の検索結果フィルタについて詳しくは、自動フィルタリングをご覧ください。このパラメータの有効な値は次のとおりです。

  • 0: 無効

  • 1: 有効(デフォルト)

: 検索結果の品質を高めるため、デフォルトではすべての検索結果にフィルタが適用されます。

queries.nextPage[].gl

string

元の国がパラメータ値と一致する検索結果をブーストします。有効な値のリストについては、国コードをご覧ください。

WebSearch リクエストで gl パラメータ値を指定すると、結果の関連性が向上するはずです。これは特に海外のお客様、さらに具体的には米国以外の英語圏のお客様に当てはまります。

queries.nextPage[].cr

string

検索結果を、特定の国で作成されたドキュメントに限定します。cr パラメータの値にはブール演算子を使用できます。

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

  • ドキュメントの URL のトップレベル ドメイン(TLD)。

  • ウェブサーバーの IP アドレスの地理的位置

このパラメータの有効な値の一覧については、Country(cr)パラメータ値をご覧ください。

queries.nextPage[].googleHost

string

検索を絞り込む Google ドメイン(google.com、google.de、google.fr など)を指定します。

queries.nextPage[].disableCnTwTranslation

string

中国語(簡体字、繁体字)の検索機能を有効または無効にします。

サポートされている値は次のとおりです。

  • 0: 有効(デフォルト)

  • 1: 無効

queries.nextPage[].hq

string

指定したクエリ語句を、AND 論理演算子で結合されているかのようにクエリに追加します。

queries.nextPage[].hl

string

ユーザー インターフェースのインターフェース言語(ホスト言語)を指定します。このパラメータを明示的に設定すると、検索結果のパフォーマンスと品質が向上します。

詳しくは、クエリと結果の表示の国際化インターフェース言語のセクションをご覧ください。サポートされている言語の一覧については、サポートされているインターフェース言語をご覧ください。

queries.nextPage[].siteSearch

string

検索結果を指定のサイトの URL に限定します。

queries.nextPage[].siteSearchFilter

string

sitesearch パラメータで指定したサイトの結果を含めるか除外するかを指定します。サポートされている値は次のとおりです。

  • i: サイトのコンテンツを含める

  • e: サイトからコンテンツを除外

queries.nextPage[].exactTerms

string

検索結果内のすべてのドキュメントに含まれるフレーズを識別します。

queries.nextPage[].excludeTerms

string

検索結果のどのドキュメントにも表示すべきではない単語またはフレーズを識別します。

queries.nextPage[].linkSite

string

すべての結果に特定の URL へのリンクを含めるよう指定します。

queries.nextPage[].orTerms

string

ドキュメント内をチェックする追加の検索キーワードを指定します。検索結果の各ドキュメントには、追加の検索キーワードが 1 つ以上含まれている必要があります。このタイプのクエリには、Boolean OR クエリ用語を使用することもできます。

queries.nextPage[].relatedSite

string

指定した URL に関連するページの検索結果がすべて表示されるように指定します。パラメータ値には URL を指定する必要があります。

queries.nextPage[].dateRestrict

string

日付に基づいて、検索結果を URL に制限します。次の値がサポートされています。

  • d[number]: 指定した過去の日数の結果をリクエストします。

  • w[number]: 指定した過去の週数の結果をリクエストします。

  • m[number]: 指定した過去の月数の結果をリクエストします。

  • y[number]: 指定した過去数年の結果をリクエストします。

queries.nextPage[].lowRange

string

検索範囲の開始値を指定します。cse:lowRangecse:highrange を使用して、lowRange...highRange の包括的な検索範囲をクエリに追加します。

queries.nextPage[].highRange

string

検索範囲の終了値を指定します。cse:lowRangecse:highrange を使用して、lowRange...highRange の包括的な検索範囲をクエリに追加します。

queries.nextPage[].fileType

string

結果を指定した拡張子のファイルに制限します。Google でサポートされているファイル形式は次のとおりです。

  • Adobe Portable Document Format(pdf

  • Adobe PostScript(ps

  • ロータス 1-2-3(wk1wk2wk3wk4wk5wkiwkswku

  • ロータス WordPro(lwp

  • Macwrite(mw

  • Microsoft Excel(xls

  • Microsoft PowerPoint(ppt

  • Microsoft Word(doc

  • Microsoft Works(wkswpswdb

  • Microsoft Write(wri

  • リッチテキスト形式(rtf

  • ShockWave Flash(swf

  • テキスト(anstxt)。

今後、ファイル形式が追加される可能性があります。最新のリストについては、Google のファイル形式に関するよくある質問をご覧ください。

queries.nextPage[].rights

string

ライセンスに基づくフィルタ。次の値がサポートされています。

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.nextPage[].searchType

string

指定できる値は web または image です。指定しない場合、検索結果はウェブページに制限されます。

queries.nextPage[].imgSize

string

結果を指定したサイズの画像に制限します。サポートされている値は次のとおりです。

  • icon(小)

  • small | medium | large | xlarge(中)

  • xxlarge(大)

  • huge(特大)

queries.nextPage[].imgType

string

結果を指定したタイプの画像に制限します。サポートされている値は次のとおりです。

  • clipart(クリップアート)

  • face(顔)

  • lineart(線画)

  • photo(写真)

  • animated(アニメーション)

  • stock(在庫)

queries.nextPage[].imgColorType

string

結果を指定した色タイプの画像に制限します。指定できる値は次のとおりです。

  • mono(モノクロ)

  • gray(グレースケール)

  • color(色)

queries.nextPage[].imgDominantColor

string

結果を特定のドミナント カラーの画像に限定します。サポートされている値は次のとおりです。

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

promotions[]

object (Promotion)

プロモーションのセット。カスタム検索エンジンの設定ファイルで、指定されたクエリのプロモーションが定義されている場合にのみ存在します。

context

object (Struct format)

特定の検索エンジンに関連付けられたメタデータと絞り込み。

searchInformation

object

この検索に関するメタデータ(検索時間、検索結果の合計など)。

searchInformation.searchTime

number

サーバーが検索結果を返すのにかかる時間。

searchInformation.formattedSearchTime

string

サーバーが検索結果を返すのにかかる時間(言語 / 地域のスタイルに沿った形式)。

searchInformation.totalResults

string

クエリによって返された検索結果の合計数。

searchInformation.formattedTotalResults

string

検索結果の合計数(言語 / 地域のスタイルに沿った形式)。

spelling

object

修正したクエリをカプセル化します。

spelling.correctedQuery

string

修正されたクエリ。

spelling.htmlCorrectedQuery

string

修正されたクエリ(HTML 形式)。

items[]

object (Result)

現在のカスタム検索結果セットです。

プロモーション

プロモーションの結果。

JSON 表現
{
  "title": string,
  "htmlTitle": string,
  "link": string,
  "displayLink": string,
  "bodyLines": [
    {
      "title": string,
      "htmlTitle": string,
      "url": string,
      "link": string
    }
  ],
  "image": {
    "source": string,
    "width": integer,
    "height": integer
  }
}
フィールド
title

string

プロモーションのタイトル。

htmlTitle

string

プロモーションのタイトル(HTML 形式)。

bodyLines[]

object

このプロモーションのブロック オブジェクトの配列。

bodyLines[].title

string

ブロック オブジェクトのテキスト(テキストが含まれる場合)。

bodyLines[].htmlTitle

string

HTML 形式のブロック オブジェクトのテキスト(テキストが含まれる場合)。

bodyLines[].url

string

ブロック オブジェクトのリンクの URL(リンクがある場合)。

bodyLines[].link

string

ブロック オブジェクトのリンクのアンカー テキスト(リンクがある場合)。

image

object

このプロモーションに関連付けられている画像(ある場合)。

image.source

string

このプロモーション リンクの画像の URL。

image.width

integer

ピクセル単位の画像の幅です。

image.height

integer

画像の高さ(ピクセル単位)。

結果

カスタム検索結果。

JSON 表現
{
  "kind": string,
  "title": string,
  "htmlTitle": string,
  "link": string,
  "displayLink": string,
  "snippet": string,
  "htmlSnippet": string,
  "cacheId": string,
  "formattedUrl": string,
  "htmlFormattedUrl": string,
  "pagemap": {
    object
  },
  "mime": string,
  "fileFormat": string,
  "image": {
    "contextLink": string,
    "height": integer,
    "width": integer,
    "byteSize": integer,
    "thumbnailLink": string,
    "thumbnailHeight": integer,
    "thumbnailWidth": integer
  },
  "labels": [
    {
      "name": string,
      "displayName": string,
      "label_with_op": string
    }
  ]
}
フィールド
kind

string

現在のオブジェクトのタイプの一意の識別子。この API では、customsearch#result. です。

title

string

検索結果のタイトル(書式なしテキスト)。

htmlTitle

string

検索結果のタイトル(HTML 形式)。

snippet

string

検索結果のスニペット(書式なしテキスト)。

htmlSnippet

string

検索結果のスニペット(HTML 形式)。

cacheId

string

Google がキャッシュに保存した検索結果のバージョンの ID を示します。

formattedUrl

string

各検索結果のスニペットの後に表示される URL。

htmlFormattedUrl

string

各検索結果のスニペットの後に表示される HTML 形式の URL。

pagemap

object (Struct format)

この検索結果の PageMap 情報が格納されます。

mime

string

検索結果の MIME タイプ。

fileFormat

string

検索結果のファイル形式。

image

object

検索結果で返される画像に関するすべての情報をカプセル化します。

image.contextLink

string

画像をホストするウェブページを示す URL。

image.height

integer

ピクセル単位の画像の高さです。

image.width

integer

ピクセル単位の画像の幅です。

image.byteSize

integer

画像のサイズ(バイト単位)。

image.thumbnailLink

string

サムネイル画像の URL。

image.thumbnailHeight

integer

サムネイル画像の高さ(ピクセル単位)。

image.thumbnailWidth

integer

サムネイル画像の幅(ピクセル単位)。

labels[]

object

絞り込みラベルに関するすべての情報をカプセル化します。

labels[].name

string

絞り込みラベルの名前。検索の絞り込みに使用できます。これはユーザー インターフェースには表示せず、代わりに displayName を使用してください。

labels[].displayName

string

絞り込みラベルの表示名。この名前がユーザー インターフェースに表示されます。

labels[].label_with_op

string

絞り込みラベルと関連する絞り込みオペレーション。