Package google.maps.booking.v1alpha

이용 가능 시간대가 반복될 때까지의 최대 UTC 타임스탬프입니다.

repeat_every

ExtendedServiceAvailability

연속된 이용 가능 시간대 사이의 시간을 정의합니다.

예: 이용 가능 시간대의 duration이 20분, repeat_every가 30분, start_time이 오전 9시, repeat_until이 오전 11시이면 오전 9시~9시 20분, 9시 30분~9시 50분, 오전 10시~오전 10시 20분, 오전 10시 30분~오전 10시 50분, 오전 11시~오전 11시 20분의 시간대가 생성됩니다. (필수)

ScheduleException

ScheduleException 메시지는 위에 설명된 반복의 예외로, 영업일 내 예약된 기간 및 예약이 불가능한 기간을 나타냅니다. 시간대가 예약되면 새로 이용할 수 없는 기간을 반영하도록 예외 목록이 업데이트되어야 합니다. 반복 자체는 수정할 수 없습니다.

필드

필드
`time_range`	`TimeRange` 예외의 기간입니다. 이 종료-시작 기간과 겹치는 반복에 의해 설명되는 모든 시간대는 사용할 수 없는 것으로 간주됩니다. 예: 반복의 duration이 20분, repeat_every가 30분, start_time이 오전 9시, repeat_until이 오전 11시로 지정되면 time_range가 오전 9시 45분~11시인 ScheduleException에 따라 오전 9시 30분~9시 50분, 오전 10시~10시 20분, 오전 10시 30분~10시 50분의 시간대를 이용할 수 없게 됩니다. 기간이 종료-시작 기간이므로 오전 11시에 시작하는 시간대는 영향을 받지 않습니다.

time_range

TimeRange

예외의 기간입니다. 이 종료-시작 기간과 겹치는 반복에 의해 설명되는 모든 시간대는 사용할 수 없는 것으로 간주됩니다.

예: 반복의 duration이 20분, repeat_every가 30분, start_time이 오전 9시, repeat_until이 오전 11시로 지정되면 time_range가 오전 9시 45분~11시인 ScheduleException에 따라 오전 9시 30분~9시 50분, 오전 10시~10시 20분, 오전 10시 30분~10시 50분의 시간대를 이용할 수 없게 됩니다.

기간이 종료-시작 기간이므로 오전 11시에 시작하는 시간대는 영향을 받지 않습니다.

SchedulingRuleOverrides

이용 가능 여부 수준 예약 규칙

필드

필드
`last_bookable_sec`	`int64` 이 시간대를 예약할 수 있는 마지막 시간(초)입니다. 이 타임스탬프는 적용될 시간대의 start_sec 이전이어야 합니다(사용자가 시작 시간 후에 예약할 수 있어야 하는 경우 서비스 수준 SchedulingRules.min_booking_before_end_time을 사용하세요). 이 필드가 있으면 해당하는 서비스 SchedulingRules의 min_booking_buffer에 지정된 모든 항목이 재정의됩니다.
`first_bookable_sec`	`int64` 이 시간대를 처음으로 예약할 수 있는 시간(초)입니다. 이 타임스탬프는 시간대의 start_sec 또는 last_bookable_sec(지정된 경우) 이전이어야 합니다.
`last_online_cancellable_sec`	`int64` 설정된 경우 Google 예약을 통해 이 특정 약속 시간대를 취소할 수 있는 마지막 시간 (Unix 에포크 이후 초 단위)입니다. 이 필드는 모든 서비스 수준 취소 규칙을 재정의합니다. (선택사항)

last_bookable_sec

int64

이 시간대를 예약할 수 있는 마지막 시간(초)입니다. 이 타임스탬프는 적용될 시간대의 start_sec 이전이어야 합니다(사용자가 시작 시간 후에 예약할 수 있어야 하는 경우 서비스 수준 SchedulingRules.min_booking_before_end_time을 사용하세요). 이 필드가 있으면 해당하는 서비스 SchedulingRules의 min_booking_buffer에 지정된 모든 항목이 재정의됩니다.

first_bookable_sec

int64

이 시간대를 처음으로 예약할 수 있는 시간(초)입니다. 이 타임스탬프는 시간대의 start_sec 또는 last_bookable_sec(지정된 경우) 이전이어야 합니다.

last_online_cancellable_sec

int64

설정된 경우 Google 예약을 통해 이 특정 약속 시간대를 취소할 수 있는 마지막 시간 (Unix 에포크 이후 초 단위)입니다. 이 필드는 모든 서비스 수준 취소 규칙을 재정의합니다. (선택사항)

BatchDeleteGenericRecordsRequest

지정된 피드 유형의 기록을 삭제하기 위한 일괄 요청입니다.

필드

필드
`parent`	`string` `partners/{partner_id}/feeds/{feed_name}` 형식의 리소스 이름입니다.
`records[]`	`GenericDeleteRecord` 삭제할 레코드입니다. API 호출 한 개에 최대 1,000개의 레코드가 허용됩니다.

parent

string

partners/{partner_id}/feeds/{feed_name} 형식의 리소스 이름입니다.

records[]

GenericDeleteRecord

삭제할 레코드입니다. API 호출 한 개에 최대 1,000개의 레코드가 허용됩니다.

BatchPushGenericRecordRequest

요청 URL에 지정된 피드 유형의 레코드를 삽입 또는 업데이트하기 위한 일괄 요청입니다.

필드

필드
`parent`	`string` `partners/{partner_id}/feeds/{feed_name}` 형식의 리소스 이름입니다.
`records[]`	`GenericRecord` 삽입 및/또는 업데이트할 레코드입니다. API 호출 한 개에 최대 1,000개의 레코드가 허용됩니다.

parent

string

partners/{partner_id}/feeds/{feed_name} 형식의 리소스 이름입니다.

records[]

GenericRecord

삽입 및/또는 업데이트할 레코드입니다. API 호출 한 개에 최대 1,000개의 레코드가 허용됩니다.

BatchReplaceServiceAvailabilityRequest

여러 Service의 이용 가능 시간대를 대체하기 위한 일괄 요청입니다.

필드

필드
`parent`	`string` `partners/{partner_id}` 형식입니다.
`extended_service_availability[]`	`ExtendedServiceAvailability` 기존의 이용 가능 시간대를 대체하는 확장된 서비스 이용 가능 시간대입니다.

parent

string

partners/{partner_id} 형식입니다.

extended_service_availability[]

기존의 이용 가능 시간대를 대체하는 확장된 서비스 이용 가능 시간대입니다.

BatchReplaceServiceAvailabilityResponse

여러 Service의 이용 가능 시간대를 대체하기 위한 일괄 응답입니다. 성공적으로 업데이트된 시간대만 이 메시지에 포함됩니다.

필드

필드
`extended_service_availability[]`	`ExtendedServiceAvailability` 성공적으로 업데이트된 확장된 서비스 이용 가능 시간대 메시지로, 기존 이용 가능 시간대를 대체합니다.

extended_service_availability[]

ExtendedServiceAvailability

성공적으로 업데이트된 확장된 서비스 이용 가능 시간대 메시지로, 기존 이용 가능 시간대를 대체합니다.

Booking

인벤토리 시간대 예약

필드
`name`	`string` 예약의 리소스 이름: `partners/{partner ID}/bookings/{booking ID}`
`merchant_id`	`string` 시간대의 판매자 ID입니다.
`service_id`	`string` 판매자 서비스의 ID입니다.
`start_time`	`Timestamp` 예약 시간대의 시작 시간
`duration`	`Duration` 약속 시간대의 기간입니다.
`client_information`	`ClientInformation` 예약한 고객의 개인 정보
`status`	`BookingStatus` 예약 상태
`payment_information`	`PaymentInformation` 예약과 관련된 결제 거래에 대한 정보입니다.
`party_size`	`int64` 예약 인원수

BookingFailure

예약 처리가 실패한 이유를 비동기식으로 전달하는 상태 데이터입니다. BookingFailure는 기본적으로 비즈니스 로직 오류를 캡처하기 위한 것입니다.

필드
`cause`	`Cause` 예약이 실패한 이유입니다. (필수)
`rejected_card_type`	`CreditCardType` (원인이 PAYMENT_ERROR_CARD_TYPE_REJECTED인 경우에만 필요)
`description`	`string` 이 선택적 필드는 파트너가 디버깅 목적으로만 추가 정보를 포함하는 데 사용됩니다. (선택사항)
`payment_failure`	`PaymentFailureInformation` 결제 실패에 대한 정보입니다.

원인

실패 원인의 열거형입니다.

열거형
`CAUSE_UNSPECIFIED`	(기본값) 사용하지 마세요. '알 수 없는 오류'와 마찬가지입니다.
`SLOT_UNAVAILABLE`	참조된 이용 가능 시간대를 더 이상 사용할 수 없습니다.
`SLOT_ALREADY_BOOKED_BY_USER`	사용자가 이미 참조된 이용 가능 시간대를 예약했습니다.
`LEASE_EXPIRED`	임대(제공된 경우)가 만료되었으며 더 이상 요청된 예약을 완료하는 데 사용할 수 없습니다.
`OUTSIDE_CANCELLATION_WINDOW`	판매자의 취소 정책에 명시된 시간 제한으로 인해 현재 요청된 취소를 처리할 수 없습니다.
`PAYMENT_ERROR_CARD_TYPE_REJECTED`	제공된 신용카드 유형을 판매자가 받지 않아 결제를 처리하는 동안 오류가 발생했습니다. 신용카드 유형을 ejected_card_type으로 제공해야 합니다.
`PAYMENT_ERROR_CARD_DECLINED`	제공된 신용 카드가 거부되어 결제를 처리하는 동안 오류가 발생했습니다.
`PAYMENT_OPTION_NOT_VALID`	예약 결제에 사용된 팩/멤버십에 오류가 발생했습니다. 더 이상 유효하지 않거나 만료되었을 수 있습니다.
`PAYMENT_ERROR`	이 예약에 대한 결제를 처리하는 중에 오류가 발생했습니다. 오류가 위의 특정 결제 오류와 일치하지 않는 경우에만 이 값을 사용하여 일반적인 결제 관련 오류를 표시하세요.
`USER_CANNOT_USE_PAYMENT_OPTION`	사용자가 지정된 결제 옵션을 사용할 수 없습니다(예: 사용자가 처음 가격을 다시 사용하려고 함).
`BOOKING_ALREADY_CANCELLED`	사용자가 취소하려고 하는 예약이 이미 취소되었습니다.
`BOOKING_NOT_CANCELLABLE`	사용자가 취소하려고 하는 예약을 취소할 수 없습니다.
`OVERLAPPING_RESERVATION`	사용자에게 현재 시점과 너무 가까운 기존 예약이 있습니다.
`USER_OVER_BOOKING_LIMIT`	사용자가 애그리게이터의 사용자당 예약 한도를 초과하여 예약에 실패했습니다.
`PAYMENT_REQUIRES_3DS1`	트랜잭션을 다시 시도해야 한다고 요청하고 있지만 이번에는 3DS1 확인/응답을 받은 후 결제가 거부되는 경우 설정합니다. 현재 트랜잭션의 실패 상태는 실패로 유지됩니다. 재시도는 완전히 별개입니다. 이것이 실패 이유인 경우 payment_failure.3DS1_parameters를 설정해야 합니다. 그렇지 않은 경우 현재 원인이 PAYMENT_ERROR인 것처럼 처리됩니다.

