REST Resource: inventory.partners.merchants.services

ทรัพยากร: บริการ

ข้อมูลเกี่ยวกับบริการที่ได้รับจากผู้ขาย เช่น การตัดผม

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

string

ชื่อทรัพยากรบริการ ซึ่งมีรูปแบบ partners/{partner_id}/merchants/{merchantId}/services/{serviceId}
serviceName

string

ชื่อของบริการ เช่น "ตัดผมชาย" เลิกใช้งานแล้ว ใช้ localizedServiceName แทน
localizedServiceName

object (Text)

ชื่อของบริการ เช่น "ตัดผมชาย" อาจทำได้ในหลายภาษา
description

string

คำอธิบายบริการที่ผู้ใช้มองเห็น เลิกใช้งานแล้ว ใช้ localizedDescription แทน
localizedDescription

object (Text)

คำอธิบายบริการที่ผู้ใช้มองเห็น

ช่องนี้รองรับทั้งการจัดรูปแบบข้อความธรรมดาและการจัดรูปแบบแบบ HTML การออกแบบที่กำหนดเองสามารถสร้างขึ้นได้ที่นี่ โดยใช้ส่วนหัว ย่อหน้า รายการ และแท็กวลี ซึ่งแตกต่างจากส่วนของข้อความธรรมดา โปรดอ่านคำแนะนำและหมายเหตุต่อไปนี้โดยละเอียด เพื่อให้แน่ใจว่าคุณจะสร้างประสบการณ์ของผู้ใช้ที่ดีที่สุด

แท็กการจัดรูปแบบที่คล้ายกับ HTML ที่สนับสนุน:

แท็กส่วนหัว: <h1>, <h2>, <h3>, <h4>, <h5>, <h6>
ใช้แท็กส่วนหัวเพื่อแสดงชื่อและชื่อเรื่องย่อยได้ ตัวอย่างเช่น <h1>แผนการเดินทาง</h1> จะแสดงข้อความในบรรทัดเป็นส่วนหัวที่สำคัญที่สุดของส่วนนั้น โปรดทราบว่าระบบจะไม่สนใจแท็ก รูปแบบ หรือแอตทริบิวต์ HTML ภายใน ตัวอย่างเช่น <h1 style=".."> จะถือว่าเหมือนกับ <h1> และจะเก็บเฉพาะข้อความล้วนเท่านั้น

แท็กย่อหน้า: <p>
ใช้แท็กย่อหน้าเพื่อไฮไลต์ส่วนแนะนำหรือเนื้อหาได้อย่างละเอียด ระบบจะไม่สนใจแท็ก รูปแบบ หรือแอตทริบิวต์ภายใน โดยมีข้อยกเว้นบางประการ: <br>, <strong> และ <em> โปรดดูรายละเอียดเพิ่มเติมในส่วนแท็กวลีด้านล่าง

แท็กรายการ: <ul>, <ol>, <li>
สามารถใช้แท็ก <ul> กับแท็ก <li> เพื่อแสดงรายการที่ไม่เรียงลำดับ และแท็ก <ol> สามารถใช้กับ <li> เพื่อแสดงรายการที่เรียงลำดับ วิธีนี้เป็นวิธีที่ดีในการแสดงรายการตรวจสอบ กำหนดการ หรือรายการอื่นๆ ที่เหมาะกับกรณีการใช้งานของคุณ
ตัวอย่าง: หากต้องการแสดงรายการสถานที่ท่องเที่ยวบนเรือสำราญ
<ol>
<li>วิวทะเลสุดวิเศษและโอกาสที่จะได้เล่นกับสัตว์ป่า</li>
<li>การจัดการและบริการด้านการเดินทางที่ออกแบบอย่างระมัดระวัง</li>
<li>รับประกันราคาต่ำสุด</li>
</ol>
โปรดทราบว่ามีเฉพาะ <li> แท็กเด็กที่มีอายุต่ำกว่า <ul> หรือ <ol> เท่านั้นที่จะได้รับการแปลง ส่วนบุตรหลานอื่นๆ ทั้งหมดจะหายไป นอกจากนี้ ระบบจะไม่สนใจแท็ก แอตทริบิวต์ และสไตล์ภายในทั้งหมด โดยเราจะเก็บไว้เฉพาะเนื้อหาที่เป็นข้อความเท่านั้น

แท็กหาร: <div>
แท็กภายในที่รองรับทั้งหมดของแท็ก <div> จะได้รับการแยกวิเคราะห์ด้วยกฎที่ระบุไว้ข้างต้น ซึ่งหมายความว่าแท็ก <div> เองไม่ได้หมายถึงการจัดกลุ่มหรือการเยื้องที่นี่ รวมถึงจะไม่สนใจแอตทริบิวต์และรูปแบบภายใน

แท็กวลี: <br>, <strong>, <em>:
รองรับเฉพาะแท็ก 3 แบบที่กล่าวถึงข้างต้นเท่านั้น <br> สามารถใช้เพื่อแบ่งบรรทัดในย่อหน้า และ <strong>/<em> สามารถใช้เพื่อไฮไลต์ข้อความสำคัญ และจะไม่สนใจแท็กวลีอื่นๆ

แท็กที่ไม่รองรับ:

  • ไม่อนุญาตให้ใช้แท็ก <html>, <header> และ <body>
  • ไม่รองรับแท็กอื่นๆ ที่ไม่ได้กล่าวถึงข้างต้น (เช่น <table>, <td> ...)
    URL, Anchor และลิงก์ทั้งหมดจะถูกตัดออก และจะไม่แสดงต่อผู้ใช้ปลายทาง หากต้องการใช้รูปภาพเพื่อสร้างประสบการณ์ของผู้ใช้ที่สมบูรณ์ โปรดใช้ฟิลด์ "relatedMedia" ด้านล่างเพื่อส่ง URL รูปภาพของคุณ

หมายเหตุสำคัญ

  • พยายามอย่าใช้แท็กอื่นๆ ยกเว้นแท็กที่รองรับตามที่ระบุไว้ข้างต้น เนื่องจากเนื้อหาภายในแท็กที่ไม่รองรับจะถูกนำออก และอาจทำให้ผู้ใช้ได้รับประสบการณ์การใช้งานที่ไม่พึงประสงค์
  • พยายามหลีกเลี่ยงโครงสร้างที่ฝังอยู่ลึก เช่น ส่วนหัวมีมากกว่า 3 ระดับหรือรายการที่ซ้อนกัน การวางโครงสร้างให้แบนราบ เรียบง่าย และตรงไปตรงมาจะช่วยสร้างประสบการณ์ของผู้ใช้ที่ดียิ่งขึ้น
  • หากเลย์เอาต์ที่รองรับในปัจจุบันนั้นไม่เพียงพอสําหรับกรณีการใช้งานของคุณ โปรดติดต่อทีมจองกับ Google
  • ขนาดสูงสุดที่แนะนำคือ 32,000 อักขระ
price

object (Price)

ค่าบริการ
priceInterpretation

enum (PriceInterpretation)

อธิบายวิธีตีความราคาและแสดงให้ผู้ใช้เห็น ใช้ได้กับธุรกิจทุกประเภทยกเว้นร้านอาหารและกิจกรรมน่าสนใจเพื่อกำหนดค่าการแสดงราคาบริการ
rules

object (SchedulingRules)

กฎการจอง/ยกเลิกการนัดหมาย
prepaymentType

enum (PrepaymentType)

กำหนดว่าต้องชำระเงินล่วงหน้า ไม่บังคับ หรือไม่รองรับ
prepaymentTerms

object (PrepaymentTerms)

ข้อกำหนดเกี่ยวกับเวลาที่การชำระล่วงหน้าเสร็จสมบูรณ์
form[]
(deprecated)

object (ServiceIntakeForm)

เลิกใช้งานแล้ว โปรดใช้ intakeForm และ perTicketIntakeForm
intakeForm

object (ServiceIntakeForm)

แบบฟอร์มที่ขอข้อมูลเพิ่มเติมจากผู้ใช้เมื่อผู้ใช้จองบริการนี้ (ไม่บังคับ)
perTicketIntakeForm

object (ServiceIntakeForm)

