REST Resource: inventory.partners.merchants.services

리소스: 서비스

판매자가 제공하는 서비스에 대한 정보입니다(예: 헤어컷).

JSON 표현 
{
  "name": string,
  "serviceName": string,
  "localizedServiceName": {
    object (Text)
  },
  "description": string,
  "localizedDescription": {
    object (Text)
  },
  "price": {
    object (Price)
  },
  "priceInterpretation": enum (PriceInterpretation),
  "rules": {
    object (SchedulingRules)
  },
  "prepaymentType": enum (PrepaymentType),
  "prepaymentTerms": {
    object (PrepaymentTerms)
  },
  "form": [
    {
      object (ServiceIntakeForm)
    }
  ],
  "intakeForm": {
    object (ServiceIntakeForm)
  },
  "perTicketIntakeForm": {
    object (ServiceIntakeForm)
  },
  "taxRate": {
    object (TaxRate)
  },
  "paymentOptionId": [
    string
  ],
  "deposit": {
    object (Deposit)
  },
  "noShowFee": {
    object (NoShowFee)
  },
  "requireCreditCard": enum (RequireCreditCard),
  "actionLink": [
    {
      object (ActionLink)
    }
  ],
  "type": enum (ServiceType),
  "ticketType": [
    {
      object (TicketType)
    }
  ],
  "relatedMedia": [
    {
      object (RelatedMedia)
    }
  ],
  "serviceAttributeValueId": [
    {
      object (ServiceAttributeValueId)
    }
  ],
  "waitlistRules": {
    object (WaitlistRules)
  },
  "ticketingVerticalSpecificData": {
    object (TicketingVerticalSpecificData)
  },
  "integrationType": enum (IntegrationType),
  "perOrderFee": {
    object (PerOrderFee)
  },
  "toursAndActivitiesContent": {
    object (ToursAndActivitiesContent)
  },
  "location": [
    {
      object (Location)
    }
  ],
  "rating": {
    object (Rating)
  },
  "homeServiceData": {
    object (HomeServiceData)
  },
  "virtualSession": {
    object (VirtualSession)
  },
  "directMerchantPayment": {
    object (DirectMerchantPayment)
  },
  "uriTemplate": {
    object (UriTemplate)
  }
}
필드
name

string

partners/{partner_id}/merchants/{merchantId}/services/{serviceId} 형식의 서비스 리소스 이름입니다.
serviceName

string

서비스 이름입니다(예: '남성 헤어컷'). 지원 중단되었습니다. 대신 localizedServiceName을 사용하세요.
localizedServiceName

object (Text)

서비스 이름입니다(예: '남성 헤어컷'). 아마도 여러 언어로 표시됩니다.
description

string

사용자에게 표시되는 서비스 설명입니다. 지원 중단되었습니다. 대신 localizedDescription을 사용하세요.
localizedDescription

object (Text)

사용자에게 표시되는 서비스 설명입니다.

이 필드에는 일반 텍스트와 HTML 형식을 모두 입력할 수 있습니다. 일반 텍스트 섹션과 달리 여기에서는 제목, 단락, 목록 및 일부 구문 태그를 사용하여 맞춤 레이아웃을 만들 수 있습니다. 최상의 사용자 환경을 만들려면 다음 안내와 참고사항을 주의 깊게 읽어보세요.

지원되는 HTML 형식의 태그:

제목 태그: <h1>, <h2>, <h3>, <h4>, <h5>, <h6>
제목 태그는 제목과 부제목을 표시하는 데 사용할 수 있습니다. 예를 들어 <h1>여정</h1>은 인라인 텍스트를 섹션의 가장 중요한 제목으로 표시합니다. 내부 HTML 태그, 스타일, 속성은 모두 무시됩니다. 예를 들어 <h1 style="..">은 <h1>과 같은 것으로 간주됩니다. 순수한 텍스트만 보존됩니다.

단락 태그: <p>
단락 태그는 자세한 소개 또는 콘텐츠를 강조표시하는 데 사용할 수 있습니다. 몇 가지를 제외하고 내부 태그, 스타일, 속성은 모두 무시됩니다(예: <br>, <strong>, <em>). 자세한 내용은 아래의 구문 태그 섹션을 참고하세요.

목록 태그: <ul>, <ol>, <li>
<ul> 태그는 <li> 태그와 함께 순서가 지정되지 않은 목록을 표시하는데 사용하고 <ol> 태그는 <li>와 함께 순서가 지정된 목록을 표시하는 데 사용할 수 있습니다. 이 방법은 체크리스트, 일정 또는 기타 사용 사례에 맞는 목록을 표시하는 데 유용합니다.
예: 크루즈 여행의 특징 목록을 표시하려면 다음을 실행합니다.
<ol>
<li>멋진 바다 전망과 야생동물과 놀 수 있는 기회</li>
<li>신중하게 설계된 여행 일정 및 서비스</li>
<li>최저가 보장</li>
</ol>
<ul> 또는 <ol> 태그 아래의 <li> 하위 요소만 변환됩니다. 다른 하위 항목은 모두 삭제됩니다. 또한 내부 태그, 속성, 스타일은 모두 무시됩니다. 순수한 일반 텍스트 콘텐츠만 보존됩니다.

분할 태그: <div>
<div> 태그의 지원되는 내부 태그는 모두 위에 명시된 규칙으로 파싱되며 여기서 <div> 태그 자체를 암시해도 그룹화 또는 들여쓰기를 의미하지 않습니다. 또한 내부 속성과 스타일은 모두 무시됩니다.

구문 태그: <br>, <strong>, <em>:
위에 언급된 세 가지 태그만 지원됩니다. <br>은 단락에서 줄을 바꾸는 데 사용할 수 있으며, <strong>/<em>은 중요한 텍스트를 강조표시하는 데 사용할 수 있습니다. 다른 구문 태그는 모두 무시됩니다.

지원되지 않는 태그:

  • <html>, <header>, <body> 태그는 허용되지 않습니다.
  • 위에 언급되지 않은 다른 태그는 지원되지 않습니다(예: <table>, <td> ...).
    URL, 앵커, 링크는 모두 제거되며 최종 사용자에게 표시되지 않습니다. 사진을 사용하여 풍부한 사용자 환경을 만들려면 아래의 'relatedMedia' 필드를 사용하여 사진 URL을 보내세요.

중요사항:

  • 위에 언급된 지원되는 태그 외 다른 태그를 사용하지 마세요. 지원되지 않는 태그 내의 콘텐츠는 제거되며 원하지 않는 사용자 환경으로 이어질 수도 있습니다.
  • 4개 이상의 제목 수준 또는 중첩 목록과 같이 깊이 중첩된 구조를 사용하지 마세요. 구조를 단순하고 간단하게 유지하면 더 나은 사용자 환경을 만들 수 있습니다.
  • 현재 지원되는 레이아웃이 사용 사례에 충분하지 않은 경우 Google 예약팀에 문의하세요.
  • 권장되는 최대 크기는 32,000자입니다.
price

object (Price)

서비스 가격입니다.
priceInterpretation

enum (PriceInterpretation)

가격이 해석되고 사용자에게 표시되는 방식을 설명합니다. 식당 및 즐길 거리를 제외한 모든 카테고리에서 서비스 가격 표시를 구성하는 데 사용할 수 있습니다.
rules

