Image Search API v7 リファレンスImage Search API v7 reference

Image Search API を使用すると、Bing に検索クエリを送信し、関連する画像の一覧を取得できます。The Image Search API lets you send a search query to Bing and get back a list of relevant images. ここでは、イメージを要求するために使用するクエリパラメーターとヘッダー、およびそれらを含む JSON 応答オブジェクトに関する技術的な詳細について説明します。This section provides technical details about the query parameters and headers that you use to request images and the JSON response objects that contain them. 要求の作成方法を示す例については、「 Web でイメージを検索する」を参照してください。For examples that show how to make requests, see Searching the Web for Images.

要求に含めるヘッダーの詳細については、「要求ヘッダー」を参照してください。For information about the headers that requests should include, see Request Headers.

要求に含める必要があるクエリパラメーターの詳細については、「クエリパラメーター」を参照してください。For information about the query parameters that requests should include, see Query Parameters.

応答に含めることができる JSON 応答オブジェクトの詳細については、「応答オブジェクト」を参照してください。For information about the JSON response objects that responses may include, see Response Objects.

結果の使用と表示の許可の詳細については、「 BING SEARCH API の使用と表示の要件」を参照してください。For information about permitted use and display of results, see Bing Search API Use and Display requirements.

注意

URL の書式とパラメーターは、予告なしで変更されることがあるため、すべての URL をそのまま使用してください。Because URL formats and parameters are subject to change without notice, use all URLs as-is. 明記されている場合を除いて、URL の書式またはパラメーターに依存しないでください。You should not take dependencies on the URL format or parameters except where noted.

エンドポイントEndpoints

イメージを要求するには、GET 要求を次の Url のいずれかに送信します。To request images, send a GET request to one of the following URLs:

エンドポイントEndpoint 説明Description
https://api.cognitive.microsoft.com/bing/v7.0/images/search ユーザー検索クエリに関連する画像を返します。Returns images that are relevant to the users search query.
https://api.cognitive.microsoft.com/bing/v7.0/images/details 画像を含む Web ページなど、画像に関する分析情報を返します。Returns insights about an image, such as webpages that include the image.
https://api.cognitive.microsoft.com/bing/v7.0/images/trending 他のユーザーが行った検索要求に基づく注目の画像を返します。Returns images that are trending based on search requests made by others. 画像は、さまざまなカテゴリに分類されます。The images are broken out into different categories. たとえば、人気のある方が検索します。For example, Popular People Searches.

注目の画像をサポートする市場の一覧については、注目の画像に関する記事をご覧ください。For a list of markets that support trending images, see Trending Images.

マルチサービスサブスクリプションの場合は、URL にリージョンを含める必要があります。For multi-service subscriptions, you must include the region in the URL. 例: westus.api.cognitive.microsoft.com。For example: westus.api.cognitive.microsoft.com. サポートされているリージョンを参照してください。See Supported Regions.

要求では、HTTPS プロトコルを使う必要があります。The request must use the HTTPS protocol.

注意

URL の最大長は 2,048 文字です。The maximum URL length is 2,048 characters. URL の長さが上限を超えないよう、クエリ パラメーターの最大長は 1,500 文字未満にする必要があります。To ensure that your URL length does not exceed the limit, the maximum length of your query parameters should be less than 1,500 characters. URL が 2,048 文字を超えた場合、サーバーが 404 Not found を返します。If the URL exceeds 2,048 characters, the server returns 404 Not found.

ヘッダーHeaders

要求と応答に含まれる可能性があるヘッダーを次に示します。The following are the headers that a request and response may include.

ヘッダーHeader 説明Description
AcceptAccept 省略可能な要求ヘッダー。Optional request header.

既定のメディアの種類は application/json です。The default media type is application/json. 応答で JSON-LD が使用されるよう指定するには、Accept ヘッダーを application/ld+json に設定します。To specify that the response use JSON-LD, set the Accept header to application/ld+json.
Accept-LanguageAccept-Language 省略可能な要求ヘッダー。Optional request header.

ユーザー インターフェイス文字列に使用する言語のコンマ区切りリストです。A comma-delimited list of languages to use for user interface strings. リストでは優先度の高いものから順に指定します。The list is in decreasing order of preference. 有効な形式など、詳細については RFC2616 を参照してください。For more information, including expected format, see RFC2616.

このヘッダーと setLang— クエリ パラメーターは相互に排他的なので、両方は指定しないでください。This header and the setLang query parameter are mutually exclusive—do not specify both.

このヘッダーを設定する場合は、cc クエリ パラメーターも指定する必要があります。If you set this header, you must also specify the cc query parameter. 結果が返される市場を特定するために、Bing によってリストから検出された最初のサポート対象言語が使用され、それが cc パラメーター値と組み合わされます。To determine the market to return results for, Bing uses the first supported language it finds from the list and combines it with the cc parameter value. サポート対象言語がリストに含まれていない場合、要求がサポートされる最も近い言語と市場が Bing によって検出されるか、集計された市場または既定の市場が結果に使用されます。If the list does not include a supported language, Bing finds the closest language and market that supports the request or it uses an aggregated or default market for the results. Bing によって使用された市場を確認するには、BingAPIs-Market ヘッダーを調べます。To determine the market that Bing used, see the BingAPIs-Market header.

このヘッダーと cc クエリ パラメーターは、複数の言語を指定する場合にのみ使用します。Use this header and the cc query parameter only if you specify multiple languages. それ以外の場合は、mkt クエリ パラメーターおよび setLang クエリ パラメーターを使用します。Otherwise, use the mkt and setLang query parameters.

ユーザー インターフェイス文字列は、ユーザー インターフェイスでラベルとして使われる文字列です。A user interface string is a string that's used as a label in a user interface. JSON 応答オブジェクトには、いくつかのユーザー インターフェイス文字列があります。There are few user interface strings in the JSON response objects. 応答オブジェクト内の Bing.com プロパティへのリンクには、指定された言語が適用されます。Any links to Bing.com properties in the response objects apply the specified language.
BingAPIs-MarketBingAPIs-Market 応答ヘッダー。Response header.

要求で使用された市場。The market used by the request. 形式は <言語コード>-<国番号> です。The form is <languageCode>-<countryCode>. たとえば、en-US などです。For example, en-US.

市場コードに記載されていない市場を指定する場合、この値は、 mktクエリパラメーターで指定した市場とは異なる場合があります。If you specify a market that is not listed in Market Codes, this value may differ from the market you specified in the mkt query parameter. 照合できないccおよびAccept 言語の値を指定した場合も同様です。The same is true if you specify values for cc and Accept-Language that can't be reconciled.
BingAPIs-TraceIdBingAPIs-TraceId 応答ヘッダー。Response header.

要求の詳細が含まれたログ エントリの ID。The ID of the log entry that contains the details of the request. エラーが発生した場合、この ID をキャプチャします。When an error occurs, capture this ID. 問題を特定して解決できない場合は、その他の情報と共にこの ID をサポート チームに提供します。If you are not able to determine and resolve the issue, include this ID along with the other information that you provide the Support team.
Content-TypeContent-Type 省略可能な要求ヘッダー。Optional request header.

Modulesクエリパラメーターを認識されたエンティティに設定した場合は、POST 要求の本体でイメージのバイナリを指定することができます。If you set the modules query parameter to RecognizedEntities, you may specify the binary of an image in the body of a POST request. POST 要求の本文でイメージを指定する場合は、このヘッダーを指定し、その値をマルチパート/フォームデータに設定する必要があります。If you specify the image in the body of a POST request, you must specify this header and set its value to multipart/form-data.

イメージの最大サイズは 1 MB です。The maximum image size is 1 MB.
Ocp-Apim-Subscription-KeyOcp-Apim-Subscription-Key 必須の要求ヘッダー。Required request header.

Cognitive Services でこのサービスにサインアップしたときに受け取ったサブスクリプション キーです。The subscription key that you received when you signed up for this service in Cognitive Services.
PragmaPragma 省略可能な要求ヘッダーOptional request header

既定では、Bing はキャッシュされたコンテンツがある場合にそれを返します。By default, Bing returns cached content, if available. キャッシュされたコンテンツを防止するには、プラグマヘッダーを no cache (たとえば、Pragma: no cache) に設定します。To prevent cached content, set the Pragma header to no-cache (for example, Pragma: no-cache).
再試行-後Retry-After 応答ヘッダー。Response header.

応答には、1秒あたりに許可されるクエリの数 (QPS) または1か月 (QPM) を超える場合に、このヘッダーが含まれます。The response includes this header if you exceed the number of queries allowed per second (QPS) or per month (QPM). ヘッダーには、別の要求を送信する前に待機する必要がある秒数が含まれています。The header contains the number of seconds that you must wait before sending another request.
User-AgentUser-Agent 省略可能な要求ヘッダー。Optional request header.

要求送信元のユーザー エージェント。The user agent originating the request. Bing では、モバイル ユーザーに最適なエクスペリエンスを提供するためにユーザー エージェントが使用されます。Bing uses the user agent to provide mobile users with an optimized experience. 省略可能ですが、このヘッダーは常に指定することをお勧めします。Although optional, you are encouraged to always specify this header.

ユーザーエージェントは、よく使用されるブラウザーによって送信されるのと同じ文字列にする必要があります。The user-agent should be the same string that any commonly used browser sends. ユーザー エージェントについては、RFC 2616 を参照してください。For information about user agents, see RFC 2616.

ユーザーエージェント文字列の例を次に示します。The following are examples of user-agent strings.
  • Windows Phone — Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 822)Windows Phone—Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 822)

  • Android — Mozilla/5.0 (Linux; U; Android 2.3.5; en-us; SCH-I500 Build/GINGERBREAD) AppleWebKit/533.1 (KHTML; like Gecko) Version/4.0 Mobile Safari/533.1Android—Mozilla/5.0 (Linux; U; Android 2.3.5; en-us; SCH-I500 Build/GINGERBREAD) AppleWebKit/533.1 (KHTML; like Gecko) Version/4.0 Mobile Safari/533.1

  • iPhone — Mozilla/5.0 (iPhone; CPU iPhone OS 6_1 like Mac OS X) AppleWebKit/536.26 (KHTML; like Gecko) Mobile/10B142 iPhone4;1 BingWeb/3.03.1428.20120423iPhone—Mozilla/5.0 (iPhone; CPU iPhone OS 6_1 like Mac OS X) AppleWebKit/536.26 (KHTML; like Gecko) Mobile/10B142 iPhone4;1 BingWeb/3.03.1428.20120423

  • PC — Mozilla/5.0 (Windows NT 6.3; WOW64; Trident/7.0; Touch; rv:11.0) like GeckoPC—Mozilla/5.0 (Windows NT 6.3; WOW64; Trident/7.0; Touch; rv:11.0) like Gecko

  • iPad — Mozilla/5.0 (iPad; CPU OS 7_0 like Mac OS X) AppleWebKit/537.51.1 (KHTML, like Gecko) Version/7.0 Mobile/11A465 Safari/9537.53iPad—Mozilla/5.0 (iPad; CPU OS 7_0 like Mac OS X) AppleWebKit/537.51.1 (KHTML, like Gecko) Version/7.0 Mobile/11A465 Safari/9537.53
X-MSEdge-ClientIDX-MSEdge-ClientID 省略可能な要求および応答ヘッダー。Optional request and response header.

このヘッダーは、Bing API の呼び出し間で一貫性のある動作をユーザーに提供するために Bing によって使用されます。Bing uses this header to provide users with consistent behavior across Bing API calls. Bing によって、新しい機能と改善点が頻繁にフライト化されます。そして、トラフィックを異なるフライトに割り当てるためのキーとして、クライアント ID が使用されます。Bing often flights new features and improvements, and it uses the client ID as a key for assigning traffic on different flights. 複数の要求に対してユーザーの同じクライアント ID を使用しないと、ユーザーが複数の競合するフライトに割り当てられる可能性があります。If you do not use the same client ID for a user across multiple requests, then Bing may assign the user to multiple conflicting flights. 複数の競合するフライトに割り当てられると、ユーザー エクスペリエンスの一貫性がなくなる場合があります。Being assigned to multiple conflicting flights can lead to an inconsistent user experience. たとえば、2 番目の要求に 1 番目とは異なるフライトが割り当てられていると、エクスペリエンスが予期しないものになる可能性があります。For example, if the second request has a different flight assignment than the first, the experience may be unexpected. また、クライアント ID は、そのクライアント ID の検索履歴に合わせて Web の結果を調整し、ユーザーにリッチなエクスペリエンスを提供するために Bing によって使用される場合があります。Also, Bing can use the client ID to tailor web results to that client ID’s search history, providing a richer experience for the user.

このヘッダーは、クライアント ID で生成されたアクティビティを分析して結果の順位付けを向上させるために Bing によって使用されることもあります。Bing also uses this header to help improve result rankings by analyzing the activity generated by a client ID. 関連性の向上は、Bing API によって提供される結果の品質向上に役立ち、API コンシューマーのクリックスルー率の向上を実現します。The relevance improvements help with better quality of results delivered by Bing APIs and in turn enables higher click-through rates for the API consumer.

重要: このヘッダーは省略可能ですが、必須であると考える必要があります。IMPORTANT: Although optional, you should consider this header required. 同じエンド ユーザーとデバイスの組み合わせによる複数の要求に対してクライアント ID を保持することで、1) API コンシューマーが一貫性のあるユーザー エクスペリエンスを受け取ることができ、2) Bing API からの結果の品質向上を通じてクリックスルー率の向上が実現します。Persisting the client ID across multiple requests for the same end user and device combination enables 1) the API consumer to receive a consistent user experience, and 2) higher click-through rates via better quality of results from the Bing APIs.

