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>
The <ul> สามารถใช้กับ <li> เพื่อแสดงรายการที่ไม่เรียงลำดับ และ <ol> สามารถใช้กับ <li> เพื่อแสดงรายการตามลำดับ ซึ่งเป็นวิธีที่ดีในการแสดงเช็กลิสต์ กำหนดการ หรือรายการอื่นๆ ที่เหมาะกับกรณีการใช้งานของคุณ
ตัวอย่าง: หากต้องการแสดงรายการลักษณะของเรือสำราญ:
<ol>
<li>วิวทะเลสุดอลังการพร้อมโอกาสเล่นกับสัตว์ป่า</li>
<li>ออกแบบการเดินทางและบริการอย่างพิถีพิถัน</li>
<li>รับประกันราคาที่ถูกที่สุด</li>
</ol>
โปรดทราบว่าเฉพาะ <li> เด็กอายุต่ำกว่า <ul> หรือ <ol> แท็กทั้งหมดจะถูกแปลง ผู้เผยแพร่โฆษณาย่อยอื่นๆ ทั้งหมดจะหายไป นอกจากนี้ แท็ก แอตทริบิวต์ และรูปแบบภายในจะถูกละเว้น เราจะเก็บรักษาเฉพาะเนื้อหาที่เป็นข้อความล้วน

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

แท็กวลี: <br>, <strong>, <em>:
รองรับเฉพาะแท็ก 3 รายการข้างต้นเท่านั้น &lt;br&gt; สามารถใช้เพื่อแบ่งบรรทัดในย่อหน้า และ <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)

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

object (NoShowFee)

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

enum (RequireCreditCard)

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

enum (ServiceType)

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

object (TicketType)

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

object (RelatedMedia)

รูปภาพที่เกี่ยวข้องกับบริการนี้ Google จะรวบรวมข้อมูลและจัดเก็บสื่อเพื่อให้แน่ใจว่าเนื้อหานั้นจะแสดงต่อผู้ใช้ปลายทางด้วยวิธีที่มีประสิทธิภาพสูงสุด (ไม่บังคับ)
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 ไม่ได้ตั้งค่าเป็น REQUIRED

PriceInterpretation

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

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

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

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

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

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

ตัวอย่างเช่น ตัดแต่งขนสุนัข $30 แต่ตัวเลือกเพิ่มเติมของผู้บริโภคอาจขึ้นราคา
NOT_DISPLAYED

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

โปรดทราบว่าบริการที่ใช้การตีความราคานี้ต้องใช้ 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 ช่อง ระบบจะเลือกเพียงค่าเดียวและจะไม่สนใจค่าอื่นๆ ด้วย เราไม่สามารถคาดการณ์ได้อย่างน่าเชื่อถือว่าจะเลือกค่าใด

ตัวอย่าง

  • ตัดผมที่ต้องจองล่วงหน้าอย่างน้อย 1 ชั่วโมงก่อนเวลาเริ่มต้น &#39;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)

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

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" ใน "ตำแหน่ง" เพื่อระบุค่าตำแหน่ง
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 ช่องป้อนข้อมูลแบบ 1 บรรทัดสำหรับข้อความ
PARAGRAPH ช่องป้อนข้อมูลหลายบรรทัดสำหรับข้อความ
MULTIPLE_CHOICE ชุดปุ่มตัวเลือกที่ต้องใช้ 1 ตัวเลือกจากตัวเลือกที่มีอยู่หลายรายการ
CHECKBOXES รายการที่แจกแจงอย่างน้อย 1 รายการที่มีช่องทำเครื่องหมาย
DROPDOWN ตัวเลือกจากเมนูแบบเลื่อนลง
BOOLEAN ปุ่มใช่/ไม่ใช่

ServiceType

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

Enum
SERVICE_TYPE_UNSPECIFIED ไม่ได้ใช้งาน
SERVICE_TYPE_DINING_RESERVATION การจองร้านอาหาร
SERVICE_TYPE_FOOD_ORDERING การสั่งอาหารอาจเป็นการจัดส่งอาหารหรือสั่งกลับบ้าน หรือทั้ง 2 อย่างก็ได้
SERVICE_TYPE_FOOD_DELIVERY บริการจัดส่งอาหาร
SERVICE_TYPE_FOOD_TAKEOUT อาหารแบบสั่งกลับบ้าน
SERVICE_TYPE_EVENT_TICKET ตั๋วกิจกรรม
SERVICE_TYPE_TRIP_TOUR ทัวร์ชม
SERVICE_TYPE_APPOINTMENT บริการที่มีการนัดหมายหรือชั้นเรียน แนะนำสำหรับ (1) สุขภาพและการออกกำลังกาย (2) สปาและความงาม และ (3) บริการให้คำปรึกษาและประเมินด้านการเงิน โปรดดูประเภทบริการที่รองรับที่ https://developers.google.com/maps-booking/guides/end-to-end-integration/overview
SERVICE_TYPE_ONLINE_APPOINTMENT บริการที่มีการนัดหมายทางออนไลน์สำหรับชั้นเรียนหรือเซสชันต่างๆ ซึ่งจะเป็นแบบออนไลน์ทั้งหมด ต้องตั้งค่าหากเปิดใช้การจองบริการเสมือนจริง
SERVICE_TYPE_SHOPPING บริการที่ช่วยให้ผู้ใช้เลือกซื้อจากผู้ขายที่ระบุ โดยอาจเป็นบริการจัดส่งหรือไปรับที่ร้านก็ได้