PaymentFailureInformation

결제 실패에 대한 정보입니다.

필드

필드
`threeds1_parameters`	`ThreeDS1Parameters` RwG 애그리게이터가 사용자와 함께 3DS1 인증 프로토콜을 시작하는 데 사용하는 매개변수입니다. BookingFailure.cause가 PAYMENT_REQUIRES_3DS1로 설정되지 않은 경우 무시됩니다.

threeds1_parameters

ThreeDS1Parameters

RwG 애그리게이터가 사용자와 함께 3DS1 인증 프로토콜을 시작하는 데 사용하는 매개변수입니다. BookingFailure.cause가 PAYMENT_REQUIRES_3DS1로 설정되지 않은 경우 무시됩니다.

ThreeDS1Parameters

RwG에 3DS1 확인을 실행하도록 요청하는 매개변수입니다.

매개변수는 EMVCo의 3DS1 프로토콜 설명에 의해 설정됩니다.

필드
`acs_url`	`string` 인증을 위해 사용자에게 표시할 양식을 로드할 URL입니다.
`pa_req`	`string` PaymentAuthentication 요청입니다. ACSUrl 양식에 게시됩니다(제공되는 경우).
`transaction_id`	`string` ACS 제공업체에서 사용하는 식별자입니다. ACSUrl 양식에 게시됩니다(제공되는 경우).
`md_merchant_data`	`string` 판매자 데이터 ACSUrl 양식에 게시됩니다(제공되는 경우).

BookingStatus

예약의 상태

열거형
`BOOKING_STATUS_UNSPECIFIED`	지정되지 않습니다.
`CONFIRMED`	예약이 확인되었습니다.
`PENDING_MERCHANT_CONFIRMATION`	예약이 판매자의 확인을 대기 중이며 확인 후 확인됨 상태로 전환됩니다(현재 지원되지 않음).
`PENDING_CLIENT_CONFIRMATION`	예약이 고객의 확인을 대기 중이며 확인 후 확인됨 상태로 전환됩니다(현재 지원되지 않음).
`CANCELED`	사용자를 대신하여 예약이 취소되었습니다.
`NO_SHOW`	고객이 예약 시간에 나타나지 않았습니다.
`NO_SHOW_PENALIZED`	고객이 취소 정책을 위반하고 예약 시간에 나타나지 않았습니다.
`FAILED`	처리 실패로 인해 예약을 완료할 수 없습니다.
`DECLINED_BY_MERCHANT`	판매자가 예약을 비동기식으로 거부했습니다.

CallMerchant

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

CancellationPolicy

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

필드

필드
`refund_condition[]`	`RefundCondition` 정책에 적용되는 환불 조건이 0개 이상 있습니다.

refund_condition[]

RefundCondition

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

RefundCondition

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

필드

필드
`min_duration_before_start_time`	`Duration` 시작 시간 전 고객이 `refund_percent`에 명시된 서비스 비용의 일부를 환불받을 때까지의 기간입니다. 0(기본값)으로 설정된 경우 서비스가 언제든지 취소될 수 있습니다.
`refund_percent`	`uint32` 서비스 예약이 서비스 시작 시간 `min_duration_before_start_time` 이상 전에 취소되는 경우 환불 가능한 비율입니다([0, 100]의 범위). 0(기본값)으로 설정된 경우 환불되지 않습니다. 100으로 설정된 경우 전액 환불받을 수 있습니다.

min_duration_before_start_time

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

refund_percent

uint32

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

ClientInformation

예약하는 사람에 대한 개인 정보

필드
`given_name`	`string` 고객의 이름입니다.
`family_name`	`string` 고객의 성
`address`	`PostalAddress` 클라이언트의 주소입니다.
`telephone`	`string` 고객의 전화번호입니다.
`email`	`string` 고객의 이메일 주소입니다.

CreateMerchantRequest

Merchant 생성 요청입니다.

필드

필드
`parent`	`string` 이 판매자를 소유한 파트너의 상위 리소스 이름으로, `partners/{partner_id}` 형식입니다.
`merchant_id`	`string` 이 판매자에 사용할 판매자 ID입니다.
`merchant`	`Merchant` 생성할 판매자입니다.

parent

string

이 판매자를 소유한 파트너의 상위 리소스 이름으로, partners/{partner_id} 형식입니다.

merchant_id

string

이 판매자에 사용할 판매자 ID입니다.

merchant

Merchant

생성할 판매자입니다.

CreateServiceRequest

새 Service 생성 요청입니다.

필드

필드
`parent`	`string` 이 서비스를 소유한 판매자의 상위 리소스 이름으로, `partners/{partner_id}/merchants/{merchant_id}` 형식입니다.
`service_id`	`string` 이 서비스에 사용할 서비스 ID입니다.
`service`	`Service` 만들 서비스입니다.

parent

string

이 서비스를 소유한 판매자의 상위 리소스 이름으로, partners/{partner_id}/merchants/{merchant_id} 형식입니다.

service_id

string

이 서비스에 사용할 서비스 ID입니다.

service

Service

만들 서비스입니다.

CreditCardRestrictions

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

필드

필드
`credit_card_type[]`	`CreditCardType` 지원되는 신용카드 목록입니다. 비어 있으면 신용카드가 지원되지 않습니다.

credit_card_type[]

CreditCardType

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

CreditCardType

신용카드 유형입니다.

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

DeleteMerchantRequest

Merchant 삭제 요청입니다.

필드

필드
`name`	`string` 삭제할 판매자의 리소스 이름입니다. 파트너/{partner_id}/판매자/{merchant_id} 형식입니다.

name

string

삭제할 판매자의 리소스 이름입니다. 파트너/{partner_id}/판매자/{merchant_id} 형식입니다.

DeleteServiceRequest

Service 삭제 요청입니다.

필드

필드
`name`	`string` 삭제할 서비스의 리소스 이름입니다. `partners/{partner_id}/merchants/{merchant_id}/services/{service_id}` 형식입니다.

name

string

삭제할 서비스의 리소스 이름입니다. partners/{partner_id}/merchants/{merchant_id}/services/{service_id} 형식입니다.

Deposit

사용자에게 청구하거나 사용자의 신용카드에 보류한 보증금입니다.

필드

필드
`deposit`	`Price` 보증금
`min_advance_cancellation_sec`	`int64` 보증금에 대한 최소 사전 취소 금액입니다.
`deposit_type`	`PriceType` 이용 가능 여부로부터 보증금이 결정되는 방식을 정의합니다.

deposit

보증금

min_advance_cancellation_sec

int64

보증금에 대한 최소 사전 취소 금액입니다.

deposit_type

PriceType

이용 가능 여부로부터 보증금이 결정되는 방식을 정의합니다.

DirectMerchantPayment

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

필드

필드
`payment_methods[]`	`Text` 사용자는 아래에 언급된 결제 수단을 통해서만 결제하는 것이 좋습니다.

payment_methods[]

Text

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

DurationRange

제한되거나 제한되지 않을 수 있는 기간 범위의 래퍼입니다. min_duration과 max_duration 기간 중 하나 이상이 필요합니다.

필드

필드
`min_duration`	`Duration` 최소 기간
`max_duration`	`Duration` 최대 기간

min_duration

최소 기간

max_duration

최대 기간

ExtendedServiceAvailability

이용 가능 여부 및 적용 대상/시기의 목록입니다.

필드
`merchant_id`	`string` 아래의 재고 메시지가 속한 판매자를 지정하는 데 필요한 필수 필드입니다.
`service_id`	`string` 아래의 이용 가능 여부 메시지가 속한 서비스를 지정하는 데 필요한 필수 필드입니다.
`start_time_restrict`	`Timestamp` 제공되는 경우 제공된 이용 가능 여부 항목이 [start_time_restrict, end_time_restrict)의 전체 스냅샷으로 간주됩니다. 즉 다음 조건이 참이면 기존의 이용 가능 여부가 모두 삭제됩니다. `start_time_restrict <= availability.start_sec && availability.start_sec < end_time_restrict` duration 메시지가 설정되면 조건이 추가로 제한됩니다. `availability.duration == duration_restrict` resources_restrict 메시지가 설정되면 조건이 추가로 제한됩니다. `availability.resources.staff_id == resources_restrict.staff_id && availability.resources.room_id == resources_restrict.room_id` 이 필드는 일반적으로 지정된 기간의 이용 가능 여부를 완전히 업데이트하는 데 사용됩니다. start_time_restrict를 설정하고 end_time_restrict를 설정하지 않으면 start_time_restrict에서 시작하는 모든 시간을 의미하는 것으로 해석됩니다.
`end_time_restrict`	`Timestamp` end_time_restrict를 설정하고 start_time_restrict를 설정하지 않으면 end_time_restrict까지의 모든 시간을 의미하는 것으로 해석됩니다.
`duration_restrict`	`Duration` duration을 설정하면 업데이트 범위가 일치하는 기간의 이용 가능 여부로만 제한됩니다.
`resources_restrict`	`Resources` resources_restrict를 설정하면 업데이트 범위가 이 리소스 집합만으로 추가 제한됩니다. 리소스의 모든 ID 필드는 정확히 일치해야 합니다.
`availability[]`	`Availability` 새 이용 가능 여부 목록입니다.

FeedStatistics

업로드된 피드를 처리하는 동안 얻은 통계입니다.

필드

new_items

int64

이 피드에서 새로 추가한 항목입니다. 항목은 피드 유형에 따라 판매자, 서비스 또는 이용 가능 시간대입니다.