このヘッダーに適用される基本的な使用規則を次に示します。The following are the basic usage rules that apply to this header.
  • デバイスでアプリケーションを使用する各ユーザーは、Bing によって生成された一意のクライアント ID を持っている必要があります。Each user that uses your application on the device must have a unique, Bing generated client ID.

    このヘッダーを要求に含めない場合、Bing によって ID が生成され、それが X-MSEdge-ClientID 応答ヘッダーで返されます。If you do not include this header in the request, Bing generates an ID and returns it in the X-MSEdge-ClientID response header. このヘッダーを要求に含めるべきでない唯一の場合は、ユーザーがそのデバイスでアプリを初めて使用するときです。The only time that you should NOT include this header in a request is the first time the user uses your app on that device.

  • 注意: このクライアント ID は認証可能なユーザー アカウント情報にリンクできないようにする必要があります。ATTENTION: You must ensure that this Client ID is not linkable to any authenticatable user account information.

  • そのユーザーのためにアプリによってデバイスで実行される各 Bing API 要求で、クライアント ID を使用します。Use the client ID for each Bing API request that your app makes for this user on the device.

  • クライアント ID を保持します。Persist the client ID. ブラウザー アプリで ID を永続化するには、永続的な HTTP Cookie を使用して ID がすべてのセッションで確実に使用されるようにします。To persist the ID in a browser app, use a persistent HTTP cookie to ensure the ID is used across all sessions. セッション Cookie は使用しないようにしてください。Do not use a session cookie. モバイル アプリなど、他のアプリの場合は、デバイスの永続的ストレージを使用して ID を保持します。For other apps such as mobile apps, use the device's persistent storage to persist the ID.

    次にそのデバイスでユーザーがアプリを使用するときに、保持したクライアント ID を取得します。The next time the user uses your app on that device, get the client ID that you persisted.

注: Bing の応答には、このヘッダーが含まれる場合と含まれない場合があります。NOTE: Bing responses may or may not include this header. このヘッダーが応答に含まれる場合、クライアント ID をキャプチャして、ユーザーのためにそのデバイスで実行される後続のすべての Bing 要求でそれを使用します。If the response includes this header, capture the client ID and use it for all subsequent Bing requests for the user on that device.

注: X-MSEdge-ClientID を含める場合、要求には Cookie を含めないようにしてください。NOTE: If you include the X-MSEdge-ClientID, you must not include cookies in the request.
X-MSEdge-ClientIPX-MSEdge-ClientIP 省略可能な要求ヘッダー。Optional request header.

クライアント デバイスの IPv4 アドレスまたは IPv6 アドレス。The IPv4 or IPv6 address of the client device. IP アドレスは、ユーザーの位置情報の検出に使用されます。The IP address is used to discover the user's location. 位置情報は、安全な検索動作を決定するために Bing によって使用されます。Bing uses the location information to determine safe search behavior.

注: 省略可能ですが、このヘッダーと X-Search-Location ヘッダーは常に指定することをお勧めします。NOTE: Although optional, you are encouraged to always specify this header and the X-Search-Location header.

(最後のオクテットを 0 に変更するなど) アドレスを難読化しないようにしてください。Do not obfuscate the address (for example, by changing the last octet to 0). アドレスを難読化すると、デバイスの実際の場所から離れた場所が検出され、Bing から誤った結果が提供される可能性があります。Obfuscating the address results in the location not being anywhere near the device's actual location, which may result in Bing serving erroneous results.
X-Search-LocationX-Search-Location 省略可能な要求ヘッダー。Optional request header.

クライアントの地理的な場所を示す、キーと値のペアのセミコロン区切りリストです。A semicolon-delimited list of key/value pairs that describe the client's geographical location. 位置情報は、安全な検索動作を決定して関連するローカル コンテンツを返すために、Bing によって使用されます。Bing uses the location information to determine safe search behavior and to return relevant local content. キーと値のペアは、<キー>:<値> の形式で指定します。Specify the key/value pair as <key>:<value>. ユーザーの場所の指定に使用するキーは次のとおりです。The following are the keys that you use to specify the user's location.

  • lat — 必須。lat—Required. クライアントの場所の緯度です (度単位)。The latitude of the client's location, in degrees. 緯度は、-90.0 以上、+90.0 以下である必要があります。The latitude must be greater than or equal to -90.0 and less than or equal to +90.0. 負の値は南半球の緯度を示し、正の値は北半球の緯度を示します。Negative values indicate southern latitudes and positive values indicate northern latitudes.

  • long — 必須。long—Required. クライアントの場所の経度です (度単位)。The longitude of the client's location, in degrees. 経度は、-180.0 以上、+180.0 以下である必要があります。The longitude must be greater than or equal to -180.0 and less than or equal to +180.0. 負の値は西半球の経度を示し、正の値は東半球の経度を示します。Negative values indicate western longitudes and positive values indicate eastern longitudes.

  • re — 必須。re—Required. 座標の水平方向の精度を指定する半径 (m) です。The radius, in meters, which specifies the horizontal accuracy of the coordinates. デバイスの位置情報サービスによって返される値を渡します。Pass the value returned by the device's location service. 一般的な値は、GPS/Wi-Fi の 22 m、携帯電話基地局の三角測量の 380 m、IP 逆引き参照の 18,000 m などです。Typical values might be 22m for GPS/Wi-Fi, 380m for cell tower triangulation, and 18,000m for reverse IP lookup.

  • ts — 省略可能。ts—Optional. クライアントがその場所にいたときの UTC UNIX タイムスタンプです。The UTC UNIX timestamp of when the client was at the location. (UNIX タイムスタンプは、1970 年 1 月 1 日からの経過秒数です)。(The UNIX timestamp is the number of seconds since January 1, 1970.)

  • head — 省略可能。head—Optional. クライアントの相対的な先頭方向または移動方向。The client's relative heading or direction of travel. 移動方向は、真北を基準として時計回りに 0 から 360 度で指定します。Specify the direction of travel as degrees from 0 through 360, counting clockwise relative to true north. このキーは、sp キーが 0 以外の場合にのみ指定します。Specify this key only if the sp key is nonzero.

  • sp — 省略可能。sp—Optional. クライアント デバイスが移動している水平方向の速度 (m/秒) です。The horizontal velocity (speed), in meters per second, that the client device is traveling.

  • alt — 省略可能。alt—Optional. クライアント デバイスの高度 (m) です。The altitude of the client device, in meters.

  • are — 省略可能。are—Optional. 座標の垂直方向の精度を指定する半径 (m)。The radius, in meters, that specifies the vertical accuracy of the coordinates. このキーは、alt キーを指定する場合にのみ指定します。Specify this key only if you specify the alt key.

  • 変位—(省略可能)。disp—Optional. フォーム内のユーザーの地理的な場所 (変位: <City、州>)。The user’s geographic location in the form, disp:<City, State>. たとえば、"変位: Seattle, ワシントン" のようになります。For example, disp:Seattle, Washington. これは、lat/長いキーを使用して指定したユーザーの場所の表示テキストバージョンです。This is the display text version of the user’s location that you specified using the lat/long keys. この値が lat/long 座標と競合する場合、Bing では、ユーザーの場所として変位値が使用されます。If this value conflicts with the lat/long coordinates, Bing uses the disp value as the user's location.

注: Bing は、クエリに場所が含まれている場合、このヘッダーを無視します。NOTE: Bing ignores this header if the query includes a location. たとえば、このヘッダーにユーザーの場所がサンフランシスコとして反映されていて、クエリがレストラン seattleである場合、Bing はワシントン州シアトルにあるレストランを返します。For example, if this header reflects the user’s location as San Francisco, but the query is restaurants seattle, Bing returns restaurants located in Seattle, Washington.

注: 多くのキーは省略可能ですが、提供する情報が多いほど、場所の結果の正確さが増します。NOTE: Although many of the keys are optional, the more information that you provide, the more accurate the location results are.

注: 省略可能ですが、ユーザーの地理的な場所は常に指定することをお勧めします。NOTE: Although optional, you are encouraged to always specify the user's geographical location. 位置情報を提供することは、クライアントの IP アドレスがユーザーの物理的な場所を正確に反映していない場合 (たとえば、クライアントによって VPN が使用されている場合) に特に重要です。Providing the location is especially important if the client's IP address does not accurately reflect the user's physical location (for example, if the client uses VPN). 最適な結果を得るには、このヘッダーと X-Search-ClientIP ヘッダーを含める必要がありますが、少なくともこのヘッダーを含める必要があります。For optimal results, you should include this header and the X-Search-ClientIP header, but at a minimum, you should include this header.

注意

利用規約ですべての該当法規 (これらのヘッダーの使用に関するものなど) への準拠が要求されていることに注意してください。Remember that the Terms of Use require compliance with all applicable laws, including regarding use of these headers. たとえば、ヨーロッパなどの特定の地域では、特定の追跡デバイスをユーザー デバイスに組み込む前に、ユーザーの同意を得る必要があります。For example, in certain jurisdictions, such as Europe, there are requirements to obtain user consent before placing certain tracking devices on user devices.

クエリ パラメーターQuery parameters

要求に含めることができるクエリパラメーターを次に示します。The following are the query parameters that a request may include. 必須のパラメーターについては、必須の列を参照してください。See the Required column for required parameters. クエリ パラメーターの値を URL エンコードする必要があります。You must URL encode the query parameter values. Bing が返す画像をフィルター処理するために使用するクエリパラメーターの詳細については、「クエリパラメーターのフィルター選択」を参照してください。For information about query parameters that you use to filter the images that Bing returns, see Filter Query Parameters.

名前Name Value TypeType 必須Required
.cabcab トリミングする領域の下端の座標。The bottom coordinate of the region to crop.

座標は元のイメージの高さの小数点以下の値で、イメージの左上隅から測定されます。The coordinate is a fractional value of the original image's height and is measured from the top, left corner of the image. 0.0 ~ 1.0 の値として座標を指定します。Specify the coordinate as a value from 0.0 through 1.0.

このパラメーターは、Insights API でのみ使用してください。Use this parameter only with the Insights API. 画像、トレンドの画像、Web Search Api を呼び出すときは、このパラメーターを指定しないでください。Do not specify this parameter when calling the Images, Trending Images, or Web Search APIs.
FloatFloat いいえNo
calcal トリミングする領域の左座標。The left coordinate of the region to crop.

座標は元のイメージの幅の割合であり、イメージの左上隅から測定されます。The coordinate is a fraction of the original image's width and is measured from the top, left corner of the image. 0.0 ~ 1.0 の値として座標を指定します。Specify the coordinate as a value from 0.0 through 1.0.

このパラメーターは、Insights API でのみ使用してください。Use this parameter only with the Insights API. 画像、トレンドの画像、Web Search Api を呼び出すときは、このパラメーターを指定しないでください。Do not specify this parameter when calling the Images, Trending Images, or Web Search APIs.
FloatFloat いいえNo
carcar トリミングする領域の右座標。The right coordinate of the region to crop.

座標は元のイメージの幅の割合であり、イメージの左上隅から測定されます。The coordinate is a fraction of the original image's width and is measured from the top, left corner of the image. 0.0 ~ 1.0 の値として座標を指定します。Specify the coordinate as a value from 0.0 through 1.0.

このパラメーターは、Insights API でのみ使用してください。Use this parameter only with the Insights API. 画像、トレンドの画像、Web Search Api を呼び出すときは、このパラメーターを指定しないでください。Do not specify this parameter when calling the Images, Trending Images, or Web Search APIs.
FloatFloat いいえNo
catcat トリミングする領域の上端の座標。The top coordinate of the region to crop.

座標は元のイメージの高さの割合であり、イメージの左上隅から測定されます。The coordinate is a fraction of the original image's height and is measured from the top, left corner of the image. 0.0 ~ 1.0 の値として座標を指定します。Specify the coordinate as a value from 0.0 through 1.0.

このパラメーターは、Insights API でのみ使用してください。Use this parameter only with the Insights API. 画像、トレンドの画像、Web Search Api を呼び出すときは、このパラメーターを指定しないでください。Do not specify this parameter when calling the Images, Trending Images, or Web Search APIs.
FloatFloat いいえNo
ctct calcatcar、およびcabの各パラメーターで指定された座標に基づいてイメージをトリミングするときに使用するトリミングの種類。The crop type to use when cropping the image based on the coordinates specified in the cal, cat, car, and cab parameters.

有効な値を次に示します。The following are the possible values.
  • 0—四角形 (既定値)0—Rectangular (default)

このパラメーターは、Insights API でのみ使用してください。Use this parameter only with the Insights API. 画像、トレンドの画像、Web Search Api を呼び出すときは、このパラメーターを指定しないでください。Do not specify this parameter when calling the Images, Trending Images, or Web Search APIs.
符号なし整数Unsigned Integer いいえNo
cccc 結果を取得する国の 2 文字の国番号です。A 2-character country code of the country where the results come from. 使用可能な値の一覧については、「マーケットコード」を参照してください。For a list of possible values, see Market Codes.

