Package google.maps.booking.v1alpha

string

이 작업 링크의 진입점 URL입니다.

string

이 URI의 콘텐츠를 사용할 수 있는 언어를 나타내는 BCP-47 언어 태그입니다.

string

ISO 3166-1 alpha-2 국가 코드입니다. 공개 상태를 제한하지 않으려면 비워두세요.

ActionPlatform

이 작업을 실행해야 하는 플랫폼입니다. 이 필드가 설정되지 않은 경우 ACTION_PLATFORM_WEB_APPLICATION이 대신 사용됩니다.

ActionLinkType

사전 정의된 작업 유형입니다.

OrderOnlineMetadata

온라인 주문 링크의 메타데이터입니다. ACTION_LINK_TYPE_SHOP_ONLINE의 ActionLinkType을 사용한 작업을 지원합니다.

FoodOrderingMetadata

음식 주문 링크의 메타데이터입니다. 지원되는 작업 유형: * ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY * ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT, ACTION_LINK_TYPE_ORDER_FOOD는 지원하지 않습니다.

Text

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

Timestamp

약속 시간대의 시작 시간입니다.

Duration

약속 시간대의 기간입니다.

int64

이 이용 가능 시간대의 총 자릿수 및 이용 가능한 자릿수입니다. 예:

• 10자리 중 3자리가 예약된 요가 수업: availability {spots_total: 10, spots_open: 7 ...}
• 예약이 모두 완료된 체어 마사지 세션: availability {spots_total: 1, spots_open: 0 ...}

참고: 아래에 정의된 이용 가능 여부 압축 형식을 사용하여 요청을 보내면 이 두 필드가 추론됩니다.

• 반복은 spots_total=1 및 spots_open=1을 의미합니다.
• ScheduleException은 spots_total=1 및 spots_open=0를 의미합니다.

int64

예약 가능한 자릿수입니다.

string

이 이용 가능 시간대를 나타내는 불투명 문자열입니다(선택사항). 설정된 경우 예약을 예약/업데이트/취소하는 요청에 포함됩니다.

Resources

다른 직원이나 방이 서비스의 일부인 경우 이 이용 가능 시간대를 다른 이용 가능 시간대와 구별하기 위한 리소스입니다(선택사항).

예: 2명의 강사가 진행하는 동일한 요가 수업:

availability { resources { staff_id: "1" staff_name: "Amy" }
               spots_total: 10 spots_open: 7 }
availability { resources { staff_id: "2" staff_name: "John" }
               spots_total: 5 spots_open: 2 }

string

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

이 필드는 서비스 메시지에 지정된 모든 payment_option_ids를 재정의합니다. 마찬가지로 여기에 지정된 payment_option_ids는 서비스 수준 메시지에는 없어도 되지만 판매자 수준에서는 정의되어야 합니다.

Recurrence

두 개 이상의 시작 시간을 나타내는 이용 가능 시간대의 반복 정보입니다. 반복에는 영업일 기준 1일의 약속이 포함되어야 합니다.

ScheduleException

이 서비스를 예약할 수 없는 시간입니다. schedule_exception 메시지의 수를 제한하려면 인접한 예외를 결합해보세요.

Deposit

이 이용 가능 시간대의 보증금입니다(선택사항). 지정된 경우 서비스 보증금이 재정의됩니다.

NoShowFee

이 이용 가능 시간대의 예약 불이행 수수료입니다(선택사항). 지정된 경우 서비스 예약 불이행 수수료가 재정의됩니다.

RequireCreditCard

이 이용 가능 시간대를 예약하기 위해서는 사용자가 신용카드를 제공해야 하는지 여부를 나타냅니다. 값이 설정되지 않은 경우 서비스 수준에서 상속됩니다(설정된 경우). (선택사항)

string

이 이용 가능 시간대에 지원되는 티켓 유형의 목록을 나타냅니다. 설정되지 않으면 상위 서비스의 모든 티켓 유형을 이 시간대에 사용할 수 있습니다. 이 필드의 값은 상위 서비스에서 정의되어야 합니다. 예:

• 티켓 유형이 네 개인 서비스: TicketType {ticket_type_id: "adult_1" short_description: "Adult weekdays"} TicketType {ticket_type_id: "adult_2" short_description: "Adult weekends"} TicketType {ticket_type_id: "youth_1" short_description: "Youth weekdays"} TicketType {ticket_type_id: "youth_2" short_description: "Youth weekends"}

