หน้านี้ได้รับการแปลโดย Cloud Translation API

Engage SDK Travel: คำแนะนำการผสานรวมทางเทคนิคของบุคคลที่สาม

Google กำลังสร้างแพลตฟอร์มในอุปกรณ์ที่จัดระเบียบแอปของผู้ใช้ตามประเภทธุรกิจ และมอบประสบการณ์การใช้งานเนื้อหาแอปที่ปรับเปลี่ยนในแบบของคุณและค้นพบเนื้อหาใหม่ๆ ประสบการณ์การใช้งานแบบเต็มหน้าจอนี้เปิดโอกาสให้พาร์ทเนอร์นักพัฒนาซอฟต์แวร์ได้แสดงเนื้อหาที่สมบูรณ์ที่สุดในช่องเฉพาะนอกแอป คู่มือนี้มีวิธีการสำหรับพาร์ทเนอร์นักพัฒนาแอปในการผสานรวมเนื้อหาด้านการท่องเที่ยวและกิจกรรม โดยใช้ Engage SDK ในการสร้างพื้นที่ใหม่แห่งนี้

รายละเอียดการผสานรวม

คำศัพท์

การผสานรวมนี้ประกอบด้วยคลัสเตอร์ 3 ประเภท ได้แก่ คําแนะนํา แนะนํา และต่อเนื่อง

กลุ่มคําแนะนําจะแสดงคําแนะนําการเดินทางและกิจกรรมที่ปรับเปลี่ยนในแบบของคุณจากพาร์ทเนอร์นักพัฒนาแอปแต่ละราย คำแนะนำเหล่านี้อาจปรับเปลี่ยนไปตามผู้ใช้หรือเป็นแบบทั่วไป (เช่น สินค้ามาแรง) ใช้เพื่อแสดงบทความ กิจกรรม ที่พัก หรือสถานที่น่าสนใจที่แนะนํา
- กลุ่มคําแนะนําอาจประกอบด้วยข้อมูล ArticleEntity, EventEntity, LodgingEntity, PointOfInterestEntity หรือ StoreEntity แต่ต้องไม่ผสมกับเอนทิตีประเภทต่างๆ
คำแนะนำของคุณควรมีโครงสร้างดังต่อไปนี้
- คลัสเตอร์คําแนะนํา: มุมมอง UI ที่มีกลุ่มคําแนะนําจากพาร์ทเนอร์นักพัฒนาแอปรายเดียวกัน
- เอนทิตี: ออบเจ็กต์ที่แสดงรายการเดียวในคลัสเตอร์ การผสานรวมนี้มีเอนทิตีบางรายการที่จะแสดงโดยใช้คลัสเตอร์คำแนะนำ ดังนี้
  - ArticleEntity: ArticleEntity แสดงคําแนะนําสําหรับเนื้อหาที่เป็นข้อความซึ่งเกี่ยวข้องกับการเดินทางและกิจกรรม ซึ่งสามารถใช้เป็นบทความ บล็อกโพสต์ เนื้อหาการตลาด ตัวอย่างข่าว ฯลฯ
    
    รูปที่ 1: UI ที่แสดง ArticleEntity รายการเดียวภายในคลัสเตอร์คําแนะนํา
  - EventEntity: EventEntity แสดงถึงเหตุการณ์ที่เกิดขึ้นในอนาคต เวลาเริ่มต้นของกิจกรรมเป็นข้อมูลสำคัญที่จำเป็นต้องแจ้งให้ผู้ใช้ทราบ
    
    รูปที่ 2: UI ที่แสดง EventEntity รายการเดียวภายในกลุ่มคําแนะนํา
  - LodgingEntity: LodgingEntity แสดงที่พัก เช่น โรงแรม อพาร์ตเมนต์ บ้านพักให้เช่าระยะสั้นและระยะยาว
    
    รูปที่ 3: UI ที่แสดง LodgingEntity รายการเดียวภายในคลัสเตอร์คําแนะนํา
  - StoreEntity: StoreEntity แสดงถึงร้านค้า ร้านอาหาร คาเฟ่ ฯลฯ โดยจะไฮไลต์เนื้อหาที่ร้านอาหารหรือร้านค้าเป็นข้อมูลสำคัญที่ต้องสื่อให้ผู้ใช้ทราบ
    
    รูปที่ 4: UI ที่แสดง StoreEntity รายการเดียวภายในกลุ่มคําแนะนํา
  - PointOfInterestEntity: PointOfInterestEntity แสดงถึงสถานที่ที่น่าสนใจ เช่น ปั๊มน้ำมัน สถานที่จัดงาน สวนสนุก พิพิธภัณฑ์ สถานที่ท่องเที่ยว เส้นทางเดินป่า ฯลฯ โดยจะไฮไลต์เนื้อหาที่ตำแหน่งเป็นข้อมูลสำคัญที่ต้องสื่อให้ผู้ใช้ทราบ ไม่ควรใช้กับที่พัก ร้านค้า หรือสถานที่รับประทานอาหาร
    
    รูปที่ 5: UI ที่แสดง PointOfInterestEntity รายการเดียวภายในคลัสเตอร์คําแนะนํา
กลุ่มการดําเนินการต่อจะแสดงเนื้อหาที่ผู้ใช้มีส่วนร่วมเมื่อเร็วๆ นี้จากพาร์ทเนอร์นักพัฒนาแอปหลายรายในการรวมกลุ่ม UI เดียว พาร์ทเนอร์นักพัฒนาซอฟต์แวร์แต่ละรายจะได้รับอนุญาตให้ออกอากาศเอนทิตีในคลัสเตอร์ Continuation ได้สูงสุด 10 รายการ

เนื้อหาต่อสามารถมีโครงสร้างดังต่อไปนี้
- ArticleEntity: ArticleEntity แสดงคําแนะนําสําหรับเนื้อหาที่เกี่ยวข้องกับการเดินทางและกิจกรรม เอนทิตีนี้สามารถใช้เพื่อแสดงบทความข่าวที่ยังไม่จบหรือเนื้อหาอื่นๆ ที่ผู้ใช้ต้องการอ่านต่อจากจุดที่หยุดไว้ เช่น ข้อมูลโค้ดข่าว บล็อกโพสต์ ข้อมูลโค้ดเกี่ยวกับสถานที่ท่องเที่ยวหรือกิจกรรม
  
  รูปที่ 6 UI ที่แสดง ArticleEntity รายการเดียวภายในคลัสเตอร์การต่อเรื่อง
- RestaurantReservationEntity: RestaurantReservationEntity แสดงการจองร้านอาหารหรือคาเฟ่ และช่วยให้ผู้ใช้ติดตามการจองร้านอาหารที่กําลังจะเกิดขึ้นหรืออยู่ระหว่างดำเนินการได้
  
  รูปที่ 7 UI แสดง RestaurantReservationEntity รายการเดียวภายในคลัสเตอร์ Continuation
- EventReservationEntity: EventReservationEntity แสดงถึงการจองกิจกรรมและช่วยให้ผู้ใช้ติดตามการจองกิจกรรมที่กําลังจะเกิดขึ้นหรือกําลังดำเนินอยู่ กิจกรรมอาจรวมถึงแต่ไม่จำกัดเพียงกิจกรรมต่อไปนี้
  - กิจกรรมกีฬา เช่น การจองตั๋วเข้าชมการแข่งขันฟุตบอล
  - กิจกรรมเกม เช่น การจองสำหรับอีสปอร์ต
  - กิจกรรมด้านความบันเทิง เช่น การจองหนังในโรงภาพยนตร์ คอนเสิร์ต โรงภาพยนตร์ งานเซ็นชื่อหนังสือ
  - การจองการเดินทางหรือสถานที่น่าสนใจ เช่น ทัวร์ชมพร้อมไกด์ ตั๋วเข้าชมพิพิธภัณฑ์
  - การจองเพื่องานสังคม/สัมมนา/การประชุม
  - การจองเซสชันการศึกษา/การฝึกอบรม
  รูปที่ 8 UI ที่แสดง EventReservationEntity รายการเดียวภายในคลัสเตอร์การดําเนินการต่อ
- LodgingReservationEntity: LodgingEntityReservation แสดงการจองที่พักสำหรับการเดินทางและช่วยให้ผู้ใช้ติดตามการจองโรงแรมหรือที่พักให้เช่าที่กำลังจะเกิดขึ้นหรือกำลังดำเนินอยู่
  
  รูปที่ 9 UI ที่แสดง LodgingReservationEntity รายการเดียวภายในคลัสเตอร์การต่ออายุ
- TransportationReservationEntity: TransportationReservationEntity เป็นตัวแทนของการจองการเดินทางทุกรูปแบบและช่วยให้ผู้ใช้ติดตามการจองสำหรับเที่ยวบิน เรือข้ามฟาก รถไฟ รถประจำทาง บริการเรียกรถ หรือเรือที่กำลังจะมาถึงหรือกำลังดำเนินอยู่
  
  รูปที่ 10 UI แสดง TransportationReservationEntity รายการเดียวภายในคลัสเตอร์การต่ออายุ
- VehicleRentalReservationEntity: VehicleRentalReservationEntity แสดงการจองรถเช่าและช่วยให้ผู้ใช้ติดตามการจองรถเช่าที่กําลังจะเกิดขึ้นหรืออยู่ระหว่างดำเนินการ
  
  รูปที่ 11 UI ที่แสดง VehicleRentalReservationEntity รายการเดียวภายในคลัสเตอร์การดําเนินการต่อ
กลุ่มแนะนําจะแสดงรายการต่างๆ จากพาร์ทเนอร์นักพัฒนาแอปหลายรายในการรวมกลุ่ม UI เดียว โดยจะมีคลัสเตอร์แนะนำกลุ่มเดียวที่แสดงอยู่ใกล้กับด้านบนของ UI ด้วยตำแหน่งที่มีลำดับความสำคัญเหนือคลัสเตอร์คำแนะนำทั้งหมด พาร์ทเนอร์นักพัฒนาแอปแต่ละรายจะออกอากาศได้สูงสุด 10 รายการในคลัสเตอร์แนะนํา
- GenericFeaturedEntity: GenericFeaturedEntity แตกต่างจากรายการคำแนะนำตรงที่ควรใช้รายการแนะนำสำหรับเนื้อหายอดนิยมรายการเดียวจากนักพัฒนาแอป และควรแสดงเนื้อหาที่สำคัญที่สุดรายการเดียวที่จะน่าสนใจและเกี่ยวข้องกับผู้ใช้
  
  รูปที่ 12: UI ที่แสดง FeaturedCluster พร้อมรายการ GenericFeaturedEntity

งานก่อนเริ่มเวิร์กช็อป

ระดับ API ขั้นต่ำ: 19

เพิ่มไลบรารี com.google.android.engage:engage-core ลงในแอปโดยทำดังนี้

dependencies {
    // Make sure you also include that repository in your project's build.gradle file.
    implementation 'com.google.android.engage:engage-core:1.5.2'
}

สรุป

การออกแบบนี้อิงตามการใช้งานบริการที่เชื่อมโยง

ข้อมูลที่จะเผยแพร่ได้จะขึ้นอยู่กับขีดจํากัดต่อไปนี้สําหรับคลัสเตอร์ประเภทต่างๆ

ประเภทคลัสเตอร์	ขีดจํากัดของคลัสเตอร์	ขีดจํากัดขั้นต่ำของเอนทิตีในคลัสเตอร์	ขีดจํากัดสูงสุดของเอนทิตีในคลัสเตอร์
กลุ่มคําแนะนํา	สูงสุด 5 รายการ	อย่างน้อย 5 รายการ	ไม่เกิน 25 (`ArticleEntity`, `EventEntity`, `LodgingEntity`, `StoreEntity` หรือ `PointOfInterestEntity`)
คลัสเตอร์การต่อเรื่อง	ไม่เกิน 1	อย่างน้อย 1 รายการ	ไม่เกิน 10 รายการ (`ArticleEntity`, `RestaurantReservationEntity` `EventReservationEntity`, `LodgingReservationEntity`, `TransportationReservationEntity` หรือ `VehicleRentalReservationEntity`)
คลัสเตอร์แนะนำ	ไม่เกิน 1	อย่างน้อย 1	ไม่เกิน 10 (`GenericFeaturedEntity`)

