SerpApi (プレビュー)

このコネクタは、次の製品とリージョンで使用できます。

Service	クラス	Regions
コピロット スタジオ	Premium	次を除くすべての Power Automate リージョン :      - 米国政府 (GCC)      - 米国政府 (GCC High)      - 21Vianet が運営する China Cloud      - 米国国防総省 (DoD)
ロジック アプリ	Standard	次を除くすべての Logic Apps リージョン :      - Azure Government リージョン      - 中国リージョンAzure      - 米国国防総省 (DoD)
Power Apps	Premium	次を除くすべての Power Apps リージョン :      - 米国政府 (GCC)      - 米国政府 (GCC High)      - 21Vianet が運営する China Cloud      - 米国国防総省 (DoD)
Power Automate（パワーオートメート）	Premium	次を除くすべての Power Automate リージョン :      - 米国政府 (GCC)      - 米国政府 (GCC High)      - 21Vianet が運営する China Cloud      - 米国国防総省 (DoD)

お問い合わせ
名前	SerpApi
URL	https://serpapi.com
Email	support@serpapi.com

コネクタ メタデータ
パブリッシャー	SerpApi
Web サイト	https://serpapi.com
プライバシー ポリシー	https://serpapi.com/legal/privacy
Categories	ウェブサイト;ビジネス インテリジェンス

SerpApi

SerpApi は、リアルタイム検索エンジンの結果 API です。 プロキシ、CAPTCHA、解析を処理するため、Power AppsフローとPower Automate フローは、スクレイピング インフラストラクチャを管理することなく、クリーンで構造化された JSON を受け取ります。

Publisher: SerpApi

前提条件

• SerpApi アカウント。 serpapi.com でサインアップします。
• 有効な SerpApi API キー。 無料プランには、1 か月あたり 250 件の検索が含まれます。 有料プランは、より多くのボリュームで利用できます。

サポートされている操作

Google Search (GoogleSearch)

特定のクエリの構造化された Google 検索結果を取得します。 オーガニックな結果、広告、ナレッジ グラフ エントリ、関連する質問、ローカルの結果、上位のストーリーなどを返します。 返される正確なフィールドは、クエリと Google が表示する内容によって異なります。

場所の取得 (GetLocations)

検索の location パラメーターに渡すことができる、サポートされている地理的な場所の一覧を返します。 検索を実行する前に、市区町村または地域の正確な場所の文字列を検索する場合に使用します。

アカウント情報の取得 (GetAccount)

現在のプラン、毎月の検索クォータ、残りの検索、1 時間ごとの使用状況の統計情報など、SerpApi アカウントに関する情報を返します。

資格情報の取得

1. serpapi.com で SerpApi アカウントにサインインします。
2. serpapi.com/manage-api-key に移動します。
3. API キーをコピーします。
4. Power AppsまたはPower Automateで接続を作成する場合は、API キーを [API キー] フィールドに貼り付けます。

API キーは Power Platform によって安全に格納され、すべての要求に自動的に挿入されます。 接続のセットアップ後に、もう一度指定する必要はありません。

はじめに

基本的な使用方法

GoogleSearchアクションは、1 つの必須引数 (検索クエリ) と追加パラメーターの省略可能なレコードを受け取ります。

Set(varJsonResponse, SerpApi.GoogleSearch("coffee"))

デバッグ用の HTML テキスト コントロールに生の JSON 応答を表示するには:

$"<pre>{JSON(varJsonResponse, JSONFormat.IndentFour)}</pre>"

省略可能なパラメーターの渡し

省略可能なパラメーターは、レコード (2 番目の引数) として渡されます。 設定するパラメーターのみを含めます。キーを省略すると、そのパラメーターに対して何も送信されません。SerpApi は独自の既定値を使用できます。

次の例では、入力の種類と名前は必須ではなく推奨事項です。

Set(varJsonResponse, SerpApi.GoogleSearch(
    searchQueryInput.Text,
    {
        location: locationInput.Text,
        gl: glInput.Text,
        hl: hlInput.Text,
        lat: latInput.Text,
        lon: lonInput.Text,
        radius: radiusInput.Text,
        uule: uuleInput.Text,
        google_domain: googleDomainInput.Text,
        cr: crInput.Text,
        lr: lrInput.Text,
        tbs: tbsInput.Text,
        nfpr: nfprCheckbox.Value,
        filter: filterCheckbox.Value,
        safe: safeDropdown.Selected.Value,
        device: deviceDropdown.Selected.Value,
        tbm: tbmDropdown.Selected.Value,
        start: startInput.Text,
        ludocid: ludocidInput.Text,
        lsig: lsigInput.Text,
        kgmid: kgmidInput.Text,
        si: siInput.Text,
        ibp: ibpInput.Text,
        uds: udsInput.Text,
        no_cache: noCacheCheckbox.Value
    }
))