このパラメーターを設定する場合は、Accept-Language ヘッダーも指定する必要があります。If you set this parameter, you must also specify the Accept-Language header. Bing は、指定された言語で見つかった最初のサポートされている言語を使用し、国コードと組み合わせて、結果を返す市場を決定します。Bing uses the first supported language it finds in the specified languages and combines it with the country code to determine the market to return results for. 言語一覧にサポートされている言語が含まれない場合、Bing は要求をサポートする最も近い言語と市場を検索します。If the languages list does not include a supported language, Bing finds the closest language and market that supports the request. また、Bing は、結果に対して集計または既定の市場を使用する場合があります。Or, Bing may use an aggregated or default market for the results.

複数の言語を指定するAccept-Language場合にのみ、このクエリパラメーターとヘッダーを使用します。Use this query parameter and the Accept-Language header only if you specify multiple languages. それ以外の場合は、 mktおよびsetLangクエリパラメーターを使用する必要があります。Otherwise, you should use the mkt and setLang query parameters.

このパラメーターと mkt— クエリ パラメーターは相互に排他的なので、両方指定することはできません。This parameter and the mkt query parameter are mutually exclusive—do not specify both.
StringString いいえNo
countcount 応答で返されるイメージの数。The number of images to return in the response. 配信される実際の数は、要求した数よりも少ない可能性があります。The actual number delivered may be less than requested. 既定値は 35 です。The default is 35. 最大値は150です。The maximum value is 150.

このパラメーターをパラメーターと共にoffset使用して、ページの結果を表示します。You use this parameter along with the offset parameter to page results. たとえば、ユーザーインターフェイスにページごとに20個のイメージが表示countされてoffsetいる場合、結果の最初のページを取得するには、を20に、を0に設定します。For example, if your user interface displays 20 images per page, set count to 20 and offset to 0 to get the first page of results. それ以降の各ページでoffsetは、20でインクリメントします (たとえば、0、20、40)。For each subsequent page, increment offset by 20 (for example, 0, 20, 40).

このパラメーターは、Image Search API でのみ使用してください。Use this parameter only with the Image Search API. Insights、トレンド画像、Web Search Api を呼び出すときは、このパラメーターを指定しないでください。Do not specify this parameter when calling the Insights, Trending Images, or Web Search APIs.
UnsignedShortUnsignedShort いいえNo
idid イメージを一意に識別する ID。An ID that uniquely identifies an image. このパラメーターを使用して、指定されたイメージが Bing が返すイメージの一覧の最初のイメージであることを確認します。Use this parameter to ensure that the specified image is the first image in the list of images that Bing returns. イメージオブジェクトのimageIdフィールドには、このパラメーターを設定した ID が含まれています。The Image object's imageId field contains the ID that you set this parameter to. StringString いいえNo
imgUrlimgUrl 洞察を取得するイメージの URL。The URL of an image that you want to get insights of. insightsTokenパラメーターを使用してイメージを指定する代わりに、このパラメーターを使用します。Use this parameter as an alternative to using the insightsToken parameter to specify the image. また、イメージのバイナリを POST 要求の本体に配置することによって、イメージを指定することもできます。You may also specify the image by placing the binary of the image in the body of a POST request. バイナリオプションを使用する場合は、 content-typeヘッダーを参照してください。If you use the binary option, see the Content-Type header.

サポートされる画像の最大サイズは 1 MB です。The maximum supported image size is 1 MB.

このパラメーターは、Insights API でのみ使用してください。Use this parameter only with the Insights API. 画像、トレンドの画像、Web Search Api を呼び出すときは、このパラメーターを指定しないでください。Do not specify this parameter when calling the Images, Trending Images, or Web Search APIs.
StringString いいえNo
insightsTokeninsightsToken イメージトークン。An image token. イメージオブジェクトのimageInsightsTokenには、トークンが含まれています。The Image object's imageInsightsToken contains the token. キャプションやショッピングソースなどのイメージに関する追加情報を取得するには、このパラメーターを指定します。Specify this parameter to get additional information about an image, such as a caption or shopping source. 取得できるイメージに関する追加情報の一覧については、「 modules query parameter」を参照してください。For a list of the additional information about an image that you can get, see the modules query parameter.

このパラメーターは、Insights API でのみ使用してください。Use this parameter only with the Insights API. 画像、トレンドの画像、Web Search Api を呼び出すときは、このパラメーターを指定しないでください。Do not specify this parameter when calling the Images, Trending Images, or Web Search APIs.
StringString いいえNo
mktmkt 結果の取得元の市場。The market where the results come from. 通常、 mktは、ユーザーが要求を行っている国です。Typically, mkt is the country where the user is making the request from. ただし、Bing が結果を提供する国にユーザーがいない場合は、別の国である可能性があります。However, it could be a different country if the user is not located in a country where Bing delivers results. 市場は、 <>-<言語コードの国コード>である必要があります。The market must be in the form <language code>-<country code>. たとえば、en-US などです。For example, en-US. 文字列の大文字と小文字は区別されません。The string is case insensitive. 可能な市場の値の一覧については、市場コードに関するページを参照してください。For a list of possible market values, see Market Codes.

注: 既知の場合は、常に市場を指定することをお勧めします。NOTE: If known, you are encouraged to always specify the market. 市場を指定すると、Bing が要求をルーティングして最適な応答を返すのに役立ちます。Specifying the market helps Bing route the request and return an appropriate and optimal response. 市場コードに記載されていない市場を指定した場合、Bing は、変更される可能性のある内部マッピングに基づいて、最適な市場コードを使用します。If you specify a market that is not listed in Market Codes, Bing uses a best fit market code based on an internal mapping that is subject to change.

このパラメーターと cc— クエリ パラメーターは相互に排他的なので、両方指定することはできません。This parameter and the cc query parameter are mutually exclusive—do not specify both.
StringString いいえNo
モジュールmodules 要求する洞察のコンマ区切りの一覧。A comma-delimited list of insights to request. 次の値を指定できます。大文字と小文字は区別されません。The following are the possible case-insensitive values.
  • すべて—の洞察が返されます (使用可能な場合)。ただし、認識しているエンティティは除きます。All—Return all insights, if available, except RecognizedEntities.

  • BRQ—最適なクエリ。BRQ—Best representative query. 画像を最もよく説明するクエリ用語。The query term that best describes the image.

  • キャプション—画像に関する情報を提供するキャプション。Caption—A caption that provides information about the image. キャプションにエンティティが含まれている場合、応答にはそれらのエンティティのイメージへのリンクが含まれる場合があります。If the caption contains entities, the response may include links to images of those entities.

  • コレクション—に関連する画像の一覧を表示します。Collections—A list of related images.

  • レシピ—画像に表示されている料理のレシピの一覧です。Recipes—A list of recipes for cooking the food shown in the images.
  • イメージを—含む web ページのリストを含むページ。PagesIncluding—A list of webpages that include the image.

  • 認識され—たエンティティは、イメージで認識されたエンティティ (people) の一覧です。RecognizedEntities—A list of entities (people) that were recognized in the image.

    注: このモジュールを他のモジュールで指定することはできません。NOTE: You may not specify this module with any other module. 他のモジュールと共に指定した場合、応答には認識されたエンティティが含まれません。If you specify it with other modules, the response doesn't include recognized entities.

  • 関係者—は、他のユーザーによって行われた関連検索の一覧を検索します。RelatedSearches—A list of related searches made by others.

  • 関連—するオファリングを購入できる商人の一覧を ShoppingSources します。ShoppingSources—A list of merchants where you can buy related offerings.

  • SimilarImages—は、元の画像に似た画像の一覧を表示します。SimilarImages—A list of images that are visually similar to the original image.

  • SimilarProducts—は、元のイメージで見つかった製品に似た製品を含むイメージの一覧を示します。SimilarProducts—A list of images that contain a product that is similar to a product found in the original image.

  • タグ—は、イメージ内で見つかったコンテンツの種類の特性を提供します。Tags—Provides characteristics of the type of content found in the image. たとえば、画像が人物の場合、タグには、ユーザーの性別と種類が表示されることがあります。For example, if the image is of a person, the tags might indicate the person's gender and type of clothes they're wearing.

モジュールを指定し、モジュールのデータがない場合、応答オブジェクトには関連フィールドは含まれません。If you specify a module and there is no data for the module, the response object doesn't include the related field. たとえば、キャプションを指定し、それが存在しない場合、応答にはフィールドimageCaptionは含まれません。For example, if you specify Caption and it does not exist, the response doesn't include the imageCaption field.

関連する検索を含めるには、要求に元のクエリ文字列を含める必要があります。To include related searches, the request must include the original query string.

類似したイメージや製品では元のクエリ文字列は必要ありませんが、関連性と結果の向上に役立つため、常に含める必要があります。Although the original query string is not required for similar images or products, you should always include it because it can help improve relevance and the results.

このパラメーターは、Insights API でのみ使用してください。Use this parameter only with the Insights API. 画像、トレンドの画像、Web Search Api を呼び出すときは、このパラメーターを指定しないでください。Do not specify this parameter when calling the Images, Trending Images, or Web Search APIs.
StringString いいえNo
offsetoffset イメージを返す前にスキップするイメージの数を示す0から始まるオフセット。The zero-based offset that indicates the number of images to skip before returning images. 既定値は 0 です。The default is 0. オフセットは、(totalEstimatedMatches - count) よりも小さくする必要があります。The offset should be less than (totalEstimatedMatches - count).

結果をページに表示するには、 countパラメーターと共にこのパラメーターを使用します。To page results, use this parameter along with the count parameter. たとえば、ユーザーインターフェイスにページごとに20個のイメージが表示countされてoffsetいる場合、結果の最初のページを取得するには、を20に、を0に設定します。For example, if your user interface displays 20 images per page, set count to 20 and offset to 0 to get the first page of results. それ以降の各ページでoffsetは、20でインクリメントします (たとえば、0、20、40)。For each subsequent page, increment offset by 20 (for example, 0, 20, 40).

複数のページに、結果に重複が含まれている可能性があります。It is possible for multiple pages to include some overlap in results. 重複を防ぐには、「 nextOffset」を参照してください。To prevent duplicates, see nextOffset.

このパラメーターは、Image API でのみ使用してください。Use this parameter only with the Image API. トレンド画像 API または Web Search API を呼び出すときは、このパラメーターを指定しないでください。Do not specify this parameter when calling the Trending Images API or the Web Search API.
Unsigned ShortUnsigned Short いいえNo
qq ユーザーの検索クエリ用語。The user's search query term. 用語を空にすることはできません。The term cannot be empty.

用語には、 Bing 高度なオペレーターが含まれている場合があります。The term may contain Bing Advanced Operators. たとえば、イメージを特定のドメインに制限するには、 site: 演算子を使用します。For example, to limit images to a specific domain, use the site: operator.

Insights クエリの関連性を向上させるために (「 insightsToken」を参照)、ユーザーのクエリ用語を常に含める必要があります。To help improve relevance of an insights query (see insightsToken), you should always include the user's query term.

このパラメーターは、Image Search API でのみ使用してください。Use this parameter only with the Image Search API. トレンド画像 API を呼び出すときは、このパラメーターを指定しないでください。Do not specify this parameter when calling the Trending Images API.
StringString はいYes
safeSearchsafeSearch アダルトコンテンツの画像をフィルター処理します。Filter images for adult content. 使用できるフィルター値は次のとおりです。The following are the possible filter values.
  • オフ—にすると、アダルトコンテンツを含む画像が返される場合があります。Off—May return images with adult content. 要求が Image Search API を介して行われる場合、応答には明確なサムネイル画像 (非あいまい) が含まれます。If the request is through the Image Search API, the response includes thumbnail images that are clear (non-fuzzy). ただし、要求が Web Search API を介して行われる場合、応答には、ピクセル化 (ファジー) であるサムネイルイメージが含まれます。However, if the request is through the Web Search API, the response includes thumbnail images that are pixelated (fuzzy).

  • [—モデレート] 要求が Image Search API を介している場合、その応答にはアダルトコンテンツを含む画像は含まれません。Moderate—If the request is through the Image Search API, the response doesn't include images with adult content. 要求が Web Search API を介して行われる場合、応答にはアダルトコンテンツを含む画像が含まれる可能性があります (サムネイル画像はピクセル化 (あいまい))。If the request is through the Web Search API, the response may include images with adult content (the thumbnail images are pixelated (fuzzy)).

  • 厳密—には、アダルトコンテンツを含む画像を返しません。Strict—Do not return images with adult content.

既定値は Moderate です。The default is Moderate.

注:safeSearch が Strict に設定されるよう Bing の成人向けコンテンツ ポリシーによって強制される市場が要求元の場合、Bing によって safeSearch の値が無視され、Strict が使用されます。NOTE: If the request comes from a market that Bing's adult policy requires that safeSearch is set to Strict, Bing ignores the safeSearch value and uses Strict.

注:site: クエリ演算子を使用している場合、safeSearch クエリ パラメーターの設定にかかわらず、成人向けのコンテンツが応答に含まれることがあります。NOTE: If you use the site: query operator, there is the chance that the response may contain adult content regardless of what the safeSearch query parameter is set to. site: は、そのサイト上のコンテンツがわかっていて、成人向けコンテンツが含まれていても問題のないシナリオの場合にのみ使用してください。Use site: only if you are aware of the content on the site and your scenario supports the possibility of adult content.
StringString いいえNo
setLangsetLang ユーザー インターフェイス文字列に使用する言語。The language to use for user interface strings. 2文字または4文字のコードを使用して、言語を指定できます。You may specify the language using either a 2-letter or 4-letter code. 4文字のコードを使用することをお勧めします。Using 4-letter codes is preferred.

