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

ระดับรายละเอียดที่จะแสดงสำหรับผู้ขายแต่ละราย

Enum
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) ของผู้ขาย

Enum
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 ล็อตเตอรี่ที่รัฐบาลเป็นเจ้าของ (ภูมิภาคที่ไม่ใช่สหรัฐอเมริกา)

รัฐ

สถานะของผู้ขาย

Enum
STATE_UNSPECIFIED ไม่ได้ระบุสถานะผู้ขาย
VERIFIED ผู้ขายได้รับการยืนยันและอนุมัติแล้ว
IN_REVIEW การแก้ไขโปรไฟล์ผู้ขายอยู่ระหว่างตรวจสอบ
REJECTED การแก้ไขโปรไฟล์ผู้ขายถูกปฏิเสธ
INCOMPLETE_SIGNUP โปรไฟล์ผู้ขายไม่สมบูรณ์
SANCTIONS_HIT โปรไฟล์ผู้ขายถูกคว่ำบาตร
READY_FOR_REVIEW โปรไฟล์ผู้ขายเสร็จสมบูรณ์และพร้อมให้ตรวจสอบแล้ว
DISABLED โปรไฟล์ผู้ขายถูกปิดใช้/ไม่มีการใช้งาน

คำอธิบายประกอบเครื่องมือ

คำอธิบายประกอบเครื่องมือจะส่งไปยังไคลเอ็นต์ MCP เพื่ออธิบายความเสี่ยงพื้นฐานของเครื่องมือที่ระบุ ไคลเอ็นต์ส่วนใหญ่จะถือว่าคำแนะนำเหล่านี้ไม่น่าเชื่อถือ แต่สามารถใช้เพื่อตัดสินใจว่าจะส่งข้อความแจ้งการยืนยันให้ผู้ใช้เมื่อใด

นอกจากสตริงชื่อแล้ว คำแนะนำบูลีนต่อไปนี้จะได้รับการกำหนดดังนี้

  • readOnlyHint: หากเป็นจริง เครื่องมือจะไม่แก้ไขสภาพแวดล้อม ค่าเริ่มต้น: เท็จ
  • destructiveHint: หากเป็นจริง เครื่องมือจะดำเนินการที่ทำลายข้อมูลได้ หากเป็นเท็จ เครื่องมือจะดำเนินการได้เฉพาะการดำเนินการเพิ่มเติมเท่านั้น ค่าเริ่มต้น: จริง
  • idempotentHint: หากเป็นจริง การเรียกใช้เครื่องมือซ้ำๆ ด้วยอาร์กิวเมนต์เดียวกันจะไม่ส่งผลกระทบเพิ่มเติมต่อสภาพแวดล้อมของเครื่องมือ ค่าเริ่มต้น: เท็จ
  • openWorldHint: หากเป็นจริง เครื่องมือจะโต้ตอบกับ "โอเพนเวิลด์" ของเอนทิตีภายนอกได้ หากเป็นเท็จ เครื่องมือจะโต้ตอบกับเอนทิตีภายในเท่านั้น ตัวอย่างเช่น เครื่องมือค้นหาเว็บจะเป็นแบบโอเพนเวิลด์ แต่เครื่องมือความทรงจำจะไม่ใช่แบบโอเพนเวิลด์

คำใบ้ที่ทำลาย: ❌ | คำใบ้ที่ทำซ้ำได้: ✅ | คำใบ้แบบอ่านอย่างเดียว: ✅ | คำใบ้แบบโลกเปิด: ❌