REST Resource: inventory.partners.merchants

리소스: 판매자

애그리게이터의 플랫폼에 있는 판매자에 대한 정보입니다.

JSON 표현식 
{
  "name": string,
  "merchantName": string,
  "telephone": string,
  "url": string,
  "geo": {
    object (GeoCoordinates)
  },
  "category": string,
  "numBookings30d": string,
  "taxRateBasisPoints": integer,
  "taxRate": {
    object (TaxRate)
  },
  "paymentRestrictions": {
    object (PaymentRestrictions)
  },
  "paymentOption": [
    {
      object (PaymentOption)
    }
  ],
  "paymentProcessorConfig": {
    object (PaymentProcessorConfig)
  },
  "tokenizationConfig": {
    object (TokenizationConfig)
  },
  "terms": {
    object (Terms)
  },
  "brandId": string,
  "matchingHints": {
    object (MerchantMatchingHints)
  },
  "serviceAttribute": [
    {
      object (ServiceAttribute)
    }
  ],
  "actionLink": [
    {
      object (ActionLink)
    }
  ],
  "waitlistAdvisement": {
    object (Advisement)
  },
  "economicOperator": {
    object (EconomicOperator)
  }
}
필드
name

string

partners/{partner_id}/merchants/{merchantId} 형식의 판매자 리소스 이름입니다.
merchantName

string

merchantName, telephone, url 및 geo는 파트너 인벤토리를 Google 지도에 이미 존재하는 판매자와 매치시키는 데 사용됩니다. 이 정보는 표시되지 않습니다.

판매자의 이름입니다.
telephone

string

