MCP Tools Reference: paydeveloper.googleapis.com

ツール: create_merchant

認証済みアカウントで新しい販売者を作成します。販売者を作成するために必要な情報をユーザーに提供してもらう必要があります。必須フィールドの 1 つに販売者カテゴリコード（MCC）があります。MCC のリストは長いため、一般的なオプションのサブセットを表示してもかまいませんが、他のオプションも利用可能であること、完全なリストをリクエストできることをユーザーに伝える必要があります（「他のオプションを表示」などのヒントを表示するなど）。また、4 桁の MCC コード（5499 など）をすでに知っている場合は、直接入力できることも伝え、入力するよう促します。販売者を作成するために必要な情報を収集するまで、このツールを呼び出さないでください。販売者が作成されたら、Business Console の利用規約の URL をユーザーに提示し、この販売者に対して操作を行う前に同意するよう指示する必要があります。

次のコードサンプルは、curl を使用して create_merchant 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": "create_merchant",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

入力スキーマ

CreateMerchant に対するリクエスト メッセージです。

CreateMerchantRequest

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

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 販売者のプロフィールが無効または非アクティブになっています。

出力スキーマ

CreateMerchant に対するレスポンス メッセージです。

CreateMerchantResponse

JSON 表現 
{
  "merchantId": string,
  "state": enum (State),
  "businessConsoleTosUrl": string
}
フィールド
merchantId

string

作成された販売者の販売者 ID。
state

enum (State)

作成された販売者の状態。
businessConsoleTosUrl

string

出力専用。Business Console の利用規約の URL。販売者に対して操作を行うには、Business Console の利用規約に同意する必要があります。

州

販売者の状態。

列挙型
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 の場合、ツールは内部エンティティとのみやり取りできます。たとえば、ウェブ検索ツールはオープン ワールドですが、メモリツールはオープン ワールドではありません。

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