ขั้นตอนที่ 1: ระบุข้อมูลเอนทิตี

SDK ได้กําหนดเอนทิตีต่างๆ เพื่อแสดงรายการแต่ละประเภท เรารองรับเอนทิตีต่อไปนี้สำหรับหมวดหมู่การเดินทางและกิจกรรม

GenericFeaturedEntity
ArticleEntity
EventEntity
LodgingEntity
StoreEntity
PointOfInterestEntity
RestaurantReservationEntity
EventReservationEntity
LodgingReservationEntity
TransportationReservationEntity
VehicleRentalReservationEntity

แผนภูมิด้านล่างแสดงแอตทริบิวต์และข้อกําหนดที่ใช้ได้สําหรับแต่ละประเภท

`GenericFeaturedEntity`

แอตทริบิวต์	ข้อกำหนด	คำอธิบาย	รูปแบบ
URI การดำเนินการ	ต้องระบุ	Deep Link ไปยังเอนทิตีในแอปผู้ให้บริการ หมายเหตุ: คุณใช้ Deep Link เพื่อการระบุแหล่งที่มาได้ ดูคำถามที่พบบ่อยนี้	URI
ภาพโปสเตอร์	ต้องระบุ	เราจะแสดงเพียง 1 ภาพหากมีหลายภาพ สัดส่วนภาพที่แนะนำคือ 16:9 หมายเหตุ: หากมีป้าย ให้เว้นพื้นที่ปลอดภัย 24 จุดต่อนิ้วทั้งด้านบนและด้านล่างของรูปภาพ	โปรดดูข้อกำหนดเกี่ยวกับรูปภาพสำหรับคำแนะนำ
ชื่อ	ไม่บังคับ	ชื่อของเอนทิตี	ข้อความอิสระ ขนาดข้อความที่แนะนำ: 50 อักขระ
คำอธิบาย	ไม่บังคับ	ย่อหน้าข้อความ 1 ย่อหน้าเพื่ออธิบายเอนทิตี หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น	ข้อความอิสระ ขนาดข้อความที่แนะนำ: 180 อักขระ
รายการคำบรรยาย	ไม่บังคับ	คำบรรยายสูงสุด 3 รายการ โดยแต่ละคำบรรยายมีข้อความ 1 บรรทัด หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น	ข้อความอิสระ ขนาดข้อความที่แนะนำสำหรับคำบรรยายแต่ละรายการ: สูงสุด 50 อักขระ
ป้าย	ไม่บังคับ	ป้ายแต่ละป้ายจะเป็นข้อความอิสระ (ไม่เกิน 15 อักขระ) หรือรูปภาพขนาดเล็ก การดูแล UX แบบพิเศษทับรูปภาพ/วิดีโอ เช่น แสดงป้ายวางซ้อนบนรูปภาพ "การอัปเดตแบบเรียลไทม์" ระยะเวลาในการอ่านบทความ
ป้าย - ข้อความ	ไม่บังคับ	ชื่อสำหรับป้าย หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับป้าย	ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด 15 อักขระ
ป้าย - รูปภาพ	ไม่บังคับ	รูปภาพขนาดเล็ก การจัดการ UX พิเศษ เช่น การวางซ้อนป้ายบนภาพ/วิดีโอขนาดย่อ หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับป้าย	ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
หมวดหมู่เนื้อหา	ไม่บังคับ	อธิบายหมวดหมู่ของเนื้อหาในเอนทิตี	รายการ Enum ดูหลักเกณฑ์ในส่วนหมวดหมู่เนื้อหา

`ArticleEntity`

แอตทริบิวต์	ข้อกำหนด	คำอธิบาย	รูปแบบ
URI การดำเนินการ	ต้องระบุ	Deep Link ไปยังเอนทิตีในแอปผู้ให้บริการ หมายเหตุ: คุณใช้ Deep Link เพื่อการระบุแหล่งที่มาได้ โปรดดูคำถามที่พบบ่อยนี้	URI
ชื่อ	ต้องระบุ	ชื่อของเอนทิตี	ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด 50 อักขระ
ภาพโปสเตอร์	ไม่บังคับ	เราจะแสดงรูปภาพเพียง 1 รูปเมื่อมีการระบุรูปภาพหลายรูป สัดส่วนภาพที่แนะนำคือ 16:9 หมายเหตุ: ขอแนะนําให้ใช้รูปภาพ หากมีป้าย โปรดตรวจดูว่ามีระยะห่างของจุดที่ปลอดภัย (24 dp) ทั้งด้านบนและด้านล่างของรูปภาพ	ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
แหล่งที่มา - ชื่อ	ไม่บังคับ	ชื่อผู้เขียน องค์กร หรือผู้รายงาน	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 25 อักขระ
แหล่งที่มา - รูปภาพ	ไม่บังคับ	รูปภาพของแหล่งที่มา เช่น ผู้เขียน องค์กร ผู้สื่อข่าว	ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
คำอธิบาย	ไม่บังคับ	ย่อหน้าข้อความ 1 ย่อหน้าเพื่ออธิบายเอนทิตี หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น	ข้อความอิสระ ขนาดข้อความที่แนะนำ: 180 อักขระ
รายการคำบรรยาย	ไม่บังคับ	คำบรรยายสูงสุด 3 รายการ โดยแต่ละคำบรรยายมีข้อความ 1 บรรทัด หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น	ข้อความอิสระ ขนาดข้อความที่แนะนำสำหรับคำบรรยายแต่ละรายการ: สูงสุด 50 อักขระ
ป้าย	ไม่บังคับ	ป้ายแต่ละป้ายจะเป็นข้อความอิสระ (ไม่เกิน 15 อักขระ) หรือรูปภาพขนาดเล็ก การจัดการ UX พิเศษบนรูปภาพ/วิดีโอ เช่น วางซ้อนป้ายบนรูปภาพ "การอัปเดตแบบเรียลไทม์" ระยะเวลาในการอ่านบทความ
ป้าย - ข้อความ	ไม่บังคับ	ชื่อสำหรับป้าย หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับป้าย	ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด 15 อักขระ
ป้าย - รูปภาพ	ไม่บังคับ	รูปภาพขนาดเล็ก การจัดการ UX พิเศษ เช่น การวางซ้อนป้ายบนภาพ/วิดีโอขนาดย่อ หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับป้าย	ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
เวลาเผยแพร่เนื้อหา	ไม่บังคับ	นี่คือการประทับเวลาตามยุคสมัยเป็นมิลลิวินาทีเมื่อมีการเผยแพร่/อัปเดตเนื้อหาในแอป	การประทับเวลา Epoch เป็นมิลลิวินาที
เวลาในการมีส่วนร่วมครั้งล่าสุด	ต้องระบุ (แบบมีเงื่อนไข)	การประทับเวลาตามยุคสมัยเป็นมิลลิวินาทีเมื่อผู้ใช้โต้ตอบกับเอนทิตีนี้ครั้งล่าสุด หมายเหตุ: ต้องกรอกช่องนี้หากเอนทิตีนี้เป็นส่วนหนึ่งของคลัสเตอร์การต่อ	การประทับเวลา Epoch เป็นมิลลิวินาที
เปอร์เซ็นต์ความคืบหน้า	ต้องระบุแบบมีเงื่อนไข	เปอร์เซ็นต์ของเนื้อหาทั้งหมดที่ผู้ใช้บริโภคจนถึงปัจจุบัน หมายเหตุ: ต้องกรอกช่องนี้หากเอนทิตีนี้เป็นส่วนหนึ่งของคลัสเตอร์การต่อ	ค่า int ระหว่าง 0~100 (รวมค่าแรกและค่าสุดท้าย)
หมวดหมู่เนื้อหา	ไม่บังคับ	อธิบายหมวดหมู่ของเนื้อหาในเอนทิตี	รายการ Enum ดูคำแนะนำได้ที่ส่วนหมวดหมู่เนื้อหา

`EventEntity`

แอตทริบิวต์	ข้อกำหนด	คำอธิบาย	รูปแบบ
URI การดำเนินการ	ต้องระบุ	Deep Link ไปยังเอนทิตีในแอปผู้ให้บริการ หมายเหตุ: คุณใช้ Deep Link เพื่อการระบุแหล่งที่มาได้ โปรดดูคำถามที่พบบ่อยนี้	URI
ชื่อ	ต้องระบุ	ชื่อรายการ	สตริง ขนาดข้อความที่แนะนำ: สูงสุด 50 อักขระ
เวลาเริ่มต้น	ต้องระบุ	การประทับเวลา Epoch เมื่อระบบคาดว่าเหตุการณ์จะเริ่มต้น หมายเหตุ: ค่านี้จะแสดงเป็นมิลลิวินาที	การประทับเวลา Epoch เป็นมิลลิวินาที
โหมดเหตุการณ์	ต้องระบุ	ช่องสำหรับระบุว่ากิจกรรมจะเป็นแบบเสมือนจริง เข้าร่วมด้วยตนเอง หรือทั้ง 2 แบบ	Enum: VIRTUAL, IN_PERSON หรือ HYBRID
ภาพโปสเตอร์	ต้องระบุ	เราจะแสดงรูปภาพเพียง 1 รูปเมื่อมีการระบุรูปภาพหลายรูป สัดส่วนภาพที่แนะนำคือ 16:9 หมายเหตุ: ขอแนะนำอย่างยิ่งให้เพิ่มรูปภาพ หากมีป้าย ให้เว้นพื้นที่ปลอดภัย 24 dps ทั้งด้านบนและด้านล่างของรูปภาพ	โปรดดูข้อกำหนดเกี่ยวกับรูปภาพสำหรับคำแนะนำ
สถานที่ตั้ง - ประเทศ	ต้องระบุ (แบบมีเงื่อนไข)	ประเทศที่จัดกิจกรรม หมายเหตุ: จำเป็นต้องใช้สำหรับกิจกรรมที่เป็น IN_PERSON หรือ HYBRID	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ - เมือง	ต้องระบุแบบมีเงื่อนไข	เมืองที่จัดกิจกรรม หมายเหตุ: จำเป็นต้องใช้สำหรับกิจกรรมที่เป็น IN_PERSON หรือ HYBRID	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ - ที่อยู่ที่แสดง	ต้องระบุ (แบบมีเงื่อนไข)	ที่อยู่หรือชื่อสถานที่ที่จัดกิจกรรมซึ่งควรแสดงต่อผู้ใช้ หมายเหตุ: จำเป็นต้องใช้สำหรับกิจกรรมที่เป็น IN_PERSON หรือ HYBRID	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - ที่อยู่	ไม่บังคับ	ที่อยู่ (หากมี) ของสถานที่จัดอีเวนต์	ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ
สถานที่ตั้ง - รัฐ	ไม่บังคับ	รัฐหรือจังหวัด (หากมี) ที่จัดกิจกรรม	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ - รหัสไปรษณีย์	ไม่บังคับ	รหัสไปรษณีย์ (หากมี) ของสถานที่จัดกิจกรรม	ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ
สถานที่ตั้ง - ย่าน	ไม่บังคับ	ย่าน (หากมี) ที่จัดกิจกรรม	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
เวลาสิ้นสุด	ไม่บังคับ	การประทับเวลา Epoch เมื่อคาดว่าเหตุการณ์จะสิ้นสุด หมายเหตุ: ค่านี้จะแสดงเป็นมิลลิวินาที	การประทับเวลา Epoch เป็นมิลลิวินาที
คำอธิบาย	ไม่บังคับ	ย่อหน้าข้อความ 1 ย่อหน้าเพื่ออธิบายเอนทิตี หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น	ข้อความอิสระ ขนาดข้อความที่แนะนำ: 180 อักขระ
รายการคำบรรยาย	ไม่บังคับ	คำบรรยายสูงสุด 3 รายการ โดยแต่ละคำบรรยายมีข้อความ 1 บรรทัด หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น	ข้อความอิสระ ขนาดข้อความที่แนะนำสำหรับคำบรรยายแต่ละรายการ: สูงสุด 50 อักขระ
ป้าย	ไม่บังคับ	ป้ายแต่ละป้ายจะเป็นข้อความอิสระ (ไม่เกิน 15 อักขระ) หรือรูปภาพขนาดเล็ก
ป้าย - ข้อความ	ไม่บังคับ	ชื่อสำหรับป้าย หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับป้าย	ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด 15 อักขระ
ป้าย - รูปภาพ	ไม่บังคับ	รูปภาพขนาดเล็ก การจัดการ UX พิเศษ เช่น การวางซ้อนป้ายบนภาพ/วิดีโอขนาดย่อ หมายเหตุ: ป้ายต้องมีข้อความหรือรูปภาพ	ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
ราคา - CurrentPrice	ต้องระบุแบบมีเงื่อนไข	ราคาปัจจุบันของตั๋ว/บัตรเข้าชมกิจกรรม ต้องระบุหากมีการระบุราคาที่มีขีดทับ	ข้อความอิสระ
ราคา - StrikethroughPrice	ไม่บังคับ	ราคาเดิมของตั๋ว/บัตรเข้างาน	ข้อความอิสระ
ข้อความไฮไลต์ราคา	ไม่บังคับ	ข้อความไฮไลต์ราคาเพื่อแสดงโปรโมชัน กิจกรรม ส่วนลดสำหรับสมาชิก (หากมี)	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 45 อักขระ (ข้อความที่ยาวเกินไปอาจแสดงจุดไข่ปลา)
หมวดหมู่เนื้อหา	ไม่บังคับ	อธิบายหมวดหมู่ของเนื้อหาในเอนทิตี	รายการ Enum ที่มีสิทธิ์ TYPE_MOVIES_AND_TV_SHOWS (เช่น ภาพยนตร์) TYPE_DIGITAL_GAMES (เช่น eSports) TYPE_MUSIC (เช่น คอนเสิร์ต) TYPE_TRAVEL_AND_LOCAL (เช่น ทัวร์ เทศกาล) TYPE_HEALTH_AND_FITENESS (เช่น ชั้นเรียนโยคะ) TYPE_EDUCATION (เช่น ชั้นเรียน) TYPE_SPORTS (เช่น การแข่งขันฟุตบอล) TYPE_DATING (เช่น การพบปะ) ดูคำแนะนำได้ที่ส่วนหมวดหมู่เนื้อหา