サポートされている言語コードの一覧については、「 Bing でサポートされる言語」を参照してください。For a list of supported language codes, see Bing supported languages.

に有効な2文字のsetlangニュートラルカルチャコード (fr) または有効な4文字の特定のカルチャコード (fr-fr) が含まれている場合、Bing はローカライズされた文字列を読み込みます。Bing loads the localized strings if setlang contains a valid 2-letter neutral culture code (fr) or a valid 4-letter specific culture code (fr-ca). たとえば、 fr-frの場合、Bing は、 fr-frニュートラルカルチャコード文字列を読み込みます。For example, for fr-ca, Bing loads the fr neutral culture code strings.

setlang有効でない場合 (たとえば、 Zh-tw) や bing がこの言語をサポートしていない場合 (例: af, af-na)、bing の既定値はen (英語) です。If setlang is not valid (for example, zh) or Bing doesn’t support the language (for example, af, af-na), Bing defaults to en (English).

2文字のコードを指定するには、このパラメーターを ISO 639-1 言語コードに設定します。To specify the 2-letter code, set this parameter to an ISO 639-1 language code.

4文字のコードを指定するには、<国/地域> を使用します。ここで、は iso 639-1 言語コード (ニュートラルカルチャ) で、<国/地域> は iso 3166 国/地域 (特定のカルチャ) コードです。To specify the 4-letter code, use the form -<country/region> where is an ISO 639-1 language code (neutral culture) and <country/region> is an ISO 3166 country/region (specific culture) code. たとえば、米国英語の場合はen-usを使用します。For example, use en-US for United States English.

省略可能ですが、常に言語を指定することをお勧めします。Although optional, you should always specify the language. ユーザー インターフェイス文字列が別の言語で表示されることをユーザーが望まない限り、通常、setLangmkt で指定されるのと同じ言語に設定します。Typically, you set setLang to the same language specified by mkt unless the user wants the user interface strings displayed in a different language.

このパラメーターと Accept 言語ヘッダーは相互に排他的です。両方を指定することはできません。This parameter and the Accept-Language header are mutually exclusive—do not specify both.

ユーザー インターフェイス文字列は、ユーザー インターフェイスでラベルとして使われる文字列です。A user interface string is a string that's used as a label in a user interface. JSON 応答オブジェクトには、いくつかのユーザー インターフェイス文字列があります。There are few user interface strings in the JSON response objects. また、応答オブジェクト内の Bing.com プロパティへのリンクには、指定された言語が適用されます。Also, any links to Bing.com properties in the response objects apply the specified language.
StringString いいえNo

クエリパラメーターのフィルター処理Filter query parameters

次に、Bing が返す画像をフィルター処理するために使用できるフィルタークエリパラメーター (省略可能) を示します。The following are the optional filter query parameters that you can use to filter the images that Bing returns. クエリ パラメーターは URL エンコードする必要があります。You must URL encode the query parameters.

これらのパラメーターは Image Search API でのみ使用してください。Use these parameters only with the Image Search API. トレンド画像 API または Web Search API を呼び出すときは、これらのパラメーターを指定しないでください。Do not specify these parameters when calling the Trending Images API or Web Search API.

名前Name Value TypeType
部分aspect 次の縦横比でイメージをフィルター処理します。Filter images by the following aspect ratios:
  • 正方形—は標準の縦横比で画像を返しますSquare—Return images with standard aspect ratio
  • ワイド—画面の縦横比を持つワイドリターン画像Wide—Return images with wide screen aspect ratio
  • 縦横—比が高い高さの画像Tall—Return images with tall aspect ratio
  • すべて—の側面によるフィルター処理は行われません。All—Do not filter by aspect. この値の指定は、 aspectパラメーターを指定しない場合と同じです。Specifying this value is the same as not specifying the aspect parameter.
StringString
color 次の色のオプションでイメージをフィルター処理します。Filter images by the following color options:
  • ColorOnly—色の画像を返すColorOnly—Return color images
  • モノクロ—画像を白黒で返すMonochrome—Return black and white images

次の主要な色のいずれかを使用してイメージを返します。Return images with one of the following dominant colors:
  • BlackBlack
  • Blue
  • BrownBrown
  • グレーGray
  • [緑]Green
  • オレンジOrange
  • ピンクPink
  • Purple
  • [赤]Red
  • 青緑Teal
  • WhiteWhite
  • Yellow
StringString
鮮度freshness 次の検出オプションでイメージをフィルター処理します。Filter images by the following discovery options:
  • 過去—24 時間以内に Bing によって検出された日付を返しますDay—Return images discovered by Bing within the last 24 hours
  • 過去—7 日以内に Bing によって検出された画像を返す週Week—Return images discovered by Bing within the last 7 days
  • 過去—30 日以内に Bing によって検出された画像を返す月Month—Return images discovered by Bing within the last 30 days
StringString
上下height 指定された高さ (ピクセル単位) のイメージをフィルター処理します。Filter images that have the specified height, in pixels.

このフィルターをフィルターと共にsize使用して、高さが150ピクセルの小さい画像を返すことができます。You may use this filter with the size filter to return small images that have a height of 150 pixels.
UnsignedShortUnsignedShort
imageContent 画像imageContent 次のコンテンツの種類でイメージをフィルター処理します。Filter images by the following content types:
  • 人物—の顔のみを表示する顔の戻り画像Face—Return images that show only a person's face
  • [—縦] は、人の頭とショルダーのみを表示する画像を返しますPortrait—Return images that show only a person's head and shoulders
StringString
imageTypeimageType 次のイメージの種類でイメージをフィルター処理:Filter images by the following image types:
  • AnimatedGif—アニメーション gif イメージを返すAnimatedGif—return animated gif images

  • AnimatedGifHttps—https アドレスからのアニメーション gif イメージを返すAnimatedGifHttps—return animated gif images that are from an https address

  • クリップ—アートのイメージのみを返すClipart—Return only clip art images

  • 行—の改行のみの描画Line—Return only line drawings

  • 写真—を返す (線の描画、アニメーション gif、クリップアートを除く)Photo—Return only photographs (excluding line drawings, animated gifs, and clip art)

  • ショッピング—では、商品を販売しているマーチャントを Bing が認識しているアイテムを含む画像のみが返されます。Shopping—Return only images that contain items where Bing knows of a merchant that is selling the items. このオプションは、en-us 市場でのみ有効です。This option is valid in the en-US market only.

  • 透明—背景が透明な画像のみを返します。Transparent—Return only images with a transparent background.
StringString
使用license 次のライセンスの種類でイメージをフィルター処理:Filter images by the following license types:
  • 任意—のライセンスの種類に該当するイメージを返します。Any—Return images that are under any license type. 応答には、ライセンスが指定されていないイメージや、ライセンスが不明なイメージは含まれません。The response doesn't include images that do not specify a license or the license is unknown.

  • 作成—者が排他的な権利を放棄した公開イメージは、法律によって認められた最大範囲になります。Public—Return images where the creator has waived their exclusive rights, to the fullest extent allowed by law.

  • 他—のユーザーと共有される可能性のある返送画像を共有します。Share—Return images that may be shared with others. イメージを変更したり編集したりすることはできません。Changing or editing the image might not be allowed. また、商用目的でのイメージの変更、共有、および使用は許可されていない可能性があります。Also, modifying, sharing, and using the image for commercial purposes might not be allowed. 通常、このオプションは最も多くのイメージを返します。Typically, this option returns the most images.

  • 個人また—は商業目的で他のユーザーと共有されている可能性のある、商業用イメージを共有します。ShareCommercially—Return images that may be shared with others for personal or commercial purposes. イメージを変更したり編集したりすることはできません。Changing or editing the image might not be allowed.

  • 変更—、共有、および使用される可能性がある復帰イメージを変更します。Modify—Return images that may be modified, shared, and used. イメージを変更したり編集したりすることはできません。Changing or editing the image might not be allowed. 商用目的でのイメージの変更、共有、および使用は許可されていない可能性があります。Modifying, sharing, and using the image for commercial purposes might not be allowed.

  • 個人また—は商業目的で変更、共有、使用する可能性のあるイメージを変更して返却します。ModifyCommercially—Return images that may be modified, shared, and used for personal or commercial purposes. 通常、このオプションは最も少ないイメージを返します。Typically, this option returns the fewest images.

  • すべて—のライセンスの種類でフィルター処理することはできません。All—Do not filter by license type. この値の指定は、 licenseパラメーターを指定しない場合と同じです。Specifying this value is the same as not specifying the license parameter.

これらのライセンスの種類の詳細については、「ライセンスの種類別にイメージをフィルター処理する」を参照してください。For more information about these license types, see Filter Images By License Type.
StringString
maxFileSizemaxFileSize 指定されたファイルサイズ以下のイメージをフィルター処理します。Filter images that are less than or equal to the specified file size.

指定できる最大ファイルサイズは520192バイトです。The maximum file size that you may specify is 520,192 bytes. より大きな値を指定すると、API は520192を使用します。If you specify a larger value, the API uses 520,192. 応答には、指定された最大値よりも少し大きい画像が含まれている可能性があります。It is possible that the response may include images that are slightly larger than the specified maximum.

このフィルターを指定したりminFileSize 、ファイルサイズの範囲内のイメージをフィルター処理したりすることができます。You may specify this filter and minFileSize to filter images within a range of file sizes.
IntegerInteger
maxHeightmaxHeight 高さが指定した高さ以下のイメージをフィルター処理します。Filter images that have a height that is less than or equal to the specified height. 高さをピクセル単位で指定します。Specify the height in pixels.

このフィルターを指定してminHeight 、高さの範囲内のイメージをフィルター処理することができます。You may specify this filter and minHeight to filter images within a range of heights.

このフィルターとheightフィルターは相互に排他的です。This filter and the height filter are mutually exclusive.
IntegerInteger
maxWidthmaxWidth 指定した幅以下の幅を持つイメージをフィルター処理します。Filter images that have a width that is less than or equal to the specified width. 幅をピクセル単位で指定します。Specify the width in pixels.

このフィルターを指定してmaxWidth 、幅の範囲内のイメージをフィルター処理することができます。You may specify this filter and maxWidth to filter images within a range of widths.

このフィルターとwidthフィルターは相互に排他的です。This filter and the width filter are mutually exclusive.
IntegerInteger
minFileSize サイズminFileSize 指定されたファイルサイズ以上のイメージをフィルター処理します。Filter images that are greater than or equal to the specified file size.

指定できる最大ファイルサイズは520192バイトです。The maximum file size that you may specify is 520,192 bytes. より大きな値を指定すると、API は520192を使用します。If you specify a larger value, the API uses 520,192. 応答には、指定した最小値より若干小さい画像が含まれている可能性があります。It is possible that the response may include images that are slightly smaller than the specified minimum.

このフィルターを指定したりmaxFileSize 、ファイルサイズの範囲内のイメージをフィルター処理したりすることができます。You may specify this filter and maxFileSize to filter images within a range of file sizes.
IntegerInteger
minHeightminHeight 高さが指定した高さ以上のイメージをフィルター処理します。Filter images that have a height that is greater than or equal to the specified height. 高さをピクセル単位で指定します。Specify the height in pixels.

このフィルターを指定してmaxHeight 、高さの範囲内のイメージをフィルター処理することができます。You may specify this filter and maxHeight to filter images within a range of heights.

このフィルターとheightフィルターは相互に排他的です。This filter and the height filter are mutually exclusive.
IntegerInteger
minWidthminWidth 指定された幅以上の幅を持つイメージをフィルター処理します。Filter images that have a width that is greater than or equal to the specified width. 幅をピクセル単位で指定します。Specify the width in pixels.

このフィルターを指定してmaxWidth 、幅の範囲内のイメージをフィルター処理することができます。You may specify this filter and maxWidth to filter images within a range of widths.

このフィルターとwidthフィルターは相互に排他的です。This filter and the width filter are mutually exclusive.
IntegerInteger
size 次のサイズでイメージをフィルター処理します。Filter images by the following sizes:
  • 200—x 200 ピクセル未満の小さい返される画像Small—Return images that are less than 200x200 pixels

  • 200—x 200 ピクセル以上で500x500 ピクセル未満のメディアを返します。Medium—Return images that are greater than or equal to 200x200 pixels but less than 500x500 pixels

  • 500x500—ピクセル以上の大きい戻り画像Large—Return images that are 500x500 pixels or larger

  • 壁紙—は壁紙イメージを返します。Wallpaper—Return wallpaper images.

  • すべて—のサイズでフィルター処理されません。All—Do not filter by size. この値の指定は、 sizeパラメーターを指定しない場合と同じです。Specifying this value is the same as not specifying the size parameter.

このパラメーターは、 heightパラメーターまたはwidthパラメーターと共に使用できます。You may use this parameter along with the height or width parameters. たとえば、とheight sizeを使用して、高さ150ピクセルの小さい画像を要求することができます。For example, you may use height and size to request small images that are 150 pixels tall.
StringString
width 指定された幅を持つイメージをピクセル単位でフィルター処理します。Filter images that have the specified width, in pixels.

このフィルターをsizeフィルターと共に使用すると、幅が150ピクセルの小さい画像を返すことができます。You may use this filter with the size filter to return small images that have a width of 150 pixels.
UnsignedShortUnsignedShort

応答オブジェクトResponse objects

注意