평일의 인벤토리를 나타내는 방법: availability {ticket_type_id: "adult_1" ticket_type_id: "youth_1"...} 휴일의 인벤토리를 나타내는 방법: availability {ticket_type_id: "adult_2" ticket_type_id: "youth_2"...}

• 티켓 유형이 세 개인 서비스: TicketType {ticket_type_id: "adult" short_description: "Adult"} TicketType {ticket_type_id: "youth" short_description: "Youth"} TicketType {ticket_type_id: "senior" short_description: "Senior"}

이 시간대에 세 티켓 유형을 모두 사용할 수 있다는 것을 나타내려면 availability {ticket_type_id: "adult" ticket_type_id: "youth" ticket_type_id: "senior" ...} 또는 'availability {...}'를 사용하세요(이 시간대에서 ticket_type_id를 설정하지 마세요).

(선택사항)

DurationRequirement

슬롯 시간 또는 종료 시간을 표시하기 위한 요구사항입니다. 슬롯을 사용할 수 없는 경우 이 필드는 무시됩니다. 즐길 거리 카테고리에서 사용되지 않습니다. (선택사항)

SchedulingRuleOverrides

이용 가능 시간대 예약 규칙입니다. 필드가 채워지면 서비스 수준 SchedulingRules의 해당 예약 규칙이 재정의됩니다.

ConfirmationMode

이 이용 가능 시간대를 예약할 때 사용될 확인 모드입니다. CONFIRMATION_MODE_SYNCHRONOUS의 확인 모드로 이용 가능 시간대에 대해 예약을 생성하려고 시도하는 경우 즉시 확인하거나 거부해야 합니다. CONFIRMATION_MODE_ASYNCHRONOUS의 확인 모드로 이용 가능 시간대에 대해 예약을 생성하려고 시도하는 경우 즉시 거부하거나 PENDING 상태로 생성해야 합니다.

Timestamp

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

Duration

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

예: 이용 가능 시간대의 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분의 시간대가 생성됩니다. (필수)

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시에 시작하는 시간대는 영향을 받지 않습니다.

int64

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

int64

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

int64

설정된 경우 Google 예약을 통해 이 특정 약속 시간대를 취소할 수 있는 마지막 시간 (Unix 에포크 이후 초 단위)입니다. 이 입력란은 서비스 수준 취소 규칙보다 우선 적용됩니다. (선택사항)

string

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

GenericDeleteRecord

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

string

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

GenericRecord

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

string

partners/{partner_id} 형식입니다.

ExtendedServiceAvailability

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

ExtendedServiceAvailability

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

string

예약의 리소스 이름: partners/{partner ID}/bookings/{booking ID}

string

시간대의 판매자 ID입니다.

string

판매자 서비스의 ID입니다.

Timestamp

예약 시간대의 시작 시간

Duration

약속 시간대의 기간입니다.

ClientInformation

예약하는 고객의 개인 정보

BookingStatus

예약 상태

PaymentInformation

예약과 관련된 결제 거래에 대한 정보입니다.

int64

예약 인원수

Cause

예약이 실패한 이유입니다. (필수)

CreditCardType

(원인이 PAYMENT_ERROR_CARD_TYPE_REJECTED인 경우에만 필요)

string

이 선택적 필드는 파트너가 디버깅 목적으로만 추가 정보를 포함하는 데 사용됩니다. (선택사항)

PaymentFailureInformation

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

ThreeDS1Parameters

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

string

인증을 위해 사용자에게 표시할 양식을 로드할 URL입니다.

string

PaymentAuthentication 요청입니다. ACSUrl 양식에 게시됩니다(제공되는 경우).

string

ACS 제공업체에서 사용하는 식별자입니다. ACSUrl 양식에 게시됩니다(제공되는 경우).

string

판매자 데이터 ACSUrl 양식에 게시됩니다(제공되는 경우).

RefundCondition

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

Duration

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

uint32

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

string

고객의 이름

string

고객의 성

PostalAddress

클라이언트의 주소

string

고객의 전화번호

string

클라이언트의 이메일 주소입니다.

string

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

string

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

Merchant

생성할 판매자입니다.

string

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

string

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

Service

만들 서비스입니다.

CreditCardType

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

string

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

string

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

Price

