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

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

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

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

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

PhoneNumber

วัตถุที่แสดงถึงหมายเลขโทรศัพท์ ซึ่งเหมาะสำหรับรูปแบบสาย 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)

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