`LodgingEntity`

แอตทริบิวต์	ข้อกำหนด	คำอธิบาย	รูปแบบ
URI การดำเนินการ	ต้องระบุ	Deep Link ไปยังเอนทิตีในแอปผู้ให้บริการ หมายเหตุ: คุณใช้ Deep Link เพื่อการระบุแหล่งที่มาได้ ดูคำถามที่พบบ่อยนี้	URI
ชื่อ	ต้องระบุ	ชื่อรายการ	สตริง ขนาดข้อความที่แนะนำ: สูงสุด 50 อักขระ
ภาพโปสเตอร์	ต้องระบุ	เราจะแสดงรูปภาพเพียง 1 รูปเมื่อมีการระบุรูปภาพหลายรูป สัดส่วนภาพที่แนะนําคือ 16:9 หมายเหตุ: หากมีป้าย ให้เว้นพื้นที่ปลอดภัย 24 จุดต่อนิ้วทั้งด้านบนและด้านล่างของรูปภาพ	ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
สถานที่ตั้ง - ประเทศ	ต้องระบุ	ประเทศที่ที่พักตั้งอยู่	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - เมือง	ต้องระบุ	เมืองที่ที่พักตั้งอยู่	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - ที่อยู่สำหรับแสดง	ต้องระบุ	ที่อยู่ของที่พักที่จะแสดงให้ผู้ใช้เห็น	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - ที่อยู่	ไม่บังคับ	ที่อยู่ (หากมี) ของที่พัก	ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ
สถานที่ตั้ง - รัฐ	ไม่บังคับ	รัฐหรือจังหวัด (หากมี) ที่ที่พักตั้งอยู่	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ - รหัสไปรษณีย์	ไม่บังคับ	รหัสไปรษณีย์ (หากมี) ของที่พัก	ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ
สถานที่ตั้ง - ย่าน	ไม่บังคับ	ย่านที่พัก (หากมี)	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ป้าย	ไม่บังคับ	ป้ายแต่ละป้ายจะเป็นข้อความอิสระ (ไม่เกิน 15 อักขระ) หรือรูปภาพขนาดเล็ก
ป้าย - ข้อความ	ไม่บังคับ	ชื่อสำหรับป้าย หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับป้าย	ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด 15 อักขระ
ป้าย - รูปภาพ	ไม่บังคับ	รูปภาพขนาดเล็ก การจัดการ UX พิเศษ เช่น การวางซ้อนป้ายบนภาพ/วิดีโอขนาดย่อ หมายเหตุ: ป้ายต้องมีข้อความหรือรูปภาพ	ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
คำอธิบาย	ไม่บังคับ	ย่อหน้าข้อความ 1 ย่อหน้าเพื่ออธิบายเอนทิตี หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น	ข้อความอิสระ ขนาดข้อความที่แนะนำ: 180 อักขระ
รายการคำบรรยาย	ไม่บังคับ	คำบรรยายสูงสุด 3 รายการ โดยแต่ละคำบรรยายมีข้อความ 1 บรรทัด หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น	ข้อความอิสระ ขนาดข้อความที่แนะนำสำหรับคำบรรยายแต่ละรายการ: สูงสุด 50 อักขระ
AvailabilityTimeWindow - Start Time	ไม่บังคับ	การประทับเวลาของยุคเป็นมิลลิวินาทีเมื่อคาดว่าที่พักจะเปิด/พร้อมให้บริการ	การประทับเวลา Epoch เป็นมิลลิวินาที
AvailabilityTimeWindow - เวลาสิ้นสุด	ไม่บังคับ	การประทับเวลาตามยุคสมัยเป็นมิลลิวินาทีจนกว่าที่พักจะเปิด/พร้อมให้บริการ	การประทับเวลา Epoch เป็นมิลลิวินาที
การจัดประเภท - ค่าสูงสุด	ไม่บังคับ	ค่าสูงสุดของรูปแบบการให้คะแนน ต้องระบุหากระบุค่าปัจจุบันของคะแนนด้วย	ตัวเลข >= 0.0
การจัดประเภท - ค่าปัจจุบัน	ไม่บังคับ	ค่าปัจจุบันของสเกลการให้คะแนน ต้องระบุหากระบุค่าสูงสุดของการจัดประเภทด้วย	ตัวเลข >= 0.0
คะแนน - จำนวน	ไม่บังคับ	จํานวนการให้คะแนนที่พัก หมายเหตุ: ระบุช่องนี้หากแอปต้องการควบคุมวิธีแสดงข้อมูลนี้ต่อผู้ใช้ ระบุสตริงที่กระชับซึ่งแสดงต่อผู้ใช้ได้ เช่น หากจํานวนคือ 1,000,000 ให้พิจารณาใช้ตัวย่อ เช่น 1 ล้าน เพื่อไม่ให้ถูกตัดในขนาดการแสดงผลที่เล็กลง	สตริง
การจัดประเภท - ค่าจำนวน	ไม่บังคับ	จํานวนการให้คะแนนที่พัก หมายเหตุ: ระบุช่องนี้หากไม่ต้องการจัดการตรรกะการแสดงตัวย่อด้วยตนเอง หากมีทั้ง Count และ Count Value เราจะใช้ Count เพื่อแสดงต่อผู้ใช้	ยาว
ราคา - CurrentPrice	ต้องระบุแบบมีเงื่อนไข	ราคาปัจจุบันของที่พัก ต้องระบุหากมีการระบุราคาที่มีขีดทับ	ข้อความอิสระ
ราคา - StrikethroughPrice	ไม่บังคับ	ราคาเดิมของที่พัก ซึ่งจะขีดฆ่าได้ใน UI	ข้อความอิสระ
ข้อความไฮไลต์ราคา	ไม่บังคับ	ข้อความไฮไลต์ราคาเพื่อแสดงโปรโมชัน กิจกรรม ส่วนลดสำหรับสมาชิก (หากมี)	ข้อความอิสระ ขนาดข้อความที่แนะนำ: น้อยกว่า 45 อักขระ (ข้อความยาวเกินไปอาจแสดงจุดไข่ปลา)

`StoreEntity`

ออบเจ็กต์ StoreEntity แสดงร้านค้าแต่ละแห่งที่พาร์ทเนอร์นักพัฒนาแอปต้องการเผยแพร่ เช่น ร้านอาหารหรือร้านขายของชำ

แอตทริบิวต์	ข้อกำหนด	คำอธิบาย	รูปแบบ
ภาพโปสเตอร์	ต้องระบุ	ต้องระบุรูปภาพอย่างน้อย 1 รูป	ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
URI การดำเนินการ	ต้องระบุ	Deep Link ไปยังเอนทิตีในแอปผู้ให้บริการ หมายเหตุ: คุณใช้ Deep Link เพื่อการระบุแหล่งที่มาได้ โปรดดูคำถามที่พบบ่อยนี้	URI
ชื่อ	ไม่บังคับ	ชื่อร้านค้า	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 45 อักขระ (ข้อความที่ยาวเกินไปอาจแสดงจุดไข่ปลา)
ตำแหน่ง	ไม่บังคับ	สถานที่ตั้งของร้านค้า	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 45 อักขระ (ข้อความที่ยาวเกินไปอาจแสดงจุดไข่ปลา)
ข้อความเสริม	ไม่บังคับ	ข้อความไฮไลต์เพื่อแสดงโปรโมชัน กิจกรรม หรือข้อมูลอัปเดตสำหรับร้านค้า หากมี	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 45 อักขระ (ข้อความที่ยาวเกินไปอาจแสดงจุดไข่ปลา)
รายละเอียดข้อความไฮไลต์	ไม่บังคับ	ข้อความไฮไลต์	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 45 อักขระ (ข้อความที่ยาวเกินไปอาจแสดงจุดไข่ปลา)
คำอธิบาย	ไม่บังคับ	คำอธิบายของร้านค้า	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 90 อักขระ (ข้อความที่ยาวเกินไปอาจแสดงจุดไข่ปลา)
การจัดประเภท - ค่าสูงสุด	ไม่บังคับ	ค่าสูงสุดของรูปแบบการให้คะแนน ต้องระบุหากระบุค่าปัจจุบันของคะแนนด้วย	ตัวเลข >= 0.0
การจัดประเภท - ค่าปัจจุบัน	ไม่บังคับ	ค่าปัจจุบันของสเกลการให้คะแนน ต้องระบุหากระบุค่าสูงสุดของการจัดประเภทด้วย	ตัวเลข >= 0.0
คะแนน - จำนวน	ไม่บังคับ	จํานวนการให้คะแนนที่พัก หมายเหตุ: ระบุช่องนี้หากแอปต้องการควบคุมวิธีแสดงข้อมูลนี้ต่อผู้ใช้ ระบุสตริงที่กระชับซึ่งแสดงต่อผู้ใช้ได้ เช่น หากจํานวนคือ 1,000,000 ให้พิจารณาใช้ตัวย่อ เช่น 1 ล้าน เพื่อไม่ให้ถูกตัดในขนาดการแสดงผลที่เล็กลง	สตริง
การจัดประเภท - ค่าจำนวน	ไม่บังคับ	จํานวนการให้คะแนนที่พัก หมายเหตุ: ระบุช่องนี้หากไม่ต้องการจัดการตรรกะการแสดงตัวย่อด้วยตนเอง หากมีทั้ง Count และ Count Value เราจะใช้ Count เพื่อแสดงต่อผู้ใช้	ยาว

`PointOfInterestEntity`