แบบฟอร์มที่ขอข้อมูลเพิ่มเติมจากผู้ใช้เมื่อผู้ใช้จองบริการนี้ ต้องกรอกข้อมูลในแบบฟอร์มนี้ 1 ครั้งสำหรับตั๋วแต่ละใบที่ผู้ใช้จอง (ไม่บังคับ)
taxRate

object (TaxRate)

อัตราภาษีของบริการ หากมีช่องนี้จะลบล้างอัตราภาษีที่ตั้งไว้ในระดับผู้ขาย ส่วนข้อความที่ว่างเปล่า (เช่น taxRate { }) จะรีเซ็ตอัตราภาษีที่ใช้เป็น 0
paymentOptionId[]

string

รายการรหัสที่อ้างอิงตัวเลือกการชำระเงินที่สามารถใช้เพื่อชำระค่าบริการนี้ ตัวเลือกการชำระเงินจริงจะกำหนดที่ระดับผู้ขาย และสามารถแชร์กับผู้ขายหลายๆ รายได้
deposit

object (Deposit)

กำหนดวิธีเรียกเก็บเงินมัดจำกับผู้ใช้ แทนที่เงินมัดจำหากระบุไว้ การตั้งค่านี้เป็นข้อความ "เงินฝาก" ที่ว่างเปล่า) จะนำเงินฝากระดับการให้บริการออก (ไม่บังคับ)
noShowFee

object (NoShowFee)

กำหนดค่าธรรมเนียมการไม่แสดงตัวที่อาจมีการเรียกเก็บจากผู้ใช้ ลบล้างค่าธรรมเนียมสำหรับการไม่แสดงบริการหากระบุไว้ การตั้งค่าเป็นข้อความ NoShowFee ที่ว่างเปล่าจะเป็นการนำค่าธรรมเนียมการไม่แสดงในระดับบริการออก (ไม่บังคับ)
requireCreditCard

enum (RequireCreditCard)

ระบุว่าผู้ใช้ต้องให้ข้อมูลบัตรเครดิตเพื่อจองบริการนี้หรือไม่ คุณลบล้างช่องนี้ได้ที่ระดับความพร้อมใช้งาน (ไม่บังคับ)
type

enum (ServiceType)

ประเภทที่กำหนดไว้ล่วงหน้าของบริการนี้ (ไม่บังคับ)
ticketType[]

object (TicketType)

ประเภทของตั๋วที่สามารถจอง/ซื้อเพื่อบริการนี้ หากรองรับตั๋ว (ไม่บังคับ)
relatedMedia[]

object (RelatedMedia)

รูปภาพที่เกี่ยวข้องกับบริการนี้ Google จะทำการ Crawl และจัดเก็บสื่อดังกล่าวเพื่อให้แน่ใจว่าสื่อนี้จะแสดงต่อผู้ใช้ปลายทางอย่างมีประสิทธิภาพที่สุด (ไม่บังคับ)
serviceAttributeValueId[]

object (ServiceAttributeValueId)

ค่าแอตทริบิวต์บริการที่ใช้กับบริการนี้ (ไม่บังคับ) แต่ละบริการอาจไม่มีค่าหรือมากกว่าสำหรับแอตทริบิวต์บริการแต่ละรายการที่กำหนดไว้ในผู้ขายที่เกี่ยวข้อง (ไม่บังคับ)
waitlistRules

object (WaitlistRules)

กฎในการเข้าร่วมคิวรอ
ticketingVerticalSpecificData

object (TicketingVerticalSpecificData)

ข้อมูลเพิ่มเติมที่มีเฉพาะสําหรับประเภทธุรกิจจำหน่ายตั๋วเข้างาน (ไม่บังคับ)
integrationType

enum (IntegrationType)

ความลึกของการผสานรวมที่เรารองรับสำหรับบริการนี้ (ไม่บังคับ) ไม่เกี่ยวข้องกับพาร์ทเนอร์ที่มีการผสานรวมเริ่มต้น จากต้นทางถึงปลายทางจะปิดใช้สำหรับพาร์ทเนอร์เหล่านี้เสมอ
perOrderFee

object (PerOrderFee)

ค่าธรรมเนียมระดับคำสั่งซื้อสำหรับการซื้อบริการนี้ (ไม่บังคับ)
toursAndActivitiesContent

object (ToursAndActivitiesContent)

ฟิลด์เนื้อหาสำหรับทัวร์ชมและกิจกรรมโดยเฉพาะ
location[]

object (Location)

ตำแหน่งที่เกี่ยวข้องกับบริการนี้ หมายเหตุสำคัญ: หากมีสถานที่ที่เยี่ยมชมแล้วหลายแห่งที่เกี่ยวข้องกับบริการนี้ หรือ START_LOCATION แตกต่างจาก VISITED_LOCATION คุณต้องระบุ START_LOCATION ตัวอย่างเช่น - ทัวร์ปั่นจักรยานแบบมีไกด์นำเที่ยวสถานที่ 3 แห่ง จะต้องระบุสถานที่เริ่มต้น - จัดประชุมทัวร์บนรถบัสที่ล็อบบี้ของโรงแรม แล้วมุ่งหน้าไปยังสถานที่ดังกล่าว ต้องระบุสถานที่ประชุม
rating

object (Rating)

คะแนนจากผู้ใช้สำหรับบริการนี้เป็นเมตริกรวมจากรีวิวทั้งหมด
homeServiceData

object (HomeServiceData)

ข้อมูลเพิ่มเติมที่ไม่ซ้ำกันสำหรับประเภทธุรกิจบริการเกี่ยวกับบ้าน (ไม่บังคับ)
virtualSession

object (VirtualSession)

ไม่บังคับ ข้อมูลเกี่ยวกับเซสชันออนไลน์ ซึ่งจำเป็นสำหรับการเปิดใช้บริการเสมือน
directMerchantPayment

object (DirectMerchantPayment)

ไม่บังคับ ต้องเพิ่มข้อมูลเพิ่มเติมหากบริการกำหนดให้ผู้ใช้ชำระเงินให้ผู้ขายโดยตรง หมายเหตุสำคัญ: RwG จะไม่มีส่วนเกี่ยวข้องในธุรกรรมนี้ ต้องระบุหากมีการกำหนด VirtualSession และบริการไม่ใช่บริการฟรี หรือ PrepaymentType ไม่ได้ตั้งค่าเป็น "ต้องระบุ"

PriceInterpretation

อธิบายว่าควรตีความราคาและแสดงให้ผู้ใช้เห็นอย่างไร

Enum
PRICE_INTERPRETATION_UNSPECIFIED ไม่ได้ระบุการตีความราคา ค่าเริ่มต้นคือ EXACT_AMOUNT
EXACT_AMOUNT

กรณีที่ควรตีความราคาเป็นค่าที่เฉพาะเจาะจง

ตัวอย่าง: $20 สำหรับชั้นเรียนโยคะ $15 สำหรับการตัดผมเด็ก
STARTS_AT

เมื่อราคาของบริการเปลี่ยนแปลง แต่ผู้บริโภคทราบราคาขั้นต่ำแล้ว ผู้บริโภคอาจเลือกขึ้นราคา

โปรดทราบว่าบริการใดๆ ที่ใช้ PriceSharedation นี้ต้องใช้ PrepaymentType NOT_SUPPORTED

ตัวอย่างเช่น 900 บาทสำหรับการตัดแต่งขนสุนัข แต่ผู้บริโภคเพิ่มเติมอาจขึ้นราคา
NOT_DISPLAYED

เมื่อราคาของบริการเปลี่ยนแปลงและไม่มีข้อมูลราคาแสดงแก่ผู้บริโภคล่วงหน้า

โปรดทราบว่าบริการใดๆ ที่ใช้ PriceSharedation นี้ต้องใช้ PrepaymentType NOT_SUPPORTED และราคาต้องว่างเปล่า

ตัวอย่าง: การให้คำปรึกษาสำหรับบริการเกี่ยวกับบ้าน

SchedulingRules

กฎการกำหนดเวลาสำหรับบริการ