フランスの新しい EU の著作権指令に準拠するには、Bing Web、News、Video、Image、およびすべてのカスタム検索 Api で、フランス語のユーザーの特定の EU ニュースソースからのコンテンツをすべて省略する必要があります。To comply with the new EU Copyright Directive in France, the Bing Web, News, Video, Image and all Custom Search APIs must omit some content from certain EU News sources for French users. 削除されたコンテンツには、サムネイル画像、ビデオ、ビデオプレビュー、およびこれらのソースからの検索結果に付随するスニペットが含まれる場合があります。The removed content may include thumbnail images and videos, video previews, and snippets which accompany search results from these sources. その結果、Bing Api は、サムネイル画像とビデオ、ビデオプレビュー、およびフランス語のユーザーへのスニペットを使用して、より多くの結果を提供することができます。As a consequence, the Bing APIs may serve fewer results with thumbnail images and videos, video previews, and snippets to French users.

応答に含めることができる JSON オブジェクトを次に示します。The following are the JSON objects that the response may include. 要求が成功した場合、応答の最上位レベルのオブジェクトは、エンドポイントが/images/search の場合はImagesオブジェクト、エンドポイントが/images/details の場合はImageInsightsResponse 、エンドポイントが/Images/trending. の場合はTrendingImagesになります。If the request succeeds, the top-level object in the response is the Images object if the endpoint is /images/search, ImageInsightsResponse if endpoint is /images/details, and TrendingImages if the endpoint is /images/trending. 要求が失敗した場合、最上位レベルのオブジェクトは ErrorResponse オブジェクトになります。If the request fails, the top-level object is the ErrorResponse object.

ObjectObject 説明Description
AggregateOfferAggregateOffer 画像に関連する商人からのオファーの一覧を定義します。Defines a list of offers from merchants that are related to the image.
集積AggregateRating 項目が他のユーザーによってどの程度評価されたかを示すメトリックを定義します。Defines the metrics that indicate how well an item was rated by others.
カテゴリCategory トレンド画像のカテゴリを定義します。Defines the category of trending images.
ErrorError 発生したエラーを定義します。Defines an error that occurred.
ErrorResponseErrorResponse 要求が失敗したときの応答に含まれている最上位レベルのオブジェクト。The top-level object that the response includes when the request fails.
ImageImage クエリに関連するイメージを定義します。Defines an image that is relevant to the query.
ImagecapImageCaption イメージのキャプションを定義します。Defines an image's caption.
ImageGalleryImageGallery 関連する画像のコレクションが含まれている web ページへのリンクを定義します。Defines a link to a webpage that contains a collection of related images.
ImageInsightsImageInsights Image insights 要求が成功したときに応答に含まれるトップレベルのオブジェクト。The top-level object that the response includes when an image insights request succeeds.
イメージImages イメージ要求が成功したときに応答に含まれるトップレベルのオブジェクト。The top-level object that the response includes when an image request succeeds.
ImagesModuleImagesModule 画像の一覧を定義します。Defines a list of images.
ImageTagsModuleImageTagsModule イメージ内で見つかったコンテンツの特性を定義します。Defines the characteristics of the content found in the image.
InsightsMetadataInsightsMetadata 画像に関連するその他の操作を実行できる web サイトの数を定義します。Defines a count of the number of websites where you can shop or perform other actions related to the image.
MediaSizeMediaSize メディアコンテンツのサイズを定義します。Defines the size of the media content.
NormalizedRectangleNormalizedRectangle イメージの領域を定義します。Defines a region of an image.
インストルメンテーションInstrumentation Bing インストルメンテーション Url を定義します。Defines the Bing instrumentation URLs.
プランOffer マーチャントのオファーを定義します。Defines a merchant's offer.
組織Organization マーチャントに関する情報を定義します。Defines information about a merchant.
PersonPerson 人物を定義します。Defines a person.
ピボットPivot ピボットセグメントを定義します。Defines the pivot segment.
クエリQuery 検索クエリ文字列を定義します。Defines a search query string.
レシピRecipe 料理レシピを定義します。Defines a cooking recipe.
RecipesModuleRecipesModule 料理レシピのリストを定義します。Defines a list of cooking recipes.
認識 IzedentityRecognizedEntity 認識されたエンティティを定義します。Defines a recognized entity.
認識 IzedentitygroupRecognizedEntityGroup 以前に認識されたエンティティのグループを定義します。Defines a group of previously recognized entities.
RecognizedEntitiesModuleRecognizedEntitiesModule 以前に認識されたエンティティの一覧を定義します。Defines a list of previously recognized entities.
認識 IzedentityregionRecognizedEntityRegion エンティティが検出された領域と、エンティティが一致する可能性のあるエンティティのリストを定義します。Defines a region where an entity was found and a list of entities that might match it.
"関連性のあるコレクション" モジュールRelatedCollectionsModule 関連する画像が含まれている web ページへのリンクの一覧を定義します。Defines a list of links to webpages that contain related images.
関連性検索モジュールRelatedSearchesModule 他のユーザーによって行われた関連検索の一覧を定義します。Defines a list of related searches made by others.
TagTag イメージ内で見つかった特性を定義します。Defines a characteristic found in the image.
サムネイルThumbnail サムネイル画像を定義します。Defines a thumbnail image.
タイルTile イメージタイルを定義します。Defines an image tile.
TrendingImagesTrendingImages トレンド画像要求が成功したときに応答に含まれるトップレベルのオブジェクト。The top-level object that the response includes when a trending images request succeeds.

AggregateOfferAggregateOffer

画像に関連する商人からのオファーの一覧を定義します。Defines a list of offers from merchants that are related to the image.

要素Element 説明Description TypeType
offersoffers イメージに関連するオファリングのオファーの一覧。A list of offers from merchants that have offerings related to the image. プラン[]Offer[]

集積AggregateRating

項目が他のユーザーによってどの程度評価されたかを示すメトリックを定義します。Defines the metrics that indicate how well an item was rated by others.

名前Name Value 種類Type
bestRatingbestRating 評価が最も高いレビュー。The highest rated review. 有効な値は、1.0 ~ 5.0 です。The possible values are 1.0 through 5.0. floatfloat
ratingValueratingValue 平均 (平均) 評価。The mean (average) rating. 有効な値は、1.0 ~ 5.0 です。The possible values are 1.0 through 5.0. floatfloat
reviewCountreviewCount レシピが評価またはレビューされた回数。The number of times the recipe has been rated or reviewed. 符号なし整数Unsigned Integer
テキストtext 平均 (平均) 評価 (文字列形式)。The mean (average) rating, in string form. StringString

カテゴリCategory

トレンド画像のカテゴリを定義します。Defines the category of trending images.

要素Element 説明Description TypeType
tiles カテゴリのトレンドであるイメージの一覧。A list of images that are trending in the category. 各タイルには、画像と、件名のより多くの画像を返す URL が含まれています。Each tile contains an image and a URL that returns more images of the subject. たとえば、カテゴリが人気のある人の検索である場合、その画像は人気のあるユーザーであり、URL はその人物のより多くの画像を返します。For example, if the category is Popular People Searches, the image is of a popular person and the URL would return more images of that person. タイル[]Tile[]
title イメージカテゴリの名前。The name of the image category. たとえば、人気のある方が検索します。For example, Popular People Searches. StringString

エラーError

発生したエラーを定義します。Defines the error that occurred.

要素Element 説明Description TypeType
codecode エラーのカテゴリを特定するエラー コード。The error code that identifies the category of error. 考えられるコードの一覧については、「エラー コード」を参照してください。For a list of possible codes, see Error Codes. StringString
messagemessage エラーの説明。A description of the error. StringString
moreDetailsmoreDetails エラーに関する追加情報を提供する説明。A description that provides additional information about the error. StringString
parameterparameter エラーを引き起こした要求内のクエリ パラメーター。The query parameter in the request that caused the error. StringString
subCodesubCode エラーを特定するエラー コード。The error code that identifies the error. たとえば、code が InvalidRequest の場合、subCode は ParameterInvalid か ParameterInvalidValue の場合があります。For example, if code is InvalidRequest, subCode may be ParameterInvalid or ParameterInvalidValue. StringString
valuevalue 有効でなかったクエリ パラメーター値。The query parameter's value that was not valid. StringString

ErrorResponseErrorResponse

要求が失敗したときの応答に含まれている最上位レベルのオブジェクト。The top-level object that the response includes when the request fails.

名前Name Value 種類Type
_type_type 種類のヒント。Type hint. StringString
errorserrors 要求が失敗した理由を示すエラーの一覧。A list of errors that describe the reasons why the request failed. エラー[]Error[]

ImageImage

クエリに関連するイメージを定義します。Defines an image that is relevant to the query.

注意

URL 形式とパラメーターは予告なしに変更される可能性があるため、すべての Url をそのまま使用します。Because the URL format and parameters are subject to change without notice, use all URLs as-is. URL 形式またはパラメーターに依存しないようにする必要があります。You should not take dependencies on the URL format or parameters. 例外は、サムネイルイメージのサイズ変更とトリミングによって説明されているパラメーターと値です。The exception is those parameters and values discussed by Resize and crop thumbnail images.

名前Name Value 種類Type
アクセント色accentColor イメージを優先する色を表す3バイトの16進数。A three-byte hexadecimal number that represents the color that dominates the image. イメージが読み込まれるまで、クライアントの一時的な背景として色を使用します。Use the color as the temporary background in your client until the image is loaded. StringString
contentSizecontentSize イメージのファイルサイズ。The image's file size. 文字列の形式は {size} {units} です。The format of the string is {size} {units}. たとえば、12345 B は、イメージのサイズが12345バイトであることを示します。For example, 12345 B indicates that the size of the image is 12,345 bytes. StringString
contentUrlcontentUrl ソース web サイト上のイメージの URL。The URL to the image on the source website. StringString
datePublisheddatePublished Bing が画像を検出した日付と時刻 (UTC)。The date and time, in UTC, that Bing discovered the image. 日付は YYYY-MM-YYYY-MM-DDTHH: MM: SS という形式になっています。The date is in the format, YYYY-MM-DDTHH:MM:SS. StringString
encodingFormatencodingFormat イメージの mime の種類 (jpeg など)。The image's mime type (for example, jpeg). StringString
上下height ソースイメージの高さ (ピクセル単位)。The height of the source image, in pixels. Unsigned ShortUnsigned Short
hostPageDisplayUrlhostPageDisplayUrl 画像をホストする web ページの表示 URL。The display URL of the webpage that hosts the image.

ユーザーインターフェイスでこの URL を使用して、イメージを含むホスト web ページを識別します。Use this URL in your user interface to identify the host webpage that contains the image. URL は適切な形式ではないため、ホストの web ページにアクセスするためには使用しないでください。The URL is not a well-formed and should not be used to access the host webpage. ホストの web ページにアクセスするにhostPageUrlは、URL を使用します。To access the host webpage, use the hostPageUrl URL.
StringString
hostPageUrlhostPageUrl 画像を含む web ページの URL。The URL of the webpage that includes the image.

この URL とcontentUrlは同じ url でもかまいません。This URL and contentUrl may be the same URL.
StringString
idid イメージの一覧でこのイメージを一意に識別する ID。An ID that uniquely identifies this image in the list of images.

このフィールドは、Web Search API 応答にのみ含まれます。Only Web Search API responses include this field. このフィールドの使用方法の詳細については、「Web Search API ガイド」の「順位付けを使用した結果の表示」を参照してください。For information about how to use this field, see Using Ranking to Display Results in the Web Search API guide.
StringString
imageIdimageId このイメージを一意に識別する ID。An ID that uniquely identifies this image. イメージを応答の最初のイメージにする場合は、要求でidクエリパラメーターをこの id に設定します。If you want the image to be the first image in the response, set the id query parameter to this ID in your request. StringString
imageInsightsTokenimageInsightsToken イメージに関する追加情報を取得するために、Image Search API への後続の呼び出しで使用するトークン。The token that you use in a subsequent call to the Image Search API to get additional information about the image. このトークンの使用方法の詳細については、 insightsTokenクエリパラメーターを参照してください。For information about using this token, see the insightsToken query parameter. StringString
insightsMetadatainsightsMetadata 画像に関連する他のアクションを実行できる web サイトの数。A count of the number of websites where you can shop or perform other actions related to the image.

たとえば、画像が apple の円グラフの場合、このオブジェクトには、apple の円を購入できる web サイトの数が含まれます。For example, if the image is of an apple pie, this object includes a count of the number of websites where you can buy an apple pie. UX 内のプランの数を示すには、カウントを含むショッピングカートアイコンなどのバッジを追加します。To indicate the number of offers in your UX, include badging such as a shopping cart icon that contains the count. ユーザーがアイコンをクリックしたときにimageInisghtsToken 、を使用して web サイトの一覧を取得します。When the user clicks on the icon, use imageInisghtsToken to get the list of websites.
InsightsMetadataInsightsMetadata
指定name 画像のタイトル。A title of the image. StringString
画像thumbnail サムネイルイメージの幅と高さ (「」 thumbnailUrlを参照)。The width and height of the thumbnail image (see thumbnailUrl). MediaSizeMediaSize
thumbnailUrlthumbnailUrl イメージのサムネイルの URL。The URL to a thumbnail of the image. 画像のサイズ変更の詳細については、「サムネイル画像のサイズ変更とトリミング」を参照してください。For information about resizing the image, see Resize and crop thumbnail images. StringString
webSearchUrlwebSearchUrl このイメージの Bing 検索結果の URL。The URL to the Bing search results for this image. StringString
width ソースイメージの幅 (ピクセル単位)。The width of the source image, in pixels. Unsigned ShortUnsigned Short

ImagecapImageCaption