object (SchedulingRules)

약속을 예약/취소하는 규칙입니다.
prepaymentType

enum (PrepaymentType)

선불 결제가 필수 또는 선택사항인지, 지원되지 않는지 여부를 나타냅니다.
prepaymentTerms

object (PrepaymentTerms)

선불이 완료되는 시점과 관련된 약관입니다.
form[]
(deprecated)

object (ServiceIntakeForm)

지원 중단되었습니다. intakeForm 및 perTicketIntakeForm을 사용하세요.
intakeForm

object (ServiceIntakeForm)

사용자가 이 서비스를 예약할 때 사용자에게 추가 정보를 요청하는 양식입니다. (선택사항)
perTicketIntakeForm

object (ServiceIntakeForm)

사용자가 이 서비스를 예약할 때 사용자에게 추가 정보를 요청하는 양식입니다. 이 양식은 사용자가 예약하는 티켓마다 한 번씩 작성해야 합니다. (선택사항)
taxRate

object (TaxRate)

서비스의 세율입니다. 이 필드가 있으면 판매자 수준에서 설정된 모든 taxRate가 재정의됩니다. 빈 메시지(taxRate { })는 적용 세율을 0으로 재설정합니다.
paymentOptionId[]

string

이 서비스 비용을 지불하는 데 사용할 수 있는 결제 옵션을 참조하는 ID 목록입니다. 실제 결제 옵션은 판매자 수준에서 정의되며 여러 판매자 간에 공유될 수도 있습니다.
deposit

object (Deposit)

사용자에게 보증금이 청구되는 방식을 정의합니다. 지정된 경우 서비스 보증금이 재정의됩니다. 이 값을 빈 Deposit 메시지로 설정하면 서비스 수준 보증금이 삭제됩니다. (선택사항)
noShowFee

object (NoShowFee)

사용자에게 청구될 수 있는 예약 불이행 수수료를 정의합니다. 지정된 경우 서비스 예약 불이행 수수료가 재정의됩니다. 이 값을 빈 NoShowFee 메시지로 설정하면 서비스 수준 예약 불이행 수수료가 삭제됩니다. (선택사항)
requireCreditCard

enum (RequireCreditCard)

이 서비스를 예약하려면 사용자가 신용카드를 제공해야 하는지 여부를 나타냅니다. 이 필드는 이용 가능 여부 수준에서 재정의할 수 있습니다. (선택사항)
type

enum (ServiceType)

이 서비스의 사전 정의된 유형입니다. (선택사항)
ticketType[]

object (TicketType)

티켓이 지원되는 경우 이 서비스에 대해 예약/구매할 수 있는 티켓 유형입니다. (선택사항)
relatedMedia[]

object (RelatedMedia)

이 서비스와 관련된 사진입니다. Google은 사진이 가장 효율적인 방법으로 사용자에게 표시될 수 있도록 미디어를 크롤링하고 저장합니다. (선택사항)
serviceAttributeValueId[]

object (ServiceAttributeValueId)

이 서비스에 적용되는 서비스 속성 값입니다(선택사항). 각 서비스는 해당 판매자에서 정의된 서비스 속성마다 0개 이상의 값을 가질 수 있습니다. (선택사항)
waitlistRules

object (WaitlistRules)

대기자 명단에 등록하는 규칙입니다.
ticketingVerticalSpecificData

object (TicketingVerticalSpecificData)

이벤트 티켓 카테고리별로 고유한 추가 정보입니다. (선택사항)
integrationType

enum (IntegrationType)

이 서비스에 지원되는 통합의 깊이입니다. (선택사항) 최초 통합 파트너와는 관련이 없습니다. 이 파트너의 경우 엔드투엔드 통합이 항상 사용 중지됩니다.
perOrderFee

object (PerOrderFee)

이 서비스를 구매하기 위한 주문 수준 수수료입니다. (선택사항)
toursAndActivitiesContent

object (ToursAndActivitiesContent)

투어 및 액티비티별 콘텐츠 필드입니다.
location[]

object (Location)

이 서비스와 관련된 위치입니다. 중요사항: 이 서비스와 관련하여 방문한 위치가 여러 개 있거나 START_LOCATION이 VISITED_LOCATION과 다른 경우 START_LOCATION을 지정해야 합니다. 예: - 가이드와 함께 세 장소를 방문하는 자전거 투어. 시작 장소를 지정해야 합니다. - 호텔 로비에서 만나 방문 장소로 이동하는 버스 투어. 만남 위치를 지정해야 합니다.
rating

object (Rating)

이 서비스에 대한 사용자 평가로 모든 리뷰의 집계 측정항목입니다.
homeServiceData

object (HomeServiceData)

홈 서비스 카테고리별로 고유한 추가 정보입니다. (선택사항)
virtualSession

object (VirtualSession)

선택사항입니다. 가상 세션에 관한 정보입니다. 가상 서비스를 사용 설정하는 데 필요합니다.
directMerchantPayment

object (DirectMerchantPayment)

선택사항입니다. 사용자가 판매자에게 직접 결제해야 하는 서비스의 경우 추가해야 하는 정보입니다. 중요사항: RwG는 이 거래에 관여하지 않습니다. virtualSession이 정의되고 서비스가 무료가 아니거나 prepaymentType이 REQUIRED로 설정되지 않은 경우 필요합니다.
uriTemplate

object (UriTemplate)

선택사항입니다. Google에서 외부 사이트의 URL을 생성하는 방법을 지정하는 선택적 템플릿입니다.

PriceInterpretation

가격이 해석되고 사용자에게 표시되는 방식을 설명합니다.

열거형
PRICE_INTERPRETATION_UNSPECIFIED 가격 해석 방법이 지정되지 않았습니다. 기본값은 EXACT_AMOUNT입니다.
EXACT_AMOUNT

가격이 특정한 값으로 해석되어야 하는 경우입니다.

예: 요가 수업 20달러, 어린이 헤어컷 15달러
STARTS_AT

서비스 가격이 가변적이지만 최소 가격이 알려져 있고 소비자에게 표시되는 경우입니다. 소비자는 가격을 높이는 옵션을 선택할 수 있습니다.

이 PriceInterpretation을 사용하는 서비스는 PrepaymentType NOT_SUPPORTED를 사용해야 합니다.

예: 반려견 미용 30달러, 소비자가 추가 옵션을 선택하면 가격이 증가할 수 있음
NOT_DISPLAYED

서비스 가격이 가변적이고 소비자에게 가격 정보가 미리 표시되지 않는 경우입니다.

이 PriceInterpretation을 사용하는 서비스는 PrepaymentType NOT_SUPPORTED를 사용해야 하고 Price가 비어 있어야 합니다.

예: 홈 서비스 상담

SchedulingRules

서비스의 예약 규칙입니다.

JSON 표현 
{
  "minAdvanceOnlineCanceling": string,
  "lateCancellationFee": {
    object (Price)
  },
  "noshowFee": {
    object (Price)
  },
  "admissionPolicy": enum (AdmissionPolicy),
  "cancellationPolicy": {
    object (CancellationPolicy)
  },

  // Union field min_booking_buffer can be only one of the following:
  "minAdvanceBooking": string,
  "minBookingBufferBeforeEndTime": string
  // End of list of possible types for union field min_booking_buffer.
}
필드
minAdvanceOnlineCanceling

