REST Resource: inventory.partners.merchants

{
  "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)
  }
}

string

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

string

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

판매자의 이름입니다.

string

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

string

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

object (GeoCoordinates)

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

string

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

string (int64 format)

이 필드는 지원 중단되었습니다.

integer (uint32 format)

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

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

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

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

object (TaxRate)

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

object (PaymentRestrictions)

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

object (PaymentOption)

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

object (PaymentProcessorConfig)

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

object (TokenizationConfig)

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

object (Terms)

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

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에 문의하여 기본 브랜드를 포함해 별도의 브랜드를 구성해야 합니다.

object (MerchantMatchingHints)

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

object (ServiceAttribute)

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

object (ActionLink)

선택사항입니다. 연결된 언어, 제한된 국가 목록, 유형, 이 작업을 실행해야 하는 플랫폼을 나타내는 플랫폼(선택사항)이 포함된 작업 URL

object (Advisement)

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

{
  "creditCardRestrictions": {
    object (CreditCardRestrictions)
  }
}

object (CreditCardRestrictions)

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

{
  "creditCardType": [
    enum (CreditCardType)
  ]
}

enum (CreditCardType)

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

{
  "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)
  }
}

string

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

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

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

string

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

string

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

object (Price)

결제 옵션의 가격입니다.

object (TaxRate)

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

enum (PaymentOptionType)

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

string (int64 format)

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

object (TimeRange)

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

object (TimeRange)

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

string (Duration format)

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

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

enum (ActivationType)

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

object (UserPurchaseRestriction)

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

{
  "newToMerchant": boolean,
  "newToPaymentOption": boolean
}

boolean

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

boolean

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

{
  "processor": enum (Processor),
  "publicKey": string,
  "version": string
}

enum (Processor)

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

string

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

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

string

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

{
  "tokenizationParameter": {
    string: string,
    ...
  },
  "billingInformationFormat": enum (BillingInformationFormat)
}

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" }

enum (BillingInformationFormat)

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

{
  "url": string,
  "text": string,
  "localizedText": {
    object (Text)
  }
}

string

이용약관의 URL(선택사항)

string

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

object (Text)

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

{
  "placeId": string
}

string

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

{
  "attributeId": string,
  "attributeName": string,
  "value": [
    {
      object (Value)
    }
  ]
}

string

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

string

사용자에게 표시되는 이 속성의 이름입니다(예: '계정 유형').

object (Value)

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

{
  "valueId": string,
  "valueName": string
}

string

이 서비스 속성의 다른 값 중에서 이 값을 고유하게 식별하는 식별자입니다(예: 'personal').

string

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

{
  "text": {
    object (Text)
  }
}

object (Text)

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