보증금 금액

int64

보증금의 최소 사전 취소 기간입니다.

PriceType

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

Text

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

Duration

최소 기간.

Duration

최대 기간.

string

아래의 이용 가능 여부 메시지가 속한 판매자를 지정하는 데 필요한 필수 필드입니다.

string

아래의 이용 가능 여부 메시지가 속한 서비스를 지정하는 데 필요한 필수 필드입니다.

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에서 시작하는 모든 시간을 의미하는 것으로 해석됩니다.

Timestamp

end_time_restrict를 설정하고 start_time_restrict를 설정하지 않으면 end_time_restrict까지의 모든 시간을 의미하는 것으로 해석됩니다.

Duration

duration을 설정하면 업데이트 범위가 일치하는 기간의 이용 가능 여부로만 제한됩니다.

Resources

resources_restrict를 설정하면 업데이트 범위가 이 리소스 집합만으로 추가 제한됩니다. 리소스의 모든 ID 필드는 정확히 일치해야 합니다.

Availability

새로운 이용 가능 여부 목록입니다.

int64

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

int64

기존 항목(필요에 따라 피드의 최신 정보에서 업데이트됨)

int64

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

string

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

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

State

이 피드의 처리 상태입니다.

string

이 피드를 처리하지 못한 경우 더 자세한 정보를 제공하는 인간이 읽을 수 있는 문자열입니다.

FeedStatistics

이 피드와 관련된 통계입니다.

FeeDetails

항목 합계 외에 사용자에게 청구된 수수료의 세부정보입니다. 서비스 수수료, 배송료 등 다양한 유형의 요금에 대해 반복됩니다.

AdvanceOrderDetails

사용자가 지금보다 나중에 주문 처리를 위해 주문할 수 있는 사전 주문이라고도 하는 고급 주문 지원에 관한 세부정보입니다.

Duration

고정 기간 예: 30분

DurationRange

기간의 범위입니다. 예: * 30분~45분 * 30분 초과 * 50분 미만

bool

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

FeeType

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

FeeAmount

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

QuantitativeValue

장바구니 금액의 백분율로 나타낸 수수료입니다. 범위 (제한된 및 제한되지 않음) 또는 고정 비율을 지원합니다. 값은 0에서 100 사이여야 합니다. 예: * 고정 5.5% * 최소 5.5% * 최대 5.5% * 4.5% ~5.5%

Money

고정 금액 예: USD 3.5

MoneyRange

금액의 범위입니다. 예: * 3.5~5.5달러 * 3.5달러 이상 * 5.5달러 이하

bool

알 수 없는 금액입니다.

FulfillmentType

필수 항목입니다. fulfillment 유형입니다.

AvailableDay

필수 항목입니다. 이 처리 방법을 사용할 수 있는 날짜 목록입니다 (최소 2일 권장).

FeeDetails

필수 항목입니다. 처리 방법의 수수료 세부정보입니다.

Price

필수 항목입니다. 작업 링크와 연결된 처리 방법의 최소 주문입니다.

Date

필수 항목입니다. 처리 방법의 사용 가능한 날짜입니다. 판매자의 시간대로 가정됩니다.

Timestamp

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

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

NoFee

처리 방법에는 수수료가 없습니다.

MinimumFee

처리 방법과 관련된 기본 요금입니다.

FixedFee

처리 방법과 관련된 고정 요금입니다.

Price

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

Price

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

Timestamp

필수 항목입니다. 이 타임스탬프는 인벤토리에 삭제를 적용할 순서를 결정하는 데 사용됩니다.

bytes

proto 기반이 아닌 피드의 경우

Any

proto 기반 피드의 경우

Timestamp

필수 항목입니다. 이 타임스탬프는 인벤토리 업데이트의 순서를 올바르게 지정하는 데 사용됩니다.

bytes

proto 기반이 아닌 피드의 경우

Any

proto 기반 피드의 경우

double

위도입니다. (선택사항)

double

경도입니다. (선택사항)

PostalAddress

위치의 우편 주소입니다(선호됨).

string

구조화되지 않은 주소를 대체 주소로 제공할 수도 있습니다. 예: '1600 amphitheatre parkway mountain view, ca 94043'

string

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

string

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

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

string

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

string

특정 홈 서비스가 속한 카테고리의 작업 유형입니다. 예: unclog_drain, install_faucet는 배관공 카테고리의 작업 유형입니다.

