BusinessInfo

การรวบรวมข้อมูลที่เกี่ยวข้องกับธุรกิจ

การแสดง JSON 
{
  "name": string,
  "address": {
    object (PostalAddress)
  },
  "phone": {
    object (PhoneNumber)
  },
  "phoneVerificationState": enum (PhoneVerificationState),
  "customerService": {
    object (CustomerService)
  }
}
ช่อง
name

string

ตัวระบุ ชื่อทรัพยากรของข้อมูลธุรกิจ รูปแบบ: accounts/{account}/businessInfo
address

object (PostalAddress)

ไม่บังคับ ที่อยู่ของธุรกิจ
phone

object (PhoneNumber)

เอาต์พุตเท่านั้น หมายเลขโทรศัพท์ของธุรกิจ
phoneVerificationState

enum (PhoneVerificationState)

เอาต์พุตเท่านั้น สถานะการยืนยันทางโทรศัพท์ของธุรกิจ
customerService

object (CustomerService)

ไม่บังคับ ฝ่ายบริการลูกค้าของธุรกิจ

PostalAddress

แสดงที่อยู่ไปรษณีย์ เช่น สำหรับที่อยู่ไปรษณีย์หรือที่อยู่การชำระเงิน หากใช้ที่อยู่ไปรษณีย์ บริการไปรษณีย์จะนำส่งสินค้าไปยังสถานที่ตั้งของ P.O ได้ กล่องหรือสิ่งอื่นที่คล้ายกัน ไม่ได้มีไว้เพื่อสร้างแบบจำลองตำแหน่งทางภูมิศาสตร์ (ถนน เมือง ภูเขา)

ในการใช้งานโดยทั่วไป ที่อยู่จะสร้างขึ้นผ่านข้อมูลจากผู้ใช้หรือจากการนำเข้าข้อมูลที่มีอยู่ ทั้งนี้ขึ้นอยู่กับประเภทของกระบวนการ

คำแนะนำเกี่ยวกับการป้อน / การแก้ไขที่อยู่: - ใช้วิดเจ็ตที่อยู่ที่รองรับการปรับให้เป็นสากล เช่น 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

integer

การแก้ไขสคีมาของ PostalAddress โดยต้องตั้งค่าเป็น 0 ซึ่งเป็นรุ่นล่าสุด

การแก้ไขใหม่ทั้งหมดต้องเข้ากันได้กับการแก้ไขเก่า
regionCode

string

ต้องระบุ รหัสภูมิภาค CLDR ของประเทศ/ภูมิภาคของที่อยู่ ข้อมูลนี้ไม่ได้มีการอนุมานแต่อย่างใด และขึ้นอยู่กับผู้ใช้ที่จะตรวจสอบว่าค่าถูกต้อง ดูรายละเอียดได้ที่ https://cldr.unicode.org/ และ https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html ตัวอย่างเช่น "CH" สำหรับสวิตเซอร์แลนด์
languageCode

string

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

หากไม่ทราบค่านี้ ก็ควรละเว้น (แทนที่จะระบุค่าเริ่มต้นที่อาจไม่ถูกต้อง)

เช่น "zh-Hant", "ja", "ja-Latn", "en"
postalCode

string

ไม่บังคับ รหัสไปรษณีย์ของที่อยู่ บางประเทศอาจไม่ได้ใช้หรือกำหนดให้มีการแสดงรหัสไปรษณีย์ แต่ประเทศที่ใช้รหัสเหล่านี้อาจทำให้มีการตรวจสอบเพิ่มเติมกับส่วนอื่นๆ ของที่อยู่ (เช่น การตรวจสอบรัฐ/รหัสไปรษณีย์ในสหรัฐอเมริกา)
sortingCode

string

