Programmable Search Element 有料 API
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
プログラム可能検索要素が、広告なしの有料版を提供するようになりました。Programmable Search Element 有料 API を有効にすると、お客様のプログラム可能な検索要素は、無料版とまったく同じように機能し続けます。ただし、検索結果と一緒に広告が表示される代わりに、検索ごとに少額の料金が発生します。
非営利団体、教育機関、政府機関のユーザーは、こちらの手順に沿って広告なしで利用することができます。
前提条件
検索エンジンの設定
Programmable Search Element 有料 API を使用するには、まず、プログラム可能検索エンジンを作成して設定する必要があります。プログラム可能検索エンジンをまだ作成していない場合は、まずプログラム可能検索エンジンのコントロール パネルにアクセスします。
チュートリアルで、さまざまな構成オプションの詳細を確認してください。
API キー
Programmable Search Element API では API キーを使用する必要があります。キーを取得
Programmable Search Element API キーを取得すると、プログラム可能検索エンジンのコントロール パネルを使用して、このキーを検索エンジンに追加できます。検索エンジンの [概要] ページの [広告] セクションに移動し、[有料 Element API キー] 欄にキーを貼り付けます。これで、この検索エンジンで Programmable Search Element API が有効になりました。
無料の広告型検索要素に戻す場合は、コントロール パネルのこのフィールドからキーを削除してください。
料金
Programmable Search Element API では、広告なしの検索要素クエリ 1,000 回あたり $5 が課金されます。課金は API Console で構成する必要があります。Cloud Platform Console で割り当てを構成して、1 日の最大費用を制限できます。
新規のユーザー プロジェクトでは、デフォルトで 1 日の割り当てが無制限になるため、トラフィック量に十分な量の 1 日の割り当てを設定することを強くおすすめします。1 日の割り当ての上限に達すると、その日が終わるまで、エンジンを使用するすべての検索要素クエリが拒否されます。また、分単位およびユーザーごとの分単位の割り当て制御も利用できます（ユーザーの識別には IP アドレスが使用されます）。
モニタリング
Programmable Search Element API の使用状況は、次の 2 つの方法で監視できます。まず、Cloud Platform Console の API ダッシュボードには、エラー率や秒間クエリ数などの一般的な指標をモニタリングするために、さまざまな事前構築済みのグラフが用意されています。次に、Google Cloud Operations コンソールには、カスタムグラフの作成やアラートの設定を行うための強力なツールが用意されています。詳細については、API Monitoring をご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-08-31 UTC。
[null,null,["最終更新日 2025-08-31 UTC。"],[[["\u003cp\u003eThe Programmable Search Element now offers a paid ads-free version, charging a small fee per search instead of displaying ads.\u003c/p\u003e\n"],["\u003cp\u003eNonprofits, educational institutions, and government users can access an ads-free experience through a separate process.\u003c/p\u003e\n"],["\u003cp\u003eTo use the paid version, you need to configure a Programmable Search Engine, obtain an API key, and add it to your search engine settings.\u003c/p\u003e\n"],["\u003cp\u003eThe pricing is $5 per 1000 ad-free searches, with billing and quota management handled through the Google Cloud Platform.\u003c/p\u003e\n"],["\u003cp\u003eYou can monitor usage and set up alerts using tools provided in the Cloud Platform Console and Google Cloud Operations console.\u003c/p\u003e\n"]]],[],null,["# Programmable Search Element Paid API\n\nThe [Programmable Search\nElement](/custom-search/docs/tutorial/implementingsearchbox) now offers a paid\nads-free version. By enabling the Programmable Search Element Paid API your\nProgrammable Search Element will continue to function exactly the same as the\nfree ad-supported version, except that instead of ads being displayed along with\nsearch results you'll instead be charged a small fee for each search.\n\nNote that our nonprofit, education, and government users can get an ads-free\nexperience by following [these\ninstructions](https://support.google.com/programmable-search/answer/12423873).\n\nPrerequisites\n-------------\n\n### Search engine configuration\n\nBefore using the Programmable Search Element Paid API you first need to create\nand configure your Programmable Search Engine. If you have not already created a Programmable Search Engine, you\ncan start by visiting the [Programmable Search Engine control panel](https://programmablesearchengine.google.com/controlpanel/all).\n\nFollow the [tutorial](/custom-search/docs/tutorial/creatingcse) to learn more\nabout different configuration options.\n\n### API key\n\nThe Programmable Search Element API requires the use of an API key. Get a Key\n\nOnce you have a Programmable Search Element API key, you can add this key to\nyour search engine using the [Programmable Search Engine control panel](https://programmablesearchengine.google.com/controlpanel/all). Navigate to the Ads section of your search engine's\nOverview page and paste your key in the \"Paid Element API key\" field.\nCongratulations, the Programmable Search Element API is now active for this\nsearch engine!\n\nIf at any point you wish to return to the free ad-supported search element, just\ndelete the key from this field in the control panel.\n\nPricing\n-------\n\nThe Programmable Search Element API charges $5 per 1000 ad-free search element\nqueries. [Billing](https://cloud.google.com/billing/docs/how-to/manage-billing-account) needs to be configured in the\nAPI Console. Quotas can be configured in the [Cloud Platform\nConsole](https://console.cloud.google.com/apis/dashboard) to help limit maximum\ndaily expenditures.\n\nNote that new consumer projects will default to unlimited daily quota; we\n*strongly* recommend setting a [daily quota](https://console.cloud.google.com/apis/api/programmablesearchelement.googleapis.com/quotas) that is sufficient for\nyour traffic volume. Once the daily quota limit is reached all search element\nqueries using the engine will be denied for the remainder of the day. Note also\nthat per-minute and per-user per-minute quota controls are also available (with\nIP address being used to distinguish between users).\n\nMonitoring\n----------\n\nTwo options are available for monitoring usage of the Programmable Search\nElement API. First, [Cloud Platform Console's API\nDashboard](https://console.cloud.google.com/apis/dashboard) provides a variety\nof pre-built graphs for monitoring common metrics such as error rates and\nqueries-per-second. Second, the Google Cloud Operations console provides\npowerful tools for building custom graphs and also for setting up alerting. See\n[API Monitoring](/custom-search/v1/overview#monitoring) for more information."]]