string (int64 format)

예약을 온라인으로 취소하는 데 필요한 최소 사전 알림 시간(초)입니다. (선택사항)
lateCancellationFee
(deprecated)

object (Price)

최소 사전 알림 기간 내에 취소하는 경우의 수수료입니다.
noshowFee
(deprecated)

object (Price)

취소하지 않고 예약을 불이행한 경우의 수수료입니다.
admissionPolicy

enum (AdmissionPolicy)

이 서비스에 적용되는 입장 정책입니다. 설정되지 않은 경우 기본값은 TIME_STRICT입니다. (선택사항)
cancellationPolicy

object (CancellationPolicy)

예약 규칙 취소 정책입니다. (즐길 거리에 필요함)

통합 필드 min_booking_buffer입니다. 마지막 예약이 가능한 시점부터 이용 가능 시간대가 시작되거나 종료되는 시점까지의 기간(초)입니다.

'min_advance_booking'이 설정된 경우 마지막 이용 가능 시간은 (<slot start time> - 'min_advance_booking')으로 계산됩니다. 'min_booking_buffer_before_end_time'이 설정된 경우 마지막 이용 가능 시간은 (<slot end time> - 'min_booking_buffer_before_end_time')으로 계산됩니다. 'min_booking_buffer_before_end_time' 값은 설정되는 경우 양수여야 합니다. 둘 다 설정되지 않은 경우 시간대 시작 시간까지 시간대를 예약할 수 있습니다. 두 필드가 모두 설정된 경우 하나의 값만 선택되고 다른 값은 무시됩니다. 어떤 값이 선택될지는 확실하게 예측할 수 없습니다.

예:

  • 시작 시간 1시간 이상 전에 예약해야 하는 헤어컷. 'scheduling_rules{ min_advance_booking: 3600 ...}`

  • 문을 닫기 30분 전에 마지막 티켓을 구매할 수 있는 박물관: 'scheduling_rules{ min_booking_buffer_before_end_time: 1800 ...}'

  • 시작 시간 전에 구매해야 하는 영화 티켓. 'scheduling_rules{ ...}' (leave this field empty) (optional) min_booking_buffer는 다음 중 하나입니다.
minAdvanceBooking

string (int64 format)

마지막 예약이 가능한 시점부터 이용 가능 시간대가 시작되는 시점까지의 기간 (초)입니다.
minBookingBufferBeforeEndTime

string (int64 format)

마지막 예약이 가능한 시점부터 이용 가능 시간대가 종료되는 시점까지의 기간(초)입니다. 이 필드가 설정된 경우, 사용자가 구매한 티켓을 시간대가 시작된 후 사용할 수 있다는 것을 나타내려면 'admissionPolicy' 필드를 TIME_FLEXIBLE로 설정해야 합니다.

AdmissionPolicy

이 서비스의 입장 정책입니다.

열거형
ADMISSION_POLICY_UNSPECIFIED 사용하지 않습니다.
TIME_STRICT 고객이 이용 가능 시간대의 시작 시간에 출석해야 하며 서비스가 시간대의 종료 시간에 완료될 것으로 예상됩니다. TIME_STRICT 사용 사례의 예: * 오전 9시에 시작하고 모든 참석자가 시작 시간까지 도착해야 하며 오후 12시경에 돌아오는 투어. * 약 30분 정도 소요될 예정인 토요일 오후 3시의 헤어컷 예약. * 오후 6시부터 오후 8시까지의 피트니스 클래스.
TIME_FLEXIBLE

고객은 이용 가능 시간대의 시작 시간과 종료 시간 사이에 언제든지 도착하여 이 예약을 사용할 수 있습니다.

TIME_FLEXIBLE 사용 사례의 예: * 구매일에 언제든지 사용할 수 있는 박물관 티켓. * 오후 12시부터 오후 9시까지 사용할 수 있는 놀이공원 오후 입장권.
TIMED_ENTRY_WITH_FLEXIBLE_DURATION

고객은 이용 가능 시간대의 시작 시간까지 판매자에게 도착해야 하지만 원하는 시간에 언제든지 나갈 수 있습니다.

예를 들어 박물관 입장 시나리오에서 오전 10시로 시간이 지정된 입장권의 경우 사용자가 오전 10시까지 박물관에 도착해야 합니다. 이 서비스 이용 가능 시간대의 시작 시간은 지정된 입장 시간을 나타냅니다. 하지만 종료 시간은 이용 가능 시간대를 식별하기 위한 키로만 사용됩니다.

CancellationPolicy

서비스의 취소 정책입니다.

JSON 표현 
{
  "refundCondition": [
    {
      object (RefundCondition)
    }
  ]
}
필드
refundCondition[]

object (RefundCondition)

정책에 적용되는 0개 이상의 환불 조건입니다.

RefundCondition

단일 환불 조건을 정의합니다. 여러 환불 조건을 함께 사용하여 '환불 단계'를 서비스 시작 시간 이전의 여러 기간으로 설명할 수 있습니다.

JSON 표현 
{
  "minDurationBeforeStartTime": string,
  "refundPercent": integer
}
필드
minDurationBeforeStartTime

string (Duration format)

시작 시간 전 고객이 refundPercent에 명시된 서비스 비용의 일부를 환불받을 때까지의 기간입니다. 0(기본값)으로 설정된 경우 서비스가 언제든지 취소될 수 있습니다.

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

integer (uint32 format)

서비스 예약이 서비스 시작 시간 minDurationBeforeStartTime 이상 전에 취소되는 경우 환불 가능한 비율입니다([0, 100]의 범위). 0(기본값)으로 설정된 경우 환불되지 않습니다. 100으로 설정된 경우 전액 환불받을 수 있습니다.

PrepaymentType

선불 유형을 나타내는 열거형입니다.

열거형
PREPAYMENT_TYPE_UNSPECIFIED 기본적으로 선불 결제는 NOT_SUPPORTED로 가정합니다.
REQUIRED 사용자가 예약 시 서비스 대금을 결제해야 합니다.
OPTIONAL 사용자가 예약 시 또는 그 이후에 서비스 대금을 선불 결제할 수 있지만 예약하기 위해 선불 결제할 필요는 없습니다.
NOT_SUPPORTED 이 서비스의 경우 선불 결제가 지원되지 않습니다.

PrepaymentTerms

선불이 완료되는 시점에 관한 구체적인 정보입니다.

JSON 표현 
{
  "chargeTiming": enum (ChargeTiming),
  "chargeTimeBeforeStartTimeSec": string
}
필드
chargeTiming

enum (ChargeTiming)

구매 시간과 관련하여 청구가 발생하는 시점입니다.
chargeTimeBeforeStartTimeSec

string (int64 format)

서비스 시작 시간 전에 사용자에게 결제 금액이 청구되는 시간(초)입니다. 이 필드는 ChargeTiming이 CHARGE_LATER인 경우에만 설정해야 합니다.

ChargeTiming

구매 시간과 관련하여 청구가 발생하는 시점을 지정하는 enum입니다.

열거형
CHARGE_TIMING_UNSPECIFIED 사용하지 않습니다.
CHARGE_NOW 고객에게 즉시 요금이 청구됩니다.
CHARGE_LATER 고객에게 나중에 요금이 청구됩니다.