ไม่บังคับ รหัสการจัดเรียงเพิ่มเติม รหัสเฉพาะประเทศ ซึ่งไม่มีใช้ในภูมิภาคส่วนใหญ่ ในที่ที่ใช้ ค่าอาจเป็นสตริง เช่น "CEDEX" ซึ่งอาจจะตามด้วยตัวเลข (เช่น "CEDEX 7") หรือเป็นเพียงตัวเลขเพียงอย่างเดียวซึ่งเป็นตัวแทนของ "รหัสเซกเตอร์" (จาเมกา), "ดัชนีพื้นที่นำส่ง" (มาลาวี) หรือ "ตัวบ่งชี้ที่ทำการไปรษณีย์" (เช่น โกตดิวัวร์)
administrativeArea

string

ไม่บังคับ เขตการปกครองสูงสุด ซึ่งใช้สำหรับที่อยู่ทางไปรษณีย์ของประเทศหรือภูมิภาค ตัวอย่างเช่น อาจเป็นรัฐ จังหวัด แคว้น หรือจังหวัด โดยเฉพาะอย่างยิ่งสำหรับสเปน ประเทศนี้เป็นจังหวัด ไม่ใช่ชุมชนปกครองตนเอง (เช่น "บาร์เซโลนา" ไม่ใช่ "คาตาโลเนีย") มีหลายประเทศไม่ใช้เขตบริหารในที่อยู่ทางไปรษณีย์ เช่น ในสวิตเซอร์แลนด์ ข้อมูลนี้ไม่ควรถูกปล่อยไว้
locality

string

ไม่บังคับ โดยทั่วไปหมายถึงส่วนเมืองของที่อยู่ ตัวอย่าง: เมืองในสหรัฐอเมริกา, เขตไอที, เมืองไปรษณีย์ของสหราชอาณาจักร ในภูมิภาคของโลกที่ไม่มีการกำหนดพื้นที่ไว้อย่างดีหรือไม่เหมาะสมกับโครงสร้างนี้ ให้ปล่อยย่านนั้นว่างไว้และใช้บรรทัดที่อยู่
sublocality

string

ไม่บังคับ สถานที่ตั้งย่อยของที่อยู่ ตัวอย่างเช่น ย่านใกล้เคียง เขตเมือง เขตต่างๆ
addressLines[]

string

บรรทัดที่อยู่ที่ไม่มีโครงสร้างซึ่งอธิบายถึงระดับที่ต่ำกว่าของที่อยู่

เนื่องจากค่าใน addressLines ไม่มีข้อมูลประเภท และบางครั้งอาจมีค่าหลายค่าในช่องเดียว (เช่น "Austin, TX") ดังนั้นจึงจำเป็นที่การเรียงลำดับบรรทัดจะต้องชัดเจน ลำดับของบรรทัดที่อยู่ควรเป็น "ลำดับซองจดหมาย" สำหรับประเทศ/ภูมิภาคของที่อยู่ ในพื้นที่ที่อาจแตกต่างกันไป (เช่น ญี่ปุ่น) ระบบจะใช้ address_language เพื่อทำให้ชัดเจน (เช่น "ja" สำหรับการสั่งซื้อจากใหญ่ไปเล็ก และ "ja-Latn" หรือ "en" สำหรับเล็กไปใหญ่) วิธีนี้จะช่วยให้เลือกบรรทัดของที่อยู่ที่เจาะจงที่สุดตามภาษาได้

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

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

string

ไม่บังคับ ผู้รับในที่อยู่ ในบางกรณี ช่องนี้อาจมีข้อมูลหลายบรรทัด เช่น อาจมีคำว่า "ดูแล"

organization

string

ไม่บังคับ ชื่อขององค์กรตามที่อยู่

หมายเลขโทรศัพท์

วัตถุที่แสดงถึงหมายเลขโทรศัพท์ ซึ่งเหมาะสำหรับรูปแบบสาย 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 kind can be only one of the following:
  "e164Number": string,
  "shortCode": {
    object (ShortCode)
  }
  // End of list of possible types for union field kind.
}
ช่อง
extension

string

