MCP Tools Reference: paydeveloper.googleapis.com

도구: 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
}'

입력 스키마

UpdateMerchant 요청 메시지입니다.

UpdateMerchantFacadeRequest

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.
}
필드
merchantId

string

필수 항목입니다. 업데이트할 판매자의 판매자 ID입니다.

통합 필드 _display_name.

_display_name는 다음 중 하나여야 합니다.
displayName

string

판매자의 표시 이름입니다.

통합 필드 _mcc.

_mcc는 다음 중 하나여야 합니다.
mcc

enum (Mcc)

판매자의 MCC (판매자 카테고리 코드)입니다.

통합 필드 _corporate_website_url.

_corporate_website_url는 다음 중 하나여야 합니다.
corporateWebsiteUrl

string

판매자의 회사 웹사이트입니다.

통합 필드 _customer_support_website_url.

_customer_support_website_url는 다음 중 하나여야 합니다.
customerSupportWebsiteUrl

string

판매자의 고객 지원 웹사이트입니다.

통합 필드 _customer_support_email.

_customer_support_email는 다음 중 하나여야 합니다.
customerSupportEmail

string

판매자의 고객 지원 이메일 주소입니다.

통합 필드 _customer_support_phone.

_customer_support_phone는 다음 중 하나여야 합니다.
customerSupportPhone

string

판매자의 고객 지원 전화번호입니다.

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

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인 경우 도구는 내부 항목과만 상호작용할 수 있습니다. 예를 들어 웹 검색 도구는 오픈 월드이지만 메모리 도구는 오픈 월드가 아닙니다.

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