工具:update_merchant
更新现有商家的特定字段。支持的字段包括 display_name、mcc、corporate_website_url、customer_support_website_url、customer_support_email 和 customer_support_phone。
以下代码示例展示了如何使用 curl 调用 update_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": "update_merchant", "arguments": { // Provide these details according to the MCP tool specification. } }, "jsonrpc": "2.0", "id": 1 }' |
输入架构
请求更新商户的消息。
UpdateMerchantFacadeRequest
| JSON 表示法 |
|---|
{ "merchantId": string, // Union field |
| 字段 | |
|---|---|
merchantId |
必需。要更新的商家的商家 ID。 |
联合字段
|
|
displayName |
商家的显示名称。 |
联合字段
|
|
mcc |
商家的 MCC(商家类别代码)。 |
联合字段
|
|
corporateWebsiteUrl |
商家的企业网站。 |
联合字段
|
|
customerSupportWebsiteUrl |
商家的客户支持网站。 |
联合字段
|
|
customerSupportEmail |
商家的客户服务电子邮件地址。 |
联合字段
|
|
customerSupportPhone |
商家的客户支持电话。 |
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 |
政府所有的彩票(非美国地区) |
输出架构
针对 UpdateMerchant 的响应消息。
UpdateMerchantResponse
| JSON 表示法 |
|---|
{
"state": enum ( |
| 字段 | |
|---|---|
state |
更新后的商家的状态。 |
州
商家的状态。
| 枚举 | |
|---|---|
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,则该工具只能与内部实体互动。例如,网络搜索工具是开放世界工具,而内存工具不是开放世界工具。
破坏性提示:❌ | 等幂性提示:✅ | 只读提示:❌ | 开放世界提示:❌