string

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

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

string

판매자 서비스의 ID입니다.

int64

약속 시간대의 시작 시간(Unix 에포크 이후 UTC 시간 초)입니다.

int64

약속 시간대의 기간(초)입니다.

OrderedTickets

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

Price

이 광고 항목의 총 가격 (세금 제외)입니다.

BookingStatus

광고 항목의 상태입니다.

string

티켓 유형의 ID입니다.

int32

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

string

필수 항목입니다. 이 판매자 상태 컬렉션을 소유한 상위 항목입니다. 형식: partners/{partner_id}/merchants

int32

필수 항목입니다. 반환할 최대 항목 수입니다. 서버에서 페이지 크기를 줄일 수 있습니다.

string

선택사항입니다. 이전 ListMerchantStatusResponse에서 반환된 nextPageToken 값입니다(있는 경우).

BookingInventoryStatus

선택사항입니다. 예약 인벤토리 상태를 기준으로 결과를 필터링하기 위한 선택적 제한사항입니다.

WaitlistInventoryStatus

선택사항입니다. 대기자 명단 인벤토리 상태별로 결과를 필터링하는 선택적 제한사항입니다.

GeoMatchingStatus

선택사항입니다. 지역 일치 상태별로 결과를 필터링하기 위한 선택적 제한사항입니다.

MerchantStatus

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

string

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

string

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

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

int32

반환할 최대 항목 수입니다.

string

이전 List 요청에서 반환된 next_page_token 값입니다(있는 경우).

State

피드 상태별로 결과를 필터링하기 위한 선택적 제한입니다.

TimeRange

상한 및 하한을 기준으로 결과를 필터링하기 위한 선택적 제한입니다. start_time이 설정되지 않은 경우 기본적으로 Unix 시간의 시작으로 설정됩니다. end_time이 설정되지 않은 경우 기본적으로 지금으로 설정됩니다.

FeedStatus

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

string

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

string

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

string

위 언어로 된 메시지 (UTF-8)입니다.

string

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

string

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

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

string

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

string

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

GeoCoordinates

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

LocationType

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

string

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

string

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

string

merchant_name, 전화번호, URL 및 지역 정보는 파트너 인벤토리를 Google 지도에 이미 존재하는 판매자와 일치시키는 데 사용됩니다. 이 정보는 표시되지 않습니다.

판매자의 이름입니다.

string

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

string

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

GeoCoordinates

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

string

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

int64

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

uint32

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

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

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

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

TaxRate

판매자의 세율입니다. 이 필드가 있으면 지원 중단된 tax_rate_basis_points 필드가 재정의됩니다. 메시지가 비어 있으면(tax_rate { }) 적용되는 세율이 0으로 재설정됩니다.

PaymentRestrictions

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

PaymentOption

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

PaymentProcessorConfig

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

TokenizationConfig

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

Terms

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

string

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

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

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

파트너가...

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

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

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

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

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

MerchantMatchingHints

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

ServiceAttribute

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

ActionLink

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

Advisement

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

string

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

string

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

string

파트너가 제공하는 판매자 이름입니다.

GeoCoordinates

파트너가 판매자의 지역 정보를 제공했습니다.

ProcessingStatus

판매자 처리 상태입니다.

BookingStatus

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

WaitlistStatus

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

PlaceInfo

이 판매자의 지역과 일치하는 위치입니다. 판매자가 지역과 일치하지 않는 경우 비어 있습니다.

LocalServicesMatchInfo

판매자의 지역 서비스 광고와 일치합니다. 지역 서비스 판매자가 아니거나 어떤 제공업체와도 일치하지 않는 경우 비어 있습니다.

DirectUrl

현재 판매자 인벤토리의 콘텐츠를 보여주는 URL 목록입니다. 그렇다고 해서 인벤토리가 실제로 게재되고 있음을 의미하지 않으며, URL은 공개적으로 표시되는 URL과 다를 수 있습니다.

bool

판매자에게 향후 30일 이내에 인벤토리가 있으면 true입니다. 판매자가 실제로 서비스를 제공한다고 보장하지는 않습니다.

UrlType

이 URL의 유형입니다.

string

이 판매자가 표시될 수 있는 URL입니다.

MatchedProvider