イメージのキャプションを定義します。Defines an image's caption.

名前Name Value TypeType
captioncaption イメージに関するキャプション。A caption about the image. StringString
dataSourceUrldataSourceUrl キャプションが見つかった web サイトの URL。The URL to the website where the caption was found. キャプションは、ソースに属性を指定する必要があります。You must attribute the caption to the source. たとえば、キャプションの横にある URL のドメイン名を表示し、URL を使用してソース web サイトにリンクします。For example, by displaying the domain name from the URL next to the caption and using the URL to link to the source website. StringString
関連性のある検索relatedSearches キャプションに見つかったエンティティの一覧。A list of entities found in the caption. Queryオブジェクトのコンテンツを使用してキャプション内のエンティティを検索し、リンクを作成します。Use the contents of the Query object to find the entity in the caption and create a link. このリンクによって、ユーザーはエンティティのイメージに移動します。The link takes the user to images of the entity. クエリQuery

ImageGalleryImageGallery

関連する画像のコレクションが含まれている web ページへのリンクを定義します。Defines a link to a webpage that contains a collection of related images.

名前Name Value TypeType
ファcreator コレクションを所有しているユーザー。The person that owns the collection. コレクションを作成者に属性を指定する必要があります。You must attribute the collection to the creator. PersonPerson
記述description コレクションの説明。A description of the collection. 説明は空にすることができます。The description may be empty. StringString
このカウントfollowersCount 作成者に続くソーシャルネットワーク上のユーザーの数。The number of users on the social network that follow the creator. 符号なし整数Unsigned Integer
imagesCountimagesCount コレクション内で見つかった関連するイメージの数。The number of related images found in the collection. 符号なし整数Unsigned Integer
指定name ギャラリーの名前。The name of the gallery. StringString
電源source イメージが検出された発行元またはソーシャルネットワーク。The publisher or social network where the images were found. 発行元をコレクションが見つかったソースとして属性を指定する必要があります。You must attribute the publisher as the source where the collection was found. StringString
thumbnailUrlthumbnailUrl コレクション内で見つかったいずれかのイメージのサムネイルの URL。The URL to a thumbnail of one of the images found in the collection. StringString
url 関連する画像のコレクションが含まれている web ページへの URL。The URL to the webpage that contains the collection of related images. StringString

ImageInsightsImageInsights

Image insights 要求が成功したときに応答に含まれるトップレベルのオブジェクト。The top-level object that the response includes when an image insights request succeeds.

Image insights の要求の詳細については、 insightsTokenクエリパラメーターを参照してください。For information about requesting image insights, see the insightsToken query parameter.

Modulesクエリパラメーターは、Bing によって応答に含まれるフィールドに影響します。The modules query parameter affects the fields that Bing includes in the response. を [キャプションmodulesのみ] に設定すると、このオブジェクトにimageCaptionはフィールドだけが含まれます。If you set modules to only Caption, then this object includes only the imageCaption field.

名前Name Value TypeType
_type_type ImageInsights に設定されている型ヒント。A type hint, which is set to ImageInsights. StringString
bestRepresentativeQuerybestRepresentativeQuery 画像を最もよく表すクエリ用語。The query term that best represents the image. Queryオブジェクト内のリンクをクリックすると、ユーザーは画像の画像が多くなる web ページに移動します。Clicking the link in the Query object, takes the user to a webpage with more pictures of the image. クエリQuery
imagecapimageCaption 画像に使用するキャプション。The caption to use for the image. ImagecapImageCaption
imageInsightsTokenimageInsightsToken イメージに関する詳細情報を取得するために、Image Search API への後続の呼び出しで使用するトークン。A token that you use in a subsequent call to the Image Search API to get more information about the image. このトークンの使用方法の詳細については、 insightsTokenクエリパラメーターを参照してください。For information about using this token, see the insightsToken query parameter.

このトークンには、 Imageオブジェクト内のトークンと同じ使用法があります。This token has the same usage as the token in the Image object.
StringString
imageTagsimageTags イメージ内で見つかったコンテンツの特性の一覧。A list of characteristics of the content found in the image. たとえば、画像が人物の場合、タグによって、ユーザーの性別や、所有している衣類の種類が示されることがあります。For example, if the image is of a person, the tags might indicate the person's gender and the type of clothes they're wearing. ImageTagsModuleImageTagsModule
以下を含むものpagesIncluding 画像が含まれている web ページの一覧。A list of webpages that contain the image. Web ページにアクセスするには、画像のhostPageUrlフィールドの URL を使用します。To access the webpage, use the URL in the image's hostPageUrl field. ImagesModuleImagesModule
レシピrecipes イメージに関連するレシピの一覧。A list of recipes related to the image. たとえば、画像が apple の円の場合、一覧には、apple の円を作成するためのレシピが含まれています。For example, if the image is of an apple pie, the list contains recipes for making an apple pie. RecipesModuleRecipesModule
認識 IzedentitygroupsrecognizedEntityGroups 指定されたイメージで見つかったエンティティに一致するエンティティのイメージを含むグループの一覧。A list of groups that contain images of entities that match the entity found in the specified image. たとえば、エンティティがそのグループで認識された場合、応答には general 著名人グループの画像が含まれることがあります。For example, the response might include images from the general celebrity group if the entity was recognized in that group. RecognizedEntitiesModuleRecognizedEntitiesModule
関連性のあるコレクションrelatedCollections 関連する画像が含まれている web ページへのリンクの一覧です。A list of links to webpages that contain related images. "関連性のあるコレクション" モジュールRelatedCollectionsModule
関連性のある検索relatedSearches 他のユーザーによって行われた関連クエリの一覧。A list of related queries made by others. 関連性検索モジュールRelatedSearchesModule
shoppingSourcesshoppingSources イメージに関連する項目を提供する商人の一覧。A list of merchants that offer items related to the image. たとえば、画像が apple の円の場合、リストには、apple の扇形を販売している加盟店が含まれています。For example, if the image is of an apple pie, the list contains merchants that are selling apple pies. AggregateOfferAggregateOffer
visuallySimilarImagesvisuallySimilarImages 元の画像のように視覚的に似た画像の一覧。A list of images that are visually similar to the original image. たとえば、指定された画像が水の本体を越えている場合、類似した画像の一覧は水の中にあります。For example, if the specified image is of a sunset over a body of water, the list of similar images are of a sunset over a body of water.

指定された画像が個人のものである場合、類似する画像は同じ人物であるか、または類似した設定で中している可能性があります。If the specified image is of a person, similar images might be of the same person or they might be of persons dressed similarly or in a similar setting.

類似性の条件は引き続き進化します。The criteria for similarity continues to evolve.
ImagesModuleImagesModule
visuallySimilarProductsvisuallySimilarProducts 元のイメージに含まれている製品と視覚的に似ている製品を含むイメージの一覧。A list of images that contain products that are visually similar to products found in the original image. たとえば、指定した画像にドレスが含まれている場合、類似する画像の一覧にはドレスが含まれます。For example, if the specified image contains a dress, the list of similar images contain a dress.

この画像には、Bing がオンラインで見つかった製品のオファーに関する概要情報が記載されています。The image provides summary information about offers that Bing found online for the product.
ImagesModuleImagesModule

イメージImages

イメージ要求が成功したときに応答に含まれるトップレベルのオブジェクト。The top-level object that the response includes when an image request succeeds.

名前Name Value 種類Type
_type_type Type ヒント。 Images に設定されています。A type hint, which is set to Images. StringString
idid 画像の解答を一意に識別する ID。An ID that uniquely identifies the image answer.

オブジェクトは、このフィールドを Web Search API 応答にのみ含めます。The object includes this field only in a Web Search API response. このフィールドの使用方法の詳細については、「Web Search API ガイド」の「順位付けを使用した結果の表示」を参照してください。For information about how to use this field, see Using Ranking to Display Results in the Web Search API guide.
StringString
isFamilyFriendlyisFamilyFriendly 1つ以上のイメージにアダルトコンテンツが含まれているかどうかを示すブール値。A Boolean value that determines whether one or more of the images contain adult content. 画像にアダルトコンテンツが含まれていisFamilyFriendlyない場合、はtrueに設定されます。If none of the images contain adult content, isFamilyFriendly is set to true. それ以外の場合、1つまたは複数のイメージにisFamilyFriendlyアダルトコンテンツが含まれていると、はfalseに設定されます。Otherwise, if one or more of the images contain adult content, isFamilyFriendly is set to false.

Falseの場合、サムネイル画像はピクセル化 (あいまい) です。If false, the thumbnail images are pixelated (fuzzy).

注: このフィールドは Web Search API 応答にのみ含まれ、Image Search API 応答には含まれません。NOTE: This field is included only in Web Search API responses, not in Image Search API responses.
BooleanBoolean
nextOffsetnextOffset オフセットクエリパラメーターを設定するオフセット値。The offset value that you set the offset query parameter to.

最初の要求offsetでを 0 countに、を30に設定し、2番offset目の要求で30に設定した場合、2番目の応答の結果の一部が最初の応答と重複している可能性があります。If you set offset to 0 and count to 30 in your first request, and then set offset to 30 in your second request, some of the results in the second response may be duplicates of the first response.

重複を防ぐにはoffset 、をのnextOffset値に設定します。To prevent duplicates, set offset to the value of nextOffset.
IntegerInteger
pivotSuggestionspivotSuggestions 元のクエリ内のセグメントのリスト。A list of segments in the original query. たとえば、クエリが赤の花である場合、Bing はクエリをに分割することがあります。For example, if the query was Red Flowers, Bing might segment the query into Red and Flowers.

花 pivot には、赤の Peonies や Red などのクエリ候補が含まれる場合があります。また、Red pivot には、緑の花や黄色の花などのクエリ候補が含まれる場合があります。The Flowers pivot may contain query suggestions such as Red Peonies and Red Daisies, and the Red pivot may contain query suggestions such as Green Flowers and Yellow Flowers.
ピボットPivot
queryExpansionsqueryExpansions 元のクエリを絞り込む、展開されたクエリの一覧。A list of expanded queries that narrows the original query. たとえば「Microsoft Surface」というクエリは、Microsoft Surface Pro 3、Microsoft Surface RT、Microsoft Surface Phone、Microsoft Surface Hub に展開される可能性があります。For example, if the query was Microsoft Surface, the expanded queries might be: Microsoft Surface Pro 3, Microsoft Surface RT, Microsoft Surface Phone, and Microsoft Surface Hub. クエリQuery
readLinkreadLink この回答を返す URL。The URL that returns this answer. URL を使用するには、必要に応じてクエリパラメーターを追加し、 Ocpヘッダーを含めます。To use the URL, append query parameters as appropriate and include the Ocp-Apim-Subscription-Key header.

Web Search API の応答には、このフィールドが含まれます。The Web Search API response includes this field. 通常、Image Search API を直接照会する場合は、URL を使用します。Typically, you'd use the URL if you want to query the Image Search API directly.
StringString
similarTermssimilarTerms ユーザーのクエリ用語と意味が似た用語の一覧。A list of terms that are similar in meaning to the user's query term. クエリQuery
totalEstimatedMatchestotalEstimatedMatches クエリに関連するイメージの推定数。The estimated number of images that are relevant to the query. この数値をカウントおよびオフセットクエリパラメーターと共に使用して、結果をページします。Use this number along with the count and offset query parameters to page the results.

このフィールドは、Image Search API にのみ含まれます。Only the Image Search API includes this field.
LongLong
valuevalue クエリに関連するイメージの一覧。A list of images that are relevant to the query.

結果がない場合、配列は空になります。If there are no results, the array is empty.
イメージ[]Image[]
webSearchUrlwebSearchUrl 要求されたイメージの Bing 検索結果の URL。The URL to the Bing search results for the requested images. StringString

ImagesModuleImagesModule

画像の一覧を定義します。Defines a list of images.

要素Element 説明Description TypeType
valuevalue イメージの一覧。A list of images. イメージ[]Image[]

ImageTagsModuleImageTagsModule

イメージ内で見つかったコンテンツの特性を定義します。Defines the characteristics of content found in an image.

要素Element 説明Description TypeType
valuevalue イメージ内で見つかったコンテンツの特性を記述するタグの一覧。A list of tags that describe the characteristics of the content found in the image. たとえば、画像が音楽アーティストの場合、リストには女性、ドレス、および音楽が含まれていることを示します。これは、人物が女性の音楽アーティストであることを示します。For example, if the image is of a musical artist, the list might include Female, Dress, and Music to indicate the person is female music artist that's wearing a dress. タグ[]Tag[]

InsightsMetadataInsightsMetadata

画像に関連するその他の操作を実行できる web サイトの数を定義します。Defines a count of the number of websites where you can shop or perform other actions related to the image.

要素Element 説明Description TypeType
aggregateOfferaggregateOffer イメージで見つかった製品のオンラインプランの概要。A summary of the online offers of products found in the image. たとえば、画像が "ドレス" の場合、このプランでは最低価格と、検出されたプランの数が特定されます。For example, if the image is of a dress, the offer might identify the lowest price and the number of offers found.

このフィールドは、視覚的に類似した製品の洞察にのみ含まれます。Only visually similar products insights include this field.

このプランにNameは、 AggregateRating、、 OfferCount、およびLowPriceの各フィールドが含まれています。The offer includes the following fields: Name, AggregateRating, OfferCount, and LowPrice.
プランOffer
recipeSourcesCountrecipeSourcesCount 画像に表示されている食べ物のレシピを提供する web サイトの数。The number of websites that offer recipes of the food seen in the image. 符号なし整数Unsigned Integer
shoppingSourcesCountshoppingSourcesCount 画像に表示されている製品の商品を提供する web サイトの数。The number of websites that offer goods of the products seen in the image. 符号なし整数Unsigned Integer

