- 리소스: 서비스
- PriceInterpretation
- SchedulingRules
- AdmissionPolicy
- CancellationPolicy
- RefundCondition
- PrepaymentType
- PrepaymentTerms
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- ChargeTiming
- ServiceIntakeForm
- ServiceIntakeFormField
- FieldType
- ServiceType
- TicketType
- PerTicketFee
- RelatedMedia
- MediaType
- 저작자 표시
- ServiceAttributeValueId
- WaitlistRules
- UnsupportedPartySizeOption
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- CallMerchant
- TicketingVerticalSpecificData
- EventCategory
- 항목
- EntityType
- EntityRole
- PublicIdentificationData
- AttendanceMode
- OrganizerType
- EventState
- IntegrationType
- PerOrderFee
- ToursAndActivitiesContent
- 위치
- LocationType
- 평점
- HomeServiceData
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- VirtualSession
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- VirtualPlatformInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- 플랫폼
- DirectMerchantPayment
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- 메서드
리소스: 서비스
판매자가 제공하는 서비스에 대한 정보입니다(예: 헤어컷).
JSON 표현 |
---|
{ "name": string, "serviceName": string, "localizedServiceName": { object ( |
필드 | |
---|---|
name |
|
serviceName |
서비스 이름입니다(예: '남성 헤어컷'). 지원 중단되었습니다. 대신 localizedServiceName을 사용하세요. |
localizedServiceName |
서비스 이름입니다(예: '남성 헤어컷'). 아마도 여러 언어로 표시됩니다. |
description |
사용자에게 표시되는 서비스 설명입니다. 지원 중단되었습니다. 대신 localizedDescription을 사용하세요. |
localizedDescription |
사용자에게 표시되는 서비스 설명입니다. 이 필드에는 일반 텍스트와 HTML 형식을 모두 입력할 수 있습니다. 일반 텍스트 섹션과 달리 여기에서는 제목, 단락, 목록 및 일부 구문 태그를 사용하여 맞춤 레이아웃을 만들 수 있습니다. 최상의 사용자 환경을 만들려면 다음 안내와 참고사항을 주의 깊게 읽어보세요. 지원되는 HTML 형식의 태그: 제목 태그: <h1>, <h2>, <h3>, <h4>, <h5>, <h6> 단락 태그: <p> 목록 태그: <ul>, <ol>, <li> 분할 태그: <div> 구문 태그: <br>, <strong>, <em>: 지원되지 않는 태그:
중요사항:
|
price |
서비스 가격입니다. |
priceInterpretation |
가격이 해석되고 사용자에게 표시되는 방식을 설명합니다. 식당 및 즐길 거리를 제외한 모든 카테고리에서 서비스 가격 표시를 구성하는 데 사용할 수 있습니다. |
rules |
약속을 예약/취소하기 위한 규칙입니다. |
prepaymentType |
선불 결제가 필수인지, 선택사항인지, 지원되지 않는지 여부입니다. |
prepaymentTerms |
선불 결제 완료 시기에 대한 조건입니다. |
form[] |
지원 중단되었습니다. intakeForm 및 perTicketIntakeForm을 사용하세요. |
intakeForm |
사용자가 이 서비스를 예약할 때 사용자에게 추가 정보를 요청하는 양식입니다. (선택사항) |
perTicketIntakeForm |
사용자가 이 서비스를 예약할 때 사용자에게 추가 정보를 요청하는 양식입니다. 이 양식은 사용자가 예약하는 티켓마다 한 번씩 작성해야 합니다. (선택사항) |
taxRate |
서비스의 세율입니다. 이 필드가 있으면 판매자 수준에서 설정된 모든 taxRate가 재정의됩니다. 빈 메시지(taxRate { })는 적용 세율을 0으로 재설정합니다. |
paymentOptionId[] |
이 서비스 비용을 지불하는 데 사용할 수 있는 결제 옵션을 참조하는 ID 목록입니다. 실제 결제 옵션은 판매자 수준에서 정의되며 여러 판매자 간에 공유될 수도 있습니다. |
deposit |
사용자에게 보증금이 청구되는 방식을 정의합니다. 지정된 경우 서비스 보증금이 재정의됩니다. 이 값을 빈 Deposit 메시지로 설정하면 서비스 수준 보증금이 삭제됩니다. (선택사항) |
noShowFee |
사용자에게 청구될 수 있는 예약 불이행 수수료를 정의합니다. 지정된 경우 서비스 예약 불이행 수수료가 재정의됩니다. 이 값을 빈 NoShowFee 메시지로 설정하면 서비스 수준 예약 불이행 수수료가 삭제됩니다. (선택사항) |
requireCreditCard |
이 서비스를 예약하려면 사용자가 신용카드를 제공해야 하는지 여부를 나타냅니다. 이 필드는 이용 가능 여부 수준에서 재정의할 수 있습니다. (선택사항) |
actionLink[] |
이 서비스와 관련된 작업 링크입니다. 작업 링크가 있는 경우 서비스에서 유형(아래 참고)을 설정해야 합니다. |
type |
이 서비스의 사전 정의된 유형입니다. (선택사항) |
ticketType[] |
티켓이 지원되는 경우 이 서비스에 대해 예약/구매할 수 있는 티켓 유형입니다. (선택사항) |
relatedMedia[] |
이 서비스와 관련된 사진입니다. Google은 사진이 가장 효율적인 방법으로 사용자에게 표시될 수 있도록 미디어를 크롤링하고 저장합니다. (선택사항) |
serviceAttributeValueId[] |
이 서비스에 적용되는 서비스 속성 값입니다(선택사항). 각 서비스는 해당 판매자에서 정의된 서비스 속성마다 0개 이상의 값을 가질 수 있습니다. (선택사항) |
waitlistRules |
대기자 명단에 등록할 때 따라야 할 규칙입니다. |
ticketingVerticalSpecificData |
이벤트 티켓 카테고리별로 고유한 추가 정보입니다. (선택사항) |
integrationType |
이 서비스에 지원되는 통합의 깊이입니다. (선택사항) 최초 통합 파트너와는 관련이 없습니다. 이 파트너의 경우 엔드투엔드 통합이 항상 사용 중지됩니다. |
perOrderFee |
이 서비스를 구매하기 위한 주문 수준 수수료입니다. (선택사항) |
toursAndActivitiesContent |
투어 및 액티비티별 콘텐츠 필드입니다. |
location[] |
이 서비스와 관련된 위치입니다. 중요사항: 이 서비스와 관련하여 방문한 위치가 여러 개 있거나 START_LOCATION이 VISITED_LOCATION과 다른 경우 START_LOCATION을 지정해야 합니다. 예: - 가이드와 함께 세 장소를 방문하는 자전거 투어. 시작 장소를 지정해야 합니다. - 호텔 로비에서 만나 방문 장소로 이동하는 버스 투어. 만남 위치를 지정해야 합니다. |
rating |
모든 리뷰에 대한 집계 측정항목으로 이 서비스에 대한 사용자 평점입니다. |
homeServiceData |
홈 서비스 카테고리 고유의 추가 정보입니다. (선택사항) |
virtualSession |
선택사항입니다. 가상 세션에 관한 정보입니다. 가상 서비스를 사용 설정하는 데 필요합니다. |
directMerchantPayment |
선택사항입니다. 서비스에서 사용자가 판매자에게 직접 결제해야 하는 경우 추가해야 하는 추가 정보입니다. 중요사항: RwG는 이 거래에 관여하지 않습니다. virtualSession이 정의되고 서비스가 무료가 아니거나 prepaymentType이 REQUIRED로 설정되지 않은 경우 필수입니다. |
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 ( |
필드 | |
---|---|
minAdvanceOnlineCanceling |
예약을 온라인으로 취소하는 데 필요한 최소 사전 알림 시간(초)입니다. (선택사항) |
lateCancellationFee |
최소 사전 알림 기간 내에 취소하는 경우의 수수료입니다. |
noshowFee |
취소하지 않고 예약을 불이행한 경우의 수수료입니다. |
admissionPolicy |
이 서비스에 적용되는 입장 정책입니다. 설정되지 않은 경우 기본값은 TIME_STRICT입니다. (선택사항) |
cancellationPolicy |
예약 규칙 취소 정책입니다. (즐길 거리에 필요함) |
통합 필드 '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' 값은 설정되는 경우 양수여야 합니다. 둘 다 설정되지 않은 경우 시간대 시작 시간까지 시간대를 예약할 수 있습니다. 두 필드를 모두 설정하면 하나의 값만 선택되고 다른 값은 무시됩니다. 어떤 값이 선택되는지 정확하게 예측할 수 없습니다. 예:
|
|
minAdvanceBooking |
마지막 예약이 가능한 시점부터 이용 가능 시간대가 시작되는 시점까지의 기간 (초)입니다. |
minBookingBufferBeforeEndTime |
마지막 예약이 가능한 시점부터 이용 가능 시간대가 종료되는 시점까지의 기간(초)입니다. 이 필드가 설정된 경우, 사용자가 구매한 티켓을 시간대가 시작된 후 사용할 수 있다는 것을 나타내려면 '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[] |
정책에 적용되는 0개 이상의 환불 조건입니다. |
RefundCondition
단일 환불 조건을 정의합니다. 여러 환불 조건을 함께 사용하여 '환불 단계'를 서비스 시작 시간 이전의 여러 기간으로 설명할 수 있습니다.
JSON 표현 |
---|
{ "minDurationBeforeStartTime": string, "refundPercent": integer } |
필드 | |
---|---|
minDurationBeforeStartTime |
시작 시간 전 고객이 소수점 아래가 최대 9자리까지이고 ' |
refundPercent |
서비스 예약이 서비스 시작 시간 |
PrepaymentType
선불 유형을 나타내는 열거형입니다.
열거형 | |
---|---|
PREPAYMENT_TYPE_UNSPECIFIED |
기본적으로 선불 결제는 NOT_SUPPORTED로 가정합니다. |
REQUIRED |
사용자가 예약 시 서비스 대금을 결제해야 합니다. |
OPTIONAL |
사용자가 예약 시 또는 그 이후에 서비스 대금을 선불 결제할 수 있지만 예약하기 위해 선불 결제할 필요는 없습니다. |
NOT_SUPPORTED |
이 서비스의 경우 선불 결제가 지원되지 않습니다. |
PrepaymentTerms
선불 결제 완료 시기에 대한 구체적인 정보
JSON 표현 |
---|
{
"chargeTiming": enum ( |
필드 | |
---|---|
chargeTiming |
구매 시간을 기준으로 청구가 발생하는 시점입니다. |
chargeTimeBeforeStartTimeSec |
서비스 시작 후 사용자에게 결제 요금이 청구되는 시간(초)입니다. 이 필드는 ChargeTiming이 CHARGE_LATER인 경우에만 설정해야 합니다. |
ChargeTiming
구매 시간을 기준으로 청구가 발생하는 시점을 지정하기 위한 열거형입니다.
열거형 | |
---|---|
CHARGE_TIMING_UNSPECIFIED |
사용하지 않습니다. |
CHARGE_NOW |
고객에게 즉시 요금이 청구됩니다. |
CHARGE_LATER |
나중에 고객에게 요금이 청구됩니다. |
ServiceIntakeForm
판매자가 제공하는 서비스를 맞춤설정하는 접수 양식을 정의합니다.
JSON 표현 |
---|
{
"field": [
{
object ( |
필드 | |
---|---|
field[] |
사용자에게 표시되는 필드입니다. |
firstTimeCustomers |
true인 경우 서비스를 처음 이용하는 고객에게 이 양식이 표시됩니다. 지원 중단되었습니다. 이 기능은 접수 양식에서 지원되지 않습니다. |
returningCustomers |
true인 경우 서비스를 다시 이용하는 고객에게 이 양식이 표시됩니다. 지원 중단되었습니다. 이 기능은 접수 양식에서 지원되지 않습니다. |
ServiceIntakeFormField
ServiceIntakeForm에 포함되는 필드를 정의합니다.
JSON 표현 |
---|
{ "id": string, "type": enum ( |
필드 | |
---|---|
id |
양식 필드를 고유하게 나타내는 애그리게이터 파트너의 문자열입니다. 이 ID는 해당 양식 필드 답변의 ID와 동일해야 하며 서비스 수준과 티켓 접수 양식마다 고유해야 합니다. (필수) |
type |
이 필드의 유형입니다. |
label |
이 필드의 사용자에게 표시되는 텍스트입니다. 지원 중단되었습니다. 대신 |
localizedLabel |
이 필드의 사용자에게 표시되는 텍스트입니다. 이 필드는 여러 언어로 제공될 수 있습니다. (필수) |
value[] |
필드 유형이 LOCATION_SEARCH인 경우에만 설정합니다. 위치 값을 지정하려면 'location' 필드의 'locationId'를 사용하세요. |
choiceText[] |
필드 유형이 MULTIPLE_CHOICE, CHECKBOXES 또는 DROPDOWN인 경우에만 설정합니다. 가능한 선택 항목을 열거하는 데 사용됩니다. |
isRequired |
사용자가 이 필드에 답변해야 하는지 여부를 나타냅니다. |
allowCustomAnswer |
사전 정의된 답변 외에 커스텀 값이 허용되는지 여부를 나타냅니다. 필드 유형이 LOCATION_SEARCH인 경우에만 적용됩니다. (선택사항) |
additionalOption[] |
제공된 값과 더불어 제공된 추가 옵션입니다. 필드 유형이 LOCATION_SEARCH인 경우에만 적용됩니다. 예: 제공된 위치 목록 외에 '공급업체에 나중에 문의하겠습니다.'를 선택할 수도 있습니다. (선택사항) |
ticketTypeRestrict[] |
사용자가 특정 티켓 유형을 예약할 때만 이 질문을 표시해야 하는 경우 이 필드를 해당 티켓 유형 ID의 집합으로 설정해야 합니다. 질문을 항상 표시해야 하는 경우 입력란을 비워두세요. |
hint |
입력 힌트 텍스트로, 텍스트 자리표시자로 표시됩니다. 필드 유형이 SHORT_ANSWER 또는 PARAGRAPH인 경우에만 적용됩니다. (선택사항) |
FieldType
필드 유형을 나타내는 열거형입니다.
열거형 | |
---|---|
FIELD_TYPE_UNSPECIFIED |
지정되지 않거나 알 수 없는 유형의 필드는 무시됩니다. |
SHORT_ANSWER |
한 줄의 텍스트 입력란입니다. |
PARAGRAPH |
여러 줄의 텍스트 입력란입니다. |
MULTIPLE_CHOICE |
여러 옵션 중 하나를 선택해야 하는 라디오 버튼의 집합입니다. |
CHECKBOXES |
체크박스가 있는 하나 이상의 열거된 항목입니다. |
DROPDOWN |
드롭다운의 선택항목입니다. |
BOOLEAN |
예/아니요 버튼입니다. |
LOCATION_SEARCH |
제공된 위치 목록에서 제공된 사용자 입력과 일치하는 위치를 찾을 수 있는 검색 창입니다. |
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 ( |
필드 | |
---|---|
ticketTypeId |
티켓 ID는 동일한 서비스의 여러 티켓 유형을 구분하는 데 사용되며 서비스 내에서만 고유합니다. |
shortDescription |
이 TicketType의 간단한 설명입니다. 사용자가 볼 수 있습니다(예: '성인', '어린이', '재향군인', 'J열'). 필수 항목입니다. 각 티켓 유형에는 사용자가 볼 수 있는 설명이 있어야 합니다. 지원 중단되었습니다. 대신 localizedShortDescription을 사용하세요. |
localizedShortDescription |
i18n 지원 기능이 있는 이 TicketType의 간단한 설명입니다. 사용자가 볼 수 있습니다(예: '성인', '어린이', '재향군인', 'J열'). 필수 항목입니다. 각 티켓 유형에는 사용자가 볼 수 있는 설명이 있어야 합니다. 언어마다 별도의 값을 제공할 수 있습니다. |
price |
이 유형의 티켓 한 장의 가격입니다(세금 제외). 서비스 세율이 티켓에 적용됩니다. |
perTicketFee |
이 티켓을 구매하기 위한 추가 수수료입니다. (선택사항) |
optionDescription |
이 티켓 유형이 나타내는 추가 옵션의 설명입니다. 지원 중단되었습니다. 대신 localizedOptionDescription을 사용하세요. |
localizedOptionDescription |
이 티켓 유형이 나타내는 추가 옵션의 설명입니다. 언어마다 별도의 값을 제공할 수 있습니다. 추가 옵션은 티켓 유형이 여러 측정기준을 나타내는 경우 유용합니다. 예 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 형식 태그(, |
PerTicketFee
사용자가 구매하는 티켓마다 지불해야 하는 수수료입니다.
JSON 표현 |
---|
{ "serviceCharge": { object ( |
필드 | |
---|---|
serviceCharge |
서비스에 대해 계산된 추가 요금입니다. |
facilityFee |
장소/시설에 대한 비용 |
taxes |
티켓당 세금입니다. |
RelatedMedia
이 서비스와 관련된 사진입니다. Google에서 이 미디어를 크롤링하여 최종 사용자에게 올바르게 표시되도록 합니다. (선택사항)
JSON 표현 |
---|
{ "url": string, "type": enum ( |
필드 | |
---|---|
url |
이 미디어 소스의 URL입니다. Google에서 이 URL에서 호스팅되는 미디어를 크롤링합니다. |
type |
이 미디어 소스의 유형입니다. |
localizedCaption |
i18n을 지원하는 미디어의 자막입니다. 일반 텍스트만 지원됩니다. 모든 HTML 구성요소가 제거됩니다. (선택사항) |
attribution |
미디어의 소스에 대한 저작자 표시 정보입니다. 미디어에 저작자를 표시하여 사진사 또는 대행사의 이름을 언급해야 하는 경우 이 필드를 설정해야 합니다. (선택사항) |
caption |
지원 중단되었습니다. localizedCaption을 사용하세요. |
MediaType
이 미디어 소스의 유형을 나타내는 열거형입니다. 사진만 지원됩니다. 사진 이외 다른 미디어를 지원해야 하는 경우 Google 예약 팀에 문의하세요.
열거형 | |
---|---|
TYPE_UNSPECIFIED |
사용하지 않습니다. |
PHOTO |
URL에서 제공하는 미디어가 사진임을 나타냅니다. |
저작자 표시
이 미디어의 저작권 표시 정보입니다.
JSON 표현 |
---|
{
"localizedText": {
object ( |
필드 | |
---|---|
localizedText |
i18n을 지원하는 사진사 또는 대행사의 이름을 언급하는 텍스트입니다. 이 텍스트는 소스 미디어와 함께 표시됩니다. 이 필드에는 일반 텍스트만 사용할 수 있으며 HTML 구성요소는 모두 제거됩니다(하이퍼링크 기반 저작자 표시는 지원되지 않습니다). |
text |
지원 중단되었습니다. localizedText를 사용하세요. |
ServiceAttributeValueId
서비스에 적용될 서비스 속성의 특정 값을 나타냅니다.
JSON 표현 |
---|
{ "attributeId": string, "valueId": string } |
필드 | |
---|---|
attributeId |
Merchant.service_attribute에 정의된 속성의 ID입니다. 예: 'service-type'입니다. |
valueId |
이 속성 값의 ID입니다(예: '헤어컷')입니다. 서비스 속성 정의의 valueId와 일치해야 합니다. |
WaitlistRules
대기자 명단에 등록하는 것과 관련된 규칙입니다.
JSON 표현 |
---|
{
"minPartySize": integer,
"maxPartySize": integer,
"supportsAdditionalRequest": boolean,
"aboveMaxPartySizeOptions": [
{
object ( |
필드 | |
---|---|
minPartySize |
필수사항입니다. 대기자 목록 기능을 제공하는 서비스의 경우 양의 정수여야 합니다. 서비스 또는 판매자가 대기자 명단 기능을 제공하지 않는 경우에는 입력하지 않아야 합니다. |
maxPartySize |
필수사항입니다. 대기자 목록 기능을 제공하는 서비스의 경우 양의 정수여야 합니다. 서비스 또는 판매자가 대기자 명단 기능을 제공하지 않는 경우에는 입력하지 않아야 합니다. |
supportsAdditionalRequest |
true인 경우 사용자는 이 서비스의 대기자 명단에 등록할 때 자유 형식의 추가 텍스트 요청을 보낼 수 있습니다. |
aboveMaxPartySizeOptions[] |
설정된 maxPartySize보다 큰 파티용 옵션을 설정합니다. 인원이 많은 인원이 대기자 명단에 등록할 수 있는 대체 옵션을 제공하지 않으려면 비워 둡니다. |
UnsupportedPartySizeOption
범위를 벗어난 정당을 위한 옵션입니다.
JSON 표현 |
---|
{
"callMerchant": {
object ( |
필드 | |
---|---|
callMerchant |
인원수가 범위를 벗어나면 비즈니스에 전화를 걸 수 있습니다. 사전 정의된 메시지가 사용자에게 표시됩니다. 표시할 샘플 텍스트: '{waitlistRules.max_party_size}보다 큰 규모의 파티인 경우 {phone}번으로 음식점에 전화하세요. CallMerchant를 설정해야 하지만 비어 있습니다. |
CallMerchant
지원되지 않는 파티크기 옵션에 사용할 빈 메시지입니다. 이 설정을 사용하면 사용자가 비즈니스에 전화를 걸어 예약할 수 있는 옵션이 표시됩니다.
TicketingVerticalSpecificData
이벤트 티켓 카테고리별로 고유한 추가 정보입니다.
JSON 표현 |
---|
{ "eventCategory": enum ( |
필드 | |
---|---|
eventCategory |
이벤트의 카테고리입니다. 이벤트가 사전 정의된 카테고리 중 하나에 속하는 경우에만 설정합니다. (선택사항) |
eventUrl |
파트너 웹사이트의 이벤트 URL입니다. (선택사항) |
entity[] |
이벤트와 관련된 항목의 목록입니다. (선택사항) |
eventAttendanceMode |
필수 항목입니다. 이벤트 참석 유형입니다. |
eventVirtualLocationUrl[] |
선택사항입니다. 이벤트를 볼 수 있는 URL입니다. |
eventOrganizer |
선택사항입니다. 이벤트를 주최하는 주최자입니다. |
eventOrganizerUrl |
선택사항입니다. 일정을 주최하는 주최자의 URL입니다. |
eventOrganizerType |
선택사항입니다. 주최자 유형입니다. |
eventSourceUrl[] |
필수 항목입니다. 이벤트 정보 또는 설명을 찾을 수 있는 페이지의 URL입니다. |
eventState |
선택사항입니다. 이벤트 상태입니다. |
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 ( |
필드 | |
---|---|
id |
파트너 데이터베이스에 있는 항목의 고유 식별자입니다. (선택사항) |
name |
항목의 이름입니다. (필수) |
url |
항목을 명확하게 설명하는 웹페이지의 URL입니다. 파트너 웹사이트의 항목에 대한 웹페이지입니다(있는 경우). 항목의 다른 공개 URL의 경우 publicIdentificationData의 relevantUrl을 사용합니다. (선택사항) |
entityType |
항목의 유형입니다. (선택사항) |
entityRole |
이벤트에서 항목의 역할입니다. (선택사항) |
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[] |
주제 전용 웹페이지의 공개 URL입니다. 여기에는 공식 웹사이트, 디스코그스, 소셜 미디어 플랫폼, 위키피디아 또는 imdb 페이지가 포함됩니다(예: https://www.discogs.com/artist/1124645-Taylor-Swift, https://www.wikidata.org/wiki/Q19320959, https://twitter.com/acmilan). (선택사항) |
musicbrainzId |
해당하는 경우 아티스트 또는 기타 음악 항목의 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 |
이벤트가 연기되었습니다. |
IntegrationType
지원되는 통합의 심도입니다.
열거형 | |
---|---|
INTEGRATION_TYPE_UNSPECIFIED |
기본값은 END_TO_END입니다. |
INTEGRATION_TYPE_END_TO_END |
Google을 통한 엔드투엔드 예약이 가능한 완전한 통합입니다. |
INTEGRATION_TYPE_INVENTORY_ONLY |
예약 서버는 이 서비스를 지원할 필요가 없습니다. 판매자, 서비스 및 이용 가능 여부 데이터(선택사항)만 전송해야 합니다. |
PerOrderFee
티켓 수와 관계없이 주문당 한 번 지불해야 하는 수수료입니다.
JSON 표현 |
---|
{ "deliveryFee": { object ( |
필드 | |
---|---|
deliveryFee |
배송 방법에 따라 달라질 수 있는 수수료. |
processingFee |
사용자의 결제 수단을 처리하기 위한 수수료입니다. |
ToursAndActivitiesContent
투어 및 액티비티별 콘텐츠 필드입니다. 반복 필드의 각 요소는 독립적으로 렌더링되어야 합니다(예: 글머리 기호).
투어 및 액티비티의 경우 ToursAndActivitiesContent를 채우는 것이 좋지만 반드시 그럴 필요는 없습니다. 모든 필드에는 일반 텍스트와 HTML 텍스트 모두 기본 서식으로 사용할 수 있습니다. 지원되는 HTML 형식의 태그:
구문 태그:
, , , : 위에 언급된 세 가지 태그만 지원됩니다.
은 단락에서 줄을 바꾸는 데 사용할 수 있으며, //은 중요한 텍스트를 강조표시하는 데 사용할 수 있습니다. 다른 구문 태그는 모두 무시됩니다.
다른 모든 태그와 맞춤 스타일은 허용되지 않으며 삭제됩니다. URL, 앵커, 링크는 모두 제거되며 최종 사용자에게 표시되지 않습니다.
중요사항: * highlights
, exclusion
및 기타 서비스 설명의 더 구체적인 필드에 이미 입력된 데이터를 복제하지 마세요. * 위에 언급된 지원되는 태그를 제외한 다른 태그를 사용하지 마세요. 지원되지 않는 태그 내의 콘텐츠는 제거되며 원하지 않는 사용자 환경으로 이어질 수도 있습니다.
JSON 표현 |
---|
{ "highlights": [ { object ( |
필드 | |
---|---|
highlights[] |
사용자에게 표시되는 하이라이트 목록입니다. |
inclusions[] |
사용자에게 표시되는 포함 목록입니다. |
exclusions[] |
사용자에게 표시되는 제외 목록입니다. |
mustKnow[] |
사용자에게 표시되는 중요 참고사항 목록으로, 연령 제한 또는 기타 이 서비스를 부적합하게 만드는 조건 등의 세부정보에 사용합니다. |
Location
위치의 지리 정보입니다.
JSON 표현 |
---|
{ "placeId": string, "name": string, "telephone": string, "url": string, "geo": { object ( |
필드 | |
---|---|
placeId |
Google 지역 정보 데이터베이스 및 Google 지도에 있는 장소의 장소 ID입니다. 장소 ID에 대한 자세한 내용은 https://developers.google.com/places/web-service/place-id를 참고하세요. 이 필드가 제공되면 Google에서 위치를 이 장소에 일치시킵니다. |
name |
위치 이름, 전화번호, URL 및 지역 정보는 위치를 Google 지도에 이미 존재하는 장소와 일치시키는 데 사용됩니다. 이 필드는 선택사항이지만 일부 컨텍스트에서는 필수사항일 수 있습니다. 예를 들어 이름이 없는 Service.location은 동일한 주소에 위치하더라도 비즈니스 법인과 일치하지 않습니다. (선택사항) |
telephone |
국가 및 지역 번호를 포함한 위치의 공개 전화번호입니다(예: +14567891234). (선택사항) |
url |
위치의 공개 웹사이트 URL입니다. (선택사항) |
geo |
위도, 경도, 주소 등 위치의 지역 정보입니다. (선택사항) |
locationType |
위치의 유형으로, 서비스에 이 위치가 제공되는 경우 제공해야 합니다. |
locationId |
서비스 내 위치의 고유 참조입니다. 이 ID는 다른 서비스 필드에서 이 위치를 참조하는 데 사용할 수 있습니다. 예: 맞춤 접수 양식에서는 위치 ID 집합을 사용하여 수령 위치 옵션을 지정할 수 있습니다. 설정된 경우 이 ID는 동일한 서비스 내에서 고유해야 합니다. (선택사항) |
LocationType
이 위치의 유형입니다.
열거형 | |
---|---|
LOCATION_TYPE_UNSPECIFIED |
위치 유형이 지정되지 않았습니다. |
VISITED_LOCATION |
이 서비스가 방문하는 위치입니다. |
START_LOCATION |
이 서비스가 시작되는 위치로 MEETING_LOCATION으로도 사용됩니다. |
END_LOCATION |
서비스가 종료되는 위치입니다. |
Rating
항목의 평점을 정의합니다.
JSON 표현 |
---|
{ "value": number, "numberOfRatings": string } |
필드 | |
---|---|
value |
평균 평점 값입니다(numberOfRatings > 0인 경우 필수). 값은 [1, 5] 범위 내에 있어야 하며 numberOfRatings가 0인 경우에만 생략할 수 있습니다. |
numberOfRatings |
값을 계산하는 데 사용된 평점 수입니다 (필수). |
HomeServiceData
홈 서비스 카테고리에 대해 추가 정보를 제공해야 합니다.
JSON 표현 |
---|
{ "categoryType": string, "jobType": string } |
필드 | |
---|---|
categoryType |
이 홈 서비스가 속한 상위 수준의 카테고리입니다. 예: 배관공, 전기 기사 등 |
jobType |
특정 홈 서비스가 속한 카테고리의 작업 유형입니다. 예: unclog_drain, install_faucet는 배관공 카테고리의 작업 유형입니다. |
VirtualSession
가상/온라인 세션에 관한 정보입니다. 예: 온라인 요가 수업, 온라인 요리 강좌 등
JSON 표현 |
---|
{ "sessionInstructions": { object ( |
필드 | |
---|---|
sessionInstructions |
이 가상 수업 설정 방법에 대한 안내입니다. 파트너가 예약 시 동영상 URL을 포함하지 않는 경우 이 텍스트에는 동영상 URL이 사용자와 공유되는 시점이 포함되어야 합니다. 예: '수업 30분 전에 Zoom URL이 발송됩니다.' (권장) |
sessionRequirements |
특정 가상 세션의 요구사항입니다. 예: 요가 매트, 조리 기구 등(권장) |
virtualPlatformInfo |
이 세션에서 사용된 가상 플랫폼에 대한 정보입니다. (가상 서비스를 사용 설정하는 데 필요) |
isSessionPrerecorded |
필수 항목입니다. 가상 세션이 실시간이 아니며 사전 녹화된 경우 true로 설정합니다. |
VirtualPlatformInfo
이 가상 세션에 사용될 플랫폼에 관한 정보입니다.
JSON 표현 |
---|
{ "platform": enum ( |
필드 | |
---|---|
platform |
가상 세션에 사용되는 플랫폼입니다. |
otherPlatformName |
플랫폼이 OTHER로 설정된 경우 플랫폼의 이름입니다. (플랫폼이 OTHER로 설정된 경우 필수) |
플랫폼
판매자가 사용할 가상 플랫폼을 나타내는 열거형입니다.
열거형 | |
---|---|
PLATFORM_UNSPECIFIED |
사용하지 않습니다. |
FLEXIBLE |
판매자는 동영상 플랫폼을 유연하게 선택할 수 있습니다. |
GOOGLE_HANGOUTS |
Google 행아웃 제품입니다. |
GOOGLE_MEET |
Google Meet 제품입니다. |
ZOOM |
Zoom Video Communications를 이용해 보세요. |
SKYPE |
Skype |
YOUTUBE |
YouTube의 라이브 스트리밍 |
OTHER |
사용된 동영상 플랫폼이 여기에 언급된 플랫폼과 다른 경우 설정해야 합니다. |
DirectMerchantPayment
사용자가 RwG를 통해 서비스 요금을 선불 결제하는 대신 판매자에게 직접 지불하는 방법에 대한 정보입니다.
JSON 표현 |
---|
{
"paymentMethods": [
{
object ( |
필드 | |
---|---|
paymentMethods[] |
사용자는 아래에 언급된 결제 수단을 통해서만 결제하는 것이 좋습니다. |
메서드 |
|
---|---|
|
지정된 애그리게이터에서 관리하는 판매자의 새 Service 를 만들고 반환합니다. |
|
지정된 애그리게이터에서 관리하는 판매자의 기존 Service 를 삭제합니다. |
|
지정된 애그리게이터에서 관리하는 판매자의 기존 Service 를 업데이트하고 반환합니다. |