แอตทริบิวต์	ข้อกำหนด	คำอธิบาย	รูปแบบ
URI การดำเนินการ	ต้องระบุ	Deep Link ไปยังเอนทิตีในแอปผู้ให้บริการ หมายเหตุ: คุณใช้ Deep Link เพื่อการระบุแหล่งที่มาได้ โปรดดูคำถามที่พบบ่อยนี้	URI
ชื่อ	ต้องระบุ	ชื่อรายการ	สตริง ขนาดข้อความที่แนะนำ: สูงสุด 50 อักขระ
ภาพโปสเตอร์	ต้องระบุ	เราจะแสดงรูปภาพเพียง 1 รูปเมื่อมีการระบุรูปภาพหลายรูป สัดส่วนภาพที่แนะนำคือ 16:9 หมายเหตุ: ขอแนะนําให้ใช้รูปภาพ หากมีป้าย ให้เว้นพื้นที่ปลอดภัย 24 dp ทั้งด้านบนและด้านล่างของรูปภาพ	ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
สถานที่ตั้ง - ประเทศ	ต้องระบุ	ประเทศที่จุดที่น่าสนใจเกิดขึ้น	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - เมือง	ต้องระบุ	เมืองที่มีจุดสนใจเกิดขึ้น	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - ที่อยู่สำหรับแสดง	ต้องระบุ	ที่อยู่ของจุดที่น่าสนใจที่จะแสดงต่อผู้ใช้	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - ที่อยู่	ไม่บังคับ	ที่อยู่ (หากมี) ของจุดที่น่าสนใจ	ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ
สถานที่ตั้ง - รัฐ	ไม่บังคับ	รัฐหรือจังหวัด (หากมี) ที่จุดที่น่าสนใจตั้งอยู่	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ - รหัสไปรษณีย์	ไม่บังคับ	รหัสไปรษณีย์ (หากมี) ของจุดสนใจ	ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ
สถานที่ตั้ง - ย่าน	ไม่บังคับ	ย่าน (หากมี) ของจุดที่น่าสนใจ	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
AvailabilityTimeWindow - เวลาเริ่มต้น	ไม่บังคับ	การประทับเวลา Epoch เป็นมิลลิวินาทีเมื่อคาดว่าจุดที่น่าสนใจจะเปิด/พร้อมใช้งาน	การประทับเวลา Epoch เป็นมิลลิวินาที
AvailabilityTimeWindow - เวลาสิ้นสุด	ไม่บังคับ	การประทับเวลา Epoch ในหน่วยมิลลิวินาทีจนกระทั่งคาดว่าจุดที่น่าสนใจจะเปิด/พร้อมใช้งาน	การประทับเวลา Epoch ในหน่วยมิลลิวินาที
ป้าย	ไม่บังคับ	ป้ายแต่ละป้ายจะเป็นข้อความอิสระ (ไม่เกิน 15 อักขระ) หรือรูปภาพขนาดเล็ก
ป้าย - ข้อความ	ไม่บังคับ	ชื่อสำหรับป้าย หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับป้าย	ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด 15 อักขระ
ป้าย - รูปภาพ	ไม่บังคับ	รูปภาพขนาดเล็ก การจัดการ UX พิเศษ เช่น การวางซ้อนป้ายบนภาพ/วิดีโอขนาดย่อ หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับป้าย	โปรดดูข้อกำหนดเกี่ยวกับรูปภาพสำหรับคำแนะนำ
คำอธิบาย	ไม่บังคับ	ย่อหน้าข้อความ 1 ย่อหน้าเพื่ออธิบายเอนทิตี หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น	ข้อความอิสระ ขนาดข้อความที่แนะนำ: 180 อักขระ
รายการคำบรรยาย	ไม่บังคับ	คำบรรยายสูงสุด 3 รายการ โดยแต่ละคำบรรยายมีข้อความ 1 บรรทัด หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น	ข้อความอิสระ ขนาดข้อความที่แนะนำสำหรับคำบรรยายแต่ละรายการ: สูงสุด 50 อักขระ
การจัดประเภท - ค่าสูงสุด	ไม่บังคับ	ค่าสูงสุดของรูปแบบการให้คะแนน ต้องระบุหากระบุค่าปัจจุบันของคะแนนด้วย	ตัวเลข >= 0.0
การจัดประเภท - ค่าปัจจุบัน	ไม่บังคับ	ค่าปัจจุบันของสเกลการให้คะแนน ต้องระบุหากระบุค่าสูงสุดของการจัดประเภทด้วย	ตัวเลข >= 0.0
คะแนน - จำนวน	ไม่บังคับ	จำนวนการให้คะแนนสำหรับจุดที่น่าสนใจ หมายเหตุ: ระบุช่องนี้หากแอปต้องการควบคุมวิธีแสดงข้อมูลนี้ต่อผู้ใช้ ระบุสตริงที่กระชับซึ่งแสดงต่อผู้ใช้ได้ เช่น หากจํานวนคือ 1,000,000 ให้พิจารณาใช้ตัวย่อ เช่น 1 ล้าน เพื่อไม่ให้ถูกตัดในขนาดการแสดงผลที่เล็กลง	สตริง
การจัดประเภท - ค่าจำนวน	ไม่บังคับ	จำนวนการให้คะแนนสำหรับจุดที่น่าสนใจ หมายเหตุ: ระบุช่องนี้หากไม่ต้องการจัดการตรรกะการแสดงตัวย่อด้วยตนเอง หากมีทั้ง Count และ Count Value เราจะใช้ Count เพื่อแสดงต่อผู้ใช้	ยาว
ราคา - CurrentPrice	ต้องระบุแบบมีเงื่อนไข	ราคาปัจจุบันของตั๋ว/บัตรเข้าชมจุดสนใจ ต้องระบุหากระบุราคาที่มีการขีดทับ	ข้อความอิสระ
ราคา - StrikethroughPrice	ไม่บังคับ	ราคาเดิมของตั๋ว/บัตรเข้าชมจุดสนใจ	ข้อความอิสระ
ข้อความไฮไลต์ราคา	ไม่บังคับ	ข้อความไฮไลต์ราคาเพื่อแสดงโปรโมชัน กิจกรรม ส่วนลดสำหรับสมาชิก (หากมี)	ข้อความอิสระ ขนาดข้อความที่แนะนำ: น้อยกว่า 45 อักขระ (ข้อความยาวเกินไปอาจแสดงจุดไข่ปลา)
หมวดหมู่เนื้อหา	ไม่บังคับ	อธิบายหมวดหมู่ของเนื้อหาในเอนทิตี	รายการ Enum ที่มีสิทธิ์ TYPE_TRAVEL_AND_LOCAL TYPE_MOVIES_AND_TV_SHOWS (เช่น โรงภาพยนตร์) TYPE_MEDICAL (เช่น โรงพยาบาล) TYPE_EDUCATION (เช่น โรงเรียน) TYPE_SPORTS (เช่น สนามกีฬา) ดูคำแนะนำได้ที่ส่วนหมวดหมู่เนื้อหา

`RestaurantReservationEntity`

แอตทริบิวต์	ข้อกำหนด	คำอธิบาย	รูปแบบ
URI การดำเนินการ	ต้องระบุ	Deep Link ไปยังเอนทิตีในแอปผู้ให้บริการ หมายเหตุ: คุณใช้ Deep Link เพื่อการระบุแหล่งที่มาได้ ดูคำถามที่พบบ่อยนี้	URI
ชื่อ	ต้องระบุ	ชื่อรายการ	สตริง ขนาดข้อความที่แนะนำ: สูงสุด 50 อักขระ
เวลาเริ่มต้นการจอง	ต้องระบุ	การประทับเวลา Epoch เป็นมิลลิวินาทีเมื่อคาดว่าการจองจะเริ่มขึ้น	การประทับเวลา Epoch เป็นมิลลิวินาที
สถานที่ - ประเทศ	ต้องระบุ	ประเทศที่ร้านอาหารตั้งอยู่	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - เมือง	ต้องระบุ	เมืองที่ร้านอาหารตั้งอยู่	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - ที่อยู่สำหรับแสดง	ต้องระบุ	ที่อยู่ของร้านอาหารที่จะแสดงต่อผู้ใช้	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - ที่อยู่	ไม่บังคับ	ที่อยู่ (หากมี) ของร้านอาหาร	ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ
สถานที่ตั้ง - รัฐ	ไม่บังคับ	รัฐหรือจังหวัด (หากมี) ที่ร้านอาหารตั้งอยู่	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ - รหัสไปรษณีย์	ไม่บังคับ	รหัสไปรษณีย์ (หากมี) ของร้านอาหาร	ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ
สถานที่ตั้ง - ย่าน	ไม่บังคับ	ย่าน (หากมี) ของร้านอาหาร	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ภาพโปสเตอร์	ไม่บังคับ	เราจะแสดงรูปภาพเพียง 1 รูปเมื่อมีการระบุรูปภาพหลายรูป สัดส่วนภาพที่แนะนําคือ 16:9	ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
คำอธิบาย	ไม่บังคับ	ย่อหน้าข้อความ 1 ย่อหน้าเพื่ออธิบายเอนทิตี หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น	ข้อความอิสระ ขนาดข้อความที่แนะนำ: 180 อักขระ
รายการคำบรรยาย	ไม่บังคับ	คำบรรยายสูงสุด 3 รายการ โดยแต่ละคำบรรยายมีข้อความ 1 บรรทัด หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น	ข้อความอิสระ ขนาดข้อความที่แนะนำสำหรับคำบรรยายแต่ละรายการ: สูงสุด 50 อักขระ
ขนาดตาราง	ไม่บังคับ	จำนวนผู้ที่อยู่ในกลุ่มการจอง	จำนวนเต็ม > 0

`EventReservationEntity`