existing_items

int64

기존 항목이며 필요에 따라 피드의 최신 정보로 업데이트됩니다.

deleted_items

int64

이 피드에 더 이상 존재하지 않고 그 결과 삭제된 항목입니다.

FeedStatus

애그리게이터의 플랫폼에서 업로드한 피드의 상태입니다.

필드
`name`	`string` 다음 형식의 피드 리소스 이름입니다. `partners/{partner_id}/feeds/merchants/{file_name}` `partners/{partner_id}/feeds/services/{file_name}` `partners/{partner_id}/feeds/availability/{file_name}`
`state`	`State` 이 피드의 처리 상태입니다.
`error_details`	`string` 이 피드를 처리하지 못한 경우 사람이 읽을 수 있는 문자열로, 자세한 정보를 제공합니다.
`statistics`	`FeedStatistics` 이 피드와 관련된 통계입니다.

상태

피드의 처리 상태를 나타내는 열거형입니다.

열거형
`STATE_UNSPECIFIED`	(기본값) 사용하지 않습니다.
`IN_PROGRESS`	피드를 아직 처리 중입니다.
`SUCCESS`	피드가 처리되었습니다.
`FAILURE`	피드를 처리하는 중에 오류가 발생했습니다.

FoodOrderingMetadata

음식 주문 작업 링크의 메타데이터입니다.

필드
`fee_details[]`	`FeeDetails` 상품 총액 외에 사용자에게 청구되는 수수료의 세부정보입니다. 서비스 수수료, 배송 수수료 등 다른 유형의 수수료에 대해 반복됩니다.
`advance_order_details`	`AdvanceOrderDetails` 사용자가 지금보다 나중에 처리를 위해 주문할 수 있는 고급 주문 지원(사전 주문이라고도 함)에 관한 세부정보입니다.
통합 필드 `fulfillment_duration_options`. 주문 확인 후 주문 처리 기간입니다. 배달 주문의 경우 음식이 배달되기까지 걸리는 시간입니다. 포장 주문의 경우 음식이 준비되는 데 걸리는 시간입니다. `fulfillment_duration_options`은 다음 중 하나여야 합니다.
`fulfillment_lead_time_duration`	`Duration` 고정 기간 예: 30분
`fulfillment_lead_time_duration_range`	`DurationRange` 기간의 범위입니다. 예: * 30분~45분 * 30분 초과 * 50분 미만

AdvanceOrderDetails

미리 주문 지원

필드

is_supported

bool

사전 주문(미리 주문이라고도 함)이 지원되는 경우 true입니다. (필수)

FeeDetails

수수료 세부정보

필드

type

FeeType

수수료 유형입니다. (필수)

fee_amount

FeeAmount

단위 통화, 장바구니 금액의 일정 비율 또는 둘의 조합으로 표시된 수수료 금액입니다. (필수)

FeeAmount

FeeAmount 예: * 고정 수수료: 0달러(수수료 없음), 1.5달러(USD), 1.5달러(USD) * 고정 수수료 범위: 1.0달러(최소), 3.0달러(최대), 5.0~6.0달러 * 장바구니 크기의 비율: 15.5%, 10%~20%, 10%(최소), 15%~20%, 10%(최소), 15%~20%, 10%(최소), 5~2.5%, 0.5~2.5%, 최소 0.5% 및 2.5~2.5%, 비율 및 비율의 최소 범위 및 비율: 0.5~1.5달러(USD), 1.5달러(USD) * 고정 수수료 범위: 1.0달러(최소), 3.0달러(최대), 5.0~6.0달러

필드
`cart_percentage`	`QuantitativeValue` 장바구니 금액의 일정 비율에 해당하는 수수료입니다. 범위 (제한된 및 제한되지 않은) 또는 고정 비율을 지원합니다. 값은 0에서 100 사이여야 합니다. 예: * 고정 5.5% * 최소 5.5% * 최대 5.5% * 4.5% ~5.5%
통합 필드 `amount_options`. 금액을 지정하는 옵션입니다. `amount_options`은 다음 중 하나여야 합니다.
`amount`	`Money` 정액 (예: 3.5000 KRW)
`amount_range`	`MoneyRange` 금액 범위입니다. 예: * 3.5달러~5.5달러 * 3.5달러 이상 * 최대 5.5달러(USD)
`amount_unknown`	`bool` 금액을 알 수 없습니다.

FeeType

수수료 유형입니다.

열거형
`FEE_TYPE_UNSPECIFIED`	수수료 유형이 지정되지 않았습니다.
`DELIVERY`	배송료
`SERVICE`	서비스 수수료

FulfillmentOption

온라인 주문 작업 링크의 처리 옵션입니다.

필드
`fulfillment_type`	`FulfillmentType` 필수 항목입니다. fulfillment 유형입니다.
`available_day[]`	`AvailableDay` 필수 항목입니다. 이 처리 방법을 사용할 수 있는 날짜 목록입니다. 2일 이상 사용하는 것이 좋습니다.
`fee_details`	`FeeDetails` 필수 항목입니다. 처리 방법의 수수료 세부정보입니다.
`minimum_order`	`Price` 필수 항목입니다. 작업 링크와 연결된 처리 메서드의 최소 주문입니다.

AvailableDay

일 단위 사용 가능 여부

필드

fulfillment_date

Date

필수 항목입니다. 처리 방법을 사용할 수 있는 날짜입니다. 판매자의 시간대로 간주됩니다.

last_ordering_time

필수 항목입니다. Unix 타임스탬프입니다. 사용자가 fulfillment_date까지 상품을 주문하고 받을 수 있는 마지막 시간입니다. 즉, last_ordering_time 이후에는 fulfillment_date가 더 이상 사용 가능한 것으로 표시되지 않습니다.

예를 들어 fulfillment_date가 2020-08-10인 경우 last_ordering_time 값이 2020-08-10 18:00이면 고객이 2020-08-10에 주문을 받으려면 당일 오후 6시까지 주문을 해야 합니다. - last_ordering_time 값이 2020-08-08 20:00인 경우 2020년 8월 10일에 주문을 받으려면 고객이 2일 전 오후 8시까지 주문해야 합니다.

FeeDetails

작업 링크와 연결된 처리 메서드의 수수료 세부정보입니다.

필드
통합 필드 `fee_details`. 처리 방법의 수수료 모델입니다. `fee_details`은 다음 중 하나여야 합니다.
`no_fee`	`NoFee` 처리 방법에 대한 수수료는 없습니다.
`base_fee`	`MinimumFee` 처리 방법과 연결된 기본 수수료입니다.
`fixed_fee`	`FixedFee` 처리 메서드와 연결된 고정 요금입니다.

FixedFee

작업 링크와 연결된 처리 메서드에 필요한 고정 요금입니다.

필드

amount

필수 항목입니다. 처리 방법에 대한 고정 수수료 금액입니다.

FulfillmentType

작업 링크와 연결된 처리 유형입니다.

열거형
`FULFILLMENT_TYPE_UNSPECIFIED`	처리 유형이 지정되지 않았습니다.
`FULFILLMENT_TYPE_DELIVERY`	처리 유형은 전송입니다.
`FULFILLMENT_TYPE_PICKUP`	처리 유형이 수령입니다.

MinimumFee

작업 링크와 연결된 처리 메서드에 필요한 최소 수수료입니다.

필드

base_fee_amount

필수 항목입니다. 처리 방법의 기본 수수료 금액입니다.

NoFee

작업 링크와 연결된 처리 방법에는 수수료가 필요하지 않습니다.

GenericDeleteRecord

URL 요청에 언급된 피드 유형을 삭제할 기록입니다.

필드
`delete_time`	`Timestamp` 필수 항목입니다. 이 타임스탬프는 인벤토리에 삭제가 적용되는 순서를 결정하는 데 사용됩니다.
통합 필드 `record_type`. 다양한 유형의 피드 캡슐화 (ndjson, proto 기반 등) 파트너는 레코드가 피드 또는 BatchPush API에 제공되는 방식과 유사하게 전체 레코드를 제공할 수 있습니다. 또한 파트너는 레코드를 고유하게 식별하는 데 필요한 레코드의 필수 필드만 포함할 수 있습니다. `record_type`은 다음 중 하나여야 합니다.
`data_record`	`bytes` proto 기반이 아닌 피드용.
`proto_record`	`Any` proto 기반 피드의 경우

GenericRecord

URL 요청에 언급된 피드 유형 기록

필드
`generation_timestamp`	`Timestamp` 필수 항목입니다. 이 타임스탬프는 인벤토리 업데이트의 올바른 순서를 보장하는 데 사용됩니다.
통합 필드 `record_type`. 다양한 유형의 피드 캡슐화 (ndjson, proto 기반 등) `record_type`은 다음 중 하나여야 합니다.
`data_record`	`bytes` proto 기반이 아닌 피드용.
`proto_record`	`Any` proto 기반 피드의 경우

GeoCoordinates

위도, 경도 및 주소를 포함한 위치의 지역 데이터입니다.

필드
`latitude`	`double` 위도입니다. (선택사항)
`longitude`	`double` 경도입니다. (선택사항)
통합 필드 `addresses`입니다. 위치의 주소이며, 구조화된 상태 또는 구조화되지 않은 상태입니다. `addresses`는 다음 중 하나여야 합니다.
`address`	`PostalAddress` 위치의 우편 주소입니다(권장).
`unstructured_address`	`string` 구조화되지 않은 주소를 대체 주소로 제공할 수도 있습니다. 예: '1600 amphitheatre parkway mountain view, ca 94043'

GetMerchantStatusRequest

MerchantStatus 가져오기 요청

필드

name

string

필수 항목입니다. 파트너/{partner_id}/merchants/{merchant_id}/상태 형식의 리소스 이름입니다.

GetStatusRequest

애그리게이터 플랫폼에서 업로드한 특정 피드의 Status 검색 요청입니다.

필드

name

string

다음 형식의 피드 리소스 이름입니다.

partners/{partner_id}/feeds/merchants/{file_name}
partners/{partner_id}/feeds/services/{file_name}
partners/{partner_id}/feeds/availability/{file_name}

HomeServiceData

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

필드

category_type

string

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

job_type

string

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

IntegrationType

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

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

InvalidateResourceRequest

리소스를 무효화하는 요청입니다.

필드

resource_id

string

무효화할 리소스의 이름입니다.

