REST Resource: accounts.businessInfo

ทรัพยากร: BusinessInfo

ข้อความ BusinessInfo มีข้อมูลสำคัญเกี่ยวกับธุรกิจของผู้ขาย

ข้อความนี้จะบันทึกรายละเอียดทางธุรกิจที่สำคัญ เช่น ที่อยู่จริง ข้อมูลติดต่อฝ่ายบริการลูกค้า และตัวระบุเฉพาะภูมิภาค

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

string

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

address

object (PostalAddress)

ไม่บังคับ ที่อยู่ของธุรกิจ ระบบรองรับเฉพาะช่อง regionCode, addressLines, postalCode, administrativeArea และ locality ระบบจะละเว้นช่องอื่นๆ ทั้งหมด

phone

object (PhoneNumber)

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

phoneVerificationState

enum (PhoneVerificationState)

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

customerService

object (CustomerService)

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

koreanBusinessRegistrationNumber

string

ไม่บังคับ หมายเลขจดทะเบียนธุรกิจของเกาหลี 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

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

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

sublocality

string

ไม่บังคับ เขตท้องที่ของที่อยู่ เช่น อาจเป็นย่าน เขต เขต

addressLines[]

string

บรรทัดที่อยู่ที่ไม่เป็นโครงสร้างซึ่งอธิบายที่อยู่ในระดับล่าง

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

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

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

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 รวมถึงใช้สำหรับการโทรแบบย่อ (เช่น "ส่ง SMS ไปที่ 611 เพื่อดูจำนวนนาทีที่เหลือในแพ็กเกจ")

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

การแสดง 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)

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

เมธอด

getBusinessInfo

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

updateBusinessInfo

อัปเดตข้อมูลทางธุรกิจของบัญชี