แอตทริบิวต์	ข้อกำหนด	คำอธิบาย	รูปแบบ
URI การดำเนินการ	ต้องระบุ	Deep Link ไปยังเอนทิตีในแอปผู้ให้บริการ หมายเหตุ: คุณใช้ Deep Link เพื่อการระบุแหล่งที่มาได้ โปรดดูคำถามที่พบบ่อยนี้	URI
ชื่อ	ต้องระบุ	ชื่อรายการ	สตริง ขนาดข้อความที่แนะนำ: สูงสุด 50 อักขระ
เวลาเริ่มต้น	ต้องระบุ	การประทับเวลา Epoch เมื่อระบบคาดว่าเหตุการณ์จะเริ่มต้น หมายเหตุ: ค่านี้จะแสดงเป็นมิลลิวินาที	การประทับเวลา Epoch เป็นมิลลิวินาที
โหมดเหตุการณ์	ต้องระบุ	ช่องสำหรับระบุว่ากิจกรรมจะเป็นแบบเสมือนจริง เข้าร่วมด้วยตนเอง หรือทั้ง 2 แบบ	อาร์เรย์แบบจำกัด: VIRTUAL, IN_PERSON หรือ HYBRID
สถานที่ตั้ง - ประเทศ	ต้องระบุ (แบบมีเงื่อนไข)	ประเทศที่จัดกิจกรรม หมายเหตุ: จำเป็นต้องใช้สำหรับกิจกรรมที่เป็น IN_PERSON หรือ HYBRID	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ - เมือง	ต้องระบุแบบมีเงื่อนไข	เมืองที่จัดกิจกรรม หมายเหตุ: จำเป็นต้องใช้สำหรับกิจกรรมที่เป็น IN_PERSON หรือ HYBRID	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ - ที่อยู่ที่แสดง	ต้องระบุ (แบบมีเงื่อนไข)	ที่อยู่หรือชื่อสถานที่ที่จัดกิจกรรมซึ่งควรแสดงต่อผู้ใช้ หมายเหตุ: จำเป็นต้องใช้สำหรับกิจกรรมที่เป็น IN_PERSON หรือ HYBRID	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - ที่อยู่	ไม่บังคับ	ที่อยู่ (หากมี) ของสถานที่จัดอีเวนต์	ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ
สถานที่ตั้ง - รัฐ	ไม่บังคับ	รัฐหรือจังหวัด (หากมี) ที่จัดกิจกรรม	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ - รหัสไปรษณีย์	ไม่บังคับ	รหัสไปรษณีย์ (หากมี) ของสถานที่จัดกิจกรรม	ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ
สถานที่ตั้ง - ย่าน	ไม่บังคับ	ย่าน (หากมี) ที่จัดกิจกรรม	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ภาพโปสเตอร์	ไม่บังคับ	เราจะแสดงรูปภาพเพียง 1 รูปเมื่อมีการระบุรูปภาพหลายรูป สัดส่วนภาพที่แนะนำคือ 16:9 หมายเหตุ: ขอแนะนําให้ใช้รูปภาพ หากมีป้าย โปรดตรวจดูว่ามีระยะห่างของจุดที่ปลอดภัย (24 dp) ทั้งด้านบนและด้านล่างของรูปภาพ	ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
เวลาสิ้นสุด	ไม่บังคับ	การประทับเวลา Epoch เมื่อคาดว่าเหตุการณ์จะสิ้นสุด หมายเหตุ: ค่านี้จะแสดงเป็นมิลลิวินาที	การประทับเวลา Epoch ในหน่วยมิลลิวินาที
ผู้ให้บริการ - ชื่อ	ไม่บังคับ	ชื่อผู้ให้บริการ หมายเหตุ: ผู้ให้บริการต้องมีข้อความหรือรูปภาพอย่างใดอย่างหนึ่ง	ข้อความอิสระ เช่น ชื่อผู้จัด/ทัวร์
ผู้ให้บริการ - รูปภาพ	ไม่บังคับ	โลโก้/รูปภาพของผู้ให้บริการ หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับผู้ให้บริการ	ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
คำอธิบาย	ไม่บังคับ	ย่อหน้าข้อความ 1 ย่อหน้าเพื่ออธิบายเอนทิตี หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น	ข้อความอิสระ ขนาดข้อความที่แนะนำ: 180 อักขระ
รายการคำบรรยาย	ไม่บังคับ	คำบรรยายสูงสุด 3 รายการ โดยแต่ละคำบรรยายมีข้อความ 1 บรรทัด หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น	ข้อความอิสระ ขนาดข้อความที่แนะนำสำหรับคำบรรยายแต่ละรายการ: สูงสุด 50 อักขระ
ป้าย	ไม่บังคับ	ป้ายแต่ละป้ายจะเป็นข้อความอิสระ (ไม่เกิน 15 อักขระ) หรือรูปภาพขนาดเล็ก
ป้าย - ข้อความ	ไม่บังคับ	ชื่อสำหรับป้าย หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับป้าย	ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด 15 อักขระ
ป้าย - รูปภาพ	ไม่บังคับ	รูปภาพขนาดเล็ก การจัดการ UX พิเศษ เช่น การวางซ้อนป้ายบนภาพ/วิดีโอขนาดย่อ หมายเหตุ: ต้องมีข้อความหรือรูปภาพสำหรับป้าย	ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
รหัสการจอง	ไม่บังคับ	รหัสการจองสำหรับการจองกิจกรรม	ข้อความอิสระ
ราคา - ราคาปัจจุบัน	ต้องระบุแบบมีเงื่อนไข	ราคาปัจจุบันของตั๋ว/บัตรเข้าชมกิจกรรม ต้องระบุหากมีการระบุราคาที่มีขีดทับ	ข้อความอิสระ
ราคา - StrikethroughPrice	ไม่บังคับ	ราคาเดิมของตั๋ว/บัตรเข้างาน	ข้อความอิสระ
ข้อความไฮไลต์ราคา	ไม่บังคับ	ข้อความไฮไลต์ราคาเพื่อแสดงโปรโมชัน กิจกรรม ส่วนลดสำหรับสมาชิก (หากมี)	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 45 อักขระ (ข้อความที่ยาวเกินไปอาจแสดงจุดไข่ปลา)
การจัดประเภท - ค่าสูงสุด	ไม่บังคับ	ค่าสูงสุดของรูปแบบการให้คะแนน ต้องระบุหากระบุค่าปัจจุบันของคะแนนด้วย	ตัวเลข >= 0.0
การจัดประเภท - ค่าปัจจุบัน	ไม่บังคับ	ค่าปัจจุบันของสเกลการให้คะแนน ต้องระบุหากระบุค่าสูงสุดของการจัดประเภทด้วย	ตัวเลข >= 0.0
คะแนน - จำนวน	ไม่บังคับ	จํานวนการให้คะแนนสําหรับกิจกรรม หมายเหตุ: ระบุข้อมูลในช่องนี้หากแอปของคุณต้องการควบคุมวิธีแสดงต่อผู้ใช้ ระบุสตริงที่กระชับซึ่งแสดงต่อผู้ใช้ได้ เช่น หากจำนวนนับคือ 1,000,000 ครั้ง ให้ลองใช้ตัวย่อ เช่น 1M เพื่อไม่ให้ถูกตัดให้สั้นลงในขนาดจอแสดงผลที่เล็กกว่า	สตริง
การจัดประเภท - ค่าจำนวน	ไม่บังคับ	จำนวนการให้คะแนนกิจกรรม หมายเหตุ: ระบุช่องนี้หากไม่ต้องการจัดการตรรกะการแสดงตัวย่อด้วยตนเอง หากมีทั้ง Count และ Count Value เราจะใช้ Count เพื่อแสดงต่อผู้ใช้	ยาว
หมวดหมู่เนื้อหา	ไม่บังคับ	อธิบายหมวดหมู่ของเนื้อหาในเอนทิตี	รายการ Enum ที่มีสิทธิ์ TYPE_MOVIES_AND_TV_SHOWS (เช่น ภาพยนตร์) TYPE_DIGITAL_GAMES (เช่น eSports) TYPE_MUSIC (เช่น คอนเสิร์ต) TYPE_TRAVEL_AND_LOCAL (เช่น ทัวร์ เทศกาล) TYPE_HEALTH_AND_FITENESS (เช่น ชั้นเรียนโยคะ) TYPE_EDUCATION (เช่น ชั้นเรียน) TYPE_SPORTS (เช่น การแข่งขันฟุตบอล) TYPE_DATING (ตัวอย่าง - มีตติ้ง) ดูคำแนะนำได้ที่ส่วนหมวดหมู่เนื้อหา

`LodgingReservationEntity`

แอตทริบิวต์	ข้อกำหนด	คำอธิบาย	รูปแบบ
URI การดำเนินการ	ต้องระบุ	Deep Link ไปยังเอนทิตีในแอปผู้ให้บริการ หมายเหตุ: คุณสามารถใช้ Deep Link สําหรับการระบุแหล่งที่มาได้ ดูคำถามที่พบบ่อยนี้	URI
ชื่อ	ต้องระบุ	ชื่อของเอนทิตี	ข้อความอิสระ เช่น "การเข้าพักของคุณตั้งแต่วันที่ 12 ธ.ค." ขนาดข้อความที่แนะนำ: สูงสุด 50 อักขระ
เวลาเช็คอิน	ต้องระบุ	การประทับเวลา Epoch เป็นมิลลิวินาทีที่แสดงเวลาเช็คอินสำหรับการจอง	การประทับเวลา Epoch เป็นมิลลิวินาที
เวลาเช็คเอาต์	ต้องระบุ	การประทับเวลา Epoch เป็นมิลลิวินาทีที่แสดงเวลาเช็คเอาต์สำหรับการจอง	การประทับเวลา Epoch เป็นมิลลิวินาที
สถานที่ - ประเทศ	ต้องระบุ	ประเทศที่ที่พักตั้งอยู่	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - เมือง	ต้องระบุ	เมืองที่ที่พักตั้งอยู่	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - ที่อยู่สำหรับแสดง	ต้องระบุ	ที่อยู่ของที่พักที่จะแสดงให้ผู้ใช้เห็น	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ตั้ง - ที่อยู่	ไม่บังคับ	ที่อยู่ (หากมี) ของที่พัก	ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ
สถานที่ตั้ง - รัฐ	ไม่บังคับ	รัฐหรือจังหวัด (หากมี) ที่ที่พักตั้งอยู่	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ - รหัสไปรษณีย์	ไม่บังคับ	รหัสไปรษณีย์ (หากมี) ของที่พัก	ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ
สถานที่ตั้ง - ย่าน	ไม่บังคับ	ย่านที่พัก (หากมี)	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ภาพโปสเตอร์	ไม่บังคับ	เราจะแสดงรูปภาพเพียง 1 รูปเมื่อมีการระบุรูปภาพหลายรูป สัดส่วนภาพที่แนะนําคือ 16:9 หมายเหตุ: หากมีป้าย ให้เว้นพื้นที่ปลอดภัย 24 dp ทั้งด้านบนและด้านล่างของรูปภาพ	ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
คำอธิบาย	ไม่บังคับ	ย่อหน้าข้อความ 1 ย่อหน้าเพื่ออธิบายเอนทิตี หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น	ข้อความอิสระ ขนาดข้อความที่แนะนำ: 180 อักขระ
รายการคำบรรยาย	ไม่บังคับ	คำบรรยายสูงสุด 3 รายการ โดยแต่ละคำบรรยายมีข้อความ 1 บรรทัด หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น	ข้อความอิสระ ขนาดข้อความที่แนะนำสำหรับคำบรรยายแต่ละรายการ: สูงสุด 50 อักขระ
รหัสการจอง	ไม่บังคับ	รหัสการจองสำหรับที่พัก	ข้อความอิสระ
การจัดประเภท - ค่าสูงสุด	ไม่บังคับ	ค่าสูงสุดของรูปแบบการให้คะแนน ต้องระบุหากระบุค่าปัจจุบันของคะแนนด้วย	ตัวเลข >= 0.0
การจัดประเภท - ค่าปัจจุบัน	ไม่บังคับ	ค่าปัจจุบันของสเกลการให้คะแนน ต้องระบุหากระบุค่าสูงสุดของการจัดประเภทด้วย	ตัวเลข >= 0.0
คะแนน - จำนวน	ไม่บังคับ	จํานวนการให้คะแนนที่พัก หมายเหตุ: ระบุช่องนี้หากแอปต้องการควบคุมวิธีแสดงข้อมูลนี้ต่อผู้ใช้ ระบุสตริงที่กระชับซึ่งแสดงต่อผู้ใช้ได้ เช่น หากจํานวนคือ 1,000,000 ให้พิจารณาใช้ตัวย่อ เช่น 1 ล้าน เพื่อไม่ให้ถูกตัดในขนาดการแสดงผลที่เล็กลง	สตริง
การจัดประเภท - ค่าจำนวน	ไม่บังคับ	จํานวนการให้คะแนนที่พัก หมายเหตุ: ระบุช่องนี้หากไม่ต้องการจัดการตรรกะการแสดงตัวย่อด้วยตนเอง หากมีทั้ง Count และ Count Value เราจะใช้ Count เพื่อแสดงต่อผู้ใช้	ยาว
ราคา - CurrentPrice	ต้องระบุแบบมีเงื่อนไข	ราคาปัจจุบันของที่พัก ต้องระบุหากมีการระบุราคาที่มีขีดทับ	ข้อความอิสระ
ราคา - StrikethroughPrice	ไม่บังคับ	ราคาเดิมของที่พัก ซึ่งจะขีดฆ่าได้ใน UI	ข้อความอิสระ
ข้อความไฮไลต์ราคา	ไม่บังคับ	ข้อความไฮไลต์ราคาเพื่อแสดงโปรโมชัน กิจกรรม ส่วนลดสำหรับสมาชิก (หากมี)	ข้อความอิสระ ขนาดข้อความที่แนะนำ: น้อยกว่า 45 อักขระ (ข้อความยาวเกินไปอาจแสดงจุดไข่ปลา)

`TransportationReservationEntity`