ServiceIntakeForm

판매자가 제공하는 서비스를 맞춤설정하는 접수 양식을 정의합니다.

JSON 표현 
{
  "field": [
    {
      object (ServiceIntakeFormField)
    }
  ],
  "firstTimeCustomers": boolean,
  "returningCustomers": boolean
}
필드
field[]

object (ServiceIntakeFormField)

사용자에게 표시되는 필드입니다.
firstTimeCustomers
(deprecated)

boolean

true인 경우 서비스를 처음 이용하는 고객에게 이 양식이 표시됩니다. 지원 중단되었습니다. 이 기능은 접수 양식에서 지원되지 않습니다.
returningCustomers
(deprecated)

boolean

true인 경우 서비스를 다시 이용하는 고객에게 이 양식이 표시됩니다. 지원 중단되었습니다. 이 기능은 접수 양식에서 지원되지 않습니다.

ServiceIntakeFormField

ServiceIntakeForm에 포함되는 필드를 정의합니다.

JSON 표현 
{
  "id": string,
  "type": enum (FieldType),
  "label": string,
  "localizedLabel": {
    object (Text)
  },
  "value": [
    string
  ],
  "choiceText": [
    {
      object (Text)
    }
  ],
  "isRequired": boolean,
  "allowCustomAnswer": boolean,
  "additionalOption": [
    {
      object (Text)
    }
  ],
  "ticketTypeRestrict": [
    string
  ],
  "hint": {
    object (Text)
  }
}
필드
id

string

양식 필드를 고유하게 나타내는 애그리게이터 파트너의 문자열입니다. 이 ID는 해당 양식 필드 답변의 ID와 동일해야 하며 서비스 수준과 티켓 접수 양식마다 고유해야 합니다. (필수)
type

enum (FieldType)

이 필드의 유형입니다.
label

string

이 필드의 사용자에게 표시되는 텍스트입니다. 지원 중단되었습니다. 대신 localizedLabel을 사용하세요.
localizedLabel

object (Text)

이 필드의 사용자에게 표시되는 텍스트입니다. 이 필드는 여러 언어로 제공될 수 있습니다. (필수)
value[]

string

필드 유형이 LOCATION_SEARCH인 경우에만 설정합니다. 위치 값을 지정하려면 'location' 필드의 'locationId'를 사용하세요.
choiceText[]

object (Text)

필드 유형이 MULTIPLE_CHOICE, CHECKBOXES 또는 DROPDOWN인 경우에만 설정합니다. 가능한 선택사항을 열거하는 데 사용됩니다.
isRequired

boolean

사용자가 이 필드에 답변해야 하는지 여부를 나타냅니다.
allowCustomAnswer

boolean

사전 정의된 답변 외에도 맞춤 값이 허용되는지 여부를 나타냅니다. 이는 필드 유형이 LOCATION_SEARCH인 경우에만 적용됩니다. (선택사항)
additionalOption[]

object (Text)

제공된 값 외에도 제공된 추가 옵션입니다. 필드 유형이 LOCATION_SEARCH인 경우에만 적용됩니다. 예를 들어 제공된 위치 목록 외에도 '나중에 공급업체에 문의하겠습니다'라는 옵션을 사용할 수 있습니다. (선택사항)
ticketTypeRestrict[]

string

사용자가 특정 티켓 유형을 예약할 때만 이 질문을 표시해야 하는 경우 이 필드를 해당 티켓 유형 ID의 집합으로 설정해야 합니다. 질문을 항상 표시해야 하는 경우 입력란을 비워두세요.
hint

object (Text)

입력 힌트 텍스트로, 텍스트 자리표시자로 표시됩니다. 이는 필드 유형이 SHORT_ANSWER 또는 PARAGRAPH인 경우에만 적용됩니다. (선택사항)

FieldType

필드 유형을 나타내는 열거형입니다.

열거형
FIELD_TYPE_UNSPECIFIED 지정되지 않거나 알 수 없는 유형의 필드는 무시됩니다.
SHORT_ANSWER 한 줄의 텍스트 입력란입니다.
PARAGRAPH 여러 줄의 텍스트 입력란입니다.
MULTIPLE_CHOICE 여러 옵션 중 하나를 선택해야 하는 라디오 버튼의 집합입니다.
CHECKBOXES 체크박스가 있는 하나 이상의 열거된 항목입니다.
DROPDOWN 드롭다운의 선택항목입니다.
BOOLEAN 예/아니요 버튼입니다.

ServiceType

사전 정의된 서비스 유형입니다.