การแสดง JSON 
{
  "minAdvanceOnlineCanceling": string,
  "lateCancellationFee": {
    object (Price)
  },
  "noshowFee": {
    object (Price)
  },
  "admissionPolicy": enum (AdmissionPolicy),
  "cancellationPolicy": {
    object (CancellationPolicy)
  },

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

string (int64 format)

ต้องแจ้งล่วงหน้าขั้นต่ำภายในไม่กี่วินาทีเพื่อยกเลิกการนัดหมายที่จองไว้ทางออนไลน์ (ไม่บังคับ)
lateCancellationFee
(deprecated)

object (Price)

ค่าธรรมเนียมในการยกเลิกภายในระยะเวลาการแจ้งล่วงหน้าขั้นต่ำ
noshowFee
(deprecated)

object (Price)

ค่าธรรมเนียมสำหรับการไม่แสดงตัวโดยไม่ต้องยกเลิก
admissionPolicy

enum (AdmissionPolicy)

นโยบายการรับนักศึกษาที่ใช้กับบริการนี้ หากไม่ได้ตั้งค่า ค่าเริ่มต้นจะเป็น TIME_STRICT (ไม่บังคับ)
cancellationPolicy

object (CancellationPolicy)

นโยบายการยกเลิกกฎการกำหนดเวลา (ต้องระบุสำหรับกิจกรรมน่าสนใจ)

ฟิลด์การรวม min_booking_buffer ระยะเวลา (เป็นวินาที) นับจากเวลาที่จองล่าสุดได้จนถึงเวลาที่ช่วงห้องว่างเริ่มต้นหรือสิ้นสุด

หากตั้งค่า "min_advance_booking" เวลาที่จองไว้ล่าสุดจะคำนวณเป็น (<slot start time> - "min_advance_booking") หากตั้งค่า "min_booking_buffer_before_end_time" เวลาจองล่าสุดจะคำนวณเป็น (<เวลาสิ้นสุดช่วง> - "min_booking_buffer_before_end_time") โปรดทราบว่าค่าของ "min_booking_buffer_before_end_time" ต้องเป็นบวกหากกำหนดไว้ หากไม่ได้ตั้งค่าทั้ง 2 รายการ ระบบจะจองช่วงเวลาดังกล่าวได้จนกว่าจะถึงเวลาเริ่มต้นของสล็อต หากตั้งค่าทั้ง 2 ช่อง ระบบจะเลือกเพียงค่าเดียวและไม่สนใจค่าอื่น ทำให้เราคาดการณ์ไม่ได้ว่าจะเลือกค่าใดอย่างแน่นอน

ตัวอย่าง

  • ตัดผมที่ต้องจองอย่างน้อย 1 ชั่วโมงก่อนเวลาเริ่มต้น 'scheduling_rules{ min_advance_booking: 3600 ...}`

  • พิพิธภัณฑ์ที่ซื้อตั๋วรอบสุดท้ายได้ 30 นาทีก่อนปิด: "scheduling_rules{ min_booking_buffer_before_end_time: 1800 ...}"

  • ต้องซื้อตั๋วภาพยนตร์ก่อนเวลาเริ่มต้น 'scheduling_rules{ ...}' (เว้นช่องนี้ว่างไว้) (ไม่บังคับ) min_booking_buffer สามารถเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
minAdvanceBooking

string (int64 format)

ระยะเวลา (เป็นวินาที) นับจากเวลาที่จองล่าสุดได้จนถึงเวลาที่ช่วงห้องว่างเริ่มต้น
minBookingBufferBeforeEndTime

string (int64 format)

ระยะเวลา (เป็นวินาที) นับจากเวลาที่จองล่าสุดได้จนถึงเวลาที่ช่วงเวลาว่างสิ้นสุดลง หากตั้งค่าช่องนี้ไว้ ต้องตั้งค่าช่อง "admissionPolicy" เป็น TIME_FLEXIBLE เพื่อระบุว่าผู้ใช้สามารถใช้ตั๋วที่ซื้อได้หลังจากช่วงเริ่มโฆษณา

AdmissionPolicy

นโยบายการใช้บริการนี้

Enum
ADMISSION_POLICY_UNSPECIFIED ไม่ได้ใช้
TIME_STRICT ลูกค้าจะต้องแสดงตัวในช่วงเวลาเริ่มต้นของช่วงเวลาว่าง และคาดว่าบริการจะเสร็จสิ้นเมื่อถึงเวลาสิ้นสุดของช่วงเวลาว่าง ตัวอย่างกรณีการใช้งาน TIME_STRICT: * ทัวร์ชมที่เริ่มต้นเวลา 9.00 น. กำหนดให้ผู้เข้าร่วมทุกคนไปถึงเวลาเริ่มต้น และกลับมาเวลาประมาณ 12:00 น. * การจองเวลาตัดผมวันเสาร์เวลา 15:00 น. ซึ่งจะใช้เวลาประมาณ 30 นาที * คลาสฟิตเนสตั้งแต่เวลา 18:00 ถึง 20:00 น.
TIME_FLEXIBLE

ลูกค้ามาถึงได้ทุกเมื่อตั้งแต่เวลาเริ่มต้นจนถึงเวลาสิ้นสุดของช่วงเวลาพร้อมให้บริการเพื่อใช้การจองนี้

ตัวอย่างกรณีการใช้งาน TIME_FLEXIBLE: * ตั๋วเข้าชมพิพิธภัณฑ์ที่ใช้ได้ทุกเมื่อในวันที่ซื้อ * ค่าเข้าชมสวนสนุกในช่วงบ่ายที่ใช้งานได้ตั้งแต่เวลา 12:00 น. ถึง 21:00 น.
TIMED_ENTRY_WITH_FLEXIBLE_DURATION

ลูกค้าต้องมาถึงผู้ขายตั้งแต่เวลาเริ่มต้นของช่วงเวลาความพร้อมจำหน่ายสินค้า แต่สามารถออกได้ทุกเมื่อที่ต้องการ

เช่น ถ้าเป็นกรณีเข้าชมพิพิธภัณฑ์ ตั๋วเข้าชมแบบกำหนดเวลาเวลา 10:00 น. จะให้ผู้ใช้มาที่พิพิธภัณฑ์เวลา 10:00 น. เวลาเริ่มต้นของช่วงเวลาว่างสำหรับบริการนี้จะแสดงเวลาเข้าชมที่กำหนดไว้ แต่เวลาสิ้นสุดจะใช้เป็นคีย์ในการระบุช่วงเวลาที่พร้อมให้บริการสำหรับการจองเท่านั้น

CancellationPolicy

นโยบายการยกเลิกสำหรับบริการ

การแสดง JSON 
{
  "refundCondition": [
    {
      object (RefundCondition)
    }
  ]
}
ช่อง
refundCondition[]

object (RefundCondition)

มีเงื่อนไขการคืนเงินอย่างน้อย 0 รายการที่ใช้กับนโยบาย

RefundCondition

กำหนดเงื่อนไขการคืนเงินรายการเดียว เงื่อนไขการคืนเงินหลายข้อสามารถใช้ร่วมกันเพื่ออธิบาย "ขั้นตอนการคืนเงิน" เป็นระยะเวลาต่างๆ ก่อนเวลาเริ่มต้นบริการ

การแสดง JSON 
{
  "minDurationBeforeStartTime": string,
  "refundPercent": integer
}
ช่อง
minDurationBeforeStartTime

string (Duration format)

ระยะเวลาก่อนเวลาเริ่มต้นจนกว่าจะถึงวันที่ลูกค้าจะได้รับเงินคืนบางส่วนสำหรับค่าใช้จ่ายของบริการที่ระบุไว้ใน refundPercent เมื่อตั้งค่าเป็น 0 (ค่าเริ่มต้น) คุณสามารถยกเลิกบริการได้ทุกเมื่อ

ระยะเวลาเป็นวินาทีโดยมีตัวเลขเศษส่วนไม่เกิน 9 หลัก ซึ่งลงท้ายด้วย "s" เช่น "3.5s"
refundPercent

integer (uint32 format)

เปอร์เซ็นต์ที่ขอเงินคืนได้ หากยกเลิกการจองบริการอย่างน้อย minDurationBeforeStartTime ก่อนเวลาเริ่มต้นบริการ โดยอยู่ในช่วง [0, 100] เมื่อตั้งค่าเป็น 0 (ค่าเริ่มต้น) บริการจะขอเงินคืนไม่ได้ เมื่อกำหนดเป็น 100 ระบบจะคืนเงินเต็มจำนวนได้

PrepaymentType

enum เพื่อระบุประเภทการชำระล่วงหน้า

Enum
PREPAYMENT_TYPE_UNSPECIFIED โดยค่าเริ่มต้น เราจะถือว่าการชำระเงินล่วงหน้าเป็น NOT_SUPPORTED
REQUIRED โดยผู้ใช้ต้องชำระค่าบริการนี้ ณ เวลาที่จอง
OPTIONAL ผู้ใช้จะเลือกชำระเงินล่วงหน้าสำหรับบริการนี้ได้ขณะจองหรือภายหลัง แต่ไม่จำเป็นต้องทำในการจอง
NOT_SUPPORTED บริการนี้ไม่รองรับการชำระเงินล่วงหน้า

PrepaymentTerms

ข้อมูลเฉพาะเกี่ยวกับเวลาที่ชำระเงินล่วงหน้าเสร็จสมบูรณ์

การแสดง JSON 
{
  "chargeTiming": enum (ChargeTiming),
  "chargeTimeBeforeStartTimeSec": string
}
ช่อง
chargeTiming

enum (ChargeTiming)

เวลาที่จะมีการเรียกเก็บเงินที่สัมพันธ์กับเวลาการซื้อ
chargeTimeBeforeStartTimeSec

string (int64 format)

เวลาเป็นวินาทีก่อนเวลาเริ่มต้นบริการที่ผู้ใช้จะมีการเรียกเก็บเงินสำหรับการชำระเงิน ควรตั้งค่าช่องนี้เมื่อ ChargeTiming คือ CHARGE_LATER เท่านั้น

ChargeTiming

enum เพื่อระบุว่าจะเริ่มเรียกเก็บเงินเมื่อใดซึ่งสัมพันธ์กับเวลาการซื้อ

Enum
CHARGE_TIMING_UNSPECIFIED ไม่ได้ใช้
CHARGE_NOW ลูกค้าจะถูกเรียกเก็บเงินทันที
CHARGE_LATER ลูกค้าจะถูกเรียกเก็บเงินในภายหลัง

ServiceIntakeForm

กำหนดแบบฟอร์มการสมัครที่ปรับแต่งบริการที่ผู้ขายมอบให้

การแสดง JSON 
{
  "field": [
    {
      object (ServiceIntakeFormField)
    }
  ],
  "firstTimeCustomers": boolean,
  "returningCustomers": boolean
}
ช่อง
field[]

object (ServiceIntakeFormField)

ช่องที่จะแสดงต่อผู้ใช้
firstTimeCustomers
(deprecated)

boolean

หากเป็น "จริง" แบบฟอร์มนี้จะแสดงต่อลูกค้าที่ซื้อเป็นครั้งแรก เลิกใช้งานแล้ว แบบฟอร์มนี้ไม่รองรับฟังก์ชันนี้
returningCustomers
(deprecated)

boolean

หากเป็นจริง แบบฟอร์มนี้จะแสดงต่อลูกค้าที่กลับมาซื้อซ้ำ เลิกใช้งานแล้ว แบบฟอร์มนี้ไม่รองรับฟังก์ชันนี้

ServiceIntakeFormField

กำหนดช่องที่รวมอยู่ใน ServiceIntakeForm

การแสดง JSON 
{
  "id": string,
  "type": enum (FieldType),
  "label": string,
  "localizedLabel": {
    object (Text)
  },
  "value": [
    string
  ],
  "choiceText": [
    {
      object (Text)
    }
  ],
  "isRequired": boolean,
  "allowCustomAnswer": boolean,
  "additionalOption": [
    {
      object (Text)
    }
  ],
  "ticketTypeRestrict": [
    string
  ],
  "hint": {
    object (Text)
  }
}
ช่อง
id

string

สตริงจากพาร์ทเนอร์ผู้รวบรวมข้อมูลที่ระบุช่องแบบฟอร์มโดยไม่ซ้ำกัน รหัสนี้ควรเหมือนกับรหัสในคำตอบของช่องแบบฟอร์มที่เกี่ยวข้อง และต้องไม่ซ้ำกันทั้งในระดับบริการและต่อแบบฟอร์มคำขอแจ้งปัญหา (ต้องระบุ)
type

enum (FieldType)

ประเภทของช่องนี้
label

string

ข้อความที่แสดงต่อผู้ใช้ในช่องนี้ เลิกใช้งานแล้ว โปรดใช้ localizedLabel แทน
localizedLabel

object (Text)

ข้อความที่แสดงต่อผู้ใช้ในช่องนี้ ช่องนี้สามารถใส่ได้หลายภาษา (ต้องระบุ)
value[]

string

ตั้งค่าในกรณีที่ประเภทช่องคือ LOCATION_SEARCH เท่านั้น โปรดใช้ "locationId" ในช่อง "location" เพื่อระบุค่าตำแหน่ง
choiceText[]

object (Text)

ตั้งค่าในกรณีที่ประเภทช่องเป็น MULTIPLE_CHOICE, CHECKBOXES หรือ DROPDOWN เท่านั้น ใช้เพื่อแจกแจงตัวเลือกที่เป็นไปได้
isRequired

boolean

ระบุว่าผู้ใช้ต้องการคำตอบในช่องนี้หรือไม่
allowCustomAnswer

boolean

ระบุว่าอนุญาตค่าที่กำหนดเองเพิ่มเติมในคำตอบที่กำหนดไว้ล่วงหน้าหรือไม่ ตัวเลือกนี้ใช้ได้ก็ต่อเมื่อประเภทฟิลด์คือ LOCATION_SEARCH (ไม่บังคับ)
additionalOption[]

object (Text)

มีตัวเลือกเพิ่มเติมนอกเหนือจากค่าที่ระบุ ใช้ได้เฉพาะเมื่อประเภทฟิลด์คือ LOCATION_SEARCH เช่น นอกจากข้อมูลรายชื่อสถานที่ตั้งที่ให้ไว้แล้ว ยังมีอีกตัวเลือกหนึ่งที่ใช้ได้คือ "ฉันจะติดต่อซัพพลายเออร์ในภายหลัง" (ไม่บังคับ)
ticketTypeRestrict[]

string

หากควรแสดงคำถามนี้เมื่อผู้ใช้จองตั๋วบางประเภทเท่านั้น ควรตั้งค่าช่องนี้เป็นชุดรหัสประเภทตั๋วที่เกี่ยวข้อง เว้นช่องนี้ว่างไว้หากคำถามมีความเกี่ยวข้องเสมอ
hint

object (Text)

ข้อความคำแนะนำสำหรับอินพุต ซึ่งแสดงเป็นตัวยึดตําแหน่งข้อความ ตัวเลือกนี้ใช้ได้ก็ต่อเมื่อประเภทช่องคือ SHORT_ANSWER หรือ PARAGRAPH (ไม่บังคับ)

FieldType

enum เพื่อระบุประเภทฟิลด์

Enum
FIELD_TYPE_UNSPECIFIED ระบบจะไม่สนใจช่องประเภทที่ไม่ได้ระบุหรือไม่รู้จัก
SHORT_ANSWER ช่องป้อนข้อความแบบบรรทัดเดียว
PARAGRAPH ช่องป้อนข้อความแบบหลายบรรทัด
MULTIPLE_CHOICE ชุดปุ่มตัวเลือกที่ต้องใช้ตัวเลือกเดียวจากหลายตัวเลือก
CHECKBOXES รายการที่มีช่องทำเครื่องหมายแบบแจกแจงอย่างน้อย 1 รายการ
DROPDOWN ตัวเลือกจากเมนูแบบเลื่อนลง
BOOLEAN ปุ่มใช่/ไม่ใช่

ServiceType

ประเภทบริการที่กำหนดไว้ล่วงหน้า

Enum
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 ใช้เพื่อแยกความแตกต่างระหว่างตั๋วที่มีราคาและ/หรือความพร้อมใช้งานแตกต่างกัน เนื่องจากประเภทผู้ใช้ แอตทริบิวต์บริการ หรือตัวเลือก/ส่วนเสริมแตกต่างกัน

ตั๋วเป็นหน่วยขั้นต่ำที่สามารถจองได้สำหรับค่าบริการ เช่น จุดล่องแก่ง สิทธิ์เข้าชมพิพิธภัณฑ์ เรือคายัคคู่ให้เช่าแบบเต็มวัน

การแสดง JSON 
{
  "ticketTypeId": string,
  "shortDescription": string,
  "localizedShortDescription": {
    object (Text)
  },
  "price": {
    object (Price)
  },
  "perTicketFee": {
    object (PerTicketFee)
  },
  "optionDescription": string,
  "localizedOptionDescription": {
    object (Text)
  }
}
ช่อง
ticketTypeId

string

รหัสคำขอแจ้งปัญหาใช้เพื่อแยกความแตกต่างระหว่างตั๋วประเภทต่างๆ ของบริการเดียวกัน และต้องไม่ซ้ำกันภายในบริการหนึ่งๆ
shortDescription

string

คำอธิบายสั้นๆ ของ TicketType นี้

ชื่อนี้ผู้ใช้จะมองเห็นได้ เช่น "ผู้ใหญ่" "เด็ก" "ทหารผ่านศึก" "แถว J" ฯลฯ ต้องระบุ ตั๋วแต่ละประเภทควรมีคำอธิบายให้ผู้ใช้เห็น เลิกใช้งานแล้ว ใช้ localizedShortDescription แทน
localizedShortDescription

object (Text)

คำอธิบายสั้นๆ ของ TicketType นี้ที่รองรับ i18n

ชื่อนี้ผู้ใช้จะมองเห็นได้ เช่น "ผู้ใหญ่" "เด็ก" "ทหารผ่านศึก" "แถว J" ฯลฯ ต้องระบุ ตั๋วแต่ละประเภทควรมีคำอธิบายให้ผู้ใช้เห็น คุณระบุค่าแยกกันสำหรับแต่ละภาษาได้
price

object (Price)

ราคาตั๋วประเภทนี้ 1 ใบ ไม่รวมภาษี ระบบจะคิดอัตราภาษีของบริการกับตั๋ว
perTicketFee

object (PerTicketFee)

ค่าธรรมเนียมเพิ่มเติมสำหรับการซื้อตั๋วนี้ (ไม่บังคับ)
optionDescription

string

คำอธิบายของตัวเลือกเพิ่มเติมที่แสดงคำขอประเภทนี้ (หากมี) เลิกใช้งานแล้ว ใช้ localizedOptionDescription แทน
localizedOptionDescription

object (Text)

คำอธิบายของตัวเลือกเพิ่มเติมที่แสดงคำขอประเภทนี้ (หากมี) คุณระบุค่าแยกกันสำหรับแต่ละภาษาได้

โดยตัวเลือกเพิ่มเติมจะมีประโยชน์เมื่อประเภทตั๋วแสดงมิติข้อมูลหลายรายการ

ตัวอย่างที่ 1: แท็กการเข้าชมที่มีประเภทที่แตกต่างกัน 'adult', 'child' and language as an additional option, thead TicketType list will be: - {ticketTypeId: "ticket_type_1" localizedShortDescription { value: "adult"" } localizedOptionDescription { value: "english" } } - {ticketTypeId: "ticket_typeId: localizedShortDescription}"

ตัวอย่าง 2: ค่าที่พักเรือคายัคซึ่งมีหลายชั่วโมง: ค่าเข้าและถุงคายัคหลายชั่วโมงโดยใช้ตัวเลือก Dryry Bag add-on, the shortDescription can be "3 hours" and the optionDescription descriptionอาจจะเป็น "withDryry Bag" or " " without disring Bag" or " "some rของคุณ": - {ticketTypeId: "ticket_type_1" localizedShortDescription { value: "2 hours" } localized localizeddescription } } localized - glish { TH

ไม่บังคับ แต่หากตั๋วประเภทใดภายในบริการมีการตั้งค่าช่องนี้ไว้ เราคาดหวังให้ตั้งค่าตั๋วประเภทอื่นๆ ทั้งหมดเป็นฟิลด์นี้ด้วย (สามารถใช้ตัวเลือกเริ่มต้นเป็น "คำอธิบาย" ได้) เช่น [{ticket_type_1, adult, english}, {ticket_type_1, adult, ''}] ไม่ใช่รายการที่ถูกต้อง

สนับสนุนแท็กการจัดรูปแบบ HTML เพียง 2 แท็กเท่านั้น ได้แก่ และ
ป้ายเหล่านี้มีไว้เพื่อระบุตัวเลือกที่มีทั้งชื่อและรายละเอียดโดยละเอียด เช่น "ที่นั่งพรีเมียม
ตัวเลือกนี้มีที่นั่งในตู้ส่วนตัว รวมถึงที่นั่งแบบเบาะรองนั่ง ทีวีส่วนตัว อาหารและเครื่องดื่มในที่นั่ง ที่นั่งเหล่านี้มองเห็นวิวทุ่งนาอันสวยงาม"

PerTicketFee

ค่าธรรมเนียมที่ต้องชำระสำหรับตั๋วแต่ละใบที่ผู้ใช้ซื้อ

การแสดง JSON 
{
  "serviceCharge": {
    object (Price)
  },
  "facilityFee": {
    object (Price)
  },
  "taxes": {
    object (Price)
  }
}
ช่อง
serviceCharge

object (Price)

มีค่าใช้จ่ายเพิ่มเติมสำหรับบริการ
facilityFee

object (Price)

ค่าธรรมเนียมไปยังสถานที่จัดงาน/สิ่งอำนวยความสะดวก
taxes

object (Price)

ภาษีตั๋วต่อ

RelatedMedia

รูปภาพที่เกี่ยวข้องกับบริการนี้ Google จะทำการ Crawl สื่อเหล่านี้เพื่อให้แน่ใจว่าแสดงต่อผู้ใช้ปลายทางอย่างถูกต้อง (ไม่บังคับ)

การแสดง JSON 
{
  "url": string,
  "type": enum (MediaType),
  "localizedCaption": {
    object (Text)
  },
  "attribution": {
    object (Attribution)
  },
  "caption": string
}
ช่อง
url

string

URL ของแหล่งที่มาของสื่อนี้ Google จะทำการ Crawl สื่อที่โฮสต์ที่ URL นี้
type

enum (MediaType)

ประเภทของแหล่งที่มาของสื่อนี้
localizedCaption

object (Text)

คำบรรยายภาพของสื่อที่รองรับ i18n รองรับเฉพาะข้อความธรรมดา คอมโพเนนต์ HTML ใดๆ จะถูกตัดออก (ไม่บังคับ)
attribution

object (Attribution)

ข้อมูลการระบุแหล่งที่มาเกี่ยวกับแหล่งที่มาของสื่อ โปรดทราบว่าหากจำเป็นต้องแสดงที่มาเพื่อแสดงกับสื่อเพื่อให้เครดิตแก่ช่างภาพหรือเอเจนซี ต้องตั้งค่าช่องนี้ (ไม่บังคับ)
caption
(deprecated)

string

เลิกใช้งานแล้ว ต้องการใช้ localizedCaption

MediaType

enum เพื่อระบุประเภทของแหล่งที่มาของสื่อนี้ รองรับรูปภาพเท่านั้น โปรดติดต่อทีมจองกับ Google หากต้องการรองรับสื่ออื่นๆ นอกเหนือจากรูปภาพ

Enum
TYPE_UNSPECIFIED ไม่ได้ใช้
PHOTO บ่งบอกว่าสื่อที่ระบุโดย URL เป็นรูปภาพ

การระบุแหล่งที่มา

ข้อมูลการระบุแหล่งที่มาของสื่อนี้

การแสดง JSON 
{
  "localizedText": {
    object (Text)
  },
  "text": string
}
ช่อง
localizedText

object (Text)

ข้อความที่ให้เครดิตช่างภาพหรือเอเจนซีที่สนับสนุน i18n ข้อความนี้จะปรากฏพร้อมกับสื่อต้นฉบับ โปรดทราบว่าช่องนี้สนับสนุนเฉพาะข้อความธรรมดาเท่านั้น คอมโพเนนต์ HTML ใดๆ จะถูกตัดออก (ไม่รองรับการระบุที่มาตามไฮเปอร์ลิงก์)
text
(deprecated)

string

เลิกใช้งานแล้ว ต้องการใช้ localizedText

ServiceAttributeValueId

ระบุค่าเฉพาะของแอตทริบิวต์บริการที่จะใช้กับบริการ

การแสดง JSON 
{
  "attributeId": string,
  "valueId": string
}
ช่อง
attributeId

string

รหัสของแอตทริบิวต์ตามที่กำหนดไว้ใน Merchant.service_attribute เช่น "service-type"
valueId

string

รหัสของค่าสำหรับแอตทริบิวต์นี้ เช่น "การตัดผม" ต้องตรงกับ valueId ในคำจำกัดความแอตทริบิวต์ service

WaitlistRules

กฎที่เกี่ยวข้องกับการเข้าร่วมคิวรอ

การแสดง JSON 
{
  "minPartySize": integer,
  "maxPartySize": integer,
  "supportsAdditionalRequest": boolean,
  "aboveMaxPartySizeOptions": [
    {
      object (UnsupportedPartySizeOption)
    }
  ]
}
ช่อง
minPartySize

integer

ต้องระบุ ต้องเป็นจำนวนเต็มบวกสำหรับบริการที่มีฟังก์ชันคิวรอ หากบริการหรือผู้ขายไม่มีฟังก์ชันคิวรอ คุณต้องไม่ป้อนข้อมูลนี้
maxPartySize

integer

ต้องระบุ ต้องเป็นจำนวนเต็มบวกสำหรับบริการที่มีฟังก์ชันคิวรอ หากบริการหรือผู้ขายไม่มีฟังก์ชันคิวรอ คุณต้องไม่ป้อนข้อมูลนี้
supportsAdditionalRequest

boolean

หากเป็นจริง ผู้ใช้จะส่งคำขอข้อความเพิ่มเติมรูปแบบอิสระได้เมื่อเข้าร่วมคิวรอสำหรับบริการนี้
aboveMaxPartySizeOptions[]

object (UnsupportedPartySizeOption)

ตั้งค่าตัวเลือกสำหรับกลุ่มที่มีขนาดใหญ่กว่า maxPartySize ที่กำหนด เว้นว่างไว้หากกลุ่มขนาดใหญ่ไม่ควรมีตัวเลือกอื่นในการเข้าร่วมคิวรอ

UnsupportedPartySizeOption

ตัวเลือกสำหรับปาร์ตี้ที่อยู่นอกเหนือระดับ

การแสดง JSON 
{
  "callMerchant": {
    object (CallMerchant)
  }
}
ช่อง
callMerchant

object (CallMerchant)

จำนวนคนที่อยู่ไกลเกินไปจะโทรหาธุรกิจได้ ระบบจะแสดงข้อความที่กำหนดไว้ล่วงหน้าให้แก่ผู้ใช้ ข้อความตัวอย่างที่จะแสดง: "สำหรับผู้ที่มีขนาดใหญ่กว่า {waitlist Rules.max_party_size} โปรดโทรหาร้านอาหารที่หมายเลข {phone}" ต้องตั้งค่า CallMerchant แต่จะว่างเปล่า

CallMerchant

ข้อความว่างเปล่าที่จะใช้ใน supportedPartySizeOption การตั้งค่านี้จะแสดงตัวเลือกให้ผู้ใช้โทรหาธุรกิจเพื่อทำการจอง

TicketingVerticalSpecificData

ข้อมูลเพิ่มเติมที่มีเฉพาะสําหรับประเภทธุรกิจจำหน่ายตั๋วเข้างาน

การแสดง JSON 
{
  "eventCategory": enum (EventCategory),
  "eventUrl": string,
  "entity": [
    {
      object (Entity)
    }
  ],
  "eventAttendanceMode": enum (AttendanceMode),
  "eventVirtualLocationUrl": [
    string
  ],
  "eventOrganizer": {
    object (Text)
  },
  "eventOrganizerUrl": string,
  "eventOrganizerType": enum (OrganizerType),
  "eventSourceUrl": [
    string
  ],
  "eventState": enum (EventState)
}
ช่อง
eventCategory

enum (EventCategory)

หมวดหมู่ของกิจกรรม ตั้งค่าเฉพาะเมื่อเหตุการณ์จัดอยู่ในหมวดหมู่ที่กำหนดไว้ล่วงหน้าเท่านั้น (ไม่บังคับ)
eventUrl

string

URL ของเหตุการณ์บนเว็บไซต์ของพาร์ทเนอร์ (ไม่บังคับ)
entity[]

object (Entity)

รายการเอนทิตีที่เกี่ยวข้องกับเหตุการณ์ (ไม่บังคับ)
eventAttendanceMode

enum (AttendanceMode)

ต้องระบุ ประเภทของการเข้าร่วมกิจกรรม
eventVirtualLocationUrl[]

string

ไม่บังคับ URL ที่สามารถดูเหตุการณ์
eventOrganizer

object (Text)

ไม่บังคับ ผู้จัดที่จัดกิจกรรม
eventOrganizerUrl

string

ไม่บังคับ URL ของผู้จัดกิจกรรม
eventOrganizerType

enum (OrganizerType)

ไม่บังคับ ประเภทของผู้จัด
eventSourceUrl[]

string

ต้องระบุ URL ของหน้าเว็บที่สามารถดูข้อมูลหรือคำอธิบายกิจกรรมได้
eventState

enum (EventState)

ไม่บังคับ สถานะของเหตุการณ์

EventCategory

ชุดย่อยของหมวดหมู่กิจกรรมที่เราปรับแต่งประสบการณ์การใช้งานผลิตภัณฑ์ หมายเหตุ: ไม่ได้มีจุดประสงค์เพื่อให้เป็นบริบทของเหตุการณ์ทั่วไป

Enum
EVENT_CATEGORY_UNSPECIFIED ไม่ได้ระบุ โปรดอย่าใช้
EVENT_CATEGORY_CONCERT คอนเสิร์ต
EVENT_CATEGORY_SPORTS การแข่งขันกีฬา
EVENT_CATEGORY_THEATRE กิจกรรมโรงละคร
EVENT_CATEGORY_EXHIBITS งานแสดง
EVENT_CATEGORY_WORKSHOPS_AND_CLASSES เวิร์กช็อปและชั้นเรียน

เอนทิตี

แสดงเอนทิตีที่เกี่ยวข้องกับเหตุการณ์

การแสดง JSON 
{
  "id": string,
  "name": string,
  "url": string,
  "entityType": enum (EntityType),
  "entityRole": enum (EntityRole),
  "publicIdentificationData": {
    object (PublicIdentificationData)
  }
}
ช่อง
id

string

ตัวระบุที่ไม่ซ้ำของเอนทิตีในฐานข้อมูลของพาร์ทเนอร์ (ไม่บังคับ)
name

string

ชื่อของเอนทิตี (ต้องระบุ)
url

string

URL ของหน้าเว็บที่อธิบายเอนทิตีอย่างชัดเจน นี่คือหน้าเว็บในเว็บไซต์ของพาร์ทเนอร์สำหรับเอนทิตี (หากมี) สำหรับ URL สาธารณะอื่นๆ ของเอนทิตี ให้ใช้ relevantUrl ใน publicIdentificationData (ไม่บังคับ)
entityType

enum (EntityType)

ประเภทของเอนทิตี (ไม่บังคับ)
entityRole

enum (EntityRole)

บทบาทของเอนทิตีในเหตุการณ์ (ไม่บังคับ)
publicIdentificationData

object (PublicIdentificationData)

ข้อมูลอ้างอิงสาธารณะของเอนทิตี (ไม่บังคับ)

EntityType

ประเภทของเอนทิตี หมายเหตุ: ไม่ได้มีจุดประสงค์เพื่อให้เป็นออนโทโลจีสากล

Enum
ENTITY_TYPE_UNSPECIFIED ไม่ได้ระบุ โปรดอย่าใช้
ENTITY_TYPE_PERFORMER เอนทิตีแสดงถึงศิลปินหรือกลุ่มที่แสดงในคอนเสิร์ตหรือการแสดง ใช้ได้เฉพาะเมื่อหมวดหมู่กิจกรรมเป็นคอนเสิร์ตหรือโรงภาพยนตร์
ENTITY_TYPE_PLAYER เอนทิตีหมายถึงทีมกีฬาหรือผู้เล่นในการแข่งขัน ใช้เมื่อหมวดหมู่กิจกรรมคือกีฬาเท่านั้น
ENTITY_TYPE_CONCERT_TOUR เอนทิตีแสดงถึงทัวร์ชมที่มีกิจกรรมนี้ ใช้ได้เมื่อหมวดหมู่กิจกรรมเป็น CONCERT เท่านั้น
ENTITY_TYPE_SPORTS_SERIES เอนทิตีแสดงถึงการแข่งขันกีฬาที่มีกิจกรรมนี้ ใช้เมื่อหมวดหมู่กิจกรรมคือกีฬาเท่านั้น
ENTITY_TYPE_PLAY รายการที่แสดงประเภทการเล่น (เช่น ดนตรี ตลก บัลเล่ต์ ฯลฯ) ที่แสดงในกิจกรรม มีผลเฉพาะเมื่อหมวดหมู่กิจกรรมเป็น THEATRE

EntityRole

บทบาทของเอนทิตีในเหตุการณ์

Enum
ENTITY_ROLE_UNSPECIFIED ไม่ได้ระบุ
ENTITY_ROLE_HEADLINER บุคคลหมายความว่าเป็นผู้พาดหัวข่าวหรือผู้มีผลงานอันดับต้นๆ ในกิจกรรม
ENTITY_ROLE_SUPPORTER เอนทิตีดังกล่าวเป็นตัวแทนของนักแสดงสนับสนุนในกิจกรรม
ENTITY_ROLE_HOME_TEAM เอนทิตีแสดงถึงทีมหลักในการแข่งขัน (กีฬา)
ENTITY_ROLE_AWAY_TEAM เอนทิตีแสดงถึงทีมที่ไปเยือนในกิจกรรม (กีฬา)

PublicIdentificationData

ตัวระบุ หน้าเว็บ หรือแหล่งที่มาสาธารณะอื่นๆ ที่อ้างอิงเอนทิตี

การแสดง JSON 
{
  "relevantUrl": [
    string
  ],
  "musicbrainzId": string
}
ช่อง
relevantUrl[]

string

URL สาธารณะของหน้าเว็บใดๆ ที่มีไว้สำหรับหัวข้อเท่านั้น ซึ่งอาจรวมถึงเว็บไซต์อย่างเป็นทางการ, ดิสโก้, แพลตฟอร์มโซเชียลมีเดีย, หน้า Wikipedia หรือ imdb เช่น https://www.discogs.com/artist/1124645-Taylor-Swift, https://www.wikidata.org/wiki/Q19320959, https://twitter.com/acmilan (ไม่บังคับ)
musicbrainzId

string

ตัวระบุ Musicbrainz ยาว 36 อักขระของศิลปินหรือหน่วยงานเพลงอื่นๆ หากมี ดู https://musicbrainz.org/doc/MusicBrainz_Identifier (ไม่บังคับ)

AttendanceMode

ประเภทของการเข้าร่วมกิจกรรม

Enum
ATTENDANCE_MODE_UNSPECIFIED ไม่ได้ระบุ
ONLINE สำหรับกิจกรรมออนไลน์
PHYSICAL สำหรับกิจกรรมต่างๆ
PHYSICAL_ONLINE_MIXED สำหรับกิจกรรมที่เป็นทั้งกิจกรรมจริงและออนไลน์

OrganizerType

ประเภทของผู้จัด

Enum
ORGANIZER_TYPE_UNSPECIFIED ไม่ได้ระบุ
PERSON สำหรับผู้จัดที่เป็นบุคคล
ORGANIZATION สำหรับผู้จัดที่เป็นองค์กร

EventState

สถานะของเหตุการณ์

Enum
EVENT_STATE_UNSPECIFIED ไม่ได้ระบุ
SCHEDULED กำหนดเวลากิจกรรมแล้ว
RESCHEDULED กิจกรรมมีกำหนดการใหม่
CANCELLED กิจกรรมถูกยกเลิก
POSTPONED กิจกรรมถูกเลื่อนออกไปแล้ว

IntegrationType

ความลึกของการผสานรวมที่รองรับ

Enum
INTEGRATION_TYPE_UNSPECIFIED ค่าเริ่มต้นคือ END_TO_END
INTEGRATION_TYPE_END_TO_END การผสานรวมโดยสมบูรณ์ช่วยให้ทำการจองผ่าน Google ได้ตั้งแต่ต้นจนจบ
INTEGRATION_TYPE_INVENTORY_ONLY เซิร์ฟเวอร์การจองไม่จำเป็นต้องรองรับบริการนี้ ระบบต้องส่งข้อมูลเฉพาะผู้ขาย บริการ และความพร้อมจำหน่ายสินค้า (ไม่บังคับ)

PerOrderFee

ค่าธรรมเนียมที่ต้องชำระ 1 ครั้งต่อคำสั่งซื้อ ไม่ว่าจะมีตั๋วกี่ใบก็ตาม

การแสดง JSON 
{
  "deliveryFee": {
    object (Price)
  },
  "processingFee": {
    object (Price)
  }
}
ช่อง
deliveryFee

object (Price)

ค่าธรรมเนียมอาจแตกต่างกันไปตามวิธีการนำส่ง
processingFee

object (Price)

ค่าธรรมเนียมในการประมวลผลวิธีการชำระเงินของผู้ใช้

ToursAndActivitiesContent

ฟิลด์เนื้อหาสำหรับทัวร์ชมและกิจกรรมโดยเฉพาะ องค์ประกอบแต่ละรายการในช่องที่ซ้ำควรแยกเป็นอิสระเพื่อให้แสดงผลแยกกันได้ (เช่น เป็นหัวข้อย่อย)

ขอแนะนำอย่างยิ่งให้เติมข้อมูล ToursAndActivityContent สำหรับทัวร์และกิจกรรม แต่ไม่บังคับอย่างเคร่งครัด ทุกฟิลด์รองรับทั้งข้อความธรรมดาและข้อความ HTML สำหรับการจัดรูปแบบพื้นฐาน แท็กการจัดรูปแบบที่คล้ายกับ HTML ที่สนับสนุน:

แท็กวลี:
, , , : รองรับเฉพาะแท็ก 3 แบบที่กล่าวถึงข้างต้นเท่านั้น
สามารถใช้เพื่อแบ่งบรรทัดในย่อหน้า และสามารถใช้ // เพื่อไฮไลต์ข้อความสำคัญ และจะไม่สนใจแท็กวลีอื่นๆ

แท็กและสไตล์ที่กำหนดเองอื่นๆ ทั้งหมดไม่ได้รับอนุญาตและจะถูกนำออก URL, โฆษณา Anchor และลิงก์ต่างๆ จะถูกตัดออก และจะไม่แสดงต่อผู้ใช้ปลายทางเลย

หมายเหตุสำคัญ: * อย่าทำซ้ำข้อมูลที่ให้ไว้แล้วใน highlights, exclusion และฟิลด์อื่นๆ ที่เฉพาะเจาะจงมากขึ้นในรายละเอียดของบริการ * หลีกเลี่ยงการใช้แท็กอื่นๆ ยกเว้นแท็กที่รองรับที่กล่าวถึงข้างต้น เนื่องจากเนื้อหาภายในแท็กที่ไม่รองรับจะถูกตัดออก และอาจส่งผลให้ผู้ใช้ได้รับประสบการณ์การใช้งานที่ไม่พึงประสงค์

การแสดง JSON 
{
  "highlights": [
    {
      object (Text)
    }
  ],
  "inclusions": [
    {
      object (Text)
    }
  ],
  "exclusions": [
    {
      object (Text)
    }
  ],
  "mustKnow": [
    {
      object (Text)
    }
  ]
}
ช่อง
highlights[]

object (Text)

รายการไฮไลต์ที่ผู้ใช้มองเห็น
inclusions[]

object (Text)

รายการการรวมที่ผู้ใช้มองเห็นได้
exclusions[]

object (Text)

รายการการยกเว้นที่ผู้ใช้มองเห็นได้
mustKnow[]

object (Text)

รายการหมายเหตุสำคัญที่ผู้ใช้มองเห็นได้ ใช้เพื่อดูรายละเอียด เช่น การจำกัดอายุหรือเงื่อนไขอื่นๆ ที่ทำให้บริการนี้ไม่เหมาะสม

ตำแหน่ง

ข้อมูลทางภูมิศาสตร์เกี่ยวกับสถานที่

การแสดง JSON 
{
  "placeId": string,
  "name": string,
  "telephone": string,
  "url": string,
  "geo": {
    object (GeoCoordinates)
  },
  "locationType": enum (LocationType),
  "locationId": string
}
ช่อง
placeId

string

รหัสสถานที่สําหรับสถานที่ในฐานข้อมูลของ Google Places และใน Google Maps ดูข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่ได้ที่ https://developers.google.com/places/web-service/place-id หากมีการระบุข้อมูลนี้ Google จะจับคู่สถานที่ตั้งกับสถานที่นี้
name

string

ระบบจะใช้ชื่อสถานที่ โทรศัพท์ URL และภูมิศาสตร์ของสถานที่ตั้งเพื่อรองรับการจับคู่สถานที่กับสถานที่ที่มีอยู่ใน Google Maps อยู่แล้ว

ช่องนี้ไม่บังคับ แต่อาจจำเป็นต้องระบุในบางบริบท ตัวอย่างเช่น Service.location ที่ไม่มีชื่อจะไม่จับคู่กับองค์กรธุรกิจ แม้ว่าจะมีที่อยู่เดียวกันก็ตาม (ไม่บังคับ)
telephone

string

หมายเลขโทรศัพท์สาธารณะของสถานที่ตั้ง รวมทั้งรหัสประเทศและรหัสพื้นที่ เช่น +14567891234 (ไม่บังคับ)
url

string

URL ของเว็บไซต์สาธารณะของสถานที่ (ไม่บังคับ)
geo

object (GeoCoordinates)

ข้อมูลทางภูมิศาสตร์ของสถานที่ รวมทั้งละติจูด ลองจิจูด และที่อยู่ (ไม่บังคับ)
locationType

enum (LocationType)

ต้องระบุประเภทของสถานที่ หากมีการระบุตำแหน่งนี้สำหรับบริการ
locationId

string

ข้อมูลอ้างอิงที่ไม่ซ้ำของตำแหน่งภายในบริการ รหัสนี้ใช้เพื่ออ้างอิงถึงตำแหน่งนี้ในช่องบริการอื่นๆ ได้ เช่น ในแบบฟอร์มแบบฟอร์มการกรอกที่กำหนดเอง อาจใช้ชุดรหัสสถานที่ตั้งเพื่อระบุตัวเลือกสถานที่รับสินค้า หากมีการตั้งค่า รหัสนี้ต้องไม่ซ้ำกันภายในบริการเดียวกัน (ไม่บังคับ)

LocationType

ประเภทของสถานที่ตั้งนี้

Enum
LOCATION_TYPE_UNSPECIFIED ไม่ได้ระบุประเภทสถานที่ตั้ง
VISITED_LOCATION สถานที่ที่บริการนี้จะไป
START_LOCATION สถานที่ที่บริการนี้เริ่มต้นจะยังแสดงเป็น MEETING_LOCATION ด้วย
END_LOCATION ตำแหน่งที่บริการนี้สิ้นสุดลง

การจัดประเภท

กำหนดการให้คะแนนสำหรับเอนทิตี

การแสดง JSON 
{
  "value": number,
  "numberOfRatings": string
}
ช่อง
value

number

ค่าคะแนนเฉลี่ย (ต้องระบุเมื่อ numberOfRatings > 0) ค่าต้องอยู่ในช่วง [1, 5] และละเว้นได้เฉพาะในกรณีที่ numberOfRatings เป็น 0
numberOfRatings

string

จำนวนการให้คะแนนที่ใช้ในการคำนวณค่า (ต้องระบุ)

HomeServiceData

ต้องระบุข้อมูลเพิ่มเติมสำหรับประเภทธุรกิจที่ให้บริการเกี่ยวกับบ้าน

การแสดง JSON 
{
  "categoryType": string,
  "jobType": string
}
ช่อง
categoryType

string

หมวดหมู่ระดับสูงที่มีบริการเกี่ยวกับบ้านนี้ เช่น ช่างประปา ช่างไฟฟ้า ฯลฯ
jobType

string

ประเภทงานในหมวดหมู่บริการเกี่ยวกับบ้านที่ระบุ เช่น unclog_drain, install_faucet คือประเภทงานในหมวดหมู่ช่างประปา

VirtualSession

ข้อมูลเกี่ยวกับเซสชันออนไลน์/ออนไลน์ เช่น ชั้นเรียนโยคะออนไลน์ ชั้นเรียนทำอาหารเสมือนจริง ฯลฯ

การแสดง JSON 
{
  "sessionInstructions": {
    object (Text)
  },
  "sessionRequirements": {
    object (Text)
  },
  "virtualPlatformInfo": {
    object (VirtualPlatformInfo)
  },
  "isSessionPrerecorded": boolean
}
ช่อง
sessionInstructions

object (Text)

วิธีการตั้งค่าชั้นเรียนออนไลน์นี้ หากพาร์ทเนอร์ไม่ได้ใส่ URL ของวิดีโอไว้ในการจอง ก็จะต้องระบุเวลาที่ระบบจะแชร์ URL ของวิดีโอกับผู้ใช้ด้วย เช่น "เราจะส่ง URL ของ Zoom ล่วงหน้า 30 นาทีก่อนเวลาเรียน" (แนะนำ)
sessionRequirements

object (Text)

ข้อกำหนดสำหรับเซสชันออนไลน์ที่ระบุ เช่น เสื่อโยคะ อุปกรณ์ทำอาหาร ฯลฯ (แนะนำ)
virtualPlatformInfo

object (VirtualPlatformInfo)

ข้อมูลเกี่ยวกับแพลตฟอร์มเสมือนที่ใช้ในเซสชันนี้ (จำเป็นสำหรับการเปิดใช้บริการเสมือน)
isSessionPrerecorded

boolean

ต้องระบุ ตั้งค่าเป็นจริงหากเซสชันเสมือนไม่ได้ถ่ายทอดสดและมีการบันทึกไว้ล่วงหน้าแล้ว

VirtualPlatformInfo

ข้อมูลเกี่ยวกับแพลตฟอร์มที่จะใช้สำหรับเซสชันออนไลน์นี้

การแสดง JSON 
{
  "platform": enum (Platform),
  "otherPlatformName": {
    object (Text)
  }
}
ช่อง
platform

enum (Platform)

แพลตฟอร์มที่ใช้สําหรับเซสชันเสมือน
otherPlatformName

object (Text)

ชื่อของแพลตฟอร์มหากตั้งค่าแพลตฟอร์มเป็น "อื่นๆ" (ต้องระบุหากตั้งค่าแพลตฟอร์มเป็น "อื่นๆ")

แพลตฟอร์ม

enum เพื่อระบุว่าผู้ขายจะใช้แพลตฟอร์มเสมือนใด

Enum
PLATFORM_UNSPECIFIED ไม่ได้ใช้
FLEXIBLE ผู้ขายสามารถใช้แพลตฟอร์มวิดีโอได้ตามต้องการ
GOOGLE_HANGOUTS ผลิตภัณฑ์ Google Hangouts
GOOGLE_MEET ผลิตภัณฑ์ Google Meet
ZOOM Zoom Video Communications
SKYPE Skype
YOUTUBE สตรีมมิงแบบสดใน YouTube
OTHER ควรตั้งค่าหากแพลตฟอร์มวิดีโอที่ใช้แตกต่างจากแพลตฟอร์มที่กล่าวถึงนี้

DirectMerchantPayment

ข้อมูลเกี่ยวกับวิธีที่ผู้ใช้สามารถชำระเงินให้ผู้ขายโดยตรงแทนการชำระค่าบริการผ่าน RwG ล่วงหน้า

การแสดง JSON 
{
  "paymentMethods": [
    {
      object (Text)
    }
  ]
}
ช่อง
paymentMethods[]

object (Text)

เราขอแนะนำให้ผู้ใช้ชำระเงินผ่านวิธีการชำระเงินที่ระบุไว้ด้านล่างเท่านั้น

วิธีการ

create

 สร้าง Service ใหม่ของผู้ขายที่จัดการโดยผู้รวบรวมข้อมูลที่ระบุ และส่งกลับมา

delete

 ลบ Service ที่มีอยู่ของผู้ขายซึ่งผู้รวบรวมข้อมูลที่ระบุเป็นผู้จัดการ

patch

 อัปเดตServiceที่มีอยู่ของผู้ขายที่จัดการโดยผู้รวบรวมข้อมูลที่ระบุ และส่งคืนสินค้า