แอตทริบิวต์	ข้อกำหนด	คำอธิบาย	รูปแบบ
URI การดำเนินการ	ต้องระบุ	Deep Link ไปยังเอนทิตีในแอปผู้ให้บริการ หมายเหตุ: คุณใช้ Deep Link เพื่อการระบุแหล่งที่มาได้ โปรดดูคำถามที่พบบ่อยนี้	URI
ชื่อ	ต้องระบุ	ชื่อของเอนทิตี	ข้อความอิสระ เช่น "SFO to SAN" ขนาดข้อความที่แนะนำ: สูงสุด 50 อักขระ
ประเภทการขนส่ง	ต้องระบุ	รูปแบบ/ประเภทการเดินทางสำหรับการจอง	Enum: เที่ยวบิน, รถไฟ, รถประจำทาง หรือ FERRY
เวลาออกเดินทาง	ต้องระบุ	การประทับเวลา Epoch เป็นมิลลิวินาทีที่แสดงเวลาออกเดินทาง	การประทับเวลา Epoch เป็นมิลลิวินาที
เวลาถึง	ต้องระบุ	การประทับเวลา Epoch เป็นมิลลิวินาทีที่แสดงถึงเวลาถึง	การประทับเวลา Epoch เป็นมิลลิวินาที
สถานที่ออกเดินทาง - ประเทศ	ไม่บังคับ	ประเทศต้นทาง	ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ
สถานที่ออกเดินทาง - เมือง	ไม่บังคับ	เมืองต้นทาง	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ออกเดินทาง - ที่อยู่สำหรับแสดง	ไม่บังคับ	ตำแหน่งเวลาออกเดินทางที่จะแสดงต่อผู้ใช้	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ออกเดินทาง - ที่อยู่	ไม่บังคับ	ที่อยู่ (หากมี) ของจุดเริ่มต้น	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ออกเดินทาง - รัฐ	ไม่บังคับ	รัฐหรือจังหวัด (หากมี) ของจุดออกเดินทาง	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ออกเดินทาง - รหัสไปรษณีย์	ไม่บังคับ	รหัสไปรษณีย์ (หากมี) ของสถานที่ออกเดินทาง	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ออกเดินทาง - ย่านใกล้เคียง	ไม่บังคับ	ย่าน (หากมี) ของจุดเริ่มต้น	ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ
สถานที่มาถึง - ประเทศ	ไม่บังคับ	ประเทศที่มาถึง	ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ
สถานที่ขาเข้า - เมือง	ไม่บังคับ	เมืองปลายทาง	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่ขาเข้า - ที่อยู่ที่แสดง	ไม่บังคับ	สถานที่ถึงที่จะแสดงต่อผู้ใช้	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่มาถึง - ที่อยู่	ไม่บังคับ	ที่อยู่ (หากมี) ของสถานที่ที่จะนำส่ง	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่มาถึง - รัฐ	ไม่บังคับ	รัฐหรือจังหวัด (หากมี) ของสถานที่ถึง	ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ
สถานที่ปลายทาง - รหัสไปรษณีย์	ไม่บังคับ	รหัสไปรษณีย์ (หากมี) ของสถานที่ถึง	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
สถานที่มาถึง - ย่านใกล้เคียง	ไม่บังคับ	ละแวกใกล้เคียง (หากมี) ของสถานที่ปลายทาง	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ผู้ให้บริการ - ชื่อ	ไม่บังคับ	ชื่อผู้ให้บริการ หมายเหตุ: ผู้ให้บริการต้องมีข้อความหรือรูปภาพอย่างใดอย่างหนึ่ง	ข้อความอิสระ เช่น ชื่อสายการบิน
ผู้ให้บริการ - รูปภาพ	ไม่บังคับ	โลโก้/รูปภาพของผู้ให้บริการ หมายเหตุ: ผู้ให้บริการต้องมีข้อความหรือรูปภาพอย่างใดอย่างหนึ่ง	ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
ภาพโปสเตอร์	ไม่บังคับ	เราจะแสดงเพียง 1 ภาพหากมีหลายภาพ สัดส่วนภาพที่แนะนําคือ 16:9	ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
คำอธิบาย	ไม่บังคับ	ย่อหน้าข้อความ 1 ย่อหน้าเพื่ออธิบายเอนทิตี หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น	ข้อความอิสระ ขนาดข้อความที่แนะนำ: 180 อักขระ
รายการคำบรรยาย	ไม่บังคับ	คำบรรยายสูงสุด 3 รายการ โดยแต่ละคำบรรยายมีข้อความ 1 บรรทัด หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น	ข้อความอิสระ ขนาดข้อความที่แนะนำสำหรับคำบรรยายแต่ละรายการ: สูงสุด 50 อักขระ
รหัสการจอง	ไม่บังคับ	รหัสการจองสำหรับบริการขนส่ง	ข้อความอิสระ
ราคา - ราคาปัจจุบัน	ต้องระบุแบบมีเงื่อนไข	ราคาปัจจุบันของการจอง ต้องระบุหากระบุราคาที่มีการขีดทับ	ข้อความอิสระ
ราคา - StrikethroughPrice	ไม่บังคับ	ราคาเดิมของการจอง ซึ่งจะมีการขีดทับใน UI	ข้อความอิสระ
ข้อความไฮไลต์ราคา	ไม่บังคับ	ข้อความไฮไลต์ราคาเพื่อแสดงโปรโมชัน กิจกรรม ส่วนลดสำหรับสมาชิก (หากมี)	ข้อความอิสระ ขนาดข้อความที่แนะนำ: น้อยกว่า 45 อักขระ (ข้อความยาวเกินไปอาจแสดงจุดไข่ปลา)
หมายเลขการขนส่ง	ต้องระบุ	หมายเลขเที่ยวบิน หมายเลขรถประจำทาง หมายเลขรถไฟ หรือหมายเลขเรือเฟอร์รี่/เรือสำราญ	ข้อความอิสระ
เวลาขึ้นเครื่อง	ต้องระบุ	การประทับเวลาตามยุคสมัยที่แสดงเวลาขึ้นเครื่องสำหรับการจอง (หากมี)	การประทับเวลา Epoch ในหน่วยมิลลิวินาที

`VehicleRentalReservationEntity`

แอตทริบิวต์	ข้อกำหนด	คำอธิบาย	รูปแบบ
URI การดำเนินการ	ต้องระบุ	Deep Link ไปยังเอนทิตีในแอปผู้ให้บริการ หมายเหตุ: คุณใช้ Deep Link เพื่อการระบุแหล่งที่มาได้ โปรดดูคำถามที่พบบ่อยนี้	URI
ชื่อ	ต้องระบุ	ชื่อของเอนทิตี	ข้อความอิสระ ตัวอย่างเช่น "Avis Union Square SF" ขนาดข้อความที่แนะนำ: สูงสุด 50 อักขระ
เวลารับสินค้า	ต้องระบุ	การประทับเวลาตามยุคที่แสดงเวลารับรถสำหรับการจอง	การประทับเวลา Epoch เป็นมิลลิวินาที
เวลาเดินทางกลับ	ไม่บังคับ	การประทับเวลาตามยุคสมัยที่แสดงเวลาเช็คเอาต์สำหรับการจอง	การประทับเวลา Epoch เป็นมิลลิวินาที
ที่อยู่ในการรับ - ประเทศ	ไม่บังคับ	ประเทศของสถานที่รับสินค้า	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ที่อยู่ในการรับ - เมือง	ไม่บังคับ	เมืองของจุดรับรถ	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ที่อยู่ในการรับ - ที่อยู่สำหรับแสดง	ไม่บังคับ	สถานที่รับสินค้าที่จะแสดงต่อผู้ใช้	ข้อความอิสระ ขนาดข้อความที่แนะนำ: สูงสุด ~20 อักขระ
ที่อยู่ในการรับ - ที่อยู่	ไม่บังคับ	ที่อยู่ (หากมี) ของจุดรับสินค้า	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ที่อยู่ในการรับ - รัฐ	ไม่บังคับ	รัฐหรือจังหวัด (หากมี) ของจุดรับสินค้า	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ที่อยู่ในการรับ - รหัสไปรษณีย์	ไม่บังคับ	รหัสไปรษณีย์ (หากมี) ของสถานที่รับสินค้า	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ที่อยู่ในการรับ - ย่าน	ไม่บังคับ	ย่าน (หากมี) ของจุดรับสินค้า	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ที่อยู่สำหรับคืนสินค้า - ประเทศ	ไม่บังคับ	ประเทศของสถานที่ตั้งสำหรับการคืนสินค้า	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ที่อยู่สำหรับคืนสินค้า - เมือง	ไม่บังคับ	เมืองของสถานที่คืนสินค้า	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ที่อยู่สำหรับคืนสินค้า - ที่อยู่ที่แสดง	ไม่บังคับ	ตำแหน่งที่แสดงผลต่อผู้ใช้	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ที่อยู่สำหรับคืนสินค้า - ที่อยู่	ไม่บังคับ	ที่อยู่ (หากมี) ของสถานที่ตั้งสำหรับการคืนสินค้า	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ที่อยู่สำหรับคืนสินค้า - รัฐ	ไม่บังคับ	รัฐหรือจังหวัด (หากมี) ของสถานที่ส่งคืน	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ที่อยู่สำหรับคืนสินค้า - รหัสไปรษณีย์	ไม่บังคับ	รหัสไปรษณีย์ (หากมี) ของสถานที่ส่งคืน	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ที่อยู่สำหรับคืนสินค้า - ย่าน	ไม่บังคับ	ย่าน (หากมี) ของสถานที่คืนสินค้า	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 20 อักขระ
ผู้ให้บริการ - ชื่อ	ไม่บังคับ	ชื่อผู้ให้บริการ หมายเหตุ: ผู้ให้บริการต้องมีข้อความหรือรูปภาพอย่างใดอย่างหนึ่ง	ข้อความอิสระ เช่น "Avis Carrenal"
ผู้ให้บริการ - รูปภาพ	ไม่บังคับ	โลโก้/รูปภาพของผู้ให้บริการ หมายเหตุ: ผู้ให้บริการต้องมีข้อความหรือรูปภาพอย่างใดอย่างหนึ่ง	โปรดดูข้อกำหนดเกี่ยวกับรูปภาพสำหรับคำแนะนำ
ภาพโปสเตอร์	ไม่บังคับ	เราจะแสดงรูปภาพเพียง 1 รูปเมื่อมีการระบุรูปภาพหลายรูป สัดส่วนภาพที่แนะนําคือ 16:9	ดูคำแนะนำได้ที่ข้อกำหนดเกี่ยวกับรูปภาพ
คำอธิบาย	ไม่บังคับ	ย่อหน้าข้อความ 1 ย่อหน้าเพื่ออธิบายเอนทิตี หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น	ข้อความอิสระ ขนาดข้อความที่แนะนำ: 180 อักขระ
รายการคำบรรยาย	ไม่บังคับ	คำบรรยายสูงสุด 3 รายการ โดยแต่ละคำบรรยายมีข้อความ 1 บรรทัด หมายเหตุ: ระบบจะแสดงรายการคำบรรยายแทนเสียงหรือคำบรรยายแทนเสียงเท่านั้น	ข้อความอิสระ ขนาดข้อความที่แนะนำสำหรับคำบรรยายแต่ละรายการ: สูงสุด 50 อักขระ
รหัสยืนยัน	ไม่บังคับ	รหัสยืนยันสำหรับการจองรถเช่า	ข้อความอิสระ
ราคา - ราคาปัจจุบัน	ต้องระบุแบบมีเงื่อนไข	ราคาปัจจุบันของการจอง ต้องระบุหากระบุราคาที่มีการขีดทับ	ข้อความอิสระ
ราคา - StrikethroughPrice	ไม่บังคับ	ราคาเดิมของการจอง ซึ่งจะมีการขีดทับใน UI	ข้อความอิสระ
ข้อความไฮไลต์ราคา	ไม่บังคับ	ข้อความไฮไลต์ราคาเพื่อแสดงโปรโมชัน กิจกรรม ส่วนลดสำหรับสมาชิก (หากมี)	ข้อความอิสระ ขนาดข้อความที่แนะนำ: ไม่เกิน 45 อักขระ (ข้อความที่ยาวเกินไปอาจแสดงจุดไข่ปลา)

ข้อกำหนดเกี่ยวกับรูปภาพ

ข้อกำหนดที่จำเป็นสำหรับชิ้นงานรูปภาพแสดงในตารางนี้

สัดส่วนภาพ	พิกเซลขั้นต่ำ	พิกเซลแนะนํา
สี่เหลี่ยมจัตุรัส (1x1) แนะนำ	300x300	1200x1200
แนวนอน (1.91x1)	600x314	1200x628
แนวตั้ง (4x5)	480x600	960x1200

สัดส่วนภาพ

พิกเซลขั้นต่ำ

พิกเซลแนะนํา

สี่เหลี่ยมจัตุรัส (1x1)

แนะนำ

300x300

1200x1200

แนวนอน (1.91x1)

600x314

1200x628

แนวตั้ง (4x5)

480x600

960x1200

รูปภาพต้องโฮสต์ใน CDN สาธารณะเพื่อให้ Google เข้าถึงได้

รูปแบบไฟล์

PNG, JPG, GIF แบบภาพนิ่ง, WebP

ขนาดไฟล์สูงสุด

5120 KB

คําแนะนําเพิ่มเติม

พื้นที่ปลอดภัยของรูปภาพ: ใส่เนื้อหาสำคัญไว้ตรงกลาง ซึ่งก็คือ 80% ของรูปภาพนั้น
ใช้พื้นหลังโปร่งใสเพื่อให้รูปภาพแสดงได้อย่างถูกต้องในการตั้งค่าธีมมืดและธีมสว่าง

หมวดหมู่เนื้อหา

