MCP Tools Reference: paydeveloper.googleapis.com

Công cụ: update_merchant

Cập nhật một số trường của người bán hiện có. Các trường được hỗ trợ bao gồm display_name, mcc, corporate_website_url, customer_support_website_url, customer_support_email và customer_support_phone.

Mã mẫu sau đây cho biết cách sử dụng curl để gọi công cụ update_merchant MCP.

Yêu cầu 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
}'

Giản đồ đầu vào

Thông báo yêu cầu cho UpdateMerchant.

UpdateMerchantFacadeRequest

Biểu diễn dưới dạng JSON
{
  "merchantId": string,

  // Union field _display_name can be only one of the following:
  "displayName": string
  // End of list of possible types for union field _display_name.

  // Union field _mcc can be only one of the following:
  "mcc": enum (Mcc)
  // End of list of possible types for union field _mcc.

  // Union field _corporate_website_url can be only one of the following:
  "corporateWebsiteUrl": string
  // End of list of possible types for union field _corporate_website_url.

  // Union field _customer_support_website_url can be only one of the following:
  "customerSupportWebsiteUrl": string
  // End of list of possible types for union field _customer_support_website_url.

  // Union field _customer_support_email can be only one of the following:
  "customerSupportEmail": string
  // End of list of possible types for union field _customer_support_email.

  // Union field _customer_support_phone can be only one of the following:
  "customerSupportPhone": string
  // End of list of possible types for union field _customer_support_phone.
}
Trường
merchantId

string

Bắt buộc. Mã người bán của người bán cần cập nhật.

Trường nhóm _display_name.

_display_name chỉ có thể là một trong những trạng thái sau:

displayName

string

Tên hiển thị của người bán.

Trường nhóm _mcc.

_mcc chỉ có thể là một trong những trạng thái sau:

mcc

enum (Mcc)

MCC (Mã danh mục của người bán) của người bán.

Trường nhóm _corporate_website_url.

_corporate_website_url chỉ có thể là một trong những trạng thái sau:

corporateWebsiteUrl

string

Trang web doanh nghiệp của người bán.

Trường nhóm _customer_support_website_url.

_customer_support_website_url chỉ có thể là một trong những trạng thái sau:

customerSupportWebsiteUrl

string

Trang web hỗ trợ khách hàng của người bán.

Trường nhóm _customer_support_email.

_customer_support_email chỉ có thể là một trong những trạng thái sau:

customerSupportEmail

string

Email hỗ trợ khách hàng của người bán.

Trường nhóm _customer_support_phone.

_customer_support_phone chỉ có thể là một trong những trạng thái sau:

customerSupportPhone

string

Số điện thoại của bộ phận hỗ trợ khách hàng của người bán.

Mcc

Mã danh mục của người bán (MCC) của một người bán.

