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

필수 항목입니다. 판매자 비즈니스 위치의 지역 코드입니다. 형식은 유니코드 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인 경우 도구는 내부 항목과만 상호작용할 수 있습니다. 예를 들어 웹 검색 도구는 오픈 월드이지만 메모리 도구는 오픈 월드가 아닙니다.

파괴적 힌트: ❌ | 멱등성 힌트: ✅ | 읽기 전용 힌트: ✅ | 오픈 월드 힌트: ❌