MediaSizeMediaSize

メディアコンテンツのサイズを定義します。Defines the size of the media content.

名前Name Value 種類Type
heightheight メディアコンテンツの高さ (ピクセル単位)。The height of the media content, in pixels. IntegerInteger
widthwidth メディアコンテンツの幅 (ピクセル単位)。The width of the media content, in pixels. IntegerInteger

NormalizedRectangleNormalizedRectangle

イメージの領域を定義します。Defines a region of an image. 領域は、領域の上、左隅、および下、右上隅の座標によって定義されます。The region is defined by the coordinates of the top, left corner and bottom, right corner of the region. 座標は、0.0 ~ 1.0 の範囲の元のイメージの幅と高さの小数部の値です。The coordinates are fractional values of the original image's width and height in the range 0.0 through 1.0.

名前Name Value 種類Type
bottom 下端の座標。The bottom coordinate. FloatFloat
leftleft 左の座標。The left coordinate. FloatFloat
rightright 右の座標The right coordinate FloatFloat
toptop 上の座標The top coordinate FloatFloat

プランOffer

マーチャントのオファーを定義します。Defines a merchant's offer.

ShoppingSources insights と SimilarProducts insights はどちらもこのオブジェクトを使用します。The ShoppingSources insights and SimilarProducts insights both use this object. フィールドが適用される洞察を確認するには、フィールドの説明を参照してください。To determine the insight that the field applies to, see the field's description.

要素Element 説明Description TypeType
集積aggregateRating 製品が他のユーザーによってどの程度評価されたかを示す集計評価。An aggregated rating that indicates how well the product has been rated by others.

SimilarProducts によって使用されます。Used by SimilarProducts.
集積AggregateRating
availabilityavailability 項目の可用性。The item's availability. 有効な値を次に示します。The following are the possible values.
  • 生産中止Discontinued
  • InStockInStock
  • InStoreOnlyInStoreOnly
  • LimitedAvailabilityLimitedAvailability
  • オンラインのみOnlineOnly
  • OutOfStockOutOfStock
  • 事前順序PreOrder
  • このようなSoldOut

ShoppingSources によって使用されます。Used by ShoppingSources.
StringString
descriptiondescription 項目の説明。A description of the item. StringString
lastUpdatedlastUpdated プランが最後に更新された日付。The last date that the offer was updated. 日付は YYYY-MM-DD という形式になっています。The date is in the form YYYY-MM-DD. FailfastSting
低料金lowPrice Bing がオンラインで検出した項目の最低価格。The lowest price of the item that Bing found online.

SimilarProducts によって使用されます。Used by SimilarProducts.
FloatFloat
namename 製品の名前です。The name of the product. StringString
offerCountofferCount Bing がオンラインで検出したオファーの数。The number of offers that Bing found online.

SimilarProducts によって使用されます。Used by SimilarProducts.
符号なし整数Unsigned Integer
priceprice 項目の価格。The item's price.

ShoppingSources によって使用されます。Used by ShoppingSources.
FloatFloat
priceCurrencypriceCurrency 通貨通貨。The monetary currency. たとえば、「USD」とします。For example, USD. StringString
書店seller マーチャントの名前。The merchant's name.

ShoppingSources によって使用されます。Used by ShoppingSources.
組織Organization
urlurl マーチャントの web サイトにあるオファーの URL。The URL to the offer on the merchant's website.

ShoppingSources によって使用されます。Used by ShoppingSources.
StringString

OrganizationOrganization

マーチャントに関する情報を定義します。Defines information about a merchant.

要素Element 説明Description TypeType
imageimage マーチャントのロゴ。The merchant's logo. オブジェクトImageには、 urlフィールドのみが含まれます。The Image object includes only the url field. ImageImage
namename マーチャントの名前。The merchant's name. StringString

PersonPerson

人物を定義します。Defines a person.

名前Name Value 種類Type
_type_type 種類のヒント。Type hint. StringString
descriptiondescription 個人の簡単な説明。A short description of the person. StringString
imageimage 人物の画像。An image of the person. ImageImage
jobTitlejobTitle ユーザーの役職。The person's job title. StringString
namename ユーザーの名前。The person's name. StringString
twitterProfiletwitterProfile 人の twitter プロファイルの URL。The URL of the person's twitter profile. StringString
urlurl ユーザーのソーシャルネットワークのホームページの URL (該当する場合)。The URL to the person's social network home page, if applicable. StringString
webSearchUrlwebSearchUrl このユーザーに関する情報が含まれている Bing の検索結果ページの URL。The URL to the Bing search results page that contains information about this person. StringString

ピボットPivot

ピボットセグメントを定義します。Defines the pivot segment.

名前Name Value 種類Type
旋回pivot ピボットする元のクエリからのセグメント。The segment from the original query to pivot on. StringString
アドバイスsuggestions ピボットに関して推奨されるクエリの一覧。A list of suggested queries for the pivot. クエリQuery

クエリQuery

検索クエリ文字列を定義します。Defines a search query string.

名前Name Value 種類Type
displayTextdisplayText クエリ用語の表示バージョン。The display version of the query term.

展開されたクエリ (「 Queryexpansions」を参照) とピボット候補 (「 pivotsuggestions」を参照) では、このフィールドによって、元のクエリを展開した用語が識別されます。For expanded queries (see queryExpansions) and pivot suggestions (see pivotSuggestions), this field identifies the term that expanded the original query. たとえば、クエリがmicrosoft surfaceで、拡張されたクエリがmicrosoft surface rtdisplayText場合、にはRTが含まれます。For example, if the query was Microsoft Surface and the expanded query is Microsoft Surface RT, displayText would contain RT.
StringString
searchLinksearchLink 関連検索の結果を取得するために使用する URL。The URL that you use to get the results of the related search. URL を使用する前に、必要に応じてクエリパラメーターを追加し、 Ocpヘッダーを含める必要があります。Before using the URL, you must append query parameters as appropriate and include the Ocp-Apim-Subscription-Key header.

独自のユーザーインターフェイスに結果を表示している場合は、この URL を使用します。Use this URL if you're displaying the results in your own user interface. それ以外の場合webSearchUrlは、URL を使用します。Otherwise, use the webSearchUrl URL.
StringString
texttext クエリ用語。The query term. StringString
thumbnailthumbnail 関連するイメージのサムネイルの URL。The URL to a thumbnail of a related image.

オブジェクトには、ピボット候補および関連する検索に対してのみこのフィールドが含まれます。The object includes this field only for pivot suggestions and related searches.
サムネイルThumbnail
webSearchUrlwebSearchUrl ユーザーがクエリの Bing の検索結果ページに移動する URL。The URL that takes the user to the Bing search results page for the query.

ユーザーインターフェイスに結果が表示されない場合は、この URL を使用します。Use this URL if you're not displaying the results in your own user interface. それ以外の場合searchUrlは、URL を使用します。Otherwise, use the searchUrl URL.

関連する検索にのみ含まれます。Included only for related searches.
StringString

レシピRecipe

料理レシピを定義します。Defines a cooking recipe.

要素Element 説明Description TypeType
集積aggregateRating 他のユーザーによってどのようにレシピが評価されたかを示す集計評価。Aggregated ratings that indicate how well the recipe has been rated by others. 集積AggregateRating
cookTimecookTime 食品がクックするまでにかかる時間。The amount of time the food takes to cook. たとえば、PT25M のようになります。For example, PT25M. 時刻形式の詳細についてはhttps://en.wikipedia.org/wiki/ISO_8601#Durations、「」を参照してください。For information about the time format, see https://en.wikipedia.org/wiki/ISO_8601#Durations. StringString
ファcreator レシピの作成者。The recipe's author. PersonPerson
namename レシピの名前。The name of the recipe. StringString
prepTimeprepTime 成分を準備するために必要な時間。The amount of time required to prepare the ingredients. たとえば、PT15M のようになります。For example, PT15M. 時刻形式の詳細についてはhttps://en.wikipedia.org/wiki/ISO_8601#Durations、「」を参照してください。For information about the time format, see https://en.wikipedia.org/wiki/ISO_8601#Durations. StringString
thumbnailUrlthumbnailUrl 準備された食べ物のサムネイル画像の URL。The URL to a thumbnail image of the prepared food. StringString
totalTimetotalTime レシピの準備とクックにかかる時間の合計。The total amount of time it takes to prepare and cook the recipe. たとえば、PT45M のようになります。For example, PT45M. 時刻形式の詳細についてはhttps://en.wikipedia.org/wiki/ISO_8601#Durations、「」を参照してください。For information about the time format, see https://en.wikipedia.org/wiki/ISO_8601#Durations. StringString
urlurl レシピを含む web ページにユーザーを移動する URL。The URL that takes the user to the webpage that contains the recipe. StringString

RecipesModuleRecipesModule

レシピのリストを定義します。Defines a list of recipes.

要素Element 説明Description TypeType
valuevalue レシピの一覧。A list of recipes. レシピ[]Recipe[]

RecognizedEntitiesModuleRecognizedEntitiesModule

以前に認識されたエンティティの一覧を定義します。Defines a list of previously recognized entities.

要素Element 説明Description TypeType
valuevalue 認識されたエンティティの一覧。A list of recognized entities. 認識Izedenitygroup[]RecognizedEnityGroup[]

認識 IzedentityRecognizedEntity

認識されたエンティティを定義します。Defines a recognized entity.

要素Element 説明Description TypeType
エンティティentity 認識されたエンティティ。The entity that was recognized.

使用可能なエンティティオブジェクトを次に示します。The following are the possible entity objects.
ObjectObject
matchConfidencematchConfidence Bing では、イメージ内のエンティティがこのエンティティと一致するという自信を持っています。The confidence that Bing has that the entity in the image matches this entity. 信頼度は、0.0 から1.0 までの範囲で、1.0 が非常に安全であることを保証します。The confidence ranges from 0.0 through 1.0 with 1.0 being very confident. FloatFloat

認識 IzedentitygroupRecognizedEntityGroup

以前に認識されたエンティティのグループを定義します。Defines a group of previously recognized entities.

要素Element 説明Description TypeType
namename エンティティのイメージも検出されたグループの名前。The name of the group where images of the entity were also found.

次のグループを使用できます。The following are possible groups.
  • CelebrityAnnotations に類似した Celeb注釈—を使用しますが、正確に一致する確率が高くなります。CelebRecognitionAnnotations—Similar to CelebrityAnnotations but provides a higher probability of an accurate match.

  • CelebrityAnnotations—には、アクター、politicians、選手、履歴などの有名人が含まれています。CelebrityAnnotations—Contains celebrities such as actors, politicians, athletes, and historical figures.
StringString
認識 IzedentityregionrecognizedEntityRegions エンティティを格納しているイメージの領域。The regions of the image that contain entities. 認識Izedentityregion[]RecognizedEntityRegion[]

認識 IzedentityregionRecognizedEntityRegion

エンティティが検出されたイメージの領域と、エンティティが一致する可能性のあるエンティティのリストを定義します。Defines a region of the image where an entity was found and a list of entities that might match it.

要素Element 説明Description TypeType
matchingEntitiesmatchingEntities Bing が地域で見つかったエンティティと一致するエンティティの一覧。A list of entities that Bing believes match the entity found in the region. エンティティは信頼度の高いものになります ( matchConfidence認識されたエンティティのフィールドを参照してください)。The entities are in descending order of confidence (see the matchConfidence field of RecognizedEntity). 認識Izedentity[]RecognizedEntity[]
regionregion エンティティを格納しているイメージの領域。A region of the image that contains an entity.

四角形の値は、元のイメージの幅と高さに対して相対的であり、0.0 から 1.0 の範囲内にあります。The values of the rectangle are relative to the width and height of the original image and are in the range 0.0 through 1.0.

たとえば、画像が300x200 で、領域の左上がポイント (10, 20) にあり、右下隅がポイント (290, 150) の場合、正規化された四角形は次のようになります。For example, if the image is 300x200 and the region's top, left corner is at point (10, 20) and the bottom, right corner is at point (290, 150), then the normalized rectangle is:

Left = 0.0333333333333333Left = 0.0333333333333333

上位 = 0.1Top = 0.1

Right = 0.9666666666666667Right = 0.9666666666666667

下 = 0.75Bottom = 0.75

人物の場合、領域はその人物の顔を表します。For people, the region represents the person's face.
NormalizedRectangleNormalizedRectangle

"関連性のあるコレクション" モジュールRelatedCollectionsModule

関連する画像を含む web ページの一覧を定義します。Defines a list of webpages that contain related images.

要素Element 説明Description TypeType
valuevalue 関連する画像が含まれている web ページの一覧。A list of webpages that contain related images. Imagegallery[]ImageGallery[]

関連性検索モジュールRelatedSearchesModule

他のユーザーによって行われた関連検索の一覧を定義します。Defines a list of related searches made by others.

要素Element 説明Description TypeType
valuevalue 他のユーザーによって行われた関連検索の一覧。A list of related searches made by others. クエリ[]Query[]

タグTag

イメージ内で見つかったコンテンツの特性を定義します。Defines a characteristic of the content found in the image.

要素Element 説明Description TypeType
namename 特性の名前。The name of the characteristic. たとえば、cat、キティー、calico cat などです。For example, cat, kitty, calico cat. StringString