Enum
OTHERS Khác
MISC_FOOD_STORES Cửa hàng thực phẩm khác – Cửa hàng tiện lợi và chợ đặc sản
MISC_APPAREL Cửa hàng quần áo và phụ kiện khác
ARTISTS_SUPPLY Cửa hàng bán đồ dùng cho nghệ sĩ và đồ thủ công
AUTOMOTIVE_PARTS Cửa hàng phụ tùng và phụ kiện ô tô
HEALTH_AND_BEAUTY Cửa hàng chăm sóc sức khỏe và làm đẹp
BOOKS_PERIODICALS Sách, tạp chí và báo
CAMERA_STORES Cửa hàng bán máy ảnh và thiết bị chụp ảnh
COMPUTERS_EQUIPMENT Máy tính, Thiết bị ngoại vi cho máy tính, Phần mềm
COMPUTER_SOFTWARE Cửa hàng phần mềm máy tính
ELECTRONICS_SALES Bán đồ điện tử
GIFT_SHOPS Cửa hàng bán thẻ, quà tặng, đồ lưu niệm và đồ chơi
EATING_PLACES Địa điểm ăn uống và nhà hàng
MISC_GENERAL_MERCHANDISE Hàng hoá chung khác
HOME_SUPPLY Cửa hàng bán buôn đồ gia dụng
COMPUTER_NETWORK_SERVICES Dịch vụ mạng máy tính
DIGITAL_GOODS_MEDIA Hàng hoá kỹ thuật số: Sách, Phim, Nhạc
DIGITAL_GOODS_GAMES Hàng hoá kỹ thuật số: Trò chơi
DIGITAL_GOODS_APPLICATIONS Hàng hoá kỹ thuật số: Ứng dụng (Không bao gồm trò chơi)
POLITICAL_ORGANIZATIONS Tổ chức chính trị
CHARITABLE_ORGANIZATIONS Tổ chức từ thiện và tổ chức dịch vụ xã hội
DRUG_STORES Quầy thuốc và hiệu thuốc
REAL_ESTATE_RENTALS Đại lý và người quản lý bất động sản – Cho thuê
MISC_PERSONAL_SERVICES Các dịch vụ cá nhân khác, không được phân loại ở nơi khác
SPORTING_GOODS Cửa hàng đồ thể thao
STATIONERY_OFFICE_SUPPLIES Văn phòng phẩm, Vật tư văn phòng, Giấy in và giấy viết
THEATRICAL_TICKET_AGENCIES Công ty bán vé xem phim
TIMESHARES Chia thời gian
TOURIST_ATTRACTIONS Điểm du lịch và triển lãm
HOBBY_TOY_GAME_SHOPS Cửa hàng đồ chơi, trò chơi và đồ theo sở thích
PET_SHOPS Cửa hàng thú cưng, cửa hàng thức ăn và đồ dùng cho thú cưng
OTHER_LODGING Chỗ ở khác – Khách sạn, Nhà nghỉ ven đường, Khu nghỉ dưỡng
TELECOMMUNICATION_SERVICES Dịch vụ viễn thông
TRANSPORTATION_SERVICES Dịch vụ vận tải
OTHER_AIRLINES Các hãng hàng không khác
TRAVEL_AGENCIES Đại lý du lịch và công ty du lịch
GOVERNMENT_OWNED_LOTTERIES_US Xổ số do chính phủ sở hữu (chỉ ở vùng Hoa Kỳ)
GOVERNMENT_LICENSED_CASINOS_US Sòng bạc trực tuyến được chính phủ cấp phép (Cờ bạc trực tuyến) (Chỉ ở khu vực Hoa Kỳ)
BETTING Cá cược (bao gồm cả Vé số, Phỉnh sòng bạc, Cá cược bên ngoài trường đua và Tiền cược)
GOVERNMENT_OWNED_LOTTERIES_NON_US Xổ số do chính phủ sở hữu (Khu vực không thuộc Hoa Kỳ)

Giản đồ đầu ra

Thông báo phản hồi cho UpdateMerchant.

UpdateMerchantResponse

Biểu diễn dưới dạng JSON
{
  "state": enum (State)
}
Trường
state

enum (State)

Trạng thái của người bán đã cập nhật.

Tiểu bang

Trạng thái của người bán.

Enum
STATE_UNSPECIFIED Trạng thái của người bán chưa được chỉ định.
VERIFIED Người bán đã được xác minh và phê duyệt.
IN_REVIEW Nội dung chỉnh sửa hồ sơ người bán đang được xem xét.
REJECTED Nội dung chỉnh sửa trang doanh nghiệp của người bán bị từ chối.
INCOMPLETE_SIGNUP Hồ sơ người bán chưa hoàn chỉnh.
SANCTIONS_HIT Hồ sơ người bán bị ảnh hưởng bởi các lệnh trừng phạt.
READY_FOR_REVIEW Hồ sơ người bán đã hoàn tất và sẵn sàng để xem xét.
DISABLED Hồ sơ người bán bị vô hiệu hoá/không hoạt động.

Chú giải công cụ

Chú thích công cụ được gửi đến các ứng dụng MCP để mô tả rủi ro cơ bản của một công cụ nhất định. Hầu hết các ứng dụng đều coi những gợi ý này là không đáng tin cậy, nhưng bạn có thể dùng chúng để quyết định thời điểm gửi lời nhắc xác nhận cho người dùng.

Cùng với chuỗi tiêu đề, các gợi ý boolean sau đây được xác định như sau:

  • readOnlyHint: Nếu đúng, công cụ sẽ không sửa đổi môi trường của công cụ. Mặc định: false.
  • destructiveHint: Nếu đúng, công cụ có thể thực hiện các hành động phá huỷ. Nếu là false, thì công cụ chỉ có thể thực hiện các thao tác bổ sung. Mặc định: true.
  • idempotentHint: Nếu đúng, thì việc gọi công cụ nhiều lần với cùng một đối số sẽ không có thêm tác động nào đến môi trường của công cụ. Mặc định: false.
  • openWorldHint: Nếu đúng, công cụ này có thể tương tác với "thế giới mở" của các thực thể bên ngoài. Nếu là false, thì công cụ chỉ có thể tương tác với các thực thể nội bộ. Ví dụ: một công cụ tìm kiếm trên web sẽ là thế giới mở, trong khi một công cụ bộ nhớ sẽ không phải là thế giới mở.

Gợi ý mang tính phá hoại: ❌ | Gợi ý mang tính bất biến: ✅ | Gợi ý chỉ đọc: ❌ | Gợi ý thế giới mở: ❌