열거형
SERVICE_TYPE_UNSPECIFIED 사용하지 않음.
SERVICE_TYPE_DINING_RESERVATION 식당 예약.
SERVICE_TYPE_FOOD_ORDERING 음식 주문(배달 또는 테이크아웃 또는 둘 다)
SERVICE_TYPE_FOOD_DELIVERY 음식 배달
SERVICE_TYPE_FOOD_TAKEOUT 음식 테이크아웃
SERVICE_TYPE_EVENT_TICKET 이벤트 티켓.
SERVICE_TYPE_TRIP_TOUR 여행 투어.
SERVICE_TYPE_APPOINTMENT 약속 또는 수업을 제공하는 서비스. (1) 건강 및 피트니스, (2) 스파 및 미용, (3) 재무 컨설팅 및 평가 서비스에 권장됩니다. 지원되는 서비스 유형을 참고하세요(https://developers.google.com/maps-booking/guides/end-to-end-integration/overview).
SERVICE_TYPE_ONLINE_APPOINTMENT 완전히 가상으로 진행되는 수업 또는 세션의 온라인 예약을 제공하는 서비스입니다. 가상 서비스 예약을 사용 설정하는 경우 설정해야 합니다.
SERVICE_TYPE_SHOPPING 사용자가 지정된 판매자로부터 쇼핑할 수 있는 서비스입니다. 배달 또는 직접 수령 중 하나일 수 있습니다.

TicketType

TicketType은 사용자 유형, 서비스 속성 또는 옵션/부가기능으로 인해 가격 및 이용 가능 여부가 다른 여러 티켓을 구별하는 데 사용됩니다.

티켓은 이용 가능한 최소 서비스 단위(예: 래프팅 여행의 한 자리, 박물관 입장권, 종일 카약 2대 대여)입니다.

JSON 표현 
{
  "ticketTypeId": string,
  "shortDescription": string,
  "localizedShortDescription": {
    object (Text)
  },
  "price": {
    object (Price)
  },
  "perTicketFee": {
    object (PerTicketFee)
  },
  "priceDisplayType": enum (PriceDisplayType),
  "optionDescription": string,
  "localizedOptionDescription": {
    object (Text)
  },
  "inventoryType": enum (InventoryType)
}
필드
ticketTypeId

string

티켓 ID는 동일한 서비스의 여러 티켓 유형을 구분하는 데 사용되며 서비스 내에서만 고유합니다.
shortDescription

string

이 TicketType의 간단한 설명입니다.

사용자가 볼 수 있습니다(예: '성인', '어린이', '재향군인', 'J열'). 필수 항목입니다. 각 티켓 유형에는 사용자가 볼 수 있는 설명이 있어야 합니다. 지원 중단되었습니다. 대신 localizedShortDescription을 사용하세요.
localizedShortDescription

object (Text)

i18n 지원 기능이 있는 이 TicketType의 간단한 설명입니다.

사용자가 볼 수 있습니다(예: '성인', '어린이', '재향군인', 'J열'). 필수 항목입니다. 각 티켓 유형에는 사용자가 볼 수 있는 설명이 있어야 합니다. 언어마다 별도의 값을 제공할 수 있습니다.
price

object (Price)

이 유형의 티켓 한 장의 가격입니다(세금 제외). 서비스 세율이 티켓에 적용됩니다.
perTicketFee

object (PerTicketFee)

이 티켓을 구매하기 위한 추가 수수료입니다. (선택사항)
priceDisplayType

enum (PriceDisplayType)

선택사항입니다. 이 유형의 티켓 한 장의 사전 정의된 가격 표시 유형입니다.
optionDescription

string

이 티켓 유형이 나타내는 추가 옵션의 설명입니다. 지원 중단되었습니다. 대신 localizedOptionDescription을 사용하세요.
localizedOptionDescription

object (Text)

이 티켓 유형이 나타내는 추가 옵션의 설명입니다. 언어마다 별도의 값을 제공할 수 있습니다.

추가 옵션은 티켓 유형이 여러 측정기준을 나타내는 경우 유용합니다.

예 1: 유형이 여러 가지('성인', '어린이')이고 언어가 추가 옵션인 입장권. 예상되는 TicketType 목록 : - { ticketTypeId: "ticket_type_1" localizedShortDescription { value: "adult" } localizedOptionDescription { value: "english" } } - { ticketTypeId: "ticket_type_2" localizedShortDescription { value: "adult" } localizedOptionDescription { value: "spanish" } } - { ticketTypeId: "ticket_type_3" localizedShortDescription { value: "child" } localizedOptionDescription { value: "english" } } - { ticketTypeId: "ticket_type_4" localizedShortDescription { value: "child" } localizedOptionDescription { value: "spanish" } }

예 2: 선택적 건조 주머니 부가 기능이 있는 시간 단위 카약 대여. shortDescription은 '3시간'이고 optionDescription은 '건조 주머니 포함' 또는 '건조 주머니 제외'일 수 있음: - { ticketTypeId: "ticket_type_1" localizedShortDescription { value: "2 hours" } localizedOptionDescription { value: "english" } } - { ticketTypeId: "ticket_type_2" localizedShortDescription { value: "2 hours" } localizedOptionDescription { value: "spanish" } } - { ticketTypeId: "ticket_type_3" localizedShortDescription { value: "3 hours" } localizedOptionDescription { value: "english" } } - { ticketTypeId: "ticket_type_4" localizedShortDescription { value: "3 hours" } localizedOptionDescription { value: "spanish" } }

선택사항이지만 서비스 내의 티켓 유형에 이 필드가 설정되면 다른 모든 티켓 유형에도 이 필드가 설정됩니다(기본 optionDescription 사용 가능). 예: [{ticket_type_1, adult, english}, {ticket_type_1, adult, ''}]은 유효한 목록이 아닙니다.

두 가지 HTML 형식 태그(,
)만 지원됩니다. 제목과 자세한 설명이 모두 포함된 옵션을 지정하는 데 사용됩니다. 예: '프리미엄 좌석
이 옵션은 쿠션이 있는 좌석, 전용 TV, 좌석 내 식음료 서비스가 포함된 특별석의 좌석을 제공합니다. 이 좌석은 그림 같은 경기장 전망을 제공합니다.'
inventoryType

enum (InventoryType)

선택사항입니다. 이 유형의 티켓 한 장의 사전 정의된 인벤토리 유형입니다.

PerTicketFee

사용자가 구매하는 티켓마다 지불해야 하는 수수료입니다.

JSON 표현 
{
  "serviceCharge": {
    object (Price)
  },
  "facilityFee": {
    object (Price)
  },
  "taxes": {
    object (Price)
  }
}
필드
serviceCharge

object (Price)

서비스에 부과되는 추가 요금입니다.
facilityFee

object (Price)

장소/시설에 대한 수수료입니다.
taxes

object (Price)

티켓당 세금입니다.

PriceDisplayType

방문 페이지에 표시되는 가격 형식을 나타냅니다.

이 필드는 연결 외 인벤토리에서는 무시됩니다.

이 필드를 사용하면 Google 표시 경로에 방문 페이지에서 사용한 것과 동일한 가격 형식이 표시될 수 있습니다. 일관된 가격 형식을 사용하면 전환율이 개선되고 혼란이 줄어듭니다.

열거형
PRICE_DISPLAY_TYPE_UNSPECIFIED 가격 표시 유형이 지정되지 않았습니다. Google에서 표시할 형식을 결정합니다.
PRICE_DISPLAY_TYPE_BASE 방문 페이지에 표시된 가격은 기본 가격입니다.
PRICE_DISPLAY_TYPE_ALL_IN 방문 페이지에 표시되는 가격에는 모든 수수료와 세금이 포함됩니다.

InventoryType

이 유형의 티켓 한 장의 사전 결정된 인벤토리 유형입니다.

열거형
INVENTORY_TYPE_UNSPECIFIED 인벤토리 유형이 지정되지 않았습니다.
INVENTORY_TYPE_PRIMARY 기본 인벤토리
INVENTORY_TYPE_VERIFIED_RESALE 인증된 재판매 인벤토리
INVENTORY_TYPE_RESALE 재판매 인벤토리
INVENTORY_TYPE_AGGREGATOR 애그리게이터 인벤토리

RelatedMedia

이 서비스와 관련된 사진입니다. Google에서 이 미디어를 크롤링하여 최종 사용자에게 올바르게 표시되도록 합니다. (선택사항)

JSON 표현 
{
  "url": string,
  "type": enum (MediaType),
  "localizedCaption": {
    object (Text)
  },
  "attribution": {
    object (Attribution)
  },
  "caption": string
}
필드
url

string

이 미디어 소스의 URL입니다. Google에서 이 URL에서 호스팅되는 미디어를 크롤링합니다.
type

enum (MediaType)

이 미디어 소스의 유형입니다.
localizedCaption

object (Text)

i18n을 지원하는 미디어의 자막입니다. 일반 텍스트만 지원됩니다. 모든 HTML 구성요소가 제거됩니다. (선택사항)
attribution

object (Attribution)

미디어의 소스에 대한 저작자 표시 정보입니다. 미디어에 저작자를 표시하여 사진사 또는 대행사의 이름을 언급해야 하는 경우 이 필드를 설정해야 합니다. (선택사항)
caption
(deprecated)

string

지원 중단되었습니다. localizedCaption을 사용하세요.

MediaType

이 미디어 소스의 유형을 나타내는 열거형입니다. 사진만 지원됩니다. 사진 이외 다른 미디어를 지원해야 하는 경우 Google 예약 팀에 문의하세요.

열거형
TYPE_UNSPECIFIED 사용하지 않습니다.
PHOTO URL에서 제공하는 미디어가 사진임을 나타냅니다.

저작자 표시

이 미디어의 저작권 표시 정보입니다.

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

object (Text)

i18n을 지원하는 사진사 또는 대행사의 이름을 언급하는 텍스트입니다. 이 텍스트는 소스 미디어와 함께 표시됩니다. 이 필드에는 일반 텍스트만 사용할 수 있으며 HTML 구성요소는 모두 제거됩니다(하이퍼링크 기반 저작자 표시는 지원되지 않습니다).
text
(deprecated)

string

지원 중단되었습니다. localizedText를 사용하세요.

ServiceAttributeValueId

서비스에 적용될 서비스 속성의 특정 값을 나타냅니다.

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

string

Merchant.service_attribute에 정의된 속성의 ID입니다(예: 'service-type').
valueId

string

이 속성 값의 ID입니다(예: '헤어컷')입니다. 서비스 속성 정의의 valueId와 일치해야 합니다.

WaitlistRules

대기자 명단에 등록하는 것과 관련된 규칙입니다.

JSON 표현 
{
  "minPartySize": integer,
  "maxPartySize": integer,
  "supportsAdditionalRequest": boolean,
  "aboveMaxPartySizeOptions": [
    {
      object (UnsupportedPartySizeOption)
    }
  ]
}
필드
minPartySize

integer

필수사항입니다. 대기자 목록 기능을 제공하는 서비스의 경우 양의 정수여야 합니다. 서비스 또는 판매자가 대기자 명단 기능을 제공하지 않는 경우에는 입력하지 않아야 합니다.
maxPartySize

integer

필수사항입니다. 대기자 목록 기능을 제공하는 서비스의 경우 양의 정수여야 합니다. 서비스 또는 판매자가 대기자 명단 기능을 제공하지 않는 경우에는 입력하지 않아야 합니다.
supportsAdditionalRequest

boolean

true인 경우 사용자가 이 서비스의 대기자 명단에 등록할 때 자유 형식의 추가 텍스트 요청을 보낼 수 있습니다.
aboveMaxPartySizeOptions[]

object (UnsupportedPartySizeOption)

설정된 maxPartySize보다 큰 파티의 옵션을 설정합니다. 대규모 파티에 대기자 명단에 등록할 수 있는 대체 옵션을 제공해서는 안 되는 경우 비워 둡니다.

UnsupportedPartySizeOption

범위 밖에 있는 당사자를 위한 옵션

JSON 표현 
{

  // Union field kind can be only one of the following:
  "callMerchant": {
    object (CallMerchant)
  }
  // End of list of possible types for union field kind.
}
필드
통합 필드 kind. 범위 밖에 있는 사용자에게 사용할 수 있는 옵션입니다. kind은 다음 중 하나여야 합니다.
callMerchant

object (CallMerchant)

범위를 벗어난 당사자는 비즈니스에 전화를 걸 수 있습니다. 사전 정의된 메시지가 사용자에게 표시됩니다. 표시할 샘플 텍스트: '{waitlistRules.max_party_size}명을 초과하는 경우 음식점(전화번호: {phone})에 전화해 주세요.' CallMerchant는 설정해야 하지만 비어 있습니다.

CallMerchant

이 유형에는 필드가 없습니다.

UnsupportedPartySizeOption에 사용되는 빈 메시지입니다. 이 옵션을 설정하면 사용자에게 비즈니스에 전화하여 예약할 수 있는 옵션이 표시됩니다.

TicketingVerticalSpecificData

이벤트 티켓 카테고리별로 고유한 추가 정보입니다.

JSON 표현 
{
  "eventCategory": enum (EventCategory),
  "eventUrl": string,
  "entity": [
    {
      object (Entity)
    }
  ],
  "eventAttendanceMode": enum (AttendanceMode),
  "eventVirtualLocationUrl": [
    string
  ],
  "eventOrganizer": {
    object (Text)
  },
  "eventOrganizerUrl": string,
  "eventOrganizerType": enum (OrganizerType),
  "eventSourceUrl": [
    string
  ],
  "eventState": enum (EventState),
  "brandName": {
    object (Text)
  },
  "eventCreator": {
    object (EventCreator)
  }
}
필드
eventCategory

enum (EventCategory)

이벤트의 카테고리입니다. 이벤트가 사전 정의된 카테고리 중 하나에 속하는 경우에만 설정합니다. (선택사항)
eventUrl

string

파트너 웹사이트의 이벤트 URL입니다. (선택사항)
entity[]

object (Entity)

이벤트와 관련된 항목의 목록입니다. (선택사항)
eventAttendanceMode

enum (AttendanceMode)

필수 항목입니다. 이벤트 참석 유형입니다.
eventVirtualLocationUrl[]

string

선택사항입니다. 이벤트를 시청할 수 있는 URL입니다.
eventOrganizer

object (Text)

선택사항입니다. 이벤트를 주최하는 주최자입니다.
eventOrganizerUrl

string

선택사항입니다. 이벤트를 주최하는 주최자의 URL입니다.
eventOrganizerType

enum (OrganizerType)

선택사항입니다. 주최자 유형입니다.
eventSourceUrl[]

string

필수 항목입니다. 이벤트 정보 또는 설명을 찾을 수 있는 페이지의 URL입니다.
eventState

enum (EventState)

선택사항입니다. 이벤트의 상태입니다.
brandName

object (Text)

선택사항입니다. 현지화된 브랜드 이름입니다.
eventCreator

object (EventCreator)

선택사항입니다. 이벤트 크리에이터에 관한 정보입니다.

EventCategory

제품 환경을 맞춤설정하는 이벤트 카테고리의 하위 집합입니다. 참고: 이벤트의 범용 온톨로지가 아닙니다.

열거형
EVENT_CATEGORY_UNSPECIFIED 지정되지 않음. 사용하지 마세요.
EVENT_CATEGORY_CONCERT 콘서트.
EVENT_CATEGORY_SPORTS 스포츠 이벤트.
EVENT_CATEGORY_THEATRE 극장 이벤트.
EVENT_CATEGORY_EXHIBITS 전시회.
EVENT_CATEGORY_WORKSHOPS_AND_CLASSES 워크숍 및 강좌.

Entity

이벤트와 관련된 항목을 나타냅니다.

JSON 표현 
{
  "id": string,
  "name": string,
  "url": string,
  "entityType": enum (EntityType),
  "entityRole": enum (EntityRole),
  "publicIdentificationData": {
    object (PublicIdentificationData)
  }
}
필드
id

string

파트너 데이터베이스에 있는 항목의 고유 식별자입니다. (선택사항)
name

string

항목의 이름입니다. (필수)
url

string

항목을 명확하게 설명하는 웹페이지의 URL입니다. 파트너 웹사이트의 항목에 대한 웹페이지입니다(있는 경우). 항목의 다른 공개 URL의 경우 publicIdentificationData의 relevantUrl을 사용합니다. (선택사항)
entityType

enum (EntityType)

항목의 유형입니다. (선택사항)
entityRole

enum (EntityRole)

이벤트에서 항목의 역할입니다. (선택사항)
publicIdentificationData

object (PublicIdentificationData)

항목의 공개 참조입니다. (선택사항)

EntityType

항목의 유형입니다. 참고: 범용 온톨로지가 아닙니다.

열거형
ENTITY_TYPE_UNSPECIFIED 지정되지 않음. 사용하지 마세요.
ENTITY_TYPE_PERFORMER 항목이 콘서트 또는 쇼에서 공연하는 아티스트 또는 그룹을 나타냅니다. 이벤트 카테고리가 CONCERT 또는 THEATRE인 경우에만 적용됩니다.
ENTITY_TYPE_PLAYER 항목이 이벤트의 스포츠팀 또는 선수를 나타냅니다. 이벤트 카테고리가 SPORTS인 경우에만 적용됩니다.
ENTITY_TYPE_CONCERT_TOUR 항목이 이 이벤트가 속한 투어를 나타냅니다. 이벤트 카테고리가 CONCERT인 경우에만 적용됩니다.
ENTITY_TYPE_SPORTS_SERIES 항목이 이 이벤트가 속한 스포츠 토너먼트를 나타냅니다. 이벤트 카테고리가 SPORTS인 경우에만 적용됩니다.
ENTITY_TYPE_PLAY 항목이 이벤트의 공연 유형(예: 뮤지컬, 코미디, 발레)을 나타냅니다. 이벤트 카테고리가 THEATRE인 경우에만 적용됩니다.

EntityRole

이벤트에서 항목의 역할입니다.

열거형
ENTITY_ROLE_UNSPECIFIED 지정되지 않습니다.
ENTITY_ROLE_HEADLINER 항목이 이벤트의 주요 연기자 또는 연주자를 나타냅니다.
ENTITY_ROLE_SUPPORTER 항목이 이벤트의 보조 연기자/연주자를 나타냅니다.
ENTITY_ROLE_HOME_TEAM 항목이 (스포츠) 이벤트의 홈팀을 나타냅니다.
ENTITY_ROLE_AWAY_TEAM 항목이 (스포츠) 이벤트의 원정팀을 나타냅니다.

PublicIdentificationData

항목을 참조하는 식별자, 웹페이지 또는 기타 공개 출처입니다.

JSON 표현 
{
  "relevantUrl": [
    string
  ],
  "musicbrainzId": string
}
필드
relevantUrl[]

string

주제 전용 웹페이지의 공개 URL입니다. 여기에는 공식 웹사이트, 디스코그스, 소셜 미디어 플랫폼, 위키피디아 또는 imdb 페이지가 포함됩니다(예: https://www.discogs.com/artist/1124645-Taylor-Swift, https://www.wikidata.org/wiki/Q19320959, https://twitter.com/acmilan). (선택사항)
musicbrainzId

string

해당하는 경우 아티스트 또는 기타 음악 항목의 36자 musicbrainz 식별자입니다. https://musicbrainz.org/doc/MusicBrainz_Identifier를 참고하세요. (선택사항)

AttendanceMode

이벤트 참석 유형입니다.

열거형
ATTENDANCE_MODE_UNSPECIFIED 지정되지 않음
ONLINE 가상 이벤트의 경우
PHYSICAL 오프라인 이벤트의 경우
PHYSICAL_ONLINE_MIXED 오프라인 및 온라인 이벤트 모두에 적용됩니다.

OrganizerType

주최자 유형입니다.

열거형
ORGANIZER_TYPE_UNSPECIFIED 지정되지 않음
PERSON 개인인 주최자의 경우
ORGANIZATION 조직인 주최자의 경우

EventState

이벤트의 상태입니다.

열거형
EVENT_STATE_UNSPECIFIED 지정되지 않음
SCHEDULED 이벤트가 예약되었습니다.
RESCHEDULED 일정이 변경되었습니다.
CANCELLED 이벤트가 취소됩니다.
POSTPONED 이벤트가 연기되었습니다.

EventCreator

이벤트 크리에이터에 관한 정보입니다. 사용자 제작 콘텐츠 이벤트가 포함된 플랫폼에만 관련이 있습니다.

JSON 표현 
{
  "name": string
}
필드
name

string

선택사항입니다. 이벤트 작성자의 이름입니다. 문자 제한이 없습니다.

IntegrationType

지원되는 통합의 심도입니다.

열거형
INTEGRATION_TYPE_UNSPECIFIED 기본값은 END_TO_END입니다.
INTEGRATION_TYPE_END_TO_END Google을 통한 엔드투엔드 예약이 가능한 완전한 통합입니다.
INTEGRATION_TYPE_INVENTORY_ONLY 예약 서버는 이 서비스를 지원할 필요가 없습니다. 판매자, 서비스 및 이용 가능 여부 데이터(선택사항)만 전송해야 합니다.

PerOrderFee

티켓 수와 관계없이 주문당 한 번 지불해야 하는 수수료입니다.

JSON 표현 
{
  "deliveryFee": {
    object (Price)
  },
  "processingFee": {
    object (Price)
  }
}
필드
deliveryFee

object (Price)

배송 방법에 따라 달라질 수 있는 수수료입니다.
processingFee

object (Price)

사용자의 결제 수단을 처리하기 위한 수수료입니다.

ToursAndActivitiesContent

투어 및 액티비티별 콘텐츠 필드입니다. 반복 필드의 각 요소는 독립적으로 렌더링되어야 합니다(예: 글머리 기호).

투어 및 액티비티의 경우 ToursAndActivitiesContent를 채우는 것이 좋지만 반드시 그럴 필요는 없습니다. 모든 필드에는 일반 텍스트와 HTML 텍스트 모두 기본 서식으로 사용할 수 있습니다. 지원되는 HTML 형식의 태그:

구문 태그:
, , , : 위에 언급된 세 가지 태그만 지원됩니다.
은 단락에서 줄을 바꾸는 데 사용할 수 있으며, //은 중요한 텍스트를 강조표시하는 데 사용할 수 있습니다. 다른 구문 태그는 모두 무시됩니다.

다른 모든 태그와 맞춤 스타일은 허용되지 않으며 삭제됩니다. URL, 앵커, 링크는 모두 제거되며 최종 사용자에게 표시되지 않습니다.

중요사항: * highlights, exclusion 및 기타 서비스 설명의 더 구체적인 필드에 이미 입력된 데이터를 복제하지 마세요. * 위에 언급된 지원되는 태그를 제외한 다른 태그를 사용하지 마세요. 지원되지 않는 태그 내의 콘텐츠는 제거되며 원하지 않는 사용자 환경으로 이어질 수도 있습니다.

JSON 표현 
{
  "highlights": [
    {
      object (Text)
    }
  ],
  "inclusions": [
    {
      object (Text)
    }
  ],
  "exclusions": [
    {
      object (Text)
    }
  ],
  "mustKnow": [
    {
      object (Text)
    }
  ]
}
필드
highlights[]

object (Text)

사용자에게 표시되는 하이라이트 목록입니다.
inclusions[]

object (Text)

사용자에게 표시되는 포함 목록입니다.
exclusions[]

object (Text)

사용자에게 표시되는 제외 목록입니다.
mustKnow[]

object (Text)

사용자에게 표시되는 중요사항의 목록으로 연령 제한 또는 기타 이 서비스를 부적합하게 만드는 조건과 같은 세부정보에 사용합니다.

Location

위치의 지리 정보입니다.

JSON 표현 
{
  "placeId": string,
  "name": string,
  "telephone": string,
  "url": string,
  "geo": {
    object (GeoCoordinates)
  },
  "locationType": enum (LocationType),
  "locationId": string
}
필드
placeId

string

Google 지역 정보 데이터베이스 및 Google 지도에 있는 장소의 장소 ID입니다. 장소 ID에 관한 자세한 내용은 https://developers.google.com/places/web-service/place-id를 참고하세요. 이 필드가 제공되면 Google에서 위치를 이 장소에 일치시킵니다.
name

string

위치 이름, 전화번호, URL 및 지역 정보는 위치를 Google 지도에 이미 존재하는 장소와 일치시키는 데 사용됩니다.

이 필드는 선택사항이지만 일부 컨텍스트에서는 필수사항일 수 있습니다. 예를 들어 이름이 없는 Service.location은 동일한 주소에 있더라도 비즈니스 항목과 일치하지 않습니다. (선택사항)
telephone

string

국가 및 지역 번호를 포함한 위치의 공개 전화번호입니다(예: +14567891234). (선택사항)
url

string

위치의 공개 웹사이트 URL입니다. (선택사항)
geo

object (GeoCoordinates)

위도, 경도, 주소 등 위치의 지역 정보입니다. (선택사항)
locationType

enum (LocationType)

위치의 유형으로 서비스에 이 위치가 제공되는 경우 제공해야 합니다.
locationId

string

서비스 내 위치의 고유 참조입니다. 이 ID는 다른 서비스 필드에서 이 위치를 참조하는 데 사용할 수 있습니다. 예를 들어 맞춤 접수 양식에서 수령 위치 옵션을 지정하기 위해 위치 ID 집합을 사용할 수 있습니다. 설정된 경우 이 ID는 동일한 서비스 내에서 고유해야 합니다. (선택사항)

LocationType

이 위치의 유형입니다.

열거형
LOCATION_TYPE_UNSPECIFIED 위치 유형이 지정되지 않았습니다.
VISITED_LOCATION 이 서비스가 방문하는 위치입니다.
START_LOCATION 이 서비스가 시작되는 위치로 MEETING_LOCATION으로도 사용됩니다.
END_LOCATION 서비스가 종료되는 위치입니다.

Rating

항목의 평점을 정의합니다.

JSON 표현 
{
  "value": number,
  "numberOfRatings": string
}
필드
value

number

평균 평점 값입니다(numberOfRatings > 0인 경우 필수). 값은 [1, 5] 범위 내에 있어야 하며 numberOfRatings가 0인 경우에만 생략할 수 있습니다.
numberOfRatings

string

값을 계산하는 데 사용되는 평점 수입니다 (필수).

HomeServiceData

홈 서비스 카테고리에 제공해야 하는 추가 정보입니다.

JSON 표현 
{
  "categoryType": string,
  "jobType": string
}
필드
categoryType

string

이 홈 서비스가 속한 상위 카테고리입니다. 예: 배관공, 전기 기사 등
jobType

string

지정된 홈 서비스가 속한 카테고리의 작업 유형입니다. 예를 들어 배관공 카테고리의 작업 유형은 unclog_drain, install_faucet입니다.

VirtualSession

가상/온라인 세션에 관한 정보입니다. 예: 온라인 요가 수업, 가상 요리 수업 등

JSON 표현 
{
  "sessionInstructions": {
    object (Text)
  },
  "sessionRequirements": {
    object (Text)
  },
  "virtualPlatformInfo": {
    object (VirtualPlatformInfo)
  },
  "isSessionPrerecorded": boolean
}
필드
sessionInstructions

object (Text)

이 가상 수업을 설정하는 방법에 관한 안내입니다. 파트너가 예약에 동영상 URL을 포함하지 않은 경우 이 텍스트에 동영상 URL이 사용자와 공유되는 시점이 포함되어야 합니다. (예: '수업 시작 30분 전에 Zoom URL을 이메일로 보내드리겠습니다'라고 안내합니다(권장).
sessionRequirements

object (Text)

지정된 가상 세션의 요구사항입니다. 예: 요가 매트, 조리 기구 등(권장)
virtualPlatformInfo

object (VirtualPlatformInfo)

이 세션에서 사용된 가상 플랫폼에 대한 정보입니다. (가상 서비스를 사용 설정하는 데 필요)
isSessionPrerecorded

boolean

필수 항목입니다. 가상 세션이 실시간이 아니고 사전 녹화된 경우 이 값을 true로 설정합니다.

VirtualPlatformInfo

이 가상 세션에 사용할 플랫폼에 관한 정보입니다.

JSON 표현 
{
  "platform": enum (Platform),
  "otherPlatformName": {
    object (Text)
  }
}
필드
platform

enum (Platform)

가상 세션에 사용되는 플랫폼입니다.
otherPlatformName

object (Text)

플랫폼이 OTHER로 설정된 경우 플랫폼의 이름입니다. (플랫폼이 OTHER로 설정된 경우 필수)

플랫폼

판매자가 사용할 가상 플랫폼을 나타내는 열거형입니다.

열거형
PLATFORM_UNSPECIFIED 사용하지 않습니다.
FLEXIBLE 판매자는 사용하는 동영상 플랫폼을 유연하게 선택할 수 있습니다.
GOOGLE_HANGOUTS Google 행아웃 제품
GOOGLE_MEET Google Meet 제품
ZOOM Zoom 비디오 커뮤니케이션
SKYPE Skype
YOUTUBE YouTube에서 라이브 스트리밍
OTHER 사용 중인 동영상 플랫폼이 여기에 언급된 플랫폼과 다른 경우 설정해야 합니다.

DirectMerchantPayment

사용자가 RwG를 통해 서비스를 선불로 결제하는 대신 판매자에게 직접 결제하는 방법에 관한 정보입니다.

JSON 표현 
{
  "paymentMethods": [
    {
      object (Text)
    }
  ]
}
필드
paymentMethods[]

object (Text)

사용자는 아래에 언급된 결제 수단을 통해서만 결제하는 것이 좋습니다.

UriTemplate

Google에서 외부 사이트의 URL을 생성하는 방법을 지정하는 템플릿입니다.

JSON 표현 
{
  "uriTemplate": string
}
필드
uriTemplate

string

선택사항입니다. URI 템플릿은 RFC6570(https://datatracker.ietf.org/doc/html/rfc6570)을 따라야 합니다. 레벨 2 템플릿을 지원합니다. 이러한 매개변수는 각 항목에 지정된 값으로 확인됩니다.

식당 예약 링크아웃에 사용할 수 있는 5가지 매개변수: 1) (필수) {availability_slot_start_seconds} :: 이용 가능 여부 피드의 startSec 필드에서 채워짐 2) (필수) {availability_slot_duration_seconds} :: 이용 가능 여부 피드의 durationSec 필드에서 채워짐 3) (선택사항) {resources_party_size} :: 이용 가능 여부 피드의 partySize 필드에서 채워짐 4) (선택사항) {availability_availability_tag} :: 이용 가능 여부 피드의 availabilityTag 필드에서 채워짐 5) (선택사항) {resources_room_id} :: 이용 가능 여부 피드의 roomId 필드에서 채워짐

사용 예: http://example.com/book/restaurant?start={availability_slot_start_seconds} &num_guests={resources_party_size} * startSec = 123456 * partySize = 2 https://example.com/book/restaurant?start=123456&num_guests=2

메서드

create

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

delete

 지정된 애그리게이터에서 관리하는 판매자의 기존 Service를 삭제합니다.

patch

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