국가 및 지역 번호를 포함한 판매자의 공개 전화번호입니다(예: +14567891234입니다.
url

string

판매자의 공개 웹사이트 URL입니다.
geo

object (GeoCoordinates)

위도, 경도, 주소를 포함한 판매자의 지역 정보입니다.
category

string

애그리게이터 플랫폼의 비즈니스 카테고리입니다.
numBookings30d
(deprecated)

string (int64 format)

이 필드는 지원 중단되었습니다.
taxRateBasisPoints
(deprecated)

integer (uint32 format)

판매자의 1/100퍼센트(1퍼센트의 1/100) 세율입니다. 예를 들어 세율이 7.5%이면 이 필드를 750으로 설정해야 합니다.

이 필드를 설정하지 않거나 0으로 설정하면 이 판매자가 제공하는 모든 서비스에 대해 사용자에게 청구되는 총가격은 Service.price에서 지정된 가격과 일치합니다. 관련 세금은 면제되었거나 이미 서비스 가격에 포함된 것으로 간주됩니다. 세금이 사용자에게 별도의 항목으로 표시되지 않습니다.

이 필드가 0이 아닌 값으로 설정되면 이 판매자가 제공하는 모든 서비스에 대해 사용자에게 청구되는 총가격에는 서비스 가격과 여기에 제공된 세율을 사용하여 부과되는 세금이 포함됩니다. 최소 통화 단위의 소수 금액(예: 1센트의 소수점 이하 금액)은 오사오입 방식으로 반올림됩니다. 세금이 사용자에게 별도의 항목으로 표시됩니다.

이 필드는 지원 중단되었습니다. 대신 taxRate를 사용하세요.
taxRate

object (TaxRate)

판매자의 세율입니다. 이 필드가 있으면 지원 중단된 taxRateBasisPoints 필드가 재정의됩니다. 빈 메시지(taxRate { })는 적용된 세율을 0으로 재설정합니다.
paymentRestrictions

object (PaymentRestrictions)

이 판매자가 수락하는 결제 수단의 제한사항입니다. 이 필드가 설정되지 않으면 제한사항이 없는 것으로 간주됩니다.
paymentOption[]

object (PaymentOption)

이 판매자가 사용할 수 있는 결제 옵션입니다. 이 판매자의 서비스에 따라 허용되는 결제 옵션이 개별적으로 제한될 수 있습니다.
paymentProcessorConfig
(deprecated)

object (PaymentProcessorConfig)

판매자가 토큰화된 결제 대행업체를 지원하는 경우 해당 결제 대행업체의 구성입니다.
tokenizationConfig

object (TokenizationConfig)

판매자가 토큰화된 결제 대행업체를 지원하는 경우 해당 결제 대행업체의 구성입니다.
terms

object (Terms)

Google 예약을 통해 서비스를 예약할 때 사용자에게 표시되는 특정 판매자의 이용약관입니다. 이 이용약관 외에 애그리게이터 파트너의 이용약관은 항상 사용자에게 표시되며 여기에 제공해서는 안 됩니다.
brandId

string

파트너 저작자를 표시할 때 사용할 소비자 관련 브랜드를 나타내는 불투명 문자열입니다. 이 필드를 사용하면 소비자 관련 브랜드를 여러 개 보유한 파트너가 동일한 피드 내의 모든 브랜드에 판매자를 제공할 수 있습니다.

브랜드는 이름, 로고, 서비스 약관, 개인정보처리방침과 같은 소비자 관련 속성으로 구성됩니다.

소비자 관련 파트너 브랜드가 하나뿐인 경우 이 필드를 설정할 필요가 없으며 무시해도 됩니다.

파트너가...

보유한 소비자 관련 브랜드가 여러 개가 아닌 경우 --> 이 필드를 무시하세요.

구성된 브랜드를 여러 개 보유한 경우

  If this field is set
    --> Associated consumer-facing brand attribution is used

  If this field is unset or the empty string
    --> Default consumer-facing brand attribution is used

주의: 대부분의 파트너는 이 필드를 설정할 필요가 없습니다. 이 필드를 사용하려는 파트너는 먼저 Google에 문의하여 기본 브랜드를 포함해 별도의 브랜드를 구성해야 합니다.
matchingHints

object (MerchantMatchingHints)

Google이 판매자를 Google 지도의 장소와 매치시키는 데 도움이 되는 힌트입니다. 참고: Google에서 위에 제공된 정보를 사용하여 판매자를 Google 지도의 장소와 매치시키므로 대부분의 파트너는 이 필드를 설정할 필요가 없습니다. (선택사항)
serviceAttribute[]

object (ServiceAttribute)

이 판매자의 서비스를 설명하는 데 사용되는 모든 서비스 속성의 정의입니다. (선택사항)
waitlistAdvisement

object (Advisement)

선택사항입니다. Google 예약을 통해 대기자 명단에 등록하는 사용자에 대한 특정 판매자가 제공하는 일반적인 조언 알림의 개별 텍스트 필드는 길이가 100바이트로 제한되어야 합니다.
economicOperator

object (EconomicOperator)

선택사항입니다. 이 판매자와 연결된 경제 운영자 정보가 규제 준수를 위해 필요합니다. (선택사항)

PaymentRestrictions

이 판매자가 수락하는 결제 수단의 제한사항입니다.

JSON 표현식 
{
  "creditCardRestrictions": {
    object (CreditCardRestrictions)
  }
}
필드
creditCardRestrictions

object (CreditCardRestrictions)

이 판매자가 받는 신용카드의 제한사항입니다. 이 필드가 설정되지 않은 경우 모든 신용카드가 허용되는 것으로 가정합니다. CreditCardType에서 지원하는 신용카드 목록은 시간이 지남에 따라 늘어나므로 이 필드를 비워두면 나중에 구성이 변경됩니다.

CreditCardRestrictions

이 판매자가 받는 신용카드 유형의 제한사항입니다.

JSON 표현식 
{
  "creditCardType": [
    enum (CreditCardType)
  ]
}
필드
creditCardType[]

enum (CreditCardType)

지원되는 신용카드 목록입니다. 비어 있으면 신용카드가 지원되지 않습니다.

CreditCardType

신용카드 유형입니다.

열거형
CREDIT_CARD_TYPE_UNSPECIFIED 사용하지 않습니다.
VISA Visa 신용카드
MASTERCARD Mastercard 신용카드
AMERICAN_EXPRESS American Express 신용카드
DISCOVER Discover 신용카드
JCB JCB 신용카드

PaymentOption

판매자가 제공한 서비스의 비용을 결제하는 데 사용할 수 있는 결제 옵션입니다. 여러 판매자(예: 동일한 체인에 속한 판매자) 간에 결제 옵션을 공유할 수 있습니다.

JSON 표현식 
{
  "paymentOptionId": string,
  "name": string,
  "description": string,
  "price": {
    object (Price)
  },
  "taxRate": {
    object (TaxRate)
  },
  "paymentOptionType": enum (PaymentOptionType),
  "sessionCount": string,
  "purchaseInterval": {
    object (TimeRange)
  },
  "validInterval": {
    object (TimeRange)
  },
  "validDuration": string,
  "activationType": enum (ActivationType),
  "userRestriction": {
    object (UserPurchaseRestriction)
  }
}
필드
paymentOptionId

string

이 ID는 이 결제 옵션을 나타내는 데 사용됩니다.

이 ID는 애그리게이터 전체에 적용되며 여러 판매자 간에 값을 재사용하면 사용자가 여러 판매자에 걸쳐 해당 결제 옵션으로 결제할 수 있습니다.

여러 판매자 간에 ID를 재사용하는 경우 한 판매자의 결제 옵션 값을 업데이트하면 ID가 동일한 다른 판매자의 다른 결제 옵션도 업데이트됩니다. 따라서 결정되지 않은 행동이 발생하지 않도록 동일한 ID를 공유하는 모든 결제 옵션을 동일한 값으로 업데이트하는 것이 좋습니다.
name

string

결제 옵션의 이름입니다. 사용자가 볼 수 있습니다.
description

string

결제 옵션의 설명입니다. 사용자가 볼 수 있습니다.
price

object (Price)

결제 옵션의 가격입니다.
taxRate

object (TaxRate)

이 결제 옵션의 세율입니다. 이 필드가 있으면 판매자 또는 서비스에 있는 taxRate 필드가 재정의됩니다. 빈 메시지(taxRate { })는 적용된 세율을 0으로 재설정합니다.
paymentOptionType

enum (PaymentOptionType)

이 결제 옵션의 유형입니다. 예약 없이 방문한 경우 일회용, 패키지의 경우 다회용, 멤버십의 경우 무제한입니다.
sessionCount

string (int64 format)

이 결제 옵션을 사용할 수 있는 세션 수입니다. 값이 1보다 커야 하는 다중 세션/패키지에만 유효합니다.
purchaseInterval

object (TimeRange)

이 간격 내에 결제 옵션을 구매할 수 있습니다.
validInterval

object (TimeRange)

이 기간 내에서 결제 옵션을 구매할 수 있습니다(예: 2017년 1월 동안 특별 가격). 이 필드가 있으면 validDuration 및 activationType이 재정의됩니다.
validDuration

string (Duration format)

결제 옵션의 유효 기간입니다(예: 30일 멤버십).

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.
activationType

enum (ActivationType)

이 결제 옵션의 유효 기간 시작 날짜가 결정되는 방식을 정의합니다.
userRestriction

object (UserPurchaseRestriction)

결제 옵션을 구매할 수 있는 사용자를 제한합니다. 프로모션 결제 옵션을 일부 사용자로 제한하는 데 사용할 수 있습니다. 설정되지 않으면 모든 사용자가 사용할 수 있습니다.

PaymentOptionType

결제 옵션 유형입니다.

열거형
PAYMENT_OPTION_TYPE_UNSPECIFIED 사용하지 않습니다.
PAYMENT_OPTION_SINGLE_USE 결제 옵션은 한 번만 사용할 수 있습니다.
PAYMENT_OPTION_MULTI_USE 세션 수가 0보다 클 때 결제 옵션을 사용할 수 있습니다.
PAYMENT_OPTION_UNLIMITED 유효한 기간 내에 결제 옵션을 사용할 수 있습니다. 세션 수는 적용되지 않습니다.

ActivationType

유효 기간 시작 날짜가 결정되는 방법을 정의합니다.

열거형
ACTIVATION_TYPE_UNSPECIFIED 사용하지 않습니다.
ACTIVATION_ON_PURCHASE 구매한 시점에 유효 기간이 시작됩니다.
ACTIVATION_ON_FIRST_USE 결제 옵션이 처음 사용되는 경우 유효 기간이 시작됩니다.

UserPurchaseRestriction

결제 옵션을 구매할 수 있는 사용자를 제한합니다.

JSON 표현식 
{
  "newToMerchant": boolean,
  "newToPaymentOption": boolean
}
필드
newToMerchant

boolean

이전에 동일한 판매자로부터 구매한 적이 없는 사용자만 구매할 수 있는 결제 옵션입니다.
newToPaymentOption

boolean

이전에 동일한 결제 옵션을 구매한 적이 없는 사용자만 구매할 수 있는 결제 옵션입니다.

PaymentProcessorConfig

결제 대행업체 구성으로 판매자별로 설정됩니다.

JSON 표현식 
{
  "processor": enum (Processor),
  "publicKey": string,
  "version": string
}
필드
processor

enum (Processor)

이 구성이 적용되는 결제 대행업체 파트너를 정의합니다.
publicKey

string

결제 대행업체로 이 판매자를 나타내는 데 사용되는 키입니다.

Stripe의 경우 https://stripe.com/docs/dashboard#api-keys를, Braintree의 경우 https://articles.braintreepayments.com/control-panel/important-gateway-credentials를 참고하세요.
version

string

결제 요청과 함께 결제 대행업체에 전송되는 API 버전 번호입니다.

Processor

특정 결제 대행업체 파트너를 정의합니다.

열거형
PROCESSOR_UNSPECIFIED 사용하지 않습니다.
PROCESSOR_STRIPE Stripe를 사용한 결제 구성입니다.
PROCESSOR_BRAINTREE Braintree를 사용한 결제 구성입니다.

TokenizationConfig

결제 대행업체 토큰화 구성으로 판매자별로 설정됩니다.

JSON 표현식 
{
  "tokenizationParameter": {
    string: string,
    ...
  },
  "billingInformationFormat": enum (BillingInformationFormat)
}
필드
tokenizationParameter

map (key: string, value: string)

토큰화 구성에는 일반적으로 키가 'gateway'이고 값이 대행업체의 이름인 tokenizationParameter가 하나 있습니다.

나머지 매개변수는 대행업체에 따라 다릅니다. 자세한 내용은 Google Pay 문서를 참고하세요.

Braintree 예: tokenizationParameter { key: "gateway" value: "braintree" } tokenizationParameter { key: "braintree:apiVersion" value: "v1" } tokenizationParameter { key: "braintree:sdkVersion" value: "2.30.0" } tokenizationParameter { key: "braintree:merchantId" value: "abcdef" } tokenizationParameter { key: "braintree:clientKey" value: "production_xxx_yyy" }

Stripe 예: tokenizationParameter { key: "gateway" value: "stripe" } tokenizationParameter { key: "stripe:version" value: "2018-02-28" } tokenizationParameter { key: "stripe:publishableKey" value: "pk_1234" }

Adyen 예: tokenizationParameter { key: "gateway" value: "adyen" } tokenizationParameter { key: "gatewayMerchantId" value: "yourId" }

"key": value 쌍 목록이 포함된 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
billingInformationFormat

enum (BillingInformationFormat)

결제 토큰에 FOP와 함께 Google Pay에 입력된 사용자의 결제 정보를 포함합니다(위 참고). 필드를 비워두는 것은 MIN을 지정하는 것과 같습니다.

BillingInformationFormat

사용자에게 요구되는 청구서 수신 주소의 정도이며 토큰에 포함됩니다. 열거형 값은 Google Pay API의 매개변수에 해당합니다(https://developers.google.com/pay/api/web/reference/object#BillingAddressParameters 참고).

열거형
BILLING_INFORMATION_FORMAT_UNSPECIFIED 지정되지 않으며 기본값은 MIN입니다.
MIN 이름, 국가 코드, 우편번호(Google Pay 기본 설정)입니다.
FULL 이름, 상세 주소, 구/군/시, 주/도, 국가 코드, 우편번호입니다.

Terms

Google 예약을 통해 예약할 때 사용자에게 표시되는 규칙과 가이드라인의 집합입니다.

JSON 표현식 
{
  "url": string,
  "text": string,
  "localizedText": {
    object (Text)
  }
}
필드
url

string

이용약관의 URL입니다(선택사항).
text

string

사용자에게 표시될 텍스트입니다. 새 통합에는 아래의 localizedText를 사용하세요.
localizedText

object (Text)

사용자에게 표시될 현지화된 텍스트입니다.

MerchantMatchingHints

Google에서 판매자를 Google 지도의 장소와 매치시키는 데 사용되는 힌트입니다.

JSON 표현식 
{
  "placeId": string
}
필드
placeId

string

Google 지역 정보 데이터베이스 및 Google 지도에 있는 장소의 장소 ID입니다. 장소 ID에 관한 자세한 내용은 https://developers.google.com/places/web-service/place-id를 참고하세요.

ServiceAttribute

서비스 속성은 파트너가 정의한 카테고리로, 판매자의 서비스를 설명합니다. 예를 들어 은행에서는 '개인' 및 '비즈니스'의 가능한 값을 사용하여 '계정 유형' 서비스 속성을 정의하고 미용실에서는 '헤어컷', '염색' 및 '스타일링' 값으로 '서비스 유형' 서비스 속성을 정의할 수 있습니다.

JSON 표현식 
{
  "attributeId": string,
  "attributeName": string,
  "value": [
    {
      object (Value)
    }
  ]
}
필드
attributeId

string

동일한 판매자의 여러 서비스 속성 중에서 이 서비스 속성을 고유하게 식별하는 식별자입니다. 예: 'account-type'입니다.
attributeName

string

사용자에게 표시되는 이 속성의 이름입니다. 예: '계정 유형'을 선택합니다.
value[]

object (Value)

이 서비스 속성에 대해 가능한 모든 값입니다.

Value

특정 서비스 속성의 가능한 값을 나타냅니다.

JSON 표현식 
{
  "valueId": string,
  "valueName": string
}
필드
valueId

string

이 서비스 속성의 여러 값 가운데 이 값을 고유하게 나타내는 식별자입니다(예: 'personal').
valueName

string

사용자에게 표시되는 값의 이름입니다. 예: '개인'.

조언

Google 예약을 통해 예약할 때 사용자에게 표시되는 안내입니다.

JSON 표현 
{
  "text": {
    object (Text)
  }
}
필드
text

object (Text)

Google 예약을 통해 예약할 때 사용자에게 표시되는 맞춤 메시지입니다.

EconomicOperator

애그리게이터의 경제적 운영자 정보입니다.

JSON 표현 
{
  "text": {
    object (Text)
  }
}
필드
text

object (Text)

필수 항목입니다. 제조업체, 공인 대리인, 수입업체, 배급업체, 주문 처리 서비스 제공업체 또는 제품의 제조, 제공 또는 서비스 제공과 관련된 의무를 부담하는 기타 자연인 또는 법인으로 정의되는 경제 운영자의 이름, 주소, 전화번호, 이메일 주소입니다. economicOperator의 자유 형식 문자열 표현입니다. 이 정보는 ' "라고 질문합니다. 및 '\n'입니다.

메서드

create

 지정된 애그리게이터에서 관리하는 새 Merchant를 만들고 반환합니다.

delete

 지정된 애그리게이터에서 관리하는 기존 Merchant를 삭제합니다.

getStatus

 Merchant의 MerchantStatus를 가져옵니다.

patch

 지정된 애그리게이터에서 관리하는 기존 Merchant를 업데이트하고 반환합니다.