ส่วนขยายของหมายเลขโทรศัพท์ ส่วนขยายไม่มีการกำหนดมาตรฐานในคำแนะนำของ ITU ยกเว้นการกำหนดเป็นชุดตัวเลขโดยมีความยาวได้สูงสุด 40 หลัก นอกเหนือจากตัวเลขแล้ว อักขระโทรออกอื่นๆ เช่น ',' (ระบุว่ารอ) หรือ "#" อาจจัดเก็บไว้ที่นี่

โปรดทราบว่าขณะนี้ไม่มีภูมิภาคใดที่ใช้ส่วนขยายที่มีรหัสสั้น ดังนั้น ปกติฟิลด์นี้จะตั้งค่าร่วมกับหมายเลข E.164 เท่านั้น หมายเลขนี้ถือแยกต่างหากจากหมายเลข E.164 เพื่อให้สามารถใช้ส่วนขยายโค้ดแบบสั้นได้ในอนาคต
ช่องการรวม kind ต้องระบุ หมายเลขปกติหรือรหัสแบบสั้น อาจมีการเพิ่มฟิลด์ใหม่ไปยังฟิลด์ใดฟิลด์หนึ่งด้านล่างในอนาคต ดังนั้น ไคลเอ็นต์จึงไม่ควรสนใจหมายเลขโทรศัพท์ที่ไม่มีการตั้งค่าฟิลด์ที่พวกเขาเขียนโค้ดไว้ kind ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
e164Number

string

หมายเลขโทรศัพท์ที่แสดงเป็นเครื่องหมายบวกนำหน้า ("+") ตามด้วยหมายเลขโทรศัพท์ที่ใช้รูปแบบ 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
shortCode

object (ShortCode)

รหัสสั้น

ข้อมูลอ้างอิง: https://en.wikipedia.org/wiki/Short_code

ShortCode

ออบเจ็กต์ที่แสดงรหัสสั้นๆ ซึ่งโดยทั่วไปจะเป็นหมายเลขโทรศัพท์ที่สั้นกว่าหมายเลขโทรศัพท์ปกติมาก และสามารถใช้เพื่อส่งข้อความในระบบ MMS และ SMS รวมถึงการโทรแบบย่อ (เช่น "ส่งข้อความ 611 เพื่อดูเวลาที่เหลือในแพ็กเกจของคุณ")

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

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

string

ต้องระบุ รหัสภูมิภาค BCP-47 ของสถานที่ตั้งที่สามารถโทรไปยังหมายเลขพิเศษนี้ได้ เช่น "US" และ "BB"

ข้อมูลอ้างอิง: - http://www.unicode.org/reports/tr35/#unicode_region_subtag
number

string

ต้องระบุ เลขรหัสแบบสั้นที่ไม่มีเครื่องหมายบวก ("+") นำหน้า หรือรหัสประเทศ เช่น "611"

PhoneVerificationState

สถานะการยืนยันทางโทรศัพท์

Enum
PHONE_VERIFICATION_STATE_UNSPECIFIED ค่าเริ่มต้น ค่านี้ไม่ได้ใช้
PHONE_VERIFICATION_STATE_VERIFIED ยืนยันโทรศัพท์แล้ว
PHONE_VERIFICATION_STATE_UNVERIFIED โทรศัพท์เครื่องนี้ไม่ได้รับการยืนยัน

CustomerService

ข้อมูลฝ่ายบริการลูกค้า

การแสดง JSON 
{
  "uri": string,
  "email": string,
  "phone": {
    object (PhoneNumber)
  }
}
ช่อง
uri

string

ไม่บังคับ URI ตำแหน่งที่อาจมีฝ่ายบริการลูกค้า
email

string

ไม่บังคับ อีเมลที่ใช้ติดต่อฝ่ายบริการลูกค้า
phone

object (PhoneNumber)

ไม่บังคับ หมายเลขโทรศัพท์ที่ใช้โทรหาฝ่ายบริการลูกค้า