MCP Tools Reference: paydeveloper.googleapis.com

ツール: list_merchants

認証済みアカウントに関連付けられているすべての Google Pay 販売者の包括的なリストを取得します。販売者に対するユーザーのロールに応じて、管理者は販売者の詳細情報をすべて表示できますが、デベロッパーは販売者の基本情報のみを表示できます。

次のコードサンプルは、curl を使用して list_merchants MCP ツールを呼び出す方法を示しています。

Curl リクエスト 
curl --location 'https://paydeveloper.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_merchants",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

入力スキーマ

販売者のリスティングに対するリクエスト メッセージです。

ListMerchantsRequest

JSON 表現 
{
  "view": enum (MerchantView)
}
フィールド
view

enum (MerchantView)

省略可。販売者ごとに返される詳細情報のレベルを指定します。

MerchantView

販売者ごとに返される詳細情報のレベル。

列挙型
MERCHANT_VIEW_UNSPECIFIED デフォルト値 / 未設定値。API はデフォルトで BASIC ビューになります。
MERCHANT_VIEW_BASIC 販売者の基本情報を含めます。
MERCHANT_VIEW_FULL 販売者の詳細情報をすべて含めます。

出力スキーマ

販売者のリスティングに対するレスポンス メッセージです。

ListMerchantsResponse

JSON 表現 
{
  "merchants": [
    {
      object (Merchant)
    }
  ]
}
フィールド
merchants[]

object (Merchant)

ユーザーがアクセスできる販売者。

販売者

JSON 表現 
{
  "merchantId": string,
  "displayName": string,
  "regionCode": string,
  "mcc": enum (Mcc),
  "corporateWebsiteUrl": string,
  "customerSupportWebsiteUrl": string,
  "customerSupportEmail": string,
  "customerSupportPhone": string,
  "state": enum (State)
}
フィールド
merchantId

string

出力専用。販売者の一意の識別子。
displayName

string

必須。販売者の表示名。
regionCode

string

必須。販売者の店舗拠点の地域コード。形式は Unicode CLDR 地域コード（例: 「US」）です。インド（「IN」）はサポートされていません。
mcc

enum (Mcc)

必須。販売者の販売者カテゴリコード（MCC）。
corporateWebsiteUrl

string

必須。販売者の企業ウェブサイト。
customerSupportWebsiteUrl

string

必須。販売者のカスタマー サポートのウェブサイト。
customerSupportEmail

string

必須。販売者のカスタマー サポートのメールアドレス。
customerSupportPhone

string

必須。販売者のカスタマー サポートの電話番号。
state

enum (State)

出力専用。販売者のステータス。

Mcc

販売者の販売者カテゴリコード（MCC）。

列挙型
OTHERS その他
MISC_FOOD_STORES その他の食料品店 - コンビニエンス ストア、専門店
MISC_APPAREL その他のアパレル、アクセサリー ショップ
ARTISTS_SUPPLY 画材店、手芸店
AUTOMOTIVE_PARTS 自動車部品、アクセサリー店
HEALTH_AND_BEAUTY 健康美容製品販売店
BOOKS_PERIODICALS 書籍、定期刊行物、新聞
CAMERA_STORES カメラ、写真用品店
COMPUTERS_EQUIPMENT コンピュータ、コンピュータ周辺機器、ソフトウェア
COMPUTER_SOFTWARE コンピュータ ソフトウェア販売店
ELECTRONICS_SALES 電化製品の販売
GIFT_SHOPS カードショップ、ギフトショップ、ノベルティ ショップ、お土産店
EATING_PLACES 飲食できる場所、レストラン
MISC_GENERAL_MERCHANDISE その他の雑貨、日用品
HOME_SUPPLY 日用品のディスカウント ストア
COMPUTER_NETWORK_SERVICES コンピュータ ネットワーク サービス
DIGITAL_GOODS_MEDIA デジタル商品: 書籍、映画、音楽
DIGITAL_GOODS_GAMES デジタル商品: ゲーム
DIGITAL_GOODS_APPLICATIONS デジタル商品: アプリケーション（ゲームを除く）
POLITICAL_ORGANIZATIONS 政治団体
CHARITABLE_ORGANIZATIONS 慈善団体、社会福祉団体
DRUG_STORES ドラッグストアと薬局
REAL_ESTATE_RENTALS 不動産業者と不動産経営 - 賃貸
MISC_PERSONAL_SERVICES その他の個人サービス（他に分類されているもの以外）
SPORTING_GOODS スポーツ用品店
STATIONERY_OFFICE_SUPPLIES 文房具、事務用品、印刷用紙、筆記用紙
THEATRICAL_TICKET_AGENCIES 劇場チケット販売業者
TIMESHARES タイムシェア
TOURIST_ATTRACTIONS 観光スポット、展示会
HOBBY_TOY_GAME_SHOPS ホビー、おもちゃ、ゲーム ショップ
PET_SHOPS ペットショップ、ペットフード、ペット用品店
OTHER_LODGING その他の宿泊施設 - ホテル、モーテル、リゾート
TELECOMMUNICATION_SERVICES 通信サービス
TRANSPORTATION_SERVICES 輸送機関
OTHER_AIRLINES その他の航空会社
TRAVEL_AGENCIES 旅行代理店、ツアーガイド
GOVERNMENT_OWNED_LOTTERIES_US 公営宝くじ（米国リージョンのみ）
GOVERNMENT_LICENSED_CASINOS_US 政府認可のオンライン カジノ（オンライン ギャンブル）（米国地域のみ）
BETTING 賭博（宝くじ、カジノゲームのチップ、場外馬券、賭け金を含む）
GOVERNMENT_OWNED_LOTTERIES_NON_US 公営宝くじ（米国以外の地域）

州

販売者のステータス。

列挙型
STATE_UNSPECIFIED 販売者のステータスが未設定です。
VERIFIED 販売者の身元確認が完了し、承認されています。
IN_REVIEW 販売者のプロフィール編集が審査中です。
REJECTED 販売者のプロフィール編集が不承認となりました。
INCOMPLETE_SIGNUP 販売者のプロフィールが不完全です。
SANCTIONS_HIT 販売者のプロフィールが制裁措置に該当しています。
READY_FOR_REVIEW 販売者のプロフィールが完成し、審査の準備ができました。
DISABLED 販売者のプロフィールが無効/無効になっています。

ツールのアノテーション

ツールのアノテーションは、特定のツールの基本的なリスクを説明するために MCP クライアントに送信されます。ほとんどのクライアントはこれらのヒントを信頼できないものとして扱いますが、確認プロンプトをユーザーに送信するタイミングを判断するために使用できます。

タイトル文字列とともに、次のブール値のヒントが次のように定義されています。

  • readOnlyHint: true の場合、ツールはその環境を変更しません。デフォルトは false です。
  • destructiveHint: true の場合、ツールは破壊的なアクションを実行できます。false の場合、ツールは追加アクションのみを実行できます。デフォルト値は true です。
  • idempotentHint: true の場合、同じ引数でツールを繰り返し呼び出しても、環境に影響はありません。デフォルトは false です。
  • openWorldHint: true の場合、ツールは外部エンティティの「オープン ワールド」とやり取りできます。false の場合、ツールは内部エンティティとのみやり取りできます。たとえば、ウェブ検索ツールはオープン ワールドですが、メモリツールはオープン ワールドではありません。

破壊的ヒント: ❌ | べき等ヒント: ✅ | 読み取り専用ヒント: ✅ | オープン ワールド ヒント: ❌