일치하는 서비스 제공업체 하나의 판매자를 여러 서비스 제공업체와 일치시킬 수 있습니다.

int64

Google 지역 서비스 외부 고객 ID

string

지역 서비스 카테고리 (카테고리) 예: '배관공' 'carpet_cleaning')을 포함합니다.

string

장소의 이름입니다.

string

현지 언어로 형식이 지정된 주소

string

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

bool

판매자가 대기자 명단 서비스를 이용하는 경우 true입니다. 판매자가 실제로 서비스를 제공한다고 보장하지는 않습니다.

Money

최소 금액입니다.

Money

최대 금액

Price

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

PriceType

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

string

주문의 리소스 이름: partners/{partner ID}/orders/{order ID}

ClientInformation

주문하는 고객의 개인 정보

PaymentInformation

주문과 관련된 결제 거래에 대한 정보입니다.

string

이 주문의 모든 서비스가 속한 판매자의 ID입니다.

LineItem

이 주문의 항목입니다.

FulfillmentOption

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

PrepaymentStatus

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

string

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

string

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

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

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

string

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

string

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

Price

결제 옵션의 가격입니다.

TaxRate

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

PaymentOptionType

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

int64

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

TimeRange

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

TimeRange

이 간격 내에서 결제 옵션을 사용할 수 있습니다(예: 2017년 1월의 특별 가격). 이 필드가 있으면 valid_duration 및 activation_type이 재정의됩니다.

Duration

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

ActivationType

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

UserPurchaseRestriction

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

Processor

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

string

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

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

string

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

CreditCardRestrictions

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

Price

배송 방법에 따라 달라질 수 있는 수수료.

Price

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

Price

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

Price

장소/시설에 대한 비용

Price

티켓당 세금입니다.

string

ISO 3166-1 alpha-2 국가 코드를 사용하여 지정된 국가입니다. 예: 'US' (필수 항목)

string

지역입니다(예: '마운틴 뷰'). (필수)

string

지역입니다(예: 'CA'). 이 필드는 보통 지역이 주소의 일부인 국가에서만 필요합니다. (선택사항)

string

우편번호입니다(예: '94043'). (필수)

string

상세 주소(예: '1600 Amphitheatre Pkwy')입니다. (필수)

int64

가격입니다(통화의 마이크로 단위). 최소 통화 단위의 부분은 오사 오입 반올림을 사용하여 반올림됩니다. (예: 미화의 경우 2.5센트는 2센트로 반내림됨, 3.5센트는 4센트로 반올림됨, 0.5센트는 0센트로 반내림됨, 2.51센트는 3센트로 반올림됨).

string

ISO 4217에 정의된 가격 통화입니다.

string

연장 가격과 연결된 가격 옵션을 식별하는 선택적 불투명 문자열입니다.

double

단일 값입니다. 예: 5.6

RangeValue

서술형이거나 한정될 수 있는 값의 범위입니다. 예: * 최소 5.5 * 최대 5.5 * 5.5 ~ 6.5

double

최솟값입니다.

double

최댓값입니다.

double

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

uint64

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

string

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

MediaType

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

Text

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

Attribution

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

string

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

Text

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

string

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

ServiceAvailability

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

string

서비스를 제공하는 직원의 ID입니다(선택사항). 이 필드는 모든 판매자, 서비스, 이용 가능 여부 레코드에서 직원을 식별합니다. 또한 이전 예약과의 상관관계를 허용하려면 시간이 지남에 따라 안정적이어야 합니다. staff_name이 있으면 이 필드가 있어야 합니다.

string

서비스를 제공하는 직원의 이름입니다(선택사항). 이 필드는 예약하는 사용자에게 표시되며 불투명 식별자와 달리 사람이 읽을 수 있어야 합니다. staff_id가 있으면 이 필드가 있어야 합니다.

string

서비스가 위치한 방의 ID입니다(선택사항). 이 필드는 모든 판매자, 서비스, 이용 가능 여부 레코드에서 방을 식별합니다. 또한 이전 예약과의 상관관계를 허용하려면 시간이 지남에 따라 안정적이어야 합니다. room_name이 있으면 이 필드가 있어야 합니다.

string

