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 と、2 つのカスタムロール(nextPage および previousPage)があります。

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 ウェブ検索では、次の情報を分析してドキュメントの国を特定します。

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

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

このパラメータの有効な値の一覧については、国(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 つ含まれている必要があります。このタイプのクエリには、ブール値 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

  • Lotus 1-2-3(wk1wk2wk3wk4wk5wkiwkswku

  • Lotus 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 ウェブ検索では、次の情報を分析してドキュメントの国を特定します。

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

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

このパラメータの有効な値の一覧については、国(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 つ含まれている必要があります。このタイプのクエリには、ブール値 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

  • Lotus 1-2-3(wk1wk2wk3wk4wk5wkiwkswku

  • Lotus 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 ウェブ検索では、次の情報を分析してドキュメントの国を特定します。

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

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

このパラメータの有効な値の一覧については、国(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 つ含まれている必要があります。このタイプのクエリには、ブール値 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

  • Lotus 1-2-3(wk1wk2wk3wk4wk5wkiwkswku

  • Lotus 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

絞り込みラベルと、関連する絞り込み操作。