หมวดหมู่เนื้อหาช่วยให้แอปเผยแพร่เนื้อหาที่อยู่ในหมวดหมู่ต่างๆ ได้ ซึ่งจะเชื่อมโยงเนื้อหากับหมวดหมู่ที่กำหนดไว้ล่วงหน้าบางหมวดหมู่ ได้แก่

TYPE_EDUCATION
TYPE_SPORTS
TYPE_MOVIES_AND_TV_SHOWS
TYPE_BOOKS
TYPE_AUDIOBOOKS
TYPE_MUSIC
TYPE_DIGITAL_GAMES
TYPE_TRAVEL_AND_LOCAL
TYPE_HOME_AND_AUTO
TYPE_BUSINESS
TYPE_NEWS
TYPE_FOOD_AND_DRINK
TYPE_SHOPPING
TYPE_HEALTH_AND_FITENESS
TYPE_MEDICAL
TYPE_PARENTING
TYPE_DATING

รูปภาพต้องโฮสต์ใน CDN สาธารณะเพื่อให้ Google เข้าถึงได้

หลักเกณฑ์การใช้หมวดหมู่เนื้อหา

เอนทิตีบางรายการ เช่น ArticleEntity และ GenericFeaturedEntity มีสิทธิ์ใช้หมวดหมู่เนื้อหาใดก็ได้ สำหรับเอนทิตีอื่นๆ เช่น EventEntity, EventReservationEntity, PointOfInterestEntity เฉพาะหมวดหมู่ย่อยของหมวดหมู่เหล่านี้เท่านั้นที่มีสิทธิ์ ตรวจสอบรายการหมวดหมู่ที่มีสิทธิ์สำหรับประเภทเอนทิตีก่อนป้อนข้อมูลในรายการ
ใช้ประเภทเอนทิตีที่เฉพาะเจาะจงสำหรับหมวดหมู่เนื้อหาบางหมวดหมู่แทนการใช้เอนทิตีทั่วไปร่วมกับ ContentCategory
- TYPE_MOVIES_AND_TV_SHOWS - ดูเอนทิตีจากคู่มือการผสานรวมการดูก่อนใช้เอนทิตีทั่วไป
- TYPE_BOOKS - ดู EbookEntity ก่อนใช้เอนทิตีทั่วไป
- TYPE_AUDIOBOOKS - ดูAudiobookEntity ก่อนใช้เอนทิตีทั่วไป
- TYPE_SHOPPING - ตรวจสอบ ShoppingEntity ก่อนใช้เอนทิตีทั่วไป
- TYPE_FOOD_AND_DRINK - ลองดูเอนทิตีจากคู่มือการผสานรวมอาหารก่อนใช้เอนทิตีทั่วไป
ช่อง ContentCategory เป็นช่องที่ไม่บังคับและควรเว้นว่างไว้หากเนื้อหาไม่ได้อยู่ในหมวดหมู่ที่กล่าวถึงก่อนหน้านี้
ในกรณีที่มีการจัดประเภทเนื้อหาไว้หลายหมวดหมู่ ให้จัดเรียงหมวดหมู่เนื้อหาตามลำดับความเกี่ยวข้องกับเนื้อหา โดยจัดอยู่ในหมวดหมู่เนื้อหาที่เกี่ยวข้องที่สุดเป็นอันดับแรก

ขั้นตอนที่ 2: ระบุข้อมูลคลัสเตอร์

เราขอแนะนำให้เรียกใช้งานเผยแพร่เนื้อหาในเบื้องหลัง (เช่น โดยใช้ WorkManager) และกำหนดเวลาเป็นประจำหรือตามเหตุการณ์ (เช่น ทุกครั้งที่ผู้ใช้เปิดแอปหรือเมื่อผู้ใช้เพิ่งเพิ่มรายการลงในรถเข็น)

AppEngagePublishClient มีหน้าที่รับผิดชอบในการเผยแพร่คลัสเตอร์

API ต่อไปนี้ใช้เพื่อเผยแพร่คลัสเตอร์ในไคลเอ็นต์

isServiceAvailable
publishRecommendationClusters
publishFeaturedCluster
publishContinuationCluster
publishUserAccountManagementRequest
updatePublishStatus
deleteRecommendationsClusters
deleteFeaturedCluster
deleteContinuationCluster
deleteUserManagementCluster
deleteClusters

`isServiceAvailable`

API นี้ใช้เพื่อตรวจสอบว่าบริการพร้อมสำหรับการผสานรวมหรือไม่ และเนื้อหาแสดงในอุปกรณ์ได้หรือไม่

Kotlin

client.isServiceAvailable.addOnCompleteListener { task ->
    if (task.isSuccessful) {
        // Handle IPC call success
        if(task.result) {
          // Service is available on the device, proceed with content publish
          // calls.
        } else {
          // Service is not available, no further action is needed.
        }
    } else {
      // The IPC call itself fails, proceed with error handling logic here,
      // such as retry.
    }
}

Java

client.isServiceAvailable().addOnCompleteListener(task - > {
    if (task.isSuccessful()) {
        // Handle success
        if(task.getResult()) {
          // Service is available on the device, proceed with content publish
          // calls.
        } else {
          // Service is not available, no further action is needed.
        }
    } else {
      // The IPC call itself fails, proceed with error handling logic here,
      // such as retry.
    }
});

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

`publishRecommendationClusters`

API นี้ใช้เพื่อเผยแพร่รายการออบเจ็กต์ RecommendationCluster

Kotlin

client.publishRecommendationClusters(
      PublishRecommendationClustersRequest.Builder()
        .addRecommendationCluster(
          RecommendationCluster.Builder()
            .addEntity(entity1)
            .addEntity(entity2)
            .setTitle("Top Picks For You")
            .build()
        )
        .build()
    )

Java

client.publishRecommendationClusters(
            new PublishRecommendationClustersRequest.Builder()
                .addRecommendationCluster(
                    new RecommendationCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .setTitle("Top Picks For You")
                        .build())
                .build());

เมื่อบริการได้รับคําขอแล้ว ระบบจะดําเนินการต่อไปนี้ภายในธุรกรรมเดียว

ระบบจะนำข้อมูล RecommendationCluster ที่มีอยู่ออกจากพาร์ทเนอร์นักพัฒนาแอป
ระบบจะแยกวิเคราะห์และจัดเก็บข้อมูลจากคําขอไว้ในคลัสเตอร์คําแนะนําที่อัปเดตแล้ว

ในกรณีที่เกิดข้อผิดพลาด ระบบจะปฏิเสธคำขอทั้งหมดและคงสถานะที่มีอยู่ไว้

`publishFeaturedCluster`

API นี้ใช้เพื่อเผยแพร่รายการออบเจ็กต์ FeaturedCluster

Kotlin

client.publishFeaturedCluster(
    PublishFeaturedClusterRequest.Builder()
      .setFeaturedCluster(
        FeaturedCluster.Builder()
          .addEntity(entity1)
          .addEntity(entity2)
          .build())
      .build())

Java

client.publishFeaturedCluster(
            new PublishFeaturedClustersRequest.Builder()
                .addFeaturedCluster(
                    new FeaturedCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .build())
                .build());

ระบบจะนำข้อมูล FeaturedCluster ที่มีอยู่ออกจากพาร์ทเนอร์นักพัฒนาแอป
ระบบจะแยกวิเคราะห์และจัดเก็บข้อมูลจากคำขอไว้ในคลัสเตอร์แนะนําที่อัปเดตแล้ว

`publishContinuationCluster`

API นี้ใช้เพื่อเผยแพร่ออบเจ็กต์ ContinuationCluster

Kotlin

client.publishContinuationCluster(
    PublishContinuationClusterRequest.Builder()
      .setContinuationCluster(
        ContinuationCluster.Builder()
          .addEntity(entity1)
          .addEntity(entity2)
          .build())
      .build())

Java

client.publishContinuationCluster(
            new PublishContinuationClusterRequest.Builder()
                .setContinuationCluster(
                    new ContinuationCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .build())
                .build());

ระบบจะนำข้อมูล ContinuationCluster ที่มีอยู่ออกจากพาร์ทเนอร์นักพัฒนาแอป
ระบบจะแยกวิเคราะห์และจัดเก็บข้อมูลจากคําขอไว้ในคลัสเตอร์การต่ออายุที่อัปเดตแล้ว

`publishUserAccountManagementRequest`

API นี้ใช้เพื่อเผยแพร่การ์ดลงชื่อเข้าใช้ การดำเนินการลงชื่อเข้าใช้จะนำผู้ใช้ไปยังหน้าลงชื่อเข้าใช้ของแอปเพื่อให้แอปเผยแพร่เนื้อหาได้ (หรือแสดงเนื้อหาที่ปรับเปลี่ยนในแบบของคุณมากขึ้น)

ข้อมูลเมตาต่อไปนี้เป็นส่วนหนึ่งของการ์ดลงชื่อเข้าใช้

แอตทริบิวต์	ข้อกำหนด	คำอธิบาย
URI การดำเนินการ	ต้องระบุ	Deep Link ไปยังการดําเนินการ (เช่น ไปยังหน้าลงชื่อเข้าใช้แอป)
รูปภาพ	ไม่บังคับ - หากไม่ระบุ จะต้องระบุชื่อ	รูปภาพที่แสดงในการ์ด รูปภาพสัดส่วนภาพ 16:9 ที่มีความละเอียด 1264x712
ชื่อ	ไม่บังคับ - หากไม่ระบุ จะต้องระบุรูปภาพ	ชื่อบนการ์ด
ข้อความการดําเนินการ	ไม่บังคับ	ข้อความที่แสดงใน CTA (เช่น ลงชื่อเข้าใช้)
ชื่อรอง	ไม่บังคับ	คำบรรยายเสริมบนการ์ด

Kotlin

var SIGN_IN_CARD_ENTITY =
      SignInCardEntity.Builder()
          .addPosterImage(
              Image.Builder()
                  .setImageUri(Uri.parse("http://www.x.com/image.png"))
                  .setImageHeightInPixel(500)
                  .setImageWidthInPixel(500)
                  .build())
          .setActionText("Sign In")
          .setActionUri(Uri.parse("http://xx.com/signin"))
          .build()

client.publishUserAccountManagementRequest(
            PublishUserAccountManagementRequest.Builder()
                .setSignInCardEntity(SIGN_IN_CARD_ENTITY)
                .build());

Java

SignInCardEntity SIGN_IN_CARD_ENTITY =
      new SignInCardEntity.Builder()
          .addPosterImage(
              new Image.Builder()
                  .setImageUri(Uri.parse("http://www.x.com/image.png"))
                  .setImageHeightInPixel(500)
                  .setImageWidthInPixel(500)
                  .build())
          .setActionText("Sign In")
          .setActionUri(Uri.parse("http://xx.com/signin"))
          .build();

client.publishUserAccountManagementRequest(
            new PublishUserAccountManagementRequest.Builder()
                .setSignInCardEntity(SIGN_IN_CARD_ENTITY)
                .build());

เมื่อบริการได้รับคำขอ การดำเนินการต่อไปนี้จะเกิดขึ้นในธุรกรรมเดียว

ระบบจะนำข้อมูล UserAccountManagementCluster ที่มีอยู่จากพาร์ทเนอร์นักพัฒนาแอปออก
ระบบจะแยกวิเคราะห์และจัดเก็บข้อมูลจากคําขอไว้ในคลัสเตอร์ UserAccountManagementCluster ที่อัปเดตแล้ว

ในกรณีที่เกิดข้อผิดพลาด คำขอทั้งหมดจะถูกปฏิเสธและระบบจะคงสถานะที่มีอยู่ไว้

`updatePublishStatus`

หากไม่มีคลัสเตอร์ใดเผยแพร่เนื่องจากเหตุผลทางธุรกิจภายใน เราขอแนะนำอย่างยิ่งให้อัปเดตสถานะการเผยแพร่โดยใช้ API updatePublishStatus ซึ่งเป็นสิ่งสำคัญเนื่องจาก :