TicketType

TicketType ใช้เพื่อแยกความแตกต่างระหว่างตั๋วที่มีราคาและ/หรือความพร้อมที่แตกต่างกันเนื่องจากมีประเภทผู้ใช้ต่างกัน แอตทริบิวต์บริการที่แตกต่างกัน หรือตัวเลือก/ส่วนเสริมที่ต่างกัน

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

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

string

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

string

คำอธิบายแบบย่อสำหรับ TicketType นี้

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

object (Text)

คำอธิบายแบบย่อสำหรับ TicketType นี้พร้อมการรองรับ i18n

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

object (Price)

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

object (PerTicketFee)

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

string

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

object (Text)

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

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

ตัวอย่างที่ 1: ตั๋วเข้าชมประเภท "ผู้ใหญ่" และ "เด็ก" และภาษาเป็นตัวเลือกเพิ่มเติม รายการ TicketType ที่คาดไว้จะเป็น - { TicketTypeId: "ticket_type_1" localizedShortDescription { value: "adult" } localizedOptionDescription { value: "english" } } - { TicketTypeId: "ticket_type_2" localizedShortDescription { value: "adult" } localizedOptionDescription { value: "spanish" } } - { TicketTypeId: "ticket_type_3" localizedShortDescription { value: "child" } localizedOptionDescription { value: "english" } } - { TicketTypeId: "ticket_type_4" localizedShortDescription { value: "child" } localizedOptionDescription { value: "spanish" }

ตัวอย่างที่ 2: บริการเช่าเรือคายัคแบบหลายชั่วโมงพร้อมส่วนเสริมสำหรับกระเป๋าแห้ง (ไม่บังคับ) คำอธิบายแบบสั้นอาจเป็น "3 ชั่วโมง" และ OptionDescription อาจเป็น "พร้อมถุงเก็บฝุ่น" ก็ได้ หรือ "ไม่มีถุงแห้ง": - { TicketTypeId: "ticket_type_1" localizedShortDescription { value: "2 ชั่วโมง" } localizedOptionDescription { value: "english" } } - { TicketTypeId: "ticket_type_2" localizedShortDescription { value: "2 ชั่วโมง" } localizedOptionDescription { value: "spanish" } } - { TicketTypeId: "ticket_type_3" localizedShortDescription { value: "3 ชั่วโมง" } localizedOptionDescription { value: "english" } } - { TicketTypeId: "ticket_type_4" localizedShortDescription { value: "3 ชั่วโมง" } localizedOptionDescription { value: "spanish" }

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

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

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 จะรวบรวมข้อมูลสื่อที่โฮสต์ที่ 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 ในคำอธิบายแอตทริบิวต์บริการ

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)

จำนวนคนที่อยู่นอกช่วงสามารถโทรหาธุรกิจได้ ข้อความที่กำหนดไว้ล่วงหน้าจะปรากฏต่อผู้ใช้ ตัวอย่างข้อความที่จะแสดง: "สําหรับผู้ที่มีขนาดใหญ่กว่า {waitlistRules.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 สาธารณะอื่นๆ ของเอนทิตี ให้ใช้ relatedUrl ใน publicIdentificationData (ไม่บังคับ)
entityType

enum (EntityType)

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

enum (EntityRole)

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

object (PublicIdentificationData)

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

EntityType

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

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

EntityRole

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

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 สาธารณะของหน้าเว็บใดๆ ที่สร้างขึ้นเฉพาะหัวข้อเท่านั้น ซึ่งอาจรวมถึงเว็บไซต์อย่างเป็นทางการ, Discogs, แพลตฟอร์มโซเชียลมีเดีย, หน้า 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 ที่สนับสนุน:

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

แท็กและรูปแบบที่กำหนดเองอื่นๆ ทั้งหมดไม่ได้รับอนุญาตและจะถูกนำออก 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 สถานที่ที่บริการนี้สิ้นสุดลง

Rating

กำหนดการจัดประเภทสำหรับเอนทิตี

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

number

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

string

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

HomeServiceData

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

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

string

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

string

ประเภทงานตามหมวดหมู่ที่มีบริการเกี่ยวกับบ้านนั้นๆ เช่น unclog_drain, install_faucet เป็นประเภทงานภายใต้หมวดหมู่ช่างประปา

VirtualSession

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

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

object (Text)

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

object (Text)

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

object (VirtualPlatformInfo)

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

boolean

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

VirtualPlatformInfo

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

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

enum (Platform)

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

object (Text)

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

แพลตฟอร์ม

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

Enum
PLATFORM_UNSPECIFIED ไม่ได้ใช้งาน
FLEXIBLE ผู้ขายมีความยืดหยุ่นในการใช้งานแพลตฟอร์มวิดีโอ
GOOGLE_HANGOUTS ผลิตภัณฑ์ Google แฮงเอาท์
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ที่มีอยู่ของผู้ขายซึ่งจัดการโดยผู้รวบรวมข้อมูลที่ระบุ และส่งคืนสินค้าดังกล่าว