예를 들어 수령 리소스의 경우 이름은 partners/{partner_id}/pickups/{pickup_id} 형식이어야 합니다. 구현은 식별된 리소스의 캐시된 버전을 삭제해야 합니다(MUST).

LineItem

주문의 단일 항목, 단일 시간대의 단일 서비스 예약입니다.

필드
`service_id`	`string` 판매자 서비스의 ID입니다.
`start_sec`	`int64` 약속 시간대의 시작 시간(Unix 에포크 이후 UTC 시간(초))입니다.
`duration_sec`	`int64` 약속 시간대의 지속 시간(초)입니다.
`tickets[]`	`OrderedTickets` 티켓 유형별 주문된 티켓 수입니다.
`price`	`Price` 이 광고 항목의 총 가격 (세금 제외)입니다.
`status`	`BookingStatus` 광고 항목의 상태입니다.

OrderedTickets

티켓 유형별 주문된 티켓 수입니다.

필드

ticket_id

string

티켓 유형의 ID입니다.

count

int32

이 유형의 주문된 티켓 수입니다.

ListMerchantStatusesRequest

MerchantStatus 목록 가져오기 요청

필드
`parent`	`string` 필수 항목입니다. 이 판매자 상태 컬렉션을 소유한 상위 항목입니다. 형식: `partners/{partner_id}/merchants`
`page_size`	`int32` 필수 항목입니다. 반환할 최대 항목 수입니다. 서버에서 페이지 크기를 줄일 수도 있습니다.
`page_token`	`string` 선택사항입니다. 이전 ListMerchantStatusResponse에서 반환된 nextPageToken 값입니다(있는 경우).
`booking_inventory_status_restrict`	`BookingInventoryStatus` 선택사항입니다. 예약 인벤토리 상태를 기준으로 결과를 필터링하기 위한 선택적 제한사항입니다.
`waitlist_inventory_status_restrict`	`WaitlistInventoryStatus` 선택사항입니다. 대기자 명단 인벤토리 상태를 기준으로 결과를 필터링하기 위한 선택적 제한사항입니다.
`geo_match_restrict`	`GeoMatchingStatus` 선택사항입니다. 지역 일치 상태별로 결과를 필터링하기 위한 선택적 제한사항입니다.

BookingInventoryStatus

엔드 투 엔드 예약 인벤토리 상태

열거형
`BOOKING_INVENTORY_STATUS_UNSPECIFIED`	지정되지 않음
`NO_VALID_FUTURE_INVENTORY`	판매자에게 향후 30일 이내에 예약 인벤토리가 없습니다.
`HAS_VALID_FUTURE_INVENTORY`	판매자가 앞으로 30일 이내에 인벤토리를 예약해야 합니다.

GeoMatchingStatus

판매자 지역 일치 상태입니다.

열거형
`GEO_MATCHING_STATUS_UNSPECIFIED`	지정되지 않음
`GEO_UNMATCHED`	판매자가 지역과 일치하지 않습니다.
`GEO_MATCHED`	판매자가 지역 일치

WaitlistInventoryStatus

엔드 투 엔드 대기자 명단 인벤토리 상태

열거형
`WAITLIST_INVENTORY_STATUS_UNSPECIFIED`	지정되지 않음
`NO_VALID_WAITLIST_SERVICE`	판매자에게 대기자 명단을 지원하는 서비스가 없습니다.
`HAS_VALID_WAITLIST_SERVICE`	판매자가 대기자 명단을 지원하는 서비스를 보유하고 있습니다.

ListMerchantStatusesResponse

목록 MerchantStatus에 대한 응답입니다.

필드

merchant_statuses[]

MerchantStatus

필터 조건을 충족하는 판매자 상태의 목록입니다.

next_page_token

string

결과의 다음 페이지를 가져오기 위한 토큰입니다. 비어 있으면 목록에 더 이상 결과가 없는 것입니다.

ListStatusRequest

애그리게이터 플랫폼에서 업로드한 여러 피드의 Status 검색 요청입니다.

필드
`name`	`string` 다음 형식의 피드 리소스 이름입니다. `partners/{partner_id}/feeds/merchants` `partners/{partner_id}/feeds/services` `partners/{partner_id}/feeds/availability`
`page_size`	`int32` 반환할 최대 항목 수입니다.
`page_token`	`string` 이전 List 요청에서 반환된 next_page_token 값입니다(있는 경우).
`state_restrict`	`State` 피드 상태를 기준으로 결과를 필터링하기 위한 선택적 제한입니다.
`time_range_restrict`	`TimeRange` 상한 및 하한을 기준으로 결과를 필터링하기 위한 선택적 제한입니다. start_time이 설정되지 않은 경우 기본적으로 Unix 시간의 시작으로 설정됩니다. end_time이 설정되지 않은 경우 기본적으로 지금으로 설정됩니다.

ListStatusResponse

애그리게이터 플랫폼에서 업로드한 여러 피드의 Status 검색 요청입니다.

필드

status[]

FeedStatus

업로드된 피드 상태의 시간 역순 목록입니다. 반환되는 최대 항목 수는 요청의 page_size 필드를 기반으로 합니다.

next_page_token

string

결과의 다음 페이지를 가져오기 위한 토큰입니다. 비어 있으면 목록에 더 이상 결과가 없는 것입니다.

LocalizedString

한 언어로 된 문자열의 인스턴스입니다.

필드

locale

string

IETF BCP 47 언어 코드(예: 'en', 'mas', 'zh-Hant', 'de-CH-1901')입니다. http://www.w3.org/International/articles/language-tags/를 참고하세요.

value

string

위 언어로 된 메시지 (UTF-8)

위치

위치의 지리 정보입니다.

필드
`place_id`	`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`	`GeoCoordinates` 위도, 경도, 주소 등 위치의 지역 정보입니다. (선택사항)
`location_type`	`LocationType` 위치의 유형으로, 서비스에 이 위치가 제공되는 경우 제공해야 합니다.
`location_id`	`string` 서비스 내 위치의 고유 참조입니다. 이 ID는 다른 서비스 필드에서 이 위치를 참조하는 데 사용할 수 있습니다. 예를 들어 맞춤 접수 양식에서 수령 위치 옵션을 지정하는 데 위치 ID 집합을 사용할 수 있습니다. 설정된 경우 이 ID는 동일한 서비스 내에서 고유해야 합니다. (선택사항)

LocationType

이 위치의 유형입니다.

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

Merchant

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