コントロール型のマッピング:

パラメーターのタイプ	推奨されるPower Appsコントロール	値の参照
テキスト (文字列)	テキスト入力	controlName.Text
ブール値	トグルまたはチェックボックス	controlName.Value
列挙型 (固定オプション)	ドロップダウン	controlName.Selected.Value
Number	テキスト入力	controlName.Text

応答データへのアクセス

応答は JSON オブジェクトです。 最上位のプロパティに変数から直接アクセスします。

varJsonResponse.search_information.total_results

ギャラリーを有機的な結果にバインドするには:

varJsonResponse.organic_results

ギャラリーをローカルビジネスの結果にバインドするには:

varJsonResponse.local_results.places

応答フィールドの完全な一覧については、 SerpApi Google Search のドキュメント を参照してください。

有効な場所の文字列を検索する

GetLocationsを使用して、GoogleSearchに渡す正確な場所の名前を見つけます。 qパラメーターは、市区町村名または地域名でフィルター処理し、limit返される結果の数を制限します。

Set(varLocations, SerpApi.GetLocations("Austin", {limit: 5}))

結果をギャラリーにバインドするには:

varLocations

コレクション内の各項目には、 name、 canonical_name、 country_code、 target_type、 reach、 gps の各フィールドがあります。 後続のGoogleSearch呼び出しで、canonical_name値を location パラメーターとして渡します。

Set(varResults, SerpApi.GoogleSearch(
    "coffee shops",
    {location: locationGallery.Selected.canonical_name}
))

アカウントの使用状況の確認

GetAccountを使用して、現在のプランの詳細とクォータの使用状況を取得します。 これは、毎月の制限に達する前に、残っている検索の数を確認するのに役立ちます。

Set(varAccount, SerpApi.GetAccount())

応答から個々のフィールドにアクセスします。

varAccount.plan_searches_left
varAccount.this_month_usage
varAccount.account_rate_limit_per_hour

応答フィールドの完全な一覧については、 SerpApi アカウント API のドキュメント を参照してください。

既知の問題と制限事項

• 可変応答構造: Google Search の応答に存在するフィールドは、クエリと Google が返す内容によって異なります。 すべてのフィールドがすべての応答に表示されるわけではありません。 可能な応答フィールドの詳細については、 SerpApi Google Search のドキュメント を参照してください。
• レート制限: 要求には、SerpApi プランの毎月のクォータと時間単位のレート制限が適用されます。 いずれかを超えると、 429 エラー応答が発生します。
• キャッシュされた結果: 既定では、SerpApi は、各ユーザーに固有の重複する要求 (最大 1 時間前) のキャッシュからの結果を提供します。 no_cache パラメーターを使用して、強制的に新しい結果を生成します。 キャッシュされた検索は、毎月のクォータにはカウントされないことに注意してください。

Support

このコネクタまたは SerpApi アカウントのヘルプについては、SerpApi サポート チームにお問い合わせください。

• Email:contact@serpapi.com
• ライブ チャット: serpapi.com で 24 時間 365 日利用可能。SerpApi サポート チームのメンバーと直接話すことができます。

接続を作成する

コネクタでは、次の認証の種類がサポートされています。

デフォルト	接続を作成するためのパラメーター。	すべてのリージョン	共有不可

デフォルト

適用対象: すべてのリージョン

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

名前	タイプ	説明	必須
API キー	securestring	SerpApi API キー。 検索する https://serpapi.com/manage-api-key	True

アクション

Google Search	特定のクエリの構造化された Google 検索結果を取得します。 オーガニックの結果、広告、ナレッジ グラフ、関連する質問、上位のストーリー、ローカルの結果などを返します。
アカウント情報の取得	プランの詳細、残りの検索、使用状況の統計情報など、認証済みの SerpApi アカウントに関する情報を返します。
場所を取得する	検索で location パラメーターと共に使用できる、サポートされている地理的な場所の一覧を返します。 市区町村または地域の正確な場所の文字列を見つける場合に便利です。

Google Search

アカウント情報の取得

場所を取得する

定義

ロケーション

アカウント情報