การให้สถานะในทุกสถานการณ์ แม้ว่าเนื้อหาจะเผยแพร่แล้ว (STATUS == PUBLISHED) ก็ตาม เป็นสิ่งที่สําคัญในการป้อนข้อมูลแดชบอร์ดที่ใช้สภาวะที่ชัดเจนนี้เพื่อสื่อให้เห็นถึงสถานะและเมตริกอื่นๆ ของการผสานรวม
หากไม่มีเนื้อหาที่เผยแพร่ แต่สถานะการผสานรวมไม่เสียหาย (STATUS == NOT_PUBLISHED) Google จะหลีกเลี่ยงการทริกเกอร์การแจ้งเตือนในแดชบอร์ดประสิทธิภาพของแอปได้ สถานะนี้ยืนยันว่าเนื้อหาไม่เผยแพร่เนื่องจากเป็นสถานการณ์ที่คาดไว้จากมุมมองของผู้ให้บริการ
ซึ่งจะช่วยให้นักพัฒนาแอปสามารถให้ข้อมูลเชิงลึกเกี่ยวกับเวลาที่เผยแพร่ข้อมูลหรือไม่เผยแพร่
Google อาจใช้รหัสสถานะเพื่อกระตุ้นให้ผู้ใช้ดำเนินการบางอย่างในแอปเพื่อให้ผู้ใช้ดูเนื้อหาของแอปหรือแก้ไขปัญหาได้

รายการรหัสสถานะการเผยแพร่ที่มีสิทธิ์มีดังนี้

// Content is published
AppEngagePublishStatusCode.PUBLISHED,

// Content is not published as user is not signed in
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN,

// Content is not published as user is not subscribed
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SUBSCRIPTION,

// Content is not published as user location is ineligible
AppEngagePublishStatusCode.NOT_PUBLISHED_INELIGIBLE_LOCATION,

// Content is not published as there is no eligible content
AppEngagePublishStatusCode.NOT_PUBLISHED_NO_ELIGIBLE_CONTENT,

// Content is not published as the feature is disabled by the client
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_FEATURE_DISABLED_BY_CLIENT,

// Content is not published as the feature due to a client error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_CLIENT_ERROR,

// Content is not published as the feature due to a service error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_SERVICE_ERROR,

// Content is not published due to some other reason
// Reach out to engage-developers@ before using this enum.
AppEngagePublishStatusCode.NOT_PUBLISHED_OTHER

หากเนื้อหาไม่เผยแพร่เนื่องจากผู้ใช้ไม่ได้เข้าสู่ระบบ Google จะแนะนำให้เผยแพร่การ์ดลงชื่อเข้าใช้ หากผู้ให้บริการไม่สามารถเผยแพร่การ์ดลงชื่อเข้าใช้ไม่ว่าด้วยเหตุผลใดก็ตาม เราขอแนะนำให้เรียกใช้ updatePublishStatus API ด้วยรหัสสถานะ NOT_PUBLISHED_REQUIRES_SIGN_IN

Kotlin

client.updatePublishStatus(
   PublishStatusRequest.Builder()
     .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
     .build())

Java

client.updatePublishStatus(
    new PublishStatusRequest.Builder()
        .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
        .build());

`deleteRecommendationClusters`

API นี้ใช้เพื่อลบเนื้อหาของคลัสเตอร์คําแนะนํา

Kotlin

client.deleteRecommendationClusters()

Java

client.deleteRecommendationClusters();

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

`deleteFeaturedCluster`

API นี้ใช้เพื่อลบเนื้อหาของคลัสเตอร์แนะนำ

Kotlin

client.deleteFeaturedCluster()

Java

client.deleteFeaturedCluster();

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

`deleteContinuationCluster`

API นี้ใช้เพื่อลบเนื้อหาของคลัสเตอร์การต่อเรื่อง

Kotlin

client.deleteContinuationCluster()

Java

client.deleteContinuationCluster();

เมื่อบริการได้รับคําขอ ระบบจะนำข้อมูลที่มีอยู่ออกจากกลุ่มต่อเนื่อง ในกรณีที่เกิดข้อผิดพลาด ระบบจะปฏิเสธคำขอทั้งหมดและรักษาสถานะที่มีอยู่

`deleteUserManagementCluster`

API นี้ใช้เพื่อลบเนื้อหาของคลัสเตอร์ UserAccountManagement

Kotlin

client.deleteUserManagementCluster()

Java

client.deleteUserManagementCluster();

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

`deleteClusters`

API นี้ใช้เพื่อลบเนื้อหาของคลัสเตอร์ประเภทหนึ่งๆ

Kotlin

client.deleteClusters(
    DeleteClustersRequest.Builder()
      .addClusterType(ClusterType.TYPE_CONTINUATION)
      .addClusterType(ClusterType.TYPE_FEATURED)
      .addClusterType(ClusterType.TYPE_RECOMMENDATION)
      .build())

Java

client.deleteClusters(
            new DeleteClustersRequest.Builder()
                .addClusterType(ClusterType.TYPE_CONTINUATION)
                .addClusterType(ClusterType.TYPE_FEATURED)
                .addClusterType(ClusterType.TYPE_RECOMMENDATION)
                .build());

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

การจัดการข้อผิดพลาด

ขอแนะนําอย่างยิ่งให้ฟังผลลัพธ์ของงานจาก API การเผยแพร่เพื่อให้ดําเนินการติดตามผลเพื่อกู้คืนและส่งงานที่สําเร็จอีกครั้งได้

Kotlin

client.publishRecommendationClusters(
        PublishRecommendationClustersRequest.Builder()
          .addRecommendationCluster(..)
          .build())
      .addOnCompleteListener { task ->
        if (task.isSuccessful) {
          // do something
        } else {
          val exception = task.exception
          if (exception is AppEngageException) {
            @AppEngageErrorCode val errorCode = exception.errorCode
            if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
              // do something
            }
          }
        }
      }

Java

client.publishRecommendationClusters(
              new PublishRecommendationClustersRequest.Builder()
                  .addRecommendationCluster(...)
                  .build())
          .addOnCompleteListener(
              task -> {
                if (task.isSuccessful()) {
                  // do something
                } else {
                  Exception exception = task.getException();
                  if (exception instanceof AppEngageException) {
                    @AppEngageErrorCode
                    int errorCode = ((AppEngageException) exception).getErrorCode();
                    if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
                      // do something
                    }
                  }
                }
              });

ระบบจะแสดงผลข้อผิดพลาดเป็น AppEngageException พร้อมระบุสาเหตุเป็นรหัสข้อผิดพลาด

รหัสข้อผิดพลาด	ชื่อข้อผิดพลาด	หมายเหตุ
`1`	`SERVICE_NOT_FOUND`	บริการไม่พร้อมให้บริการในอุปกรณ์ที่ระบุ
`2`	`SERVICE_NOT_AVAILABLE`	บริการพร้อมใช้งานในอุปกรณ์หนึ่งๆ แต่ใช้งานไม่ได้ขณะโทร (เช่น มีการปิดใช้อย่างชัดเจน)
`3`	`SERVICE_CALL_EXECUTION_FAILURE`	การดำเนินการของงานล้มเหลวเนื่องจากปัญหาการแยกชุดข้อความ ในกรณีนี้ ให้ลองอีกครั้ง
`4`	`SERVICE_CALL_PERMISSION_DENIED`	ผู้โทรไม่ได้รับอนุญาตให้โทรเรียกบริการ
`5`	`SERVICE_CALL_INVALID_ARGUMENT`	คำขอมีข้อมูลที่ไม่ถูกต้อง (เช่น มีคลัสเตอร์มากกว่าจำนวนที่อนุญาต)
`6`	`SERVICE_CALL_INTERNAL`	เกิดข้อผิดพลาดที่ฝั่งบริการ
`7`	`SERVICE_CALL_RESOURCE_EXHAUSTED`	การเรียกใช้บริการเกิดขึ้นบ่อยเกินไป

ขั้นตอนที่ 3: จัดการ Intent ของข้อความประกาศ

นอกเหนือจากการเรียกใช้ API เผยแพร่เนื้อหาผ่านงานแล้ว คุณยังต้องตั้งค่า BroadcastReceiver เพื่อรับคําขอเผยแพร่เนื้อหาด้วย

เป้าหมายของ Broadcast Intents ส่วนใหญ่คือการเปิดใช้แอปอีกครั้งและการบังคับให้ซิงค์ข้อมูล Intent แบบออกอากาศไม่ได้ออกแบบมาเพื่อส่งบ่อยครั้ง ระบบจะทริกเกอร์เฉพาะเมื่อบริการ Engage พิจารณาว่าเนื้อหาอาจล้าสมัย (เช่น เนื้อหาเก่า 1 สัปดาห์) วิธีนี้จะทำให้มั่นใจได้มากขึ้นว่าผู้ใช้จะมีประสบการณ์การรับชมเนื้อหาที่สดใหม่ แม้ว่าจะไม่มีการเรียกใช้แอปพลิเคชันดังกล่าวเป็นเวลานานก็ตาม

BroadcastReceiver ต้องตั้งค่าด้วย 2 วิธีต่อไปนี้

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

Kotlin

class AppEngageBroadcastReceiver : BroadcastReceiver(){
  // Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
  // is received
  // Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received
  // Trigger continuation cluster publish when PUBLISH_CONTINUATION broadcast is
  // received
}

fun registerBroadcastReceivers(context: Context){
  var  context = context
  context = context.applicationContext

// Register Recommendation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_RECOMMENDATION))

// Register Featured Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_FEATURED))

// Register Continuation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_CONTINUATION))
}

Java

class AppEngageBroadcastReceiver extends BroadcastReceiver {
// Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
// is received

// Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received

// Trigger continuation cluster publish when PUBLISH_CONTINUATION broadcast is
// received
}

public static void registerBroadcastReceivers(Context context) {

context = context.getApplicationContext();

// Register Recommendation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_RECOMMENDATION));

// Register Featured Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED));

// Register Continuation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_CONTINUATION));

}

ประกาศการติดตั้งใช้งานกับแท็ก <receiver> ในไฟล์ AndroidManifest.xml แบบคงที่ ซึ่งจะช่วยให้แอปพลิเคชันได้รับ Intent แบบออกอากาศเมื่อไม่ได้ทำงานอยู่ และช่วยให้แอปพลิเคชันเผยแพร่เนื้อหาได้

<application>
   <receiver
      android:name=".AppEngageBroadcastReceiver"
      android:exported="true"
      android:enabled="true">
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_RECOMMENDATION" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_FEATURED" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_CONTINUATION" />
      </intent-filter>
   </receiver>
</application>

Intent ต่อไปนี้จะส่งโดยบริการ

com.google.android.engage.action.PUBLISH_RECOMMENDATION ขอแนะนำให้เริ่มการโทร publishRecommendationClusters เมื่อได้รับ Intent นี้
com.google.android.engage.action.PUBLISH_FEATURED ขอแนะนำให้เริ่มการโทร publishFeaturedCluster เมื่อได้รับ Intent นี้
com.google.android.engage.action.PUBLISH_CONTINUATION เราขอแนะนำให้เริ่มpublishContinuationClusterการโทรเมื่อได้รับ Intent นี้

เวิร์กโฟลว์การผสานรวม

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

คำถามที่พบบ่อย

ดูคำถามที่พบบ่อยได้ที่คำถามที่พบบ่อยเกี่ยวกับ Engage SDK

รายชื่อติดต่อ

โปรดติดต่อ engage-developers@google.com หากมีคำถามระหว่างกระบวนการผสานรวม

ขั้นตอนถัดไป

หลังจากผสานรวมเสร็จแล้ว ขั้นตอนถัดไปของคุณมีดังนี้

ส่งอีเมลไปที่ Engage-developers@google.com และแนบ APK ที่ผสานรวมซึ่งพร้อมให้ทดสอบโดย Google
Google จะดำเนินการยืนยันและตรวจสอบภายในเพื่อให้แน่ใจว่าการผสานรวมทำงานได้ตามที่คาดไว้ หากจำเป็นต้องทำการเปลี่ยนแปลง Google จะติดต่อคุณพร้อมรายละเอียดที่จำเป็น
เมื่อการทดสอบเสร็จสมบูรณ์และไม่จำเป็นต้องมีการเปลี่ยนแปลงใดๆ Google จะติดต่อคุณเพื่อแจ้งให้ทราบว่าคุณสามารถเริ่มเผยแพร่ APK ที่อัปเดตและผสานรวมแล้วใน Play Store
หลังจาก Google ยืนยันว่าได้เผยแพร่ APK ที่อัปเดตแล้วไปยัง Play Store แล้ว ระบบอาจเผยแพร่คลัสเตอร์คำแนะนำ แนะนํา และการต่อเรื่องให้ผู้ใช้เห็น