필드
`name`	`string` `partners/{partner_id}/merchants/{merchant_id}` 형식의 판매자 리소스 이름입니다.
`merchant_name`	`string` merchant_name, 전화번호, URL 및 지역 정보는 파트너 인벤토리를 Google 지도에 이미 존재하는 판매자와 일치시키는 데 사용됩니다. 이 정보는 표시되지 않습니다. 판매자의 이름입니다.
`telephone`	`string` 국가 및 지역 번호를 포함한 판매자의 공개 전화번호입니다(예: +14567891234).
`url`	`string` 판매자의 공개 웹사이트 URL입니다.
`geo`	`GeoCoordinates` 위도, 경도, 주소를 포함한 판매자의 지역 정보입니다.
`category`	`string` 애그리게이터 플랫폼의 비즈니스 카테고리입니다.
`num_bookings_30d (deprecated)`	`int64` 이 항목은 지원 중단되었습니다. 이 필드는 지원 중단되었습니다.
`tax_rate_basis_points (deprecated)`	`uint32` 이 항목은 지원 중단되었습니다. 판매자의 1/100퍼센트(1퍼센트의 1/100) 세율입니다. 예를 들어 세율이 7.5%이면 이 필드를 750으로 설정해야 합니다. 이 필드를 설정하지 않거나 0으로 설정하면 이 판매자가 제공하는 모든 서비스에 대해 사용자에게 청구되는 총가격은 Service.price에서 지정된 가격과 일치합니다. 관련 세금은 면제되었거나 이미 서비스 가격에 포함된 것으로 간주됩니다. 세금이 사용자에게 별도의 항목으로 표시되지 않습니다. 이 필드가 0이 아닌 값으로 설정되면 이 판매자가 제공하는 모든 서비스에 대해 사용자에게 청구되는 총가격에는 서비스 가격과 여기에 제공된 세율을 사용하여 부과되는 세금이 포함됩니다. 최소 통화 단위의 소수 금액(예: 1센트의 소수점 이하 금액)은 오사오입 방식으로 반올림됩니다. 세금이 사용자에게 별도의 항목으로 표시됩니다. 이 필드는 지원 중단되었습니다. tax_rate를 대신 사용하세요.
`tax_rate`	`TaxRate` 판매자의 세율입니다. 이 필드가 있으면 지원 중단된 tax_rate_basis_points 필드가 재정의됩니다. 메시지가 비어 있으면(tax_rate { }) 적용되는 세율이 0으로 재설정됩니다.
`payment_restrictions`	`PaymentRestrictions` 이 판매자가 수락하는 결제 수단의 제한사항입니다. 이 필드가 설정되지 않으면 제한사항이 없는 것으로 간주됩니다.
`payment_option[]`	`PaymentOption` 이 판매자가 사용할 수 있는 결제 옵션입니다. 이 판매자의 서비스에 따라 허용되는 결제 옵션이 개별적으로 제한될 수 있습니다.
`payment_processor_config (deprecated)`	`PaymentProcessorConfig` 이 항목은 지원 중단되었습니다. 판매자가 토큰화된 결제 대행업체를 지원하는 경우 해당 결제 대행업체의 구성입니다.
`tokenization_config`	`TokenizationConfig` 판매자가 토큰화된 결제 대행업체를 지원하는 경우 해당 결제 대행업체의 구성입니다.
`terms`	`Terms` Google 예약을 통해 서비스를 예약할 때 사용자에게 표시되는 특정 판매자의 이용약관입니다. 이 이용약관 외에 애그리게이터 파트너의 이용약관은 항상 사용자에게 표시되며 여기에 제공해서는 안 됩니다.
`brand_id`	`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에 문의하여 기본 브랜드를 포함해 별도의 브랜드를 구성해야 합니다.
`matching_hints`	`MerchantMatchingHints` Google이 판매자를 Google 지도의 장소와 매치시키는 데 도움이 되는 힌트입니다. 참고: Google에서 위에 제공된 정보를 사용하여 판매자를 Google 지도의 장소와 매치시키므로 대부분의 파트너는 이 필드를 설정할 필요가 없습니다. (선택사항)
`service_attribute[]`	`ServiceAttribute` 이 판매자의 서비스를 설명하는 데 사용되는 모든 서비스 속성의 정의입니다. (선택사항)
`action_link[]`	`ActionLink` 선택사항입니다. 연결된 언어, 제한된 국가 목록, 유형, 이 작업을 실행해야 하는 플랫폼을 나타내는 플랫폼(선택사항)이 포함된 작업 URL
`waitlist_advisement`	`Advisement` 선택사항입니다. Google 예약을 통해 대기자 명단에 등록한 사용자와 관련된 특정 판매자의 일반적인 조언입니다. 조언의 개별 텍스트 필드는 길이가 100바이트로 제한되어야 합니다.

MerchantMatchingHints

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

필드

place_id

string

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

MerchantStatus

Google 예약 플랫폼의 판매자 상태입니다.

필드
`name`	`string` `partners/{partner_id}/merchants/{merchant_id}/status` 형식의 판매자 상태 리소스 이름
`merchant_name`	`string` 파트너가 제공한 판매자의 이름입니다.
`input_geo_info`	`GeoCoordinates` 파트너가 판매자의 지역 정보를 제공했습니다.
`processing_status`	`ProcessingStatus` 판매자 처리 상태
`booking_status`	`BookingStatus` 엔드 투 엔드 예약 통합과 관련된 상태입니다.
`waitlist_status`	`WaitlistStatus` 대기자 명단 통합과 관련된 상태입니다.
`geo_match`	`PlaceInfo` 이 판매자의 지리적 장소와 일치합니다. 판매자가 지역과 일치하지 않는 경우 비어 있습니다.
`local_services_match`	`LocalServicesMatchInfo` 이 판매자의 지역 서비스 광고가 일치합니다. 지역 서비스 판매자가 아니거나 어떤 제공업체와도 일치하지 않는 경우 비어 있습니다.
`direct_urls[]`	`DirectUrl` 현재 판매자 인벤토리의 콘텐츠를 보여주는 URL 목록입니다. 이는 인벤토리가 실제로 게재된다는 의미는 아니며 URL이 공개적으로 표시되는 URL과 다를 수 있습니다.

BookingStatus

엔드 투 엔드 예약 통합과 관련된 상태입니다.

필드

has_valid_future_inventory

bool

판매자가 향후 30일 이내에 인벤토리를 보유하고 있는 경우 true입니다. 판매자가 실제로 서비스를 제공한다고 보장할 수는 없습니다.

DirectUrl

판매자를 표시하는 URL입니다.

필드

type

UrlType

이 URL의 유형입니다.

url

string

이 판매자를 표시할 수 있는 URL입니다.

UrlType

표시되는 URL의 유형입니다.

열거형
`URL_TYPE_UNSPECIFIED`	지정되지 않음
`BOOKING`	엔드 투 엔드 예약 URL입니다.
`WAITLIST`	엔드 투 엔드 대기자 명단 URL입니다.
`LOCAL_SERVICES`	Google 지역 서비스 URL입니다.

LocalServicesMatchInfo

Google 지역 서비스 일치 정보입니다 (지역 서비스 판매자에게만 설정됨).

필드

matched_providers[]

MatchedProvider

일치하는 서비스 제공업체입니다. 판매자는 여러 서비스 제공업체와 일치할 수 있습니다.

MatchedProvider

지역 서비스 제공업체

필드

customer_id

int64

Google 지역 서비스 외부 고객 ID입니다.

categories[]

string

지역 서비스 카테고리 (카테고리) (예: '배관공', '카펫_청소')

PlaceInfo

일치하는 장소의 정보입니다.

필드

name

string

장소의 이름입니다.

formatted_address

string

현지 언어로 된 형식이 지정된 주소입니다.

place_id

string

이 장소의 Google 장소 ID입니다. Google 지도 URL을 생성하거나 장소의 세부정보를 가져오는 데 사용할 수 있습니다. 사용 예는 https://developers.google.com/places/web-service/place-id를 참고하세요.

ProcessingStatus

판매자 처리 상태

열거형
`PROCESSING_STATUS_UNSPECIFIED`	상태가 지정되지 않았습니다.
`IN_PROGRESS`	Madden에서 판매자를 받았지만 아직 처리 중입니다. 이 상태의 판매자는 다른 상태가 채워지지 않습니다.
`COMPLETED`	판매자의 다른 상태가 계산되었습니다.

WaitlistStatus

대기자 명단 통합과 관련된 상태입니다.

필드

has_valid_waitlist_service

bool

판매자가 대기자 명단 서비스를 보유한 경우 true입니다. 판매자가 실제로 서비스를 제공한다고 보장할 수는 없습니다.

MoneyRange

한정되거나 제한되지 않을 수 있는 금액 범위의 래퍼입니다. min_amount와 max_amount 중 하나 이상이 필요합니다.

필드

min_amount

Money

최소 금액입니다.

max_amount

Money

최대 금액

NoShowFee

사용자가 예약했지만 나타나지 않은 경우 사용자에게 청구될 수 있는 수수료입니다.

필드

fee

사용자가 예약 시간에 나타나지 않는 경우 사용자에게 청구될 수 있는 금액입니다.

fee_type

PriceType

이용 가능 여부로부터 수수료가 결정되는 방식을 정의합니다.

주문

판매자와의 서비스 예약 주문입니다.

필드
`name`	`string` 주문의 리소스 이름: `partners/{partner ID}/orders/{order ID}`
`client_information`	`ClientInformation` 주문하는 고객의 개인 정보입니다.
`payment_information`	`PaymentInformation` 주문과 관련된 결제 거래에 관한 정보입니다.
`merchant_id`	`string` 이 주문의 모든 서비스가 속한 판매자의 ID입니다.
`item[]`	`LineItem` 이 주문의 광고 항목입니다.

OrderOnlineMetadata

온라인 주문 작업 링크의 메타데이터입니다.

필드

fulfillment_option[]

FulfillmentOption

온라인 주문 작업 링크에 사용할 수 있는 처리 옵션입니다.

PaymentInformation

예약과 관련된 결제 세부정보

필드

prepayment_status

PrepaymentStatus

예약의 선불 상태입니다. prepayment_status가 PREPAYMENT_PROVIDED 또는 PREPAYMENT_REFUNDED인 경우 payment_transaction_id에 연결된 고유 트랜잭션 ID가 포함됩니다.

payment_transaction_id

string

예약과 연결된 결제 트랜잭션의 고유 식별자입니다. 해당하지 않는 경우 비어 있습니다.

PaymentOption

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

필드
`payment_option_id`	`string` 이 ID는 이 결제 옵션을 나타내는 데 사용됩니다. 이 ID는 애그리게이터 전체에 적용되며 여러 판매자 간에 값을 재사용하면 사용자가 여러 판매자에 걸쳐 해당 결제 옵션으로 결제할 수 있습니다. 여러 판매자 간에 ID를 재사용하는 경우 한 판매자의 결제 옵션 값을 업데이트하면 ID가 동일한 다른 판매자의 다른 결제 옵션도 업데이트됩니다. 따라서 결정되지 않은 행동이 발생하지 않도록 동일한 ID를 공유하는 모든 결제 옵션을 동일한 값으로 업데이트하는 것이 좋습니다.
`name`	`string` 결제 옵션의 이름입니다. 사용자가 볼 수 있습니다.
`description`	`string` 결제 옵션의 설명입니다. 사용자가 볼 수 있습니다.
`price`	`Price` 결제 옵션의 가격입니다.
`tax_rate`	`TaxRate` 이 결제 옵션의 세율입니다. 이 필드가 있으면 판매자 또는 서비스에 있는 tax_rate 필드가 재정의됩니다. 메시지가 비어 있으면(tax_rate { }) 적용되는 세율이 0으로 재설정됩니다.
`payment_option_type`	`PaymentOptionType` 이 결제 옵션의 유형입니다. 예약 없이 방문한 경우 일회용, 패키지의 경우 다회용, 멤버십의 경우 무제한입니다.
`session_count`	`int64` 이 결제 옵션을 사용할 수 있는 세션 수입니다. 값이 1보다 커야 하는 다중 세션/패키지에만 유효합니다.
`purchase_interval`	`TimeRange` 이 기간 내에 결제 옵션을 구매할 수 있습니다.
`valid_interval`	`TimeRange` 이 간격 내에서 결제 옵션을 사용할 수 있습니다(예: 2017년 1월의 특별 가격). 이 필드가 있으면 valid_duration 및 activation_type이 재정의됩니다.
`valid_duration`	`Duration` 결제 옵션의 유효 기간입니다(예: 30일 멤버십).
`activation_type`	`ActivationType` 이 결제 옵션의 유효 기간 시작일이 결정되는 방식을 정의합니다.
`user_restriction`	`UserPurchaseRestriction` 결제 옵션을 구매할 수 있는 사용자를 제한합니다. 프로모션 결제 옵션을 일부 사용자로 제한하는 데 사용할 수 있습니다. 설정하지 않으면 모든 사용자가 구매할 수 있습니다.

ActivationType

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

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

PaymentOptionType

결제 옵션 유형입니다.

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

PaymentProcessorConfig

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

필드

processor

Processor

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

public_key

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를 사용한 결제 구성입니다.

PaymentRestrictions

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

필드

credit_card_restrictions

CreditCardRestrictions

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

PerOrderFee

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

필드

delivery_fee

배송 방법에 따라 다를 수 있는 수수료입니다.

processing_fee

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

PerTicketFee

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

필드

service_charge

서비스에 대해 산정된 추가 요금입니다.

facility_fee

장소/시설에 대한 수수료.

taxes

항공권당 세금.

PostalAddress

고객 또는 비즈니스의 주소입니다.

필드
`address_country`	`string` ISO 3166-1 alpha-2 국가 코드(예: 'US')를 사용하여 지정된 국가입니다(필수).
`address_locality`	`string` 지역입니다(예: '마운틴 뷰'). (필수)
`address_region`	`string` 지역입니다(예: 'CA'). 이 필드는 보통 지역이 주소의 일부인 국가에서만 필요합니다. (선택사항)
`postal_code`	`string` 우편번호입니다(예: '94043'). (필수)
`street_address`	`string` 상세 주소(예: '1600 Amphitheatre Pkwy')입니다. (필수)

PrepaymentStatus

예약의 선불 상태입니다.

열거형
`PREPAYMENT_STATUS_UNSPECIFIED`	지정되지 않은 경우 기본값은 PREPAYMENT_NOT_PROVIDED입니다.
`PREPAYMENT_PROVIDED`	예약 수수료가 미리 지불되었습니다.
`PREPAYMENT_NOT_PROVIDED`	예약 수수료가 미리 지불되지 않았습니다.
`PREPAYMENT_REFUNDED`	수수료가 이전에 PREPAYMENT_PROVIDED되었지만 이제 환불되었습니다.

가격

서비스 가격 또는 수수료입니다.

필드
`price_micros`	`int64` 가격입니다(통화의 마이크로 단위). 최소 통화 단위의 부분은 오사 오입 반올림을 사용하여 반올림됩니다. (예: 미화의 경우 2.5센트는 2센트로 반내림됨, 3.5센트는 4센트로 반올림됨, 0.5센트는 0센트로 반내림됨, 2.51센트는 3센트로 반올림됨).
`currency_code`	`string` ISO 4217에 정의된 가격 통화입니다.
`pricing_option_tag`	`string` 총 가격과 연결된 가격 옵션을 식별하는 선택적 불투명 문자열입니다.

PriceInterpretation

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

열거형
`PRICE_INTERPRETATION_UNSPECIFIED`	가격 해석 방법이 지정되지 않았습니다. 기본값은 EXACT_AMOUNT입니다.
`EXACT_AMOUNT`	가격이 특정한 값으로 해석되어야 하는 경우입니다. 예: 요가 수업 20달러, 어린이 헤어컷 15달러
`STARTS_AT`	서비스 가격이 가변적이지만 최소 가격이 알려져 있고 소비자에게 표시되는 경우입니다. 소비자는 가격을 높이는 옵션을 선택할 수 있습니다. 이 PriceInterpretation을 사용하는 서비스는 PrepaymentType NOT_SUPPORTED를 사용해야 합니다. 예: 반려견 미용 30달러, 소비자가 추가 옵션을 선택하면 가격이 증가할 수 있음
`NOT_DISPLAYED`	서비스 가격이 가변적이고 소비자에게 가격 정보가 미리 표시되지 않는 경우입니다. 이 PriceInterpretation을 사용하는 서비스는 PrepaymentType NOT_SUPPORTED를 사용해야 하고 Price가 비어 있어야 합니다. 예: 홈 서비스 상담

PriceType

이용 가능 여부로부터 총 가격이 결정되는 방식을 정의합니다.

열거형

FIXED_RATE_DEFAULT

가격은 고정 금액입니다. 필드가 설정되지 않은 경우 기본값입니다.

예: 테이블 예약을 위한 50달러 입금, 요가 강좌의 예약 불이행 수수료 20달러

PER_PERSON

지정된 가격은 1인당 가격이며, 가격은 리소스에서 price_micros * party_size로 지정된 인원 수에 따라 계산됩니다. PER_PERSON 가격은 이용 가능 여부 리소스의 인원 수와 함께 제공되어야 합니다. 그렇지 않은 경우 인원 수가 사용됩니다.

예: 박물관 입장권당 10달러

QuantitativeValue

범위 또는 고정 값일 수 있는 숫자 값의 래퍼입니다. QuantitativeValue 예: * 단수값: value: 10.5 * 경계 범위: value_range {min_value: 5.5, max_value 10.5} * 하한값: value_range {min_value: 5.5} * 상한값: value_range {max_value: 10.5}

필드

통합 필드 value_options. (필수) value_options는 다음 중 하나여야 합니다.

value

double

단일 값입니다. 예: 5.6

value_range

RangeValue

개방형 또는 제한형일 수도 있는 값의 범위입니다. 예: * 최소 5.5 * 최대 5.5 * 5.5~6.5

RangeValue

min_value < max_value와 같은 값 범위 min_value와 max_value 중 하나 이상이 필요합니다.

필드

min_value

double

최솟값입니다.

max_value

double

최댓값입니다.

등급

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

필드

value

double

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

number_of_ratings

uint64

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

RelatedMedia

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

필드
`url`	`string` 이 미디어 소스의 URL입니다. Google에서 이 URL에서 호스팅되는 미디어를 크롤링합니다.
`type`	`MediaType` 이 미디어 소스의 유형입니다.
`localized_caption`	`Text` i18n을 지원하는 미디어의 자막입니다. 일반 텍스트만 지원됩니다. 모든 HTML 구성요소가 제거됩니다. (선택사항)
`attribution`	`Attribution` 미디어의 소스에 대한 저작자 표시 정보입니다. 미디어에 저작자를 표시하여 사진사 또는 대행사의 이름을 언급해야 하는 경우 이 필드를 설정해야 합니다. (선택사항)
`caption (deprecated)`	`string` 이 항목은 지원 중단되었습니다. 지원 중단되었습니다. localized_caption을 사용하세요.

Attribution

필드

localized_text

Text

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

text
(deprecated)

string

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

MediaType

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

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

ReplaceServiceAvailabilityRequest

Service의 이용 가능 여부 대체 요청입니다.

필드

service_availability

ServiceAvailability

기존 이용 가능 여부를 대체하는 데 사용되는 서비스 이용 가능 여부입니다.

RequireCreditCard

예약 시 신용카드가 필요한지를 명시합니다.

열거형
`REQUIRE_CREDIT_CARD_UNSPECIFIED`	신용카드 요구사항이 명시적으로 지정되지 않았으며 동작이 CONDITIONAL에 대해 지정된 것과 동일합니다.
`REQUIRE_CREDIT_CARD_CONDITIONAL`	다음 조건 중 하나가 충족되면 예약 시 신용카드가 필요합니다. * 이용 가능 여부에 가격이 있고 prepayment_type이 REQUIRED입니다. * no_show_fee가 설정되었습니다. * deposit 필드가 설정되었습니다.
`REQUIRE_CREDIT_CARD_ALWAYS`	다른 필드 값과 관계없이 이 이용 가능 시간대를 예약하려면 신용카드가 항상 필요합니다.

자료

리소스는 다른 직원이나 방이 서비스의 일부인 경우 이용 가능 시간대를 서로 구별하는 데 사용됩니다. 서로 다른 리소스가 있는 경우 동일한 서비스 및 시간 간격의 여러 시간대가 공존할 수 있습니다.

필드
`staff_id`	`string` 서비스를 제공하는 직원의 ID입니다(선택사항). 이 필드는 모든 판매자, 서비스, 이용 가능 여부 레코드에서 직원을 식별합니다. 또한 이전 예약과의 상관관계를 허용하려면 시간이 지남에 따라 안정적이어야 합니다. staff_name이 있으면 이 필드가 있어야 합니다.
`staff_name`	`string` 서비스를 제공하는 직원의 이름입니다(선택사항). 이 필드는 예약하는 사용자에게 표시되며 불투명 식별자와 달리 사람이 읽을 수 있어야 합니다. staff_id가 있으면 이 필드가 있어야 합니다.
`room_id`	`string` 서비스가 위치한 방의 ID입니다(선택사항). 이 필드는 모든 판매자, 서비스, 이용 가능 여부 레코드에서 방을 식별합니다. 또한 이전 예약과의 상관관계를 허용하려면 시간이 지남에 따라 안정적이어야 합니다. room_name이 있으면 이 필드가 있어야 합니다.
`room_name`	`string` 서비스가 위치한 방의 이름입니다(선택사항). 이 필드는 예약하는 사용자에게 표시되며 불투명 식별자와 달리 사람이 읽을 수 있어야 합니다. (선택사항이지만 room_id가 있는 경우 필수) 식당에서 방 이름은 바 또는 테라스와 같은 휴식 공간에만 사용해야 하며 고정 가격 메뉴, 특별 활동 또는 기타 객실이 아닌 값 (예: 예약 또는 저녁 식사)에는 사용해서는 안 됩니다. 기본 좌석 공간에는 연결된 방이 없는 것이 좋습니다.
`party_size`	`int32` 식당에만 해당함: 이 시간대에 수용할 수 있는 인원수입니다. 음식점은 예를 들어 2, 3 또는 4인석을 예약할 수 있는 경우 각각 다른 party_size를 지정하여 동시에 여러 시간대에 연결할 수 있습니다.

SchedulingRules

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

필드
`min_advance_online_canceling`	`int64` 예약을 온라인으로 취소하는 데 필요한 최소 사전 알림 시간(초)입니다. (선택사항)
`late_cancellation_fee (deprecated)`	`Price` 이 항목은 지원 중단되었습니다. 최소 사전 알림 기간 내에 취소하는 경우의 수수료입니다.
`noshow_fee (deprecated)`	`Price` 이 항목은 지원 중단되었습니다. 취소하지 않고 예약을 불이행한 경우의 수수료입니다.
`admission_policy`	`AdmissionPolicy` 이 서비스에 적용되는 입장 정책입니다. 설정되지 않은 경우 기본값은 TIME_STRICT입니다. (선택사항)
`cancellation_policy`	`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`는 다음 중 하나입니다.
`min_advance_booking`	`int64` 마지막 예약이 가능한 시점부터 이용 가능 시간대가 시작되는 시점까지의 시간 (초)입니다.
`min_booking_buffer_before_end_time`	`int64` 마지막 예약이 가능한 시점부터 이용 가능 시간대가 종료되는 시점까지의 기간(초)입니다. 이 필드가 설정된 경우, 사용자가 구매한 티켓을 시간대가 시작된 후 사용할 수 있음을 나타내려면 'admission_policy' 필드를 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시까지 박물관에 도착해야 합니다. 이 서비스 이용 가능 시간대의 시작 시간은 지정된 입장 시간을 나타냅니다. 하지만 종료 시간은 이용 가능 시간대를 식별하기 위한 키로만 사용됩니다.

서비스

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

필드
`name`	`string` `partners/{partner_id}/merchants/{merchant_id}/services/{service_id}` 형식의 서비스 리소스 이름
`service_name`	`string` 서비스 이름입니다(예: '남성 헤어컷'). 지원 중단되었습니다. 대신 localized_service_name을 사용하세요.
`localized_service_name`	`Text` 서비스 이름입니다(예: '남성 헤어컷'). 아마도 여러 언어로 표시됩니다.
`description`	`string` 사용자에게 표시되는 서비스 설명입니다. 지원 중단되었습니다. 대신 localized_description을 사용하세요.
`localized_description`	`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> <li>명의 어린이가 <ul> 또는 <ol> 태그를 지정한 경우에만 전환됩니다. 다른 하위 항목은 모두 삭제됩니다. 또한 내부 태그, 속성, 스타일은 모두 무시됩니다. 순수한 일반 텍스트 콘텐츠만 보존됩니다. 분할 태그: <div> <div> 태그의 지원되는 내부 태그는 모두 위에 명시된 규칙으로 파싱되며 여기서 <div> 태그 자체를 암시해도 그룹화 또는 들여쓰기를 의미하지 않습니다. 또한 내부 속성과 스타일은 모두 무시됩니다. 구문 태그: <br>, <strong>, <em>: 위에 언급된 세 가지 태그만 지원됩니다. <br>은 단락에서 줄을 바꾸는 데 사용할 수 있으며, <strong>/<em>은 중요한 텍스트를 강조표시하는 데 사용할 수 있습니다. 다른 구문 태그는 모두 무시됩니다. 지원되지 않는 태그: <html>, <header>, <body> 태그는 허용되지 않습니다. 위에 언급되지 않은 다른 태그는 지원되지 않습니다(예: <table>, <td> ...). URL, 앵커, 링크는 모두 제거되며 최종 사용자에게 표시되지 않습니다. 사진을 사용하여 풍부한 사용자 환경을 만들려면 아래의 'related_media' 필드를 사용하여 사진 URL을 보내세요. 중요사항: 위에 언급된 지원되는 태그 외 다른 태그를 사용하지 마세요. 지원되지 않는 태그 내의 콘텐츠는 제거되며 원하지 않는 사용자 환경으로 이어질 수도 있습니다. 4개 이상의 제목 수준 또는 중첩 목록과 같이 깊이 중첩된 구조를 사용하지 마세요. 구조를 단순하고 간단하게 유지하면 더 나은 사용자 환경을 만들 수 있습니다. 현재 지원되는 레이아웃이 사용 사례에 충분하지 않은 경우 Google 예약팀에 문의하세요. 권장되는 최대 크기는 32,000자입니다.
`price`	`Price` 서비스의 가격입니다.
`price_interpretation`	`PriceInterpretation` 가격이 해석되고 사용자에게 표시되는 방식을 설명합니다. 식당 및 즐길 거리를 제외한 모든 카테고리에서 서비스 가격 표시를 구성하는 데 사용할 수 있습니다.
`rules`	`SchedulingRules` 약속을 예약/취소하는 규칙입니다.
`prepayment_type`	`PrepaymentType` 선불 결제가 필수인지, 선택사항인지 또는 지원되지 않는지 여부
`prepayment_terms`	`PrepaymentTerms` 선불 결제 완료 시점에 관한 약관입니다.
`form[] (deprecated)`	`ServiceIntakeForm` 이 항목은 지원 중단되었습니다. 지원이 중단되었습니다. intake_form 및 per_ticket_intake_form을 사용하세요.
`intake_form`	`ServiceIntakeForm` 사용자가 이 서비스를 예약할 때 사용자에게 추가 정보를 요청하는 양식입니다. (선택사항)
`per_ticket_intake_form`	`ServiceIntakeForm` 사용자가 이 서비스를 예약할 때 사용자에게 추가 정보를 요청하는 양식입니다. 이 양식은 사용자가 예약하는 티켓마다 한 번씩 작성해야 합니다. (선택사항)
`tax_rate`	`TaxRate` 서비스의 세율입니다. 이 필드가 있으면 판매자 수준에서 설정된 tax_rate가 재정의됩니다. 메시지가 비어 있으면(tax_rate { }) 적용되는 세율이 0으로 재설정됩니다.
`payment_option_id[]`	`string` 이 서비스의 비용을 지불하는 데 사용할 수 있는 결제 옵션을 참조하는 ID 목록입니다. 실제 결제 옵션은 판매자 수준에서 정의되며 여러 판매자 간에 공유될 수도 있습니다.
`deposit`	`Deposit` 사용자에게 보증금이 청구되는 방식을 정의합니다. 지정된 경우 서비스 보증금이 재정의됩니다. 이 값을 빈 Deposit 메시지로 설정하면 서비스 수준 보증금이 삭제됩니다. (선택사항)
`no_show_fee`	`NoShowFee` 사용자에게 청구될 수 있는 예약 불이행 수수료를 정의합니다. 지정된 경우 서비스 예약 불이행 수수료가 재정의됩니다. 이 값을 빈 NoShowFee 메시지로 설정하면 서비스 수준 예약 불이행 수수료가 삭제됩니다. (선택사항)
`require_credit_card`	`RequireCreditCard` 이 서비스를 예약하려면 사용자가 신용카드를 제공해야 하는지 여부를 나타냅니다. 이 필드는 이용 가능 여부 수준에서 재정의할 수 있습니다. (선택사항)
`action_link[]`	`ActionLink` 이 서비스와 관련된 작업 링크입니다. 작업 링크가 있는 경우 서비스에서 유형(아래 참고)을 설정해야 합니다.
`type`	`ServiceType` 이 서비스의 사전 정의된 유형입니다. (선택사항)
`ticket_type[]`	`TicketType` 티켓이 지원되는 경우 이 서비스에 대해 예약/구매할 수 있는 티켓 유형입니다. (선택사항)
`related_media[]`	`RelatedMedia` 이 서비스와 관련된 사진입니다. Google은 사진이 가장 효율적인 방법으로 사용자에게 표시될 수 있도록 미디어를 크롤링하고 저장합니다. (선택사항)
`service_attribute_value_id[]`	`ServiceAttributeValueId` 이 서비스에 적용되는 서비스 속성 값입니다(선택사항). 각 서비스는 해당 판매자에서 정의된 서비스 속성마다 0개 이상의 값을 가질 수 있습니다. (선택사항)
`waitlist_rules`	`WaitlistRules` 대기자 명단에 등록하기 위한 규칙입니다.
`ticketing_vertical_specific_data`	`TicketingVerticalSpecificData` 이벤트 티켓 카테고리별로 고유한 추가 정보입니다. (선택사항)
`integration_type`	`IntegrationType` 이 서비스에 지원되는 통합의 깊이입니다. (선택사항) 최초 통합 파트너와는 관련이 없습니다. 이 파트너의 경우 엔드투엔드 통합이 항상 사용 중지됩니다.
`per_order_fee`	`PerOrderFee` 이 서비스를 구매하기 위한 주문 수준 수수료입니다. (선택사항)
`tours_and_activities_content`	`ToursAndActivitiesContent` 투어 및 액티비티별 콘텐츠 필드입니다.
`location[]`	`Location` 이 서비스와 관련된 위치입니다. 중요사항: 이 서비스와 관련하여 방문한 위치가 여러 개 있거나 START_LOCATION이 VISITED_LOCATION과 다른 경우 START_LOCATION을 지정해야 합니다. 예: - 가이드와 함께 세 장소를 방문하는 자전거 투어. 시작 장소를 지정해야 합니다. - 호텔 로비에서 만나 방문 장소로 이동하는 버스 투어. 만남 위치를 지정해야 합니다.
`rating`	`Rating` 이 서비스에 대한 사용자 평가로, 모든 리뷰에 대한 집계 측정항목입니다.
`home_service_data`	`HomeServiceData` 홈 서비스 카테고리 고유의 추가 정보입니다. (선택사항)
`virtual_session`	`VirtualSession` 선택사항입니다. 가상 세션에 관한 정보입니다. 가상 서비스를 사용 설정하는 데 필요합니다.
`direct_merchant_payment`	`DirectMerchantPayment` 선택사항입니다. 서비스에서 사용자가 판매자에게 직접 결제해야 하는 경우 추가해야 하는 추가 정보입니다. 중요사항: RwG는 이 거래에 관여하지 않습니다. virtual_session이 정의되고 서비스가 무료가 아니거나 prepayment_type이 REQUIRED로 설정되지 않은 경우 필수입니다.