サムネイルThumbnail

画像のサムネイルを定義します。Defines a thumbnail of an image.

要素Element 説明Description TypeType
urlurl イメージのサムネイルの URL。The URL to a thumbnail of an image. StringString

タイルTile

イメージタイルを定義します。Defines an image tile.

要素Element 説明Description TypeType
imageimage イメージのサムネイルの URL。The URL to the image's thumbnail. ImageImage
queryquery 対象の画像が多い Bing の検索結果ページを返すクエリ。A query that returns a Bing search results page with more images of the subject. たとえば、カテゴリが人気のある人の検索である場合、サムネイルは人気のあるユーザーになります。For example, if the category is Popular People Searches, then the thumbnail is of a popular person. クエリから Bing の検索結果ページが返され、その人のイメージが増えます。The query would return a Bing search results page with more images of that person. クエリQuery

TrendingImagesTrendingImages

トレンド画像要求が成功したときに応答に含まれるトップレベルのオブジェクト。The top-level object that the response includes when a trending images request succeeds.

要素Element 説明Description TypeType
categoriescategories 画像のカテゴリとそのカテゴリ内のトレンド画像の一覧を識別するリスト。A list that identifies categories of images and a list of trending images in that category. カテゴリ[]Category[]

エラー コードError codes

要求によって返される可能性のある HTTP 状態コードを次に示します。The following are the possible HTTP status codes that a request returns.

状態コードStatus Code 説明Description
200200 正常終了しました。Success.
400400 クエリ パラメーターの 1 つが欠落しているか無効です。One of the query parameters is missing or not valid.
401401 サブスクリプション キーが見つからないか、無効です。The subscription key is missing or is not valid.
403403 (たとえば、有効なサブスクリプション キーを使用して) ユーザーは認証されたものの、要求されたリソースへのアクセス許可がありません。The user is authenticated (for example, they used a valid subscription key) but they don’t have permission to the requested resource.

また、呼び出し元が 1 か月あたりのクエリ数のクォータを超えた場合にも、Bing はこの状態を返します。Bing may also return this status if the caller exceeded their queries per month quota.
410410 HTTPS プロトコルではなく HTTP プロトコルが使用された要求。The request used HTTP instead of the HTTPS protocol. サポートされるプロトコルは HTTPS のみです。HTTPS is the only supported protocol.
429429 呼び出し元が 1 秒あたりのクエリ数のクォータを超えました。The caller exceeded their queries per second quota.
500500 予期しないサーバー エラー。Unexpected server error.

要求が失敗すると、応答に ErrorResponse オブジェクトが含まれます。このオブジェクトには、エラーの原因を示す Error オブジェクトの一覧が含まれています。If the request fails, the response contains an ErrorResponse object, which contains a list of Error objects that describe what caused of error. エラーがパラメーターに関連している場合、parameter フィールドで、問題であるパラメーターが特定されます。If the error is related to a parameter, the parameter field identifies the parameter that is the issue. エラーがパラメーター値に関連している場合、value フィールドで、無効な値が特定されます。And if the error is related to a parameter value, the value field identifies the value that is not valid.

{
  "_type": "ErrorResponse", 
  "errors": [
    {
      "code": "InvalidRequest", 
      "subCode": "ParameterMissing", 
      "message": "Required parameter is missing.", 
      "parameter": "q" 
    }
  ]
}

{
  "_type": "ErrorResponse", 
  "errors": [
    {
      "code": "InvalidAuthorization", 
      "subCode": "AuthorizationMissing", 
      "message": "Authorization is required.", 
      "moreDetails": "Subscription key is not recognized."
    }
  ]
}

考えられるエラー コードとサブエラー コードの値を次に示します。The following are the possible error code and sub-error code values.

コードCode サブコードSubCode 説明Description
ServerErrorServerError UnexpectedErrorUnexpectedError
ResourceErrorResourceError
NotImplementedNotImplemented
HTTP 状態コードは 500 です。HTTP status code is 500.
InvalidRequestInvalidRequest ParameterMissingParameterMissing
ParameterInvalidValueParameterInvalidValue
HttpNotAllowedHttpNotAllowed
BlockedBlocked
要求の一部が有効でない場合に Bing は InvalidRequest を返します。Bing returns InvalidRequest whenever any part of the request is not valid. たとえば、必要なパラメーターが不足している場合や、パラメーター値が無効な場合です。For example, a required parameter is missing or a parameter value is not valid.

エラーが ParameterMissing または ParameterInvalidValue の場合、HTTP 状態コードは 400 です。If the error is ParameterMissing or ParameterInvalidValue, the HTTP status code is 400.

HTTPS プロトコルではなく HTTP プロトコルを使用すると、Bing は HttpNotAllowed を返し、HTTP 状態コードは 410 になります。If you use the HTTP protocol instead of HTTPS, Bing returns HttpNotAllowed, and the HTTP status code is 410.
RateLimitExceededRateLimitExceeded No sub-codesNo sub-codes 1 秒あたりのクエリ数 (QPS) または 1 か月あたりのクエリ数 (QPM) のクォータを超えると、Bing は RateLimitExceeded を返します。Bing returns RateLimitExceeded whenever you exceed your queries per second (QPS) or queries per month (QPM) quota.

QPS を超えた場合、Bing は HTTP 状態コード 429 を返します。また、QPM を超えた場合、Bing は 403 を返します。If you exceed QPS, Bing returns HTTP status code 429, and if you exceed QPM, Bing returns 403.
InvalidAuthorizationInvalidAuthorization AuthorizationMissingAuthorizationMissing
AuthorizationRedundancyAuthorizationRedundancy
Bing は、呼び出し元を認証できない場合に InvalidAuthorization を返します。Bing returns InvalidAuthorization when Bing cannot authenticate the caller. たとえば、Ocp-Apim-Subscription-Key ヘッダーがない場合や、サブスクリプション キーが無効な場合です。For example, the Ocp-Apim-Subscription-Key header is missing or the subscription key is not valid.

冗長性は、複数の認証方法を指定した場合に発生します。Redundancy occurs if you specify more than one authentication method.

エラーが InvalidAuthorization の場合、HTTP 状態コードは 401 です。If the error is InvalidAuthorization, the HTTP status code is 401.
InsufficientAuthorizationInsufficientAuthorization AuthorizationDisabledAuthorizationDisabled
AuthorizationExpiredAuthorizationExpired
呼び出し元がリソースに対するアクセス許可を備えていない場合、Bing は InsufficientAuthorization を返します。Bing returns InsufficientAuthorization when the caller does not have permissions to access the resource. これは、サブスクリプション キーが無効になっているか、期限が切れている場合に発生することがあります。This can occur if the subscription key has been disabled or has expired.

エラーが InsufficientAuthorization の場合、HTTP 状態コードは 403 です。If the error is InsufficientAuthorization, the HTTP status code is 403.

市場コードMarket codes

次の表に、クエリパラメーターのmkt指定に使用できる市場コードの値を示します。The following table lists the market code values that you may use to specify the mkt query parameter. Bing はこれらの市場に対してのみコンテンツを返します。Bing returns content for only these markets. 一覧は変更されることがあります。The list is subject to change.

ccクエリパラメーターで指定できる国コードの一覧については、「国コード」を参照してください。For a list of country codes that you may specify in the cc query parameter, see Country codes.

国/リージョンCountry/Region LanguageLanguage 市場コードMarket code
アルゼンチンArgentina スペイン語Spanish es-ARes-AR
オーストラリアAustralia 英語English en-AUen-AU
オーストリアAustria ドイツ語German de-ATde-AT
ベルギーBelgium オランダ語Dutch nl-BEnl-BE
ベルギーBelgium フランス語French fr-BEfr-BE
ブラジルBrazil PortuguesePortuguese pt-BRpt-BR
CanadaCanada 英語English en-CAen-CA
CanadaCanada フランス語French fr-CAfr-CA
チリChile スペイン語Spanish es-CLes-CL
デンマークDenmark デンマーク語Danish da-DKda-DK
フィンランドFinland フィンランド語Finnish fi-FIfi-FI
フランスFrance フランス語French fr-FRfr-FR
ドイツGermany ドイツ語German de-DEde-DE
香港特別行政区Hong Kong SAR 繁体字中国語Traditional Chinese zh-HKzh-HK
インドIndia 英語English en-INen-IN
インドネシアIndonesia 英語English en-IDen-ID
イタリアItaly イタリア語Italian it-ITit-IT
日本Japan 日本語Japanese ja-JPja-JP
韓国Korea 韓国語Korean ko-KRko-KR
マレーシアMalaysia 英語English en-MYen-MY
メキシコMexico スペイン語Spanish es-MXes-MX
オランダNetherlands オランダ語Dutch nl-NLnl-NL
ニュージーランドNew Zealand 英語English en-NZen-NZ
中華人民共和国People's republic of China ChineseChinese zh-CNzh-CN
ポーランドPoland ポーランド語Polish pl-PLpl-PL
ポルトガルPortugal PortuguesePortuguese pt-PTpt-PT
フィリピン共和国Republic of the Philippines 英語English en-PHen-PH
ロシアRussia ロシア語Russian ru-RUru-RU
サウジアラビアSaudi Arabia アラビア語Arabic ar-SAar-SA
南アフリカSouth Africa 英語English en-ZAen-ZA
スペインSpain スペイン語Spanish es-ESes-ES
スウェーデンSweden スウェーデン語Swedish sv-SEsv-SE
スイスSwitzerland フランス語French fr-CHfr-CH
スイスSwitzerland ドイツ語German de-CHde-CH
台湾Taiwan 繁体字中国語Traditional Chinese zh-TWzh-TW
トルコTurkey トルコ語Turkish tr-TRtr-TR
イギリスUnited Kingdom 英語English en-GBen-GB
United StatesUnited States 英語English ja-JPen-US
United StatesUnited States スペイン語Spanish es-USes-US

国コードCountry codes

cc クエリ パラメーターで指定できる国番号を次に示します。The following are the country codes that you may specify in the cc query parameter. 一覧は変更されることがあります。The list is subject to change.

国/リージョンCountry/Region 国番号Country code
アルゼンチンArgentina ARAR
オーストラリアAustralia AUAU
オーストリアAustria ATAT
ベルギーBelgium BEBE
ブラジルBrazil BRBR
CanadaCanada CACA
チリChile CLCL
デンマークDenmark DKDK
フィンランドFinland FIFI
フランスFrance FRFR
ドイツGermany DEDE
香港特別行政区Hong Kong SAR HKHK
インドIndia ININ
インドネシアIndonesia idID
イタリアItaly ITIT
日本Japan JPJP
韓国Korea KRKR
マレーシアMalaysia MYMY
メキシコMexico MXMX
オランダNetherlands NLNL
ニュージーランドNew Zealand NZNZ
ノルウェーNorway NONO
中華人民共和国People's Republic of China CNCN
ポーランドPoland PLPL
ポルトガルPortugal PTPT
フィリピン共和国Republic of the Philippines PHPH
ロシアRussia RURU
サウジアラビアSaudi Arabia SASA
南アフリカSouth Africa ZAZA
スペインSpain ESES
スウェーデンSweden SESE
スイスSwitzerland CHCH
台湾Taiwan TWTW
トルコTurkey TRTR
イギリスUnited Kingdom GBGB
United StatesUnited States USUS

Bing でサポートされる言語Bing supported languages

クエリ パラメーターで指定できるBingサポートされる言語を次にsetLang示します。The following are the Bing supported languages that you may specify in the setLang query parameter. 一覧は変更されることがあります。The list is subject to change.

サポートされている言語Supported Languages 言語コードLanguage Code
アラビア語Arabic arar
バスク語Basque eueu
ベンガル語Bengali bnbn
BulgarianBulgarian bgbg
カタロニア語Catalan caca
簡体中国語Chinese (Simplified) zh-hanszh-hans
繁体中国語Chinese (Traditional) zh-hantzh-hant
CroatianCroatian hrhr
CzechCzech cscs
DanishDanish dada
DutchDutch nlnl
EnglishEnglish enen
イギリス-イギリスEnglish-United Kingdom en-gben-gb
EstonianEstonian etet
FinnishFinnish fifi
FrenchFrench frfr
ガリシア語Galician glgl
GermanGerman dede
グジャラート語Gujarati gugu
ヘブライ語Hebrew hehe
ヒンディー語Hindi hihi
HungarianHungarian huhu
アイスランド語Icelandic isis
ItalianItalian itit
JapaneseJapanese Jpjp
カンナダ語Kannada knkn
KoreanKorean koko
LatvianLatvian lvlv
LithuanianLithuanian ltlt
マレー語Malay msms
マラヤーラム語Malayalam  mlml
マラーティー語Marathi mrmr
ノルウェー語 (ブークモール)Norwegian (Bokmål) nbnb
PolishPolish plpl
ポルトガル語 (ブラジル)Portuguese (Brazil) pt-brpt-br
ポルトガル語 (ポルトガル)Portuguese (Portugal) pt-ptpt-pt
パンジャーブ語Punjabi papa
RomanianRomanian roro
RussianRussian ruru
セルビア語 (キリリック)Serbian (Cyrylic) srsr
SlovakSlovak sksk
SlovenianSlovenian slsl
SpanishSpanish eses
SwedishSwedish svsv
タミル語Tamil tata
テルグ語Telugu tete
ThaiThai thth
TurkishTurkish trtr
ウクライナ語Ukrainian ukuk
ベトナム語Vietnamese vivi