서비스가 위치한 방의 이름입니다(선택사항). 이 필드는 예약하는 사용자에게 표시되며 불투명 식별자와 달리 사람이 읽을 수 있어야 합니다. (room_id가 있는 경우 선택사항이지만 필수) 식당에서 방 이름은 바 또는 테라스와 같은 좌석 공간에만 사용해야 하며 고정 가격 메뉴, 특별 활동 또는 기타 방이 아닌 값 (예: 예약 또는 저녁)에는 사용하면 안 됩니다. 기본 좌석 공간에는 연결된 방이 없는 것이 좋습니다.

int32

식당에만 해당함: 이 시간대에 수용할 수 있는 인원수입니다. 음식점은 예를 들어 2, 3 또는 4인석을 예약할 수 있는 경우 각각 다른 party_size를 지정하여 동시에 여러 시간대에 연결할 수 있습니다.

int64

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

Price

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

Price

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

AdmissionPolicy

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

CancellationPolicy

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

int64

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

int64

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

string

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

string

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

Text

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

string

사용자에게 표시되는 서비스 설명입니다. 지원 중단되었습니다. 대신 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

서비스 가격입니다.

PriceInterpretation

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

SchedulingRules

약속을 예약/취소하기 위한 규칙입니다.

PrepaymentType

선불 결제가 필수인지, 선택사항인지, 지원되지 않는지 여부입니다.

PrepaymentTerms

선불 결제 완료 시기에 대한 조건입니다.

ServiceIntakeForm

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

ServiceIntakeForm

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

ServiceIntakeForm

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

TaxRate

서비스의 세율입니다. 이 필드가 있으면 판매자 수준에서 설정된 tax_rate가 재정의됩니다. 메시지가 비어 있으면(tax_rate { }) 적용되는 세율이 0으로 재설정됩니다.

string

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

Deposit

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

NoShowFee

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

RequireCreditCard

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

ActionLink

이 서비스와 관련된 작업 링크입니다. 작업 링크가 있는 경우 서비스에서 유형(아래 참고)을 설정해야 합니다.

ServiceType

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

TicketType

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

RelatedMedia

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

ServiceAttributeValueId

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

WaitlistRules

대기자 명단에 등록할 때 따라야 할 규칙입니다.

TicketingVerticalSpecificData

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

IntegrationType

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

PerOrderFee

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

ToursAndActivitiesContent

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

Location

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

Rating

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

HomeServiceData

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

VirtualSession

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

DirectMerchantPayment

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

ChargeTiming

구매 시간을 기준으로 청구가 발생하는 시점입니다.

int64

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

string

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

string

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

Value

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

string

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

string

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

string

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

string

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

string

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

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에서 시작하는 모든 시간을 의미하는 것으로 해석됩니다.

Timestamp

end_time_restrict를 설정하고 start_time_restrict를 설정하지 않으면 end_time_restrict까지의 모든 시간을 의미하는 것으로 해석됩니다.

Duration

duration을 설정하면 업데이트 범위가 일치하는 기간의 이용 가능 여부로만 제한됩니다.

Resources

resources_restrict를 설정하면 업데이트 범위가 이 리소스 집합만으로 추가 제한됩니다. 리소스의 모든 ID 필드는 정확히 일치해야 합니다.

Availability

새로운 이용 가능 여부 목록입니다.

ServiceIntakeFormField

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

bool

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

bool

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

string

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

FieldType

이 필드의 유형입니다.

string

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

Text

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

string

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

Text

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

bool

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

bool

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

Text

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

string

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

Text

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

int32

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

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

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

string

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

string

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

Text

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

string

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

LocalizedString

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

string

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

string

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

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

Text

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

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

Price

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

PerTicketFee

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

string

이 티켓 유형이 나타내는 추가 옵션의 설명입니다. 지원 중단되었습니다. 대신 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, 좌석 내 식음료 서비스가 포함된 특별석의 좌석을 제공합니다. 이 좌석은 그림 같은 경기장 전망을 제공합니다.'

EventCategory

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

string

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

Entity

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

AttendanceMode

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

string

선택사항입니다. 이벤트를 볼 수 있는 URL입니다.

Text

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

string

선택사항입니다. 일정을 주최하는 주최자의 URL입니다.

OrganizerType

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

string

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

EventState

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

string

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

string

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

string

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

EntityType

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

EntityRole

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

PublicIdentificationData

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

string

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

string

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

Timestamp

기간의 하한입니다.

Timestamp

기간의 상한입니다.

map<string, string>

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

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

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

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

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

BillingInformationFormat

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