PrepaymentTerms

선불 결제 완료 시기에 대한 구체적인 정보

필드

charge_timing

ChargeTiming

구매 시간을 기준으로 요금이 청구되는 시점입니다.

charge_time_before_start_time_sec

int64

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

ChargeTiming

구매 시간을 기준으로 청구 시기를 지정하는 열거형입니다.

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

PrepaymentType

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

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

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`	사용자가 특정 판매자로부터 쇼핑할 수 있는 서비스입니다. 배달 또는 수령이 될 수 있습니다.

ServiceAttribute

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

필드

attribute_id

string

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

attribute_name

string

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

value[]

Value

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

값

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

필드

value_id

string

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

value_name

string

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

ServiceAttributeValueId

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

필드

attribute_id

string

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

value_id

string

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

ServiceAvailability

이용 가능 여부 및 적용 대상/시기의 목록입니다.

필드
`name`	`string` 이를 적용할 서비스의 리소스 이름입니다. `partners/{partner_id}/merchants/{merchant_id}/services/{service_id}` 형식입니다.
`start_time_restrict`	`Timestamp` 제공되는 경우 제공된 이용 가능 여부 항목이 [start_time_restrict, end_time_restrict)의 전체 스냅샷으로 간주됩니다. 즉 다음 조건이 참이면 기존의 이용 가능 여부가 모두 삭제됩니다. `start_time_restrict <= availability.start_sec && availability.start_sec < end_time_restrict` duration 메시지가 설정되면 조건이 추가로 제한됩니다. `availability.duration == duration_restrict` resources_restrict 메시지가 설정되면 조건이 추가로 제한됩니다. `availability.resources.staff_id == resources_restrict.staff_id && availability.resources.room_id == resources_restrict.room_id` 이 필드는 일반적으로 지정된 기간의 이용 가능 여부를 완전히 업데이트하는 데 사용됩니다. start_time_restrict를 설정하고 end_time_restrict를 설정하지 않으면 start_time_restrict에서 시작하는 모든 시간을 의미하는 것으로 해석됩니다.
`end_time_restrict`	`Timestamp` end_time_restrict를 설정하고 start_time_restrict를 설정하지 않으면 end_time_restrict까지의 모든 시간을 의미하는 것으로 해석됩니다.
`duration_restrict`	`Duration` duration을 설정하면 업데이트 범위가 일치하는 기간의 이용 가능 여부로만 제한됩니다.
`resources_restrict`	`Resources` resources_restrict를 설정하면 업데이트 범위가 이 리소스 집합만으로 추가 제한됩니다. 리소스의 모든 ID 필드는 정확히 일치해야 합니다.
`availability[]`	`Availability` 새 이용 가능 여부 목록입니다.

ServiceIntakeForm

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

필드

field[]

ServiceIntakeFormField

사용자에게 표시되는 필드입니다.

first_time_customers
(deprecated)

bool

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

returning_customers
(deprecated)

bool

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

ServiceIntakeFormField

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

필드
`id`	`string` 양식 필드를 고유하게 나타내는 애그리게이터 파트너의 문자열입니다. 이 ID는 해당 양식 필드 답변의 ID와 동일해야 하며 서비스 수준과 티켓 접수 양식마다 고유해야 합니다. (필수)
`type`	`FieldType` 이 필드의 유형입니다.
`label`	`string` 이 필드의 사용자에게 표시되는 텍스트입니다. 지원 중단되었습니다. 대신 `localized_label`을 사용하세요.
`localized_label`	`Text` 이 필드의 사용자에게 표시되는 텍스트입니다. 이 필드는 여러 언어로 제공될 수 있습니다. (필수)
`value[]`	`string` 필드 유형이 LOCATION_SEARCH인 경우에만 설정합니다. 위치 값을 지정하려면 'location' 필드의 'location_id'를 사용하세요.
`choice_text[]`	`Text` 필드 유형이 MULTIPLE_CHOICE, CHECKBOXES 또는 DROPDOWN인 경우에만 설정합니다. 가능한 선택 항목을 열거하는 데 사용됩니다.
`is_required`	`bool` 사용자가 이 필드에 답변을 입력해야 하는지 여부를 나타냅니다.
`allow_custom_answer`	`bool` 사전 정의된 답변 외에 맞춤 값이 허용되는지 여부를 나타냅니다. 필드 유형이 LOCATION_SEARCH인 경우에만 적용됩니다. (선택사항)
`additional_option[]`	`Text` 제공된 값에 더해 제공되는 추가 옵션입니다. 필드 유형이 LOCATION_SEARCH인 경우에만 적용됩니다. 예를 들어 제공된 위치 목록 외에도 '나중에 공급업체에 문의하겠습니다'라는 옵션을 사용할 수 있습니다. (선택사항)
`ticket_type_restrict[]`	`string` 사용자가 특정 티켓 유형을 예약할 때만 이 질문을 표시해야 하는 경우 이 필드를 해당 티켓 유형 ID의 집합으로 설정해야 합니다. 질문을 항상 표시해야 하는 경우 입력란을 비워두세요.
`hint`	`Text` 입력용 힌트 텍스트로, 텍스트 자리표시자로 표시됩니다. 입력란 유형이 SHORT_ANSWER 또는 PARAGRAPH인 경우에만 적용됩니다. (선택사항)

FieldType

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

열거형
`FIELD_TYPE_UNSPECIFIED`	지정되지 않거나 알 수 없는 유형의 필드는 무시됩니다.
`SHORT_ANSWER`	한 줄의 텍스트 입력란입니다.
`PARAGRAPH`	여러 줄의 텍스트 입력란입니다.
`MULTIPLE_CHOICE`	여러 옵션 중 하나를 선택해야 하는 라디오 버튼의 집합입니다.
`CHECKBOXES`	체크박스가 있는 하나 이상의 열거된 항목입니다.
`DROPDOWN`	드롭다운의 선택항목입니다.
`BOOLEAN`	예/아니요 버튼입니다.
`LOCATION_SEARCH`	제공된 위치 목록에서 제공된 사용자 입력과 일치하는 위치를 찾을 수 있는 검색 창입니다.

TaxRate

사용자에게 서비스 요금을 청구할 때 적용되는 세율이며 판매자 또는 서비스별로 설정할 수 있습니다.

필드

micro_percent

int32

1%의 백만분의 1단위의 세율로 실질적으로 소수점 6자리의 정밀도를 제공합니다. 예를 들어 세율이 7.253%이면 이 필드를 7253000으로 설정해야 합니다.

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

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

용어

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

필드

url

string

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

text

string

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

localized_text

Text

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

텍스트

현지화되었을 가능성이 있는 텍스트 페이로드입니다. 일부 텍스트 필드에는 마크업된 콘텐츠가 포함될 수 있습니다.

필드

value

string

알 수 없는 언어로 된 텍스트 값입니다. localized_value가 비어 있는 경우에만 필요합니다. 이 값의 언어는 파트너 또는 서비스 제공업체에 따라 달라질 수 있으며, 특정 언어라고 가정해서는 안 됩니다.

localized_value[]

LocalizedString

언어별 텍스트 값입니다. 선택사항입니다.

TicketType

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

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

필드
`ticket_type_id`	`string` 티켓 ID는 동일한 서비스의 여러 티켓 유형을 구분하는 데 사용되며 서비스 내에서만 고유합니다.
`short_description`	`string` 이 TicketType의 간단한 설명입니다. 사용자가 볼 수 있습니다(예: '성인', '어린이', '재향군인', 'J열'). 필수 항목입니다. 각 티켓 유형에는 사용자가 볼 수 있는 설명이 있어야 합니다. 지원 중단되었습니다. 대신 localized_short_description을 사용하세요.
`localized_short_description`	`Text` i18n 지원 기능이 있는 이 TicketType의 간단한 설명입니다. 사용자가 볼 수 있습니다(예: '성인', '어린이', '재향군인', 'J열'). 필수 항목입니다. 각 티켓 유형에는 사용자가 볼 수 있는 설명이 있어야 합니다. 언어마다 별도의 값을 제공할 수 있습니다.
`price`	`Price` 이 유형의 티켓 한 장의 가격입니다(세금 제외). 서비스 세율이 티켓에 적용됩니다.
`per_ticket_fee`	`PerTicketFee` 이 티켓을 구매하기 위한 추가 수수료입니다. (선택사항)
`option_description`	`string` 이 티켓 유형이 나타내는 추가 옵션의 설명입니다. 지원 중단되었습니다. 대신 localized_option_description을 사용하세요.
`localized_option_description`	`Text` 이 티켓 유형이 나타내는 추가 옵션의 설명입니다. 언어마다 별도의 값을 제공할 수 있습니다. 추가 옵션은 티켓 유형이 여러 측정기준을 나타내는 경우 유용합니다. 예 1: 유형이 여러 가지('성인', '어린이')이고 언어가 추가 옵션인 입장권. 예상되는 TicketType 목록: - { ticket_type_id: "ticket_type_1" localized_short_description { value: "adult" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "adult" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "child" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "child" } localized_option_description { value: "spanish" } } 예 2: 선택적 건조 주머니 부가 기능이 있는 시간 단위 카약 대여. short_description은 '3시간'이고 option_description은 '건조 주머니 포함' 또는 '건조 주머니 제외'일 수 있음: - { ticket_type_id: "ticket_type_1" localized_short_description { value: "2 hours" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "2 hours" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "3 hours" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "3 hours" } localized_option_description { value: "spanish" } } 선택사항이지만 서비스 내의 티켓 유형에 이 필드가 설정되면 다른 모든 티켓 유형에도 이 필드가 설정됩니다(기본 option_description 사용 가능). 예: [{ticket_type_1, adult, english}, {ticket_type_1, adult, ''}]은 유효한 목록이 아닙니다. 두 가지 HTML 형식 태그(, )만 지원됩니다. 제목과 자세한 설명이 모두 포함된 옵션을 지정하는 데 사용됩니다. 예: '프리미엄 좌석 이 옵션은 쿠션이 있는 좌석, 전용 TV, 좌석 내 식음료 서비스가 포함된 특별석의 좌석을 제공합니다. 이 좌석은 그림 같은 경기장 전망을 제공합니다.'

TicketingVerticalSpecificData

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

필드
`event_category`	`EventCategory` 이벤트의 카테고리입니다. 이벤트가 사전 정의된 카테고리 중 하나에 속하는 경우에만 설정합니다. (선택사항)
`event_url`	`string` 파트너 웹사이트의 이벤트 URL입니다. (선택사항)
`entity[]`	`Entity` 이벤트와 관련된 항목의 목록입니다. (선택사항)
`event_attendance_mode`	`AttendanceMode` 필수 항목입니다. 이벤트 참석 유형입니다.
`event_virtual_location_url[]`	`string` 선택사항입니다. 이벤트를 볼 수 있는 URL입니다.
`event_organizer`	`Text` 선택사항입니다. 이벤트를 주최하는 주최자
`event_organizer_url`	`string` 선택사항입니다. 일정을 호스팅하는 주최자의 URL입니다.
`event_organizer_type`	`OrganizerType` 선택사항입니다. 주최자 유형입니다.
`event_source_url[]`	`string` 필수 항목입니다. 이벤트 정보 또는 설명을 찾을 수 있는 페이지의 URL입니다.
`event_state`	`EventState` 선택사항입니다. 이벤트의 상태입니다.

AttendanceMode

이벤트 참석 유형입니다.

열거형
`ATTENDANCE_MODE_UNSPECIFIED`	지정되지 않음
`ONLINE`	가상 이벤트용
`PHYSICAL`	오프라인 이벤트용
`PHYSICAL_ONLINE_MIXED`	오프라인 및 가상 이벤트 모두 해당

항목

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

필드
`id`	`string` 파트너 데이터베이스에 있는 항목의 고유 식별자입니다. (선택사항)
`name`	`string` 항목의 이름입니다. (필수)
`url`	`string` 항목을 명확하게 설명하는 웹페이지의 URL입니다. 항목에 대한 파트너 웹사이트의 웹페이지입니다(있는 경우). 항목의 다른 공개 URL의 경우 public_identification_data의 relevant_url을 사용하세요. (선택사항)
`entity_type`	`EntityType` 항목의 유형입니다. (선택사항)
`entity_role`	`EntityRole` 이벤트에서 항목의 역할입니다. (선택사항)
`public_identification_data`	`PublicIdentificationData` 항목의 공개 참조입니다. (선택사항)

EntityRole

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

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

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인 경우에만 적용됩니다.

EventCategory

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

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

EventState

이벤트의 상태입니다.

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

OrganizerType

주최자 유형입니다.

열거형
`ORGANIZER_TYPE_UNSPECIFIED`	지정되지 않음
`PERSON`	사람인 주최자를 위한 옵션입니다.
`ORGANIZATION`	조직인 주최자용입니다.

PublicIdentificationData

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

필드

relevant_url[]

string

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

musicbrainz_id

string

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

TimeRange

종료-시작 기간. 예: [start_time, end_time).

필드

start_time

기간의 하한입니다.

end_time