- แหล่งข้อมูล: BusinessInfo
- PostalAddress
- PhoneNumber
- ShortCode
- PhoneVerificationState
- CustomerService
- เมธอด
ทรัพยากร: BusinessInfo
ข้อความ BusinessInfo
มีข้อมูลสำคัญเกี่ยวกับธุรกิจของผู้ขาย
ข้อความนี้จะบันทึกรายละเอียดทางธุรกิจที่สำคัญ เช่น ที่อยู่จริง ข้อมูลติดต่อฝ่ายบริการลูกค้า และตัวระบุเฉพาะภูมิภาค
การแสดง JSON |
---|
{ "name": string, "address": { object ( |
ช่อง | |
---|---|
name |
ตัวระบุ ชื่อทรัพยากรของข้อมูลธุรกิจ รูปแบบ: |
address |
ไม่บังคับ ที่อยู่ของธุรกิจ ระบบรองรับเฉพาะช่อง |
phone |
เอาต์พุตเท่านั้น หมายเลขโทรศัพท์ของธุรกิจ |
phone |
เอาต์พุตเท่านั้น สถานะการยืนยันทางโทรศัพท์ของธุรกิจ |
customer |
ไม่บังคับ ฝ่ายบริการลูกค้าของธุรกิจ |
korean |
ไม่บังคับ หมายเลขจดทะเบียนธุรกิจของเกาหลี 10 หลักที่คั่นด้วยขีดกลางในรูปแบบ XXX-XX-XXXXX |
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 |
การแก้ไขสคีมาของ การแก้ไขใหม่ทั้งหมดต้องใช้งานร่วมกับการแก้ไขเก่าได้ |
region |
ต้องระบุ รหัสภูมิภาค CLDR ของประเทศ/ภูมิภาคของที่อยู่ ระบบจะไม่อนุมานค่านี้และขึ้นอยู่กับผู้ใช้ที่จะตรวจสอบว่าค่านั้นถูกต้อง ดูรายละเอียดได้ที่ https://cldr.unicode.org/ และ https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html เช่น "CH" สำหรับสวิตเซอร์แลนด์ |
language |
ไม่บังคับ รหัสภาษา BCP-47 ของเนื้อหาในที่อยู่นี้ (หากทราบ) ภาษานี้มักเป็นภาษา UI ของแบบฟอร์มการป้อนข้อมูล หรือคาดว่าจะตรงกับภาษาใดภาษาหนึ่งที่ใช้ในประเทศ/ภูมิภาคของที่อยู่ หรือภาษาที่เทียบเท่าซึ่งถอดเสียง ซึ่งอาจส่งผลต่อการจัดรูปแบบในบางประเทศ แต่ไม่สำคัญต่อความถูกต้องของข้อมูลและจะไม่ส่งผลต่อการตรวจสอบหรือการดําเนินการอื่นๆ ที่ไม่เกี่ยวข้องกับการจัดรูปแบบ หากไม่ทราบค่านี้ ก็ไม่ควรระบุ (แทนที่จะระบุค่าเริ่มต้นที่ไม่ถูกต้อง) ตัวอย่างเช่น "zh-Hant", "ja", "ja-Latn", "en" |
postal |
ไม่บังคับ รหัสไปรษณีย์ของที่อยู่ บางประเทศไม่ได้ใช้หรือกำหนดให้ต้องระบุรหัสไปรษณีย์ แต่หากใช้รหัสไปรษณีย์ ระบบอาจเรียกใช้การตรวจสอบเพิ่มเติมกับส่วนอื่นๆ ของที่อยู่ (เช่น การตรวจสอบรัฐ/รหัสไปรษณีย์ในสหรัฐอเมริกา) |
sorting |
ไม่บังคับ รหัสการจัดเรียงเพิ่มเติมสำหรับแต่ละประเทศ ซึ่งไม่ได้ใช้ในภูมิภาคส่วนใหญ่ ค่าที่ใช้จะเป็นสตริง เช่น "CEDEX" ตามด้วยตัวเลข (ไม่บังคับ) (เช่น "CEDEX 7") หรือจะเป็นตัวเลขเพียงอย่างเดียวก็ได้ ซึ่งแสดงถึง "รหัสภาค" (จาไมก้า), "ตัวบ่งชี้พื้นที่การนำส่ง" (มาลาวี) หรือ "ตัวบ่งชี้ที่ทำการไปรษณีย์" (เช่น ไอวอรี่โคสต์) |
administrative |
ไม่บังคับ เขตบริหารย่อยที่สูงที่สุดซึ่งใช้สำหรับที่อยู่ไปรษณีย์ของประเทศหรือภูมิภาค เช่น รัฐ จังหวัด เขต หรือจังหวัด สำหรับสเปนโดยเฉพาะ ข้อมูลนี้หมายถึงจังหวัด ไม่ใช่แคว้นปกครองตนเอง (เช่น "บาร์เซโลนา" ไม่ใช่ "คาตาโลเนีย") หลายประเทศไม่ได้ใช้เขตบริหารในที่อยู่ไปรษณีย์ เช่น ในสวิตเซอร์แลนด์ คุณควรปล่อยฟิลด์นี้ว่างไว้ |
locality |
ไม่บังคับ โดยทั่วไปหมายถึงส่วนเมือง/อำเภอของที่อยู่ เช่น เมืองในสหรัฐอเมริกา เทศบาลในอิตาลี เมืองในสหราชอาณาจักร ในภูมิภาคของโลกที่ไม่มีการกําหนดสถานที่ตั้งอย่างชัดเจนหรือไม่เหมาะกับโครงสร้างนี้ ให้เว้นว่างสถานที่ตั้งไว้และใช้ addressLines |
sublocality |
ไม่บังคับ เขตท้องที่ของที่อยู่ เช่น อาจเป็นย่าน เขต เขต |
address |
บรรทัดที่อยู่ที่ไม่เป็นโครงสร้างซึ่งอธิบายที่อยู่ในระดับล่าง เนื่องจากค่าใน addressLines ไม่มีข้อมูลประเภทและบางครั้งอาจมีหลายค่าในช่องเดียว (เช่น "Austin, TX") คุณจึงควรจัดเรียงบรรทัดให้ชัดเจน ลำดับบรรทัดที่อยู่ควรเป็น "ลำดับของซองจดหมาย" สำหรับประเทศ/ภูมิภาคของที่อยู่ ในที่ที่อาจแตกต่างกัน (เช่น ญี่ปุ่น) ระบบจะใช้ address_language เพื่อระบุให้ชัดเจน (เช่น "ja" สำหรับการจัดเรียงจากใหญ่ไปเล็ก และ "ja-Latn" หรือ "en" สำหรับการจัดเรียงจากเล็กไปใหญ่) วิธีนี้จะช่วยให้คุณเลือกบรรทัดที่อยู่เฉพาะเจาะจงที่สุดตามภาษาได้ การนำเสนอโครงสร้างที่อยู่ขั้นต่ำที่อนุญาตประกอบด้วยรหัสภูมิภาคที่มีข้อมูลที่เหลือทั้งหมดอยู่ใน addressLines คุณสามารถจัดรูปแบบที่อยู่ดังกล่าวอย่างคร่าวๆ ได้โดยไม่ต้องใช้การจับคู่พิกัดภูมิศาสตร์ แต่ระบบไม่สามารถใช้เหตุผลเชิงความหมายกับองค์ประกอบที่อยู่ใดๆ จนกว่าจะมีการแก้ไขอย่างน้อยบางส่วน การสร้างที่อยู่ที่มีเฉพาะ regionCode และ addressLines แล้วทำการจับคู่พิกัดภูมิศาสตร์เป็นวิธีที่แนะนำในการจัดการที่อยู่ที่ไม่มีโครงสร้างโดยสมบูรณ์ (แทนที่จะเดาว่าส่วนใดของที่อยู่ควรเป็นสถานที่ตั้งหรือเขตบริหาร) |
recipients[] |
ไม่บังคับ ผู้รับที่อยู่ที่ระบุ ช่องนี้อาจมีข้อมูลหลายบรรทัดในบางกรณี เช่น อาจมีข้อมูล "รับพัสดุแทน" |
organization |
ไม่บังคับ ชื่อองค์กรที่อยู่ที่ระบุ |
หมายเลขโทรศัพท์
ออบเจ็กต์ที่แสดงหมายเลขโทรศัพท์ ซึ่งเหมาะสำหรับใช้เป็นรูปแบบการต่อ API
การแสดงข้อมูลนี้
ไม่ควรใช้สำหรับการจัดรูปแบบหมายเลขโทรศัพท์เฉพาะภาษา เช่น "+1 (650) 253-0000 ต่อ 123"
ไม่ได้ออกแบบมาเพื่อพื้นที่เก็บข้อมูลอย่างมีประสิทธิภาพ
- อาจไม่เหมาะสำหรับการโทร - ควรใช้ไลบรารีเฉพาะ (ดูข้อมูลอ้างอิง) เพื่อแยกวิเคราะห์หมายเลขสำหรับวัตถุประสงค์ดังกล่าว
หากต้องการทําสิ่งสําคัญกับตัวเลขนี้ เช่น จัดรูปแบบสําหรับกรณีการใช้งานต่างๆ ให้แปลงเป็นออบเจ็กต์ i18n.phonenumbers.PhoneNumber
ก่อน
เช่น ใน Java จะเป็นดังนี้
com.google.type.PhoneNumber wireProto = com.google.type.PhoneNumber.newBuilder().build(); com.google.i18n.phonenumbers.Phonenumber.PhoneNumber phoneNumber = PhoneNumberUtil.getInstance().parse(wireProto.getE164Number(), "ZZ"); if (!wireProto.getExtension().isEmpty()) { phoneNumber.setExtension(wireProto.getExtension()); }
ข้อมูลอ้างอิง: - https://github.com/google/libphonenumber
การแสดง JSON |
---|
{ "extension": string, // Union field |
ช่อง | |
---|---|
extension |
ส่วนขยายของหมายเลขโทรศัพท์ ส่วนขยายนี้ไม่ได้เป็นมาตรฐานตามคำแนะนำของ ITU ยกเว้นการระบุว่าเป็นชุดตัวเลขที่มีความยาวสูงสุด 40 หลัก นอกจากตัวเลขแล้ว ระบบอาจจัดเก็บอักขระการโทรอื่นๆ เช่น ',' (แสดงถึงเวลารอ) หรือ '#' ไว้ที่นี่ด้วย โปรดทราบว่าขณะนี้ไม่มีภูมิภาคใดใช้ส่วนขยายที่มีรหัสสั้น ดังนั้นโดยปกติแล้วช่องนี้จะตั้งค่าร่วมกับหมายเลข E.164 เท่านั้น โดยหมายเลขนี้จะถูกเก็บแยกจากหมายเลข E.164 เพื่อให้สามารถขยายหมายเลขสั้นได้ในอนาคต |
ฟิลด์สหภาพ kind ต้องระบุ หมายเลขปกติหรือรหัสสั้น เราอาจเพิ่มฟิลด์ใหม่ลงในรายการแบบใดแบบหนึ่งด้านล่างในอนาคต ดังนั้นลูกค้าจึงควรละเว้นหมายเลขโทรศัพท์ที่ไม่ได้ตั้งค่าฟิลด์ใดเลย kind ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
e164 |
หมายเลขโทรศัพท์ที่แสดงเป็นเครื่องหมายบวกนำหน้า ('+') ตามด้วยหมายเลขโทรศัพท์ที่ใช้รูปแบบ ITU E.164 แบบผ่อนปรน ซึ่งประกอบด้วยรหัสการโทรออกของประเทศ (1-3 หลัก) และหมายเลขผู้สมัครใช้บริการ โดยไม่มีเว้นวรรคหรือการจัดรูปแบบเพิ่มเติม เช่น - ถูกต้อง: "+15552220123" - ไม่ถูกต้อง: "+1 (555) 222-01234 x123" รูปแบบ ITU E.164 จำกัดหมายเลขโทรศัพท์หลังไว้ที่ 12 หลัก แต่ในทางปฏิบัติแล้ว ไม่ได้ทุกประเทศที่ใช้รูปแบบนี้ เราจึงผ่อนปรนข้อจำกัดนี้ ไม่อนุญาตให้ใช้หมายเลขภายในประเทศเท่านั้น ข้อมูลอ้างอิง: - https://www.itu.int/rec/T-REC-E.164-201011-I - https://en.wikipedia.org/wiki/E.164 - https://en.wikipedia.org/wiki/List_of_country_calling_codes |
short |
หมายเลขพิเศษ ข้อมูลอ้างอิง: - https://en.wikipedia.org/wiki/Short_code |
ShortCode
ออบเจ็กต์ที่แสดงถึงรหัสสั้น ซึ่งเป็นหมายเลขโทรศัพท์ที่มักจะสั้นกว่าหมายเลขโทรศัพท์ปกติมากและสามารถใช้เพื่อระบุข้อความในระบบ MMS และ SMS รวมถึงใช้สำหรับการโทรแบบย่อ (เช่น "ส่ง SMS ไปที่ 611 เพื่อดูจำนวนนาทีที่เหลือในแพ็กเกจ")
รหัสสั้นใช้ได้เฉพาะในภูมิภาคหนึ่งๆ และไม่สามารถโทรข้ามประเทศได้ ซึ่งหมายความว่ารหัสสั้นเดียวกันอาจใช้ได้ในภูมิภาคต่างๆ โดยมีการใช้งานและราคาที่แตกต่างกัน แม้ว่าภูมิภาคเหล่านั้นจะใช้รหัสการโทรในประเทศเดียวกัน (เช่น สหรัฐอเมริกาและแคนาดา) ก็ตาม
การแสดง JSON |
---|
{ "regionCode": string, "number": string } |
ช่อง | |
---|---|
region |
ต้องระบุ รหัสภูมิภาค BCP-47 ของสถานที่ที่โทรหาหมายเลขสั้นนี้ได้ เช่น "US" และ "BB" ข้อมูลอ้างอิง: - http://www.unicode.org/reports/tr35/#unicode_region_subtag |
number |
ต้องระบุ ตัวเลขของรหัสสั้นๆ โดยไม่มีเครื่องหมายบวก ('+') นําหน้าหรือรหัสการโทรระหว่างประเทศ เช่น "611" |
PhoneVerificationState
สถานะการยืนยันทางโทรศัพท์
Enum | |
---|---|
PHONE_VERIFICATION_STATE_UNSPECIFIED |
ค่าเริ่มต้น ค่านี้ไม่ได้ใช้งาน |
PHONE_VERIFICATION_STATE_VERIFIED |
โทรศัพท์ได้รับการยืนยันแล้ว |
PHONE_VERIFICATION_STATE_UNVERIFIED |
โทรศัพท์ไม่ได้รับการยืนยัน |
CustomerService
ข้อมูลฝ่ายบริการลูกค้า
การแสดง JSON |
---|
{
"uri": string,
"email": string,
"phone": {
object ( |
ช่อง | |
---|---|
uri |
ไม่บังคับ URI ที่พบฝ่ายบริการลูกค้า |
email |
ไม่บังคับ อีเมลสำหรับติดต่อฝ่ายบริการลูกค้า |
phone |
ไม่บังคับ หมายเลขโทรศัพท์สำหรับโทรหาฝ่ายบริการลูกค้า |
เมธอด |
|
---|---|
|
เรียกข้อมูลทางธุรกิจของบัญชี |
|
อัปเดตข้อมูลทางธุรกิจของบัญชี |