- แหล่งข้อมูล: ตำแหน่ง
- การแสดง JSON
- PhoneNumbers
- หมวดหมู่
- หมวดหมู่
- ServiceType
- MoreHoursType
- PostalAddress
- BusinessHours
- TimePeriod
- DayOfWeek
- TimeOfDay
- SpecialHours
- SpecialHourPeriod
- วันที่
- ServiceAreaBusiness
- BusinessType
- สถานที่
- PlaceInfo
- AdWordsLocationExtensions
- LatLng
- OpenInfo
- OpenForBusiness
- ข้อมูลเมตา
- โปรไฟล์
- RelationshipData
- RelevantLocation
- RelationType
- MoreHours
- ServiceItem
- StructuredServiceItem
- FreeFormServiceItem
- ป้ายกำกับ
- ค่าเงิน
- เมธอด
ทรัพยากร: ตำแหน่ง
สถานที่ ดูรายละเอียดของช่องเหล่านี้ได้จากบทความในศูนย์ช่วยเหลือ หรือดูรายการหมวดหมู่ธุรกิจที่ถูกต้องที่ปลายทางหมวดหมู่
การแสดง JSON |
---|
{ "name": string, "languageCode": string, "storeCode": string, "title": string, "phoneNumbers": { object ( |
ช่อง | |
---|---|
name |
ตัวระบุ Google สำหรับสถานที่ตั้งนี้ในรูปแบบ: |
languageCode |
เปลี่ยนแปลงไม่ได้ ภาษาของสถานที่ตั้ง ตั้งค่าในระหว่างการสร้างและไม่สามารถอัปเดตได้ |
storeCode |
ไม่บังคับ ตัวระบุภายนอกสำหรับสถานที่นี้ ซึ่งต้องไม่ซ้ำกันภายในบัญชีที่ระบุ นี่เป็นวิธีการเชื่อมโยงสถานที่กับบันทึกของคุณเอง |
title |
ต้องระบุ ชื่อสถานที่ตั้งควรแสดงชื่อจริงของธุรกิจ ตรงตามที่ใช้เป็นประจำที่หน้าร้าน เว็บไซต์ และหัวจดหมาย และเป็นชื่อที่ลูกค้ารู้จัก คุณสามารถใส่ข้อมูลเพิ่มเติมใดๆ ก็ตามที่เกี่ยวข้องลงในช่องอื่นๆ ของทรัพยากรได้ (เช่น |
phoneNumbers |
ไม่บังคับ หมายเลขโทรศัพท์ต่างๆ ที่ลูกค้าใช้ติดต่อธุรกิจได้ |
categories |
ไม่บังคับ หมวดหมู่ต่างๆ ที่อธิบายถึงธุรกิจ |
storefrontAddress |
ไม่บังคับ ที่อยู่ที่ถูกต้องและกระชับเพื่ออธิบายที่ตั้งธุรกิจ เราไม่อนุญาตให้ใช้ตู้ไปรษณีย์หรือตู้จดหมายซึ่งตั้งอยู่ห่างจากที่ตั้งธุรกิจ ขณะนี้คุณระบุค่า |
websiteUri |
ไม่บังคับ URL ของธุรกิจนี้ หากเป็นไปได้ ให้ใช้ URL ที่แสดงถึงสถานที่ตั้งธุรกิจแต่ละแห่งนี้แทนที่จะใช้เว็บไซต์/URL ทั่วไปที่แสดงถึงสถานที่ตั้งทั้งหมดหรือแบรนด์นั้นๆ |
regularHours |
ไม่บังคับ เวลาทําการของธุรกิจ |
specialHours |
ไม่บังคับ เวลาทำการพิเศษของธุรกิจ โดยปกติแล้วจะรวมถึงเวลาทําการในวันหยุดและเวลาอื่นๆ ที่ไม่ใช่เวลาทําการปกติ การดําเนินการนี้จะลบล้างเวลาทําการปกติ ไม่สามารถตั้งค่าช่องนี้หากไม่มีเวลาทำการปกติ |
serviceArea |
ไม่บังคับ ธุรกิจที่ให้บริการตามสถานที่ให้บริการในสถานที่ตั้งของลูกค้า หากธุรกิจนี้เป็นธุรกิจที่ให้บริการตามสถานที่ ฟิลด์นี้จะอธิบายถึงพื้นที่ให้บริการที่ธุรกิจดังกล่าวให้บริการ |
labels[] |
ไม่บังคับ คอลเล็กชันสตริงรูปแบบอิสระเพื่อให้คุณติดแท็กธุรกิจได้ ป้ายกำกับเหล่านี้ไม่ได้แสดงต่อผู้ใช้ มีคุณคนเดียวที่เห็น ต้องมีความยาวระหว่าง 1-255 อักขระต่อป้ายกำกับ |
adWordsLocationExtensions |
ไม่บังคับ ข้อมูลเพิ่มเติมที่แสดงใน AdWords |
latlng |
ไม่บังคับ ละติจูดและลองจิจูดที่ผู้ใช้ระบุ เมื่อสร้างตำแหน่ง ระบบจะไม่สนใจช่องนี้หากการระบุพิกัดทางภูมิศาสตร์ของที่อยู่ที่ให้ไว้สำเร็จ ระบบจะแสดงช่องนี้เมื่อมีคำขอรับข้อมูลก็ต่อเมื่อระบบยอมรับค่า |
openInfo |
ไม่บังคับ ธงที่บ่งบอกว่าสถานที่เปิดให้บริการอยู่ในขณะนี้หรือไม่ |
metadata |
เอาต์พุตเท่านั้น ข้อมูลเพิ่มเติมที่ผู้ใช้แก้ไขไม่ได้ |
profile |
ไม่บังคับ อธิบายธุรกิจของคุณด้วยน้ำเสียงของคุณเอง และแชร์เรื่องราวที่ไม่ซ้ำใครของธุรกิจและข้อเสนอของคุณแก่ผู้ใช้ คุณต้องระบุข้อมูลในช่องนี้สำหรับทุกหมวดหมู่ ยกเว้นหมวดหมู่ที่พัก (เช่น โรงแรม โมเทล โรงแรมขนาดเล็ก) |
relationshipData |
ไม่บังคับ สถานที่ตั้งและเครือธุรกิจทั้งหมดที่เกี่ยวข้องกับร้านนี้ |
moreHours[] |
ไม่บังคับ เวลาทําการเพิ่มเติมสําหรับแผนกต่างๆ หรือลูกค้าที่เฉพาะเจาะจงของธุรกิจ |
serviceItems[] |
ไม่บังคับ รายชื่อบริการที่รองรับโดยผู้ขาย โดยบริการหนึ่งๆ อาจตัดผม ติดตั้งเครื่องทำน้ำอุ่น เป็นต้น โดยระบบจะนำรายการบริการที่ซ้ำกันออกโดยอัตโนมัติ |
PhoneNumbers
กลุ่มหมายเลขโทรศัพท์ของธุรกิจ ต้องตั้งค่าทั้ง 2 ช่องในระหว่างการอัปเดต ลูกค้าต้องไม่อัปเดตเฉพาะหมายเลขโทรศัพท์หลักหรือหมายเลขโทรศัพท์เพิ่มเติมโดยใช้มาสก์การอัปเดต แนะนำให้ใช้รูปแบบหมายเลขโทรศัพท์ระหว่างประเทศ เช่น "+1 415 555 0132" ดูข้อมูลเพิ่มเติมใน (https://developers.google.com/style/phone-numbers#international-phone-numbers)
การแสดง JSON |
---|
{ "primaryPhone": string, "additionalPhones": [ string ] } |
ช่อง | |
---|---|
primaryPhone |
ต้องระบุ หมายเลขโทรศัพท์สำหรับติดต่อกับที่ตั้งธุรกิจแต่ละแห่งโดยตรงที่สุดเท่าที่จะเป็นไปได้ ใช้หมายเลขโทรศัพท์ในพื้นที่แทนหมายเลขฝ่ายบริการลูกค้าส่วนกลาง หากเป็นไปได้ |
additionalPhones[] |
ไม่บังคับ หมายเลขโทรศัพท์สูงสุด 2 หมายเลข (อุปกรณ์เคลื่อนที่หรือโทรศัพท์พื้นฐาน ไม่ใช่แฟกซ์) ที่ลูกค้าใช้โทรไปยังธุรกิจของคุณ นอกเหนือจากหมายเลขโทรศัพท์หลัก |
หมวดหมู่
ชุดหมวดหมู่ที่อธิบายถึงธุรกิจ ต้องตั้งค่าทั้ง 2 ช่องในระหว่างการอัปเดต ระบบไม่อนุญาตให้ลูกค้าอัปเดตหมวดหมู่หลักหรือหมวดหมู่เพิ่มเติมทีละรายการโดยใช้มาสก์การอัปเดต
การแสดง JSON |
---|
{ "primaryCategory": { object ( |
ช่อง | |
---|---|
primaryCategory |
ต้องระบุ หมวดหมู่ที่อธิบายธุรกิจหลักที่สถานที่นี้อยู่ได้ดีที่สุด |
additionalCategories[] |
ไม่บังคับ หมวดหมู่เพิ่มเติมที่อธิบายถึงธุรกิจของคุณ หมวดหมู่จะช่วยให้ลูกค้าพบผลการค้นหาบริการที่สนใจได้อย่างถูกต้องและเฉพาะเจาะจง ตรวจสอบว่าคุณใช้หมวดหมู่ให้น้อยที่สุดในการอธิบายถึงธุรกิจหลักในภาพรวม เพื่อให้ข้อมูลธุรกิจของคุณถูกต้องและเป็นปัจจุบัน เลือกหมวดหมู่ให้เฉพาะเจาะจงมากที่สุด แต่สื่อถึงธุรกิจหลักของคุณได้ดี |
หมวดหมู่
หมวดหมู่ที่อธิบายความหมายของธุรกิจนี้ (ไม่ใช่สิ่งที่ธุรกิจทำ) ดูรายการรหัสหมวดหมู่ที่ถูกต้องและการแมปกับชื่อที่มนุษย์อ่านได้ที่หัวข้อ categories.list
การแสดง JSON |
---|
{ "name": string, "displayName": string, "serviceTypes": [ { object ( |
ช่อง | |
---|---|
name |
ต้องระบุ รหัสแบบคงที่ (ให้โดย Google) สำหรับหมวดหมู่นี้ ต้องระบุค่าเมื่อแก้ไขหมวดหมู่ (เมื่อสร้างหรืออัปเดตสถานที่ตั้ง) |
displayName |
เอาต์พุตเท่านั้น ชื่อหมวดหมู่ที่มนุษย์อ่านได้ ซึ่งตั้งค่าไว้เมื่ออ่านตำแหน่ง ในการแก้ไขสถานที่ตั้ง ต้องตั้งค่า |
serviceTypes[] |
เอาต์พุตเท่านั้น รายการประเภทบริการทั้งหมดที่ใช้ได้กับหมวดหมู่ธุรกิจนี้ |
moreHoursTypes[] |
เอาต์พุตเท่านั้น ประเภทเวลาทำการเพิ่มเติมที่ใช้ได้สําหรับหมวดหมู่ธุรกิจนี้ |
ServiceType
ข้อความที่อธิบายประเภทบริการที่ธุรกิจเสนอ
การแสดง JSON |
---|
{ "serviceTypeId": string, "displayName": string } |
ช่อง | |
---|---|
serviceTypeId |
เอาต์พุตเท่านั้น รหัสแบบคงที่ (ให้โดย Google) สำหรับบริการประเภทนี้ |
displayName |
เอาต์พุตเท่านั้น ชื่อที่แสดงซึ่งมนุษย์อ่านได้สำหรับประเภทบริการ |
MoreHoursType
ประเภทเวลาทำการเพิ่มเติมที่ธุรกิจนำเสนอได้นอกเหนือจากเวลาทำการปกติ
การแสดง JSON |
---|
{ "hoursTypeId": string, "displayName": string, "localizedDisplayName": string } |
ช่อง | |
---|---|
hoursTypeId |
เอาต์พุตเท่านั้น รหัสแบบคงที่ที่ Google ให้สำหรับเวลาทำการประเภทนี้ |
displayName |
เอาต์พุตเท่านั้น ชื่อที่แสดงภาษาอังกฤษที่มนุษย์อ่านได้สำหรับประเภทเวลาทำการ |
localizedDisplayName |
เอาต์พุตเท่านั้น ชื่อที่แสดงซึ่งแปลโดยมนุษย์สำหรับประเภทชั่วโมง |
PostalAddress
แสดงที่อยู่ไปรษณีย์ เช่น ที่อยู่สำหรับการจัดส่งทางไปรษณีย์หรือที่อยู่การชำระเงิน เมื่อมีที่อยู่ไปรษณีย์ บริการไปรษณีย์จะสามารถส่งสินค้าไปยังสถานที่ตั้ง ตู้ ปณ. หรืออื่นๆ ที่คล้ายกัน แต่ไม่ได้มีไว้เพื่อสร้างแบบจำลองสถานที่ตั้งทางภูมิศาสตร์ (ถนน เมือง ภูเขา)
ในการใช้งานโดยทั่วไป ที่อยู่จะสร้างผ่านข้อมูลจากผู้ใช้หรือจากการนำเข้าข้อมูลที่มีอยู่ โดยขึ้นอยู่กับประเภทของกระบวนการ
คำแนะนำเกี่ยวกับการป้อน / แก้ไขที่อยู่: - ใช้วิดเจ็ตที่อยู่ที่พร้อมสำหรับการใช้งานให้เป็นสากล เช่น https://github.com/google/libaddressinput) - ผู้ใช้ไม่ควรได้เห็นองค์ประกอบ UI สำหรับการป้อนข้อมูลหรือแก้ไขช่องที่ไม่ได้อยู่ในประเทศอื่นๆ ที่ใช้ช่องนั้น
ดูคำแนะนำเพิ่มเติมเกี่ยวกับวิธีใช้สคีมานี้ได้ที่ https://support.google.com/business/answer/6397478
การแสดง JSON |
---|
{ "revision": integer, "regionCode": string, "languageCode": string, "postalCode": string, "sortingCode": string, "administrativeArea": string, "locality": string, "sublocality": string, "addressLines": [ string ], "recipients": [ string ], "organization": string } |
ช่อง | |
---|---|
revision |
การแก้ไขสคีมาของ การแก้ไขใหม่ทั้งหมดต้องเข้ากันได้กับการแก้ไขเก่า |
regionCode |
ต้องระบุ รหัสภูมิภาค CLDR ของประเทศ/ภูมิภาคของที่อยู่ ข้อมูลนี้จะไม่มีการอนุมานและขึ้นอยู่กับผู้ใช้ว่าค่าถูกต้องหรือไม่ ดูรายละเอียดได้ที่ https://cldr.unicode.org/ และ https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html ตัวอย่างเช่น "CH" สำหรับสวิตเซอร์แลนด์ |
languageCode |
ไม่บังคับ รหัสภาษา BCP-47 ของเนื้อหาของที่อยู่นี้ (หากทราบ) ซึ่งมักจะเป็นภาษา UI ของแบบฟอร์มการป้อนข้อมูล หรือคาดว่าจะตรงกับภาษาที่ใช้ในประเทศ/ภูมิภาคของที่อยู่ หรือคำทับศัพท์ที่เทียบเท่ากัน การตั้งค่านี้อาจส่งผลต่อการจัดรูปแบบในบางประเทศ แต่ไม่มีผลต่อความถูกต้องของข้อมูล และจะไม่ส่งผลต่อการตรวจสอบความถูกต้องหรือการดำเนินการอื่นๆ ที่เกี่ยวข้องกับการจัดรูปแบบที่ไม่เกี่ยวข้อง หากไม่ทราบค่านี้ ควรละเว้นค่านี้ (แทนการระบุค่าเริ่มต้นที่อาจไม่ถูกต้อง) ตัวอย่างเช่น "zh-Hant", "ja", "ja-Latn", "en" |
postalCode |
ไม่บังคับ รหัสไปรษณีย์ของที่อยู่ บางประเทศอาจใช้หรือกำหนดให้รหัสไปรษณีย์แสดงอยู่ แต่มีการใช้รหัสไปรษณีย์ดังกล่าว อาจทำให้มีการตรวจสอบเพิ่มเติมกับส่วนอื่นๆ ของที่อยู่ (เช่น การตรวจสอบความถูกต้องของรัฐ/รหัสไปรษณีย์ในสหรัฐอเมริกา) |
sortingCode |
ไม่บังคับ รหัสการจัดเรียงเพิ่มเติมเฉพาะสำหรับแต่ละประเทศ ไม่ได้ใช้ในภูมิภาคส่วนใหญ่ ในกรณีที่ใช้ ค่าจะเป็นสตริง เช่น "CEDEX" ซึ่งอาจตามด้วยตัวเลข (เช่น "CEDEX 7") หรือเป็นตัวเลขเพียงอย่างเดียวก็ได้ ซึ่งแสดง "รหัสภาค" (จาเมกา) "ตัวบ่งชี้พื้นที่จัดส่ง" (มาลาวี) หรือ "ตัวบ่งชี้ที่ทำการไปรษณีย์" (เช่น โกตดิวัวร์) |
administrativeArea |
ไม่บังคับ เขตปกครองที่สูงที่สุดที่ใช้สำหรับที่อยู่ทางไปรษณีย์ของประเทศหรือภูมิภาค เช่น รัฐ จังหวัด แคว้น หรือจังหวัด โดยเฉพาะอย่างยิ่ง สำหรับสเปน นี่คือจังหวัดนี้ไม่ใช่ชุมชนปกครองตนเอง (เช่น "บาร์เซโลนา" ไม่ใช่ "คาตาโลเนีย") หลายประเทศไม่ใช้เขตบริหารในที่อยู่ไปรษณีย์ เช่น ในประเทศสวิตเซอร์แลนด์ ไม่ควรมีการใส่ข้อมูล |
locality |
ไม่บังคับ โดยทั่วไปจะหมายถึงส่วนของเมือง/จังหวัดของที่อยู่ ตัวอย่าง: เมืองในสหรัฐอเมริกา ชุมชนด้านไอที เมืองตามเขตไปรษณีย์ของสหราชอาณาจักร ในภูมิภาคของโลกซึ่งมีการกำหนดย่านไม่ถูกต้องหรือไม่อยู่ในโครงสร้างนี้ ให้ปล่อยตำแหน่งว่างไว้และใช้ addressLines |
sublocality |
ไม่บังคับ สถานที่ตั้งย่อยของที่อยู่ ซึ่งอาจเป็นย่านใกล้เคียง เขตเมือง เขต |
addressLines[] |
บรรทัดที่อยู่ที่ไม่มีโครงสร้างซึ่งอธิบายถึงที่อยู่ในระดับที่ต่ำกว่า เนื่องจากค่าใน addressLines ไม่มีข้อมูลประเภท และบางครั้งอาจมีค่าหลายค่าในช่องเดียว (เช่น "Austin, TX") จึงจำเป็นต้องมีลำดับบรรทัดที่ชัดเจน ลำดับของบรรทัดที่อยู่ควรเป็น "ลำดับเอนเวโลป" สำหรับประเทศ/ภูมิภาคของที่อยู่ ซึ่งในที่ต่างๆ ที่อาจแตกต่างกัน (เช่น ญี่ปุ่น) address_language จะใช้เพื่อทำให้ชัดเจน (เช่น "ja" สำหรับลำดับจากขนาดใหญ่ไปเล็ก และ "ja-Latn" หรือ "en" สำหรับขนาดเล็กไปใหญ่) วิธีนี้จะทำให้บรรทัดของที่อยู่ที่เฉพาะเจาะจงมากที่สุดสามารถเลือกตามภาษาได้ การแสดงโครงสร้างที่อยู่ขั้นต่ำที่อนุญาตประกอบด้วยรหัสภูมิภาคพร้อมข้อมูลที่เหลืออยู่ทั้งหมดในบรรทัดที่อยู่ คุณอาจจะสามารถจัดรูปแบบที่อยู่ดังกล่าวได้อย่างคร่าวๆ โดยไม่ต้องมีการระบุพิกัดทางภูมิศาสตร์ แต่จะไม่สามารถให้เหตุผลเชิงความหมายเกี่ยวกับองค์ประกอบของที่อยู่ใดๆ ได้จนกว่าอย่างน้อยการแก้ไขจะได้รับการแก้ไขเป็นบางส่วน การสร้างที่อยู่มีเฉพาะรหัสภูมิภาคและบรรทัดที่อยู่ จากนั้นระบุพิกัดทางภูมิศาสตร์เป็นวิธีที่แนะนำในการจัดการที่อยู่ที่ไม่มีโครงสร้างโดยสิ้นเชิง (แทนการเดาว่าส่วนใดของที่อยู่ควรเป็นย่านหรือเขตบริหาร) |
recipients[] |
ไม่บังคับ ผู้รับที่ที่อยู่ ในบางกรณี ฟิลด์นี้อาจมีข้อมูลหลายบรรทัด ตัวอย่างเช่น อาจมีข้อมูล "การดูแล" |
organization |
ไม่บังคับ ชื่อขององค์กรตามที่อยู่ |
BusinessHours
แสดงระยะเวลาที่สถานที่แห่งนี้เปิดให้บริการ มีคอลเล็กชันอินสแตนซ์ [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod]
การแสดง JSON |
---|
{
"periods": [
{
object ( |
ช่อง | |
---|---|
periods[] |
ต้องระบุ ช่วงเวลาต่างๆ ที่สถานที่นี้เปิดทำการ แต่ละช่วงเวลาจะแสดงช่วงชั่วโมงที่สถานที่เปิดในระหว่างสัปดาห์ |
TimePeriod
แสดงระยะเวลาที่ธุรกิจเปิดทำการ โดยเริ่มในวัน/เวลาเปิดที่ระบุไว้ และสิ้นสุดในวัน/เวลาปิดที่ระบุไว้ เวลาปิดทำการจะต้องเกิดขึ้นหลังจากเวลาเปิดทำการ เช่น ในอีกวันเดียวกันหรือในวันต่อมา
การแสดง JSON |
---|
{ "openDay": enum ( |
ช่อง | |
---|---|
openDay |
ต้องระบุ บ่งบอกว่า |
openTime |
ต้องระบุ ค่าที่ใช้ได้คือ 00:00-24:00 โดยเวลา 24:00 น. หมายถึงเวลาเที่ยงคืนเมื่อสิ้นสุดช่องวันที่ระบุ |
closeDay |
ต้องระบุ บ่งบอกว่า |
closeTime |
ต้องระบุ ค่าที่ใช้ได้คือ 00:00-24:00 โดยเวลา 24:00 น. หมายถึงเวลาเที่ยงคืนเมื่อสิ้นสุดช่องวันที่ระบุ |
DayOfWeek
แสดงวันของสัปดาห์
Enum | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
ไม่ได้ระบุวันของสัปดาห์ |
MONDAY |
วันจันทร์ |
TUESDAY |
วันอังคาร |
WEDNESDAY |
วันพุธ |
THURSDAY |
พฤหัสบดี |
FRIDAY |
วันศุกร์ |
SATURDAY |
เสาร์ |
SUNDAY |
วันอาทิตย์ |
TimeOfDay
แสดงเวลาของวัน วันที่และเขตเวลาไม่มีนัยสำคัญหรือระบุไว้ในที่อื่น API อาจเลือกอนุญาตวินาทีอธิกสุรทิน ประเภทที่เกี่ยวข้องคือ google.type.Date
และ google.protobuf.Timestamp
การแสดง JSON |
---|
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer } |
ช่อง | |
---|---|
hours |
ชั่วโมงของวันในรูปแบบ 24 ชั่วโมง ควรอยู่ระหว่าง 0 ถึง 23 API อาจเลือกระบุค่า "24:00:00" ไว้สําหรับสถานการณ์ต่างๆ เช่น เวลาปิดทําการของธุรกิจ |
minutes |
นาทีในชั่วโมงของวัน ต้องอยู่ระหว่าง 0 ถึง 59 |
seconds |
จำนวนวินาทีของนาที ปกติต้องอยู่ระหว่าง 0 ถึง 59 API อาจอนุญาตค่า 60 หากอนุญาตวินาทีอธิกสุรทิน |
nanos |
เศษส่วนของวินาทีในหน่วยนาโนวินาที ต้องอยู่ระหว่าง 0 ถึง 999,999,999 |
SpecialHours
แสดงชุดระยะเวลาที่เวลาทำการของสถานที่ดังกล่าวแตกต่างจากเวลาทำการปกติ
การแสดง JSON |
---|
{
"specialHourPeriods": [
{
object ( |
ช่อง | |
---|---|
specialHourPeriods[] |
ต้องระบุ รายการข้อยกเว้นสำหรับเวลาทำการปกติของธุรกิจ |
SpecialHourPeriod
แสดงระยะเวลาเดียวเมื่อเวลาทําการของสถานที่แตกต่างจากเวลาทําการปกติ ช่วงเวลาพิเศษต้องเป็นช่วงเวลาที่น้อยกว่า 24 ชั่วโมง openTime
และ startDate
ต้องมาก่อน closeTime
และ endDate
closeTime
และ endDate
สามารถขยายเวลาไปจนถึง 23:59 น. ของวันหลังจาก startDate
ที่ระบุไว้ ตัวอย่างเช่น อินพุตต่อไปนี้ถูกต้อง
startDate=2015-11-23, openTime=08:00, closeTime=18:00
startDate=2015-11-23, endDate=2015-11-23, openTime=08:00,
closeTime=18:00 startDate=2015-11-23, endDate=2015-11-24,
openTime=13:00, closeTime=11:59
อินพุตต่อไปนี้ไม่ถูกต้อง:
startDate=2015-11-23, openTime=13:00, closeTime=11:59
startDate=2015-11-23, endDate=2015-11-24, openTime=13:00,
closeTime=12:00 startDate=2015-11-23, endDate=2015-11-25,
openTime=08:00, closeTime=18:00
การแสดง JSON |
---|
{ "startDate": { object ( |
ช่อง | |
---|---|
startDate |
ต้องระบุ วันที่ในปฏิทินของช่วงเวลาพิเศษนี้จะเริ่มต้นเป็นวันที่ |
openTime |
ไม่บังคับ ค่าที่ใช้ได้คือ 00:00-24:00 โดย 24:00 หมายถึงเวลาเที่ยงคืนเมื่อสิ้นสุดช่องวันที่ระบุ ต้องระบุหาก |
endDate |
ไม่บังคับ วันที่ตามปฏิทินของช่วงเวลาพิเศษนี้สิ้นสุดไป หากไม่ได้ตั้งค่าช่อง |
closeTime |
ไม่บังคับ ค่าที่ใช้ได้คือ 00:00-24:00 โดยเวลา 24:00 น. หมายถึงเวลาเที่ยงคืนเมื่อสิ้นสุดช่องวันที่ระบุ ต้องระบุหาก |
closed |
ไม่บังคับ หากเป็น "จริง" |
วันที่
แสดงวันที่ในปฏิทินทั้งหมดหรือบางส่วน เช่น วันเกิด มีการระบุเวลาของวันและเขตเวลาไว้ที่อื่นหรือไม่มีนัยสำคัญ วันที่จะสัมพันธ์กับปฏิทินเกรกอเรียน ซึ่งอาจเป็นอย่างใดอย่างหนึ่งต่อไปนี้
- วันที่แบบเต็มพร้อมค่าปี เดือน และวันที่ไม่ใช่ 0
- เดือนและวัน 1 ปี (เช่น วันครบรอบ)
- 1 ปีเท่านั้น โดยมี 0 เดือนกับ 0 วัน
- ปีและเดือนที่มี 0 วัน (เช่น วันที่หมดอายุของบัตรเครดิต)
ประเภทที่เกี่ยวข้อง
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
การแสดง JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
ช่อง | |
---|---|
year |
ปีของวันที่ ต้องอยู่ระหว่าง 1 ถึง 9999 หรือ 0 เพื่อระบุวันที่โดยไม่ต้องใส่ปี |
month |
เดือนของปี ค่านี้ต้องอยู่ระหว่าง 1 ถึง 12 หรือ 0 เพื่อระบุปีโดยไม่มีเดือนและวัน |
day |
วันของเดือน ค่านี้ต้องอยู่ระหว่าง 1 ถึง 31 และใช้ได้กับปีและเดือน หรือ 0 เพื่อระบุปีอย่างเดียว หรือปีและเดือนที่วันไม่สำคัญ |
ServiceAreaBusiness
ธุรกิจที่ให้บริการตามสถานที่จะให้การบริการตามสถานที่ของลูกค้า (เช่น ช่างทำกุญแจหรือช่างประปา)
การแสดง JSON |
---|
{ "businessType": enum ( |
ช่อง | |
---|---|
businessType |
ต้องระบุ ระบุ [type] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] ของธุรกิจที่ให้บริการตามสถานที่ |
places |
พื้นที่ที่ธุรกิจนี้ให้บริการจะกำหนดผ่านกลุ่มสถานที่ |
regionCode |
เปลี่ยนแปลงไม่ได้ รหัสภูมิภาค CLDR ของประเทศ/ภูมิภาคที่ธุรกิจที่ให้บริการตามสถานที่นี้ตั้งอยู่ ดูรายละเอียดได้ที่ http://cldr.unicode.org/ และ http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html ตัวอย่างเช่น "CH" สำหรับสวิตเซอร์แลนด์ ช่องนี้จำเป็นต้องระบุสำหรับธุรกิจ CUSTOMER_LOCATION_ONLY และระบบจะไม่สนใจช่องนี้ ภูมิภาคที่ระบุที่นี่อาจแตกต่างจากภูมิภาคในพื้นที่ที่ธุรกิจนี้ให้บริการ (เช่น ธุรกิจที่ให้บริการตามสถานที่ซึ่งให้บริการในภูมิภาคอื่นนอกเหนือจากที่ธุรกิจตั้งอยู่) หากสถานที่นี้ต้องมีการยืนยันหลังจากที่สร้าง ที่อยู่ที่ระบุไว้เพื่อการยืนยันต้องอยู่ในภูมิภาคนี้ และเจ้าของธุรกิจหรือตัวแทนที่ได้รับอนุญาตต้องรับไปรษณีย์ตามที่อยู่การยืนยันที่ระบุไว้ได้ |
BusinessType
ระบุว่าธุรกิจนี้ให้บริการเฉพาะในสถานที่ของลูกค้า (เช่น รถลาก) หรือทั้งที่อยู่และในสถานที่ (เช่น ร้านพิซซ่าที่มีพื้นที่รับประทานอาหาร และให้บริการแก่ลูกค้าด้วย)
Enum | |
---|---|
BUSINESS_TYPE_UNSPECIFIED |
เอาต์พุตเท่านั้น ไม่ได้ระบุ |
CUSTOMER_LOCATION_ONLY |
ให้บริการเฉพาะในพื้นที่รอบๆ เท่านั้น (ไม่ใช่ที่ที่อยู่ธุรกิจ) ถ้าธุรกิจกำลังถูกอัปเดตจาก CUSTOMER_AND_BUSINESS_LOCATION เป็น CUSTOMER_LOCATION_ONLY การอัปเดตตำแหน่งต้องมีฟิลด์มาสก์ storefrontAddress และตั้งค่าฟิลด์ให้ว่างเปล่า |
CUSTOMER_AND_BUSINESS_LOCATION |
ให้บริการในที่อยู่ธุรกิจและพื้นที่โดยรอบ |
สถานที่
ระบุการรวมพื้นที่ที่แสดงด้วยกลุ่มสถานที่
การแสดง JSON |
---|
{
"placeInfos": [
{
object ( |
ช่อง | |
---|---|
placeInfos[] |
พื้นที่ที่แสดงด้วยรหัสสถานที่ จํากัดสูงสุด 20 แห่ง |
PlaceInfo
กำหนดพื้นที่ที่แสดงด้วยรหัสสถานที่
การแสดง JSON |
---|
{ "placeName": string, "placeId": string } |
ช่อง | |
---|---|
placeName |
ต้องระบุ ชื่อที่แปลแล้วของสถานที่ เช่น |
placeId |
ต้องระบุ รหัสของสถานที่ ต้องสอดคล้องกับภูมิภาค (https://developers.google.com/places/web-service/supported_types#table3) |
AdWordsLocationExtensions
ข้อมูลเพิ่มเติมที่แสดงใน AdWords
การแสดง JSON |
---|
{ "adPhone": string } |
ช่อง | |
---|---|
adPhone |
ต้องระบุ หมายเลขโทรศัพท์สำรองที่จะแสดงบนส่วนขยายสถานที่ตั้งของ AdWords แทนหมายเลขโทรศัพท์หลักของสถานที่ตั้ง |
LatLng
วัตถุที่แสดงคู่ละติจูด/ลองจิจูด ค่านี้แสดงเป็นเลขคู่ 1 คู่เพื่อแสดงองศาละติจูดและลองจิจูดองศา ออบเจ็กต์นี้ต้องเป็นไปตาม มาตรฐาน WGS84 เว้นแต่จะระบุไว้เป็นอย่างอื่น ค่าต้องอยู่ในช่วงมาตรฐาน
การแสดง JSON |
---|
{ "latitude": number, "longitude": number } |
ช่อง | |
---|---|
latitude |
ละติจูด หน่วยเป็นองศา โดยต้องอยู่ในช่วง [-90.0, +90.0] |
longitude |
ลองจิจูด หน่วยเป็นองศา โดยต้องอยู่ในช่วง [-180.0, +180.0] |
OpenInfo
ข้อมูลที่เกี่ยวข้องกับสถานะการเปิดทำการของธุรกิจ
การแสดง JSON |
---|
{ "status": enum ( |
ช่อง | |
---|---|
status |
ต้องระบุ ระบุว่าสถานที่เปิดให้บริการอยู่หรือไม่ สถานที่ทั้งหมดจะเปิดโดยค่าเริ่มต้น เว้นแต่จะอัปเดตเป็นปิด |
canReopen |
เอาต์พุตเท่านั้น ระบุว่าธุรกิจนี้มีสิทธิ์เปิดอีกครั้งหรือไม่ |
openingDate |
ไม่บังคับ วันที่เปิดสถานที่เป็นครั้งแรก หากไม่ทราบวันที่ คุณจะระบุได้เฉพาะเดือนและปีเท่านั้น วันที่ต้องเป็นวันที่ที่ผ่านมาแล้วหรือไม่มากกว่า 1 ปีนับจากนี้ |
OpenForBusiness
ระบุสถานะของสถานที่
Enum | |
---|---|
OPEN_FOR_BUSINESS_UNSPECIFIED |
ไม่ได้ระบุ |
OPEN |
ระบุว่าสถานที่นี้เปิดอยู่ |
CLOSED_PERMANENTLY |
บ่งบอกว่าสถานที่นี้ปิดถาวรแล้ว |
CLOSED_TEMPORARILY |
บ่งบอกว่าสถานที่นี้ปิดชั่วคราว |
Metadata
ข้อมูลเพิ่มเติมที่ผู้ใช้แก้ไขไม่ได้เกี่ยวกับสถานที่ตั้ง
การแสดง JSON |
---|
{ "hasGoogleUpdated": boolean, "hasPendingEdits": boolean, "canDelete": boolean, "canOperateLocalPost": boolean, "canModifyServiceList": boolean, "canHaveFoodMenus": boolean, "canOperateHealthData": boolean, "canOperateLodgingData": boolean, "placeId": string, "duplicateLocation": string, "mapsUri": string, "newReviewUri": string, "canHaveBusinessCalls": boolean, "hasVoiceOfMerchant": boolean } |
ช่อง | |
---|---|
hasGoogleUpdated |
เอาต์พุตเท่านั้น ระบุว่ารหัสสถานที่ที่เชื่อมโยงกับสถานที่นี้มีการอัปเดตที่ไคลเอ็นต์จำเป็นต้องอัปเดตหรือปฏิเสธ หากมีการตั้งค่าบูลีนนี้ คุณควรเรียกใช้เมธอด |
hasPendingEdits |
เอาต์พุตเท่านั้น ระบุว่าพร็อพเพอร์ตี้ของตำแหน่งนี้อยู่ในสถานะรอดำเนินการแก้ไขหรือไม่ |
canDelete |
เอาต์พุตเท่านั้น ระบุว่าสามารถลบสถานที่โดยใช้ API ได้หรือไม่ |
canOperateLocalPost |
เอาต์พุตเท่านั้น ระบุว่าข้อมูลนี้จัดการโพสต์ในพื้นที่ได้หรือไม่ |
canModifyServiceList |
เอาต์พุตเท่านั้น ระบุว่าข้อมูลนี้แก้ไขรายการบริการได้หรือไม่ |
canHaveFoodMenus |
เอาต์พุตเท่านั้น ระบุว่าข้อมูลมีสิทธิ์สำหรับเมนูอาหารหรือไม่ |
canOperateHealthData |
เอาต์พุตเท่านั้น ระบุว่าสถานที่ทํางานกับข้อมูล Health ได้หรือไม่ |
canOperateLodgingData |
เอาต์พุตเท่านั้น ระบุว่าสถานที่ทํางานกับข้อมูลที่พักได้หรือไม่ |
placeId |
เอาต์พุตเท่านั้น หากสถานที่นี้ปรากฏใน Google Maps ช่องนี้จะถูกกรอกด้วยรหัสสถานที่สำหรับสถานที่นั้น รหัสนี้ใช้ใน Places API ได้หลายรายการ คุณจะตั้งค่าช่องนี้ได้ระหว่างการสร้างการเรียก แต่ไม่สามารถตั้งค่าสำหรับการอัปเดต |
duplicateLocation |
เอาต์พุตเท่านั้น ทรัพยากรของสถานที่ที่สถานที่นี้ซ้ำ |
mapsUri |
เอาต์พุตเท่านั้น ลิงก์ไปยังสถานที่ใน Maps |
newReviewUri |
เอาต์พุตเท่านั้น ลิงก์ไปยังหน้าใน Google Search ที่ลูกค้าสามารถเขียนรีวิวเกี่ยวกับสถานที่ดังกล่าวได้ |
canHaveBusinessCalls |
เอาต์พุตเท่านั้น ระบุว่าข้อมูลมีสิทธิ์ใช้การโทรทางธุรกิจหรือไม่ |
hasVoiceOfMerchant |
เอาต์พุตเท่านั้น ระบุว่าข้อมูลมี Voice of Merchant หรือไม่ หากบูลีนนี้เป็นเท็จ คุณควรเรียกใช้ locations.getVoiceOfMerchantState API เพื่อดูรายละเอียดว่าเหตุใดบูลีนนี้จึงไม่มี Voice of Merchant |
โปรไฟล์
ข้อมูลทั้งหมดที่เกี่ยวข้องกับโปรไฟล์ของสถานที่
การแสดง JSON |
---|
{ "description": string } |
ช่อง | |
---|---|
description |
ต้องระบุ คำอธิบายสถานที่ด้วยเสียงของคุณเอง ซึ่งคนอื่นแก้ไขไม่ได้ |
RelationshipData
ข้อมูลสถานที่ตั้งระดับบนสุดและสถานที่ตั้งย่อยทั้งหมดที่เกี่ยวข้องกับสถานที่นี้
การแสดง JSON |
---|
{ "parentLocation": { object ( |
ช่อง | |
---|---|
parentLocation |
สถานที่ตั้งระดับบนสุดที่สถานที่นี้มีความสัมพันธ์ |
childrenLocations[] |
รายการตำแหน่งย่อยที่ตำแหน่งนี้มีความสัมพันธ์ |
parentChain |
ชื่อทรัพยากรของเชนที่สถานที่นี้เป็นสมาชิก [วิธีค้นหารหัสเชน] [Locations.SearchChains] |
RelevantLocation
ข้อมูลเกี่ยวกับสถานที่อื่นที่เกี่ยวข้องกับสถานที่ปัจจุบัน ความสัมพันธ์อาจเป็นค่าใดก็ได้ใน DEPARTMENT_OF หรือ INDEPENDENT_ESTABLISHMENT_OF ก็ได้ และตำแหน่งที่ระบุที่นี่อาจเป็นด้านใดก็ได้ (ระดับบนสุด/ย่อย) ของตำแหน่ง
การแสดง JSON |
---|
{
"placeId": string,
"relationType": enum ( |
ช่อง | |
---|---|
placeId |
ต้องระบุ ระบุตำแหน่งที่อยู่อีกฝั่งหนึ่งของความสัมพันธ์ตามรหัสสถานที่ |
relationType |
ต้องระบุ ประเภทของความสัมพันธ์ |
RelationType
ความสัมพันธ์ของประเภทที่จะระบุ
Enum | |
---|---|
RELATION_TYPE_UNSPECIFIED |
ไม่ได้ระบุประเภท |
DEPARTMENT_OF |
ค่านี้แสดงถึงความสัมพันธ์ระหว่างสถานที่ 2 แห่งที่ใช้พื้นที่ทางกายภาพเพียงแห่งเดียว ใช้แบรนด์/การจัดการระดับบน/องค์กรเดียวกัน แต่มีคุณลักษณะหลักที่แตกต่างกัน เช่น เวลาทำการหรือหมายเลขโทรศัพท์ ตัวอย่างเช่น Costco Pharmacy คือแผนกหนึ่งใน Costco Wholesale |
INDEPENDENT_ESTABLISHMENT_IN |
ซึ่งแสดงถึงกรณีที่ธุรกิจ 2 แห่งตั้งอยู่ร่วมกันในสถานที่ตั้งเดียวกัน แต่มาจากคนละบริษัท (เช่น สตาร์บัคส์สาขาเซ็นทรัล ร้านค้าในห้างสรรพสินค้า) |
MoreHours
ระยะเวลาที่สถานที่เปิดสําหรับธุรกิจบางประเภท
การแสดง JSON |
---|
{
"hoursTypeId": string,
"periods": [
{
object ( |
ช่อง | |
---|---|
hoursTypeId |
ต้องระบุ ประเภทเวลาทำการ ลูกค้าควรโทรหา {#link business categories:BatchGet} เพื่อทราบประเภทเวลาทำการที่รองรับสำหรับหมวดหมู่ของสถานที่ตั้ง |
periods[] |
ต้องระบุ ช่วงเวลาต่างๆ ที่สถานที่นี้เปิด แต่ละช่วงเวลาจะแสดงช่วงชั่วโมงที่สถานที่เปิดในระหว่างสัปดาห์ |
ServiceItem
ข้อความที่อธิบายรายการบริการรายการเดียว ชื่อนี้จะใช้เพื่ออธิบายประเภทของบริการที่ผู้ขายเสนอ เช่น การตัดผมอาจเป็นบริการหนึ่ง
การแสดง JSON |
---|
{ "price": { object ( |
ช่อง | |
---|---|
price |
ไม่บังคับ แสดงราคาเป็นตัวเงินของสินค้าบริการ เราขอแนะนำให้ตั้งค่าสกุลเงินและหน่วยเมื่อระบุราคา ซึ่งจะถือเป็นราคาคงที่สำหรับบริการนั้นๆ |
ฟิลด์การรวม service_item_info ควรตั้งค่าช่องใดช่องหนึ่งต่อไปนี้เสมอ service_item_info ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
structuredServiceItem |
ไม่บังคับ ช่องนี้จะเป็นการตั้งค่าตัวพิมพ์เล็ก/ใหญ่ของข้อมูลบริการที่มีโครงสร้าง |
freeFormServiceItem |
ไม่บังคับ ช่องนี้จะตั้งค่ากรณีของข้อมูลบริการรูปแบบอิสระ |
StructuredServiceItem
หมายถึงบริการที่มีโครงสร้างที่ผู้ขายนำเสนอ เช่น toilet_installation
การแสดง JSON |
---|
{ "serviceTypeId": string, "description": string } |
ช่อง | |
---|---|
serviceTypeId |
ต้องระบุ ช่อง |
description |
ไม่บังคับ คำอธิบายรายการบริการที่มีโครงสร้าง จํานวนอักขระสูงสุดคือ 300 ตัว |
FreeFormServiceItem
หมายถึงบริการรูปแบบอิสระที่ผู้ขายนำเสนอ ซึ่งเป็นบริการที่ไม่ได้แสดงเป็นส่วนหนึ่งของข้อมูลบริการแบบมีโครงสร้างของเรา ผู้ขายป้อนชื่อบริการดังกล่าวด้วยตนเองผ่านแพลตฟอร์มของผู้ขายทางภูมิศาสตร์
การแสดง JSON |
---|
{
"category": string,
"label": {
object ( |
ช่อง | |
---|---|
category |
ต้องระบุ ฟิลด์นี้แสดงชื่อหมวดหมู่ (เช่น รหัสแบบคงที่ของหมวดหมู่) |
label |
ต้องระบุ ป้ายกำกับที่ติดแท็กภาษาสำหรับรายการ ชื่อรายการควรมีอักขระไม่เกิน 140 ตัว และคำอธิบายที่มีอักขระไม่เกิน 250 ตัว ควรตั้งค่าช่องนี้เมื่ออินพุตเป็นรายการบริการที่กำหนดเองเท่านั้น ประเภทบริการที่เป็นมาตรฐานควรอัปเดตผ่าน serviceTypeId |
ป้ายกำกับ
ป้ายกำกับที่ใช้เมื่อแสดงรายการราคา ส่วน หรือสินค้า
การแสดง JSON |
---|
{ "displayName": string, "description": string, "languageCode": string } |
ช่อง | |
---|---|
displayName |
ต้องระบุ ชื่อที่แสดงสำหรับรายการราคา ส่วน หรือสินค้า |
description |
ไม่บังคับ คำอธิบายของรายการราคา ส่วน หรือสินค้า |
languageCode |
ไม่บังคับ รหัสภาษา BCP-47 ที่สตริงเหล่านี้มีผล คุณจะตั้งค่าป้ายกำกับได้เพียงชุดเดียวต่อภาษา |
สกุลเงิน
แสดงจำนวนเงินพร้อมประเภทสกุลเงิน
การแสดง JSON |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
ช่อง | |
---|---|
currencyCode |
รหัสสกุลเงิน 3 ตัวอักษรที่กำหนดไว้ใน ISO 4217 |
units |
หน่วยทั้งหมดของจำนวนเงิน เช่น หาก |
nanos |
จำนวนนาโน (10^-9) หน่วยของจํานวน ค่าต้องอยู่ระหว่าง -999,999,999 ถึง +999,999,999 หาก |
วิธีการ |
|
---|---|
|
สร้างตำแหน่งใหม่ที่จะเป็นเจ้าของของผู้ใช้ที่เข้าสู่ระบบ |
|
แสดงสถานที่สำหรับบัญชีที่ระบุ |