REST Resource: accounts.locations

แหล่งข้อมูล: สถานที่ตั้ง

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

การแสดง JSON 
{
  "name": string,
  "languageCode": string,
  "storeCode": string,
  "title": string,
  "phoneNumbers": {
    object (PhoneNumbers)
  },
  "categories": {
    object (Categories)
  },
  "storefrontAddress": {
    object (PostalAddress)
  },
  "websiteUri": string,
  "regularHours": {
    object (BusinessHours)
  },
  "specialHours": {
    object (SpecialHours)
  },
  "serviceArea": {
    object (ServiceAreaBusiness)
  },
  "labels": [
    string
  ],
  "adWordsLocationExtensions": {
    object (AdWordsLocationExtensions)
  },
  "latlng": {
    object (LatLng)
  },
  "openInfo": {
    object (OpenInfo)
  },
  "metadata": {
    object (Metadata)
  },
  "profile": {
    object (Profile)
  },
  "relationshipData": {
    object (RelationshipData)
  },
  "moreHours": [
    {
      object (MoreHours)
    }
  ],
  "serviceItems": [
    {
      object (ServiceItem)
    }
  ]
}
ช่อง
name

string

ตัวระบุของ Google สำหรับสถานที่ตั้งนี้ในรูปแบบ: locations/{locationId}
languageCode

string

เปลี่ยนแปลงไม่ได้ ภาษาของสถานที่ตั้ง ตั้งค่าในระหว่างการสร้างและอัปเดตไม่ได้
storeCode

string

ไม่บังคับ ตัวระบุภายนอกสำหรับสถานที่ตั้งนี้ ซึ่งต้องไม่ซ้ำกันภายในบัญชี นี่คือวิธีการเชื่อมโยงสถานที่กับบันทึกของคุณเอง
title

string

ต้องระบุ ชื่อสถานที่ตั้งควรสื่อถึงชื่อตามจริงของธุรกิจ ตรงตามที่ใช้เป็นประจำที่หน้าร้าน เว็บไซต์ และเครื่องเขียน รวมถึงเป็นชื่อที่ลูกค้ารู้จัก ข้อมูลเพิ่มเติมใดๆ ที่เกี่ยวข้องจะใส่ลงในช่องอื่นๆ ของทรัพยากรได้ (เช่น Address, Categories) อย่าเพิ่มข้อมูลที่ไม่จำเป็นลงในชื่อ (เช่น ใช้ "Google" แทน "Google Inc. - Mountain View Corporate Headquarters" อย่าใส่แท็กไลน์การตลาด, รหัสร้านค้า, สัญลักษณ์พิเศษ, เวลาทำการหรือสถานะเปิด/ปิด, หมายเลขโทรศัพท์, URL ของเว็บไซต์, ข้อมูลเกี่ยวกับบริการ/ผลิตภัณฑ์, สถานที่ตั้ง/ที่อยู่หรือเส้นทาง หรือข้อมูลที่เป็นการล้อมจับ (เช่น "ตู้เอทีเอ็มในกรุงเทพฯ")
phoneNumbers

object (PhoneNumbers)

ไม่บังคับ หมายเลขโทรศัพท์ต่างๆ ที่ลูกค้าสามารถใช้เพื่อติดต่อธุรกิจได้
categories

object (Categories)

ไม่บังคับ หมวดหมู่ต่างๆ ที่อธิบายธุรกิจ
storefrontAddress

object (PostalAddress)

ไม่บังคับ ที่อยู่ที่ถูกต้องและชัดเจนเพื่ออธิบายสถานที่ตั้งธุรกิจของคุณ ไม่อนุญาตให้ใช้ตู้ไปรษณีย์หรือตู้จดหมายซึ่งตั้งอยู่ห่างจากที่ตั้งธุรกิจ ขณะนี้คุณระบุค่า addressLines ได้สูงสุด 5 ค่าในที่อยู่ ควรตั้งค่าช่องนี้สำหรับธุรกิจที่มีหน้าร้านเท่านั้น ไม่ควรตั้งค่าช่องนี้สำหรับสถานที่ตั้งประเภท CUSTOMER_LOCATION_ONLY แต่หากมีการตั้งค่า ระบบจะทิ้งค่าที่ระบุไว้
websiteUri

string

ไม่บังคับ URL ของธุรกิจนี้ หากเป็นไปได้ ให้ใช้ URL ที่แสดงถึงที่ตั้งธุรกิจแต่ละแห่งนี้แทนเว็บไซต์/URL ทั่วไปที่แสดงถึงสถานที่ตั้งทั้งหมดหรือแบรนด์
regularHours

object (BusinessHours)

ไม่บังคับ เวลาทําการของธุรกิจ
specialHours

object (SpecialHours)

ไม่บังคับ เวลาทำการพิเศษของธุรกิจ ซึ่งโดยปกติจะรวมถึงเวลาทำการในวันหยุดและเวลาอื่นๆ นอกเวลาทำการปกติ ซึ่งจะลบล้างเวลาทำการปกติ ตั้งค่าฟิลด์นี้โดยไม่มีเวลาทำการปกติไม่ได้
serviceArea

object (ServiceAreaBusiness)

ไม่บังคับ ธุรกิจที่ให้บริการตามสถานที่ให้บริการในสถานที่ตั้งของลูกค้า หากธุรกิจนี้เป็นธุรกิจที่ให้บริการตามสถานที่ ฟิลด์นี้จะอธิบายพื้นที่ที่ธุรกิจให้บริการ
labels[]

string

ไม่บังคับ คอลเล็กชันสตริงรูปแบบอิสระเพื่อให้คุณติดแท็กธุรกิจได้ ป้ายกำกับเหล่านี้ไม่แสดงต่อผู้ใช้ มีเพียงคุณเท่านั้นที่เห็น ต้องมีอักขระ 1-255 ตัวต่อป้ายกำกับ
adWordsLocationExtensions

object (AdWordsLocationExtensions)

ไม่บังคับ ข้อมูลเพิ่มเติมที่แสดงใน AdWords
latlng

object (LatLng)

ไม่บังคับ ละติจูดและลองจิจูดที่ผู้ใช้ระบุ เมื่อสร้างตำแหน่ง ระบบจะละเว้นช่องนี้หากที่อยู่ที่ระบุเข้ารหัสพิกัดภูมิศาสตร์สำเร็จ ช่องนี้จะแสดงตามคำขอรับต่อเมื่อมีการยอมรับค่า latlng ที่ได้จากผู้ใช้ระหว่างการสร้าง หรือมีการอัปเดตค่า latlng ผ่านเว็บไซต์ Google Business Profile เฉพาะไคลเอ็นต์ที่ได้รับอนุมัติเท่านั้นที่จะอัปเดตช่องนี้ได้
openInfo

object (OpenInfo)

ไม่บังคับ ธงที่บ่งชี้ว่าสถานที่เปิดให้บริการอยู่หรือไม่
metadata

object (Metadata)

เอาต์พุตเท่านั้น ข้อมูลเพิ่มเติมที่ผู้ใช้แก้ไขไม่ได้
profile

object (Profile)

ไม่บังคับ อธิบายธุรกิจของคุณด้วยเสียงของคุณเอง และแชร์เรื่องราวที่เป็นเอกลักษณ์ของธุรกิจและข้อเสนอของคุณกับผู้ใช้

ต้องกรอกช่องนี้สำหรับทุกหมวดหมู่ ยกเว้นหมวดหมู่ที่พัก (เช่น โรงแรม โมเทล โรงแรมขนาดเล็ก)
relationshipData

object (RelationshipData)

ไม่บังคับ สถานที่และเครือทั้งหมดที่เกี่ยวข้องกับสถานที่นี้
moreHours[]

object (MoreHours)

ไม่บังคับ เวลาทําการเพิ่มเติมสําหรับแผนกต่างๆ หรือลูกค้าบางกลุ่ม
serviceItems[]

object (ServiceItem)

ไม่บังคับ รายชื่อบริการที่รองรับโดยผู้ขาย บริการนั้นอาจตัดผม ติดตั้งเครื่องทำน้ำอุ่น ฯลฯ ระบบจะนำรายการบริการที่ซ้ำออกโดยอัตโนมัติ

PhoneNumbers

คอลเล็กชันหมายเลขโทรศัพท์สำหรับธุรกิจ ในระหว่างการอัปเดต ต้องตั้งค่าทั้ง 2 ฟิลด์ ไคลเอ็นต์ไม่สามารถอัปเดตเฉพาะหมายเลขโทรศัพท์หลักหรือหมายเลขโทรศัพท์เพิ่มเติมโดยใช้มาสก์การอัปเดต ใช้รูปแบบหมายเลขโทรศัพท์ระหว่างประเทศ เช่น "+1 415 555 0132" ดูข้อมูลเพิ่มเติมใน (https://developers.google.com/style/phone-numbers#international-phone-numbers)

การแสดง JSON 
{
  "primaryPhone": string,
  "additionalPhones": [
    string
  ]
}
ช่อง
primaryPhone

string

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

string

ไม่บังคับ หมายเลขโทรศัพท์สูงสุด 2 หมายเลข (มือถือหรือโทรศัพท์บ้าน ไม่ใช่แฟกซ์) ที่ลูกค้าใช้โทรไปยังธุรกิจของคุณได้ นอกเหนือจากหมายเลขโทรศัพท์หลัก

หมวดหมู่

คอลเล็กชันของหมวดหมู่ที่อธิบายถึงธุรกิจ ในระหว่างการอัปเดต ต้องตั้งค่าทั้ง 2 ฟิลด์ ไม่อนุญาตให้ลูกค้าอัปเดตหมวดหมู่หลักหรือหมวดหมู่เพิ่มเติมทีละรายการโดยใช้มาสก์การอัปเดต

การแสดง JSON 
{
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ]
}
ช่อง
primaryCategory

object (Category)

ต้องระบุ หมวดหมู่ที่อธิบายธุรกิจหลักที่สถานที่นี้มีส่วนร่วมได้ดีที่สุด
additionalCategories[]

object (Category)

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

หมวดหมู่

หมวดหมู่ที่อธิบายว่าธุรกิจนี้คืออะไร (ไม่ใช่สิ่งที่ทำ) โปรดดูรายการรหัสหมวดหมู่ที่ถูกต้องและการแมปกับชื่อที่มนุษย์อ่านได้ที่ categories.list

การแสดง JSON 
{
  "name": string,
  "displayName": string,
  "serviceTypes": [
    {
      object (ServiceType)
    }
  ],
  "moreHoursTypes": [
    {
      object (MoreHoursType)
    }
  ]
}
ช่อง
name

string

ต้องระบุ รหัสแบบคงที่ (ระบุโดย Google) สำหรับหมวดหมู่นี้ ต้องระบุค่าเมื่อแก้ไขหมวดหมู่ (เมื่อสร้างหรืออัปเดตสถานที่ตั้ง)
displayName

string

เอาต์พุตเท่านั้น ชื่อหมวดหมู่ที่มนุษย์อ่านได้ ระบบจะตั้งค่านี้เมื่ออ่านตำแหน่ง ขณะแก้ไขสถานที่ตั้ง คุณต้องตั้งค่า category_id
serviceTypes[]

object (ServiceType)

เอาต์พุตเท่านั้น รายการบริการทุกประเภทที่ใช้ได้กับหมวดหมู่ธุรกิจนี้
moreHoursTypes[]

object (MoreHoursType)

เอาต์พุตเท่านั้น ประเภทเวลาทำการเพิ่มเติมที่ใช้ได้กับหมวดหมู่ธุรกิจนี้

ServiceType

ข้อความที่อธิบายประเภทบริการที่ธุรกิจเสนอ

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

string

เอาต์พุตเท่านั้น รหัสแบบคงที่ (มาจาก Google) สำหรับบริการประเภทนี้
displayName

string

เอาต์พุตเท่านั้น ชื่อที่แสดงที่มนุษย์อ่านได้สำหรับประเภทบริการ

MoreHoursType

ประเภทเวลาทำการเพิ่มเติมที่ธุรกิจนำเสนอได้นอกเหนือจากเวลาทำการปกติ

การแสดง JSON 
{
  "hoursTypeId": string,
  "displayName": string,
  "localizedDisplayName": string
}
ช่อง
hoursTypeId

string

เอาต์พุตเท่านั้น รหัสแบบคงที่ที่ Google มีให้สำหรับเวลาทำการประเภทนี้
displayName

string

เอาต์พุตเท่านั้น ชื่อที่แสดงที่เป็นภาษาอังกฤษซึ่งมนุษย์อ่านได้สำหรับประเภทเวลาทำการ
localizedDisplayName

string

เอาต์พุตเท่านั้น ชื่อที่แสดงซึ่งแปลเป็นภาษาท้องถิ่นซึ่งมนุษย์อ่านได้สำหรับประเภทเวลาทำการ

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

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

BusinessHours

แสดงระยะเวลาที่สถานที่นี้เปิดทำการอยู่ เก็บคอลเล็กชันของอินสแตนซ์ [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod]

การแสดง JSON 
{
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
ช่อง
periods[]

object (TimePeriod)

ต้องระบุ จำนวนครั้งที่สถานที่นี้เปิดทำการ แต่ละช่วงเวลาแสดงช่วงเวลาซึ่งสถานที่เปิดทำการในระหว่างสัปดาห์

TimePeriod

แสดงระยะเวลาที่ธุรกิจเปิดทำการ โดยเริ่มต้นจากวัน/เวลาเปิดทำการที่ระบุไว้และปิดทำการในวัน/เวลาปิดที่ระบุ เวลาปิดทำการต้องเกิดขึ้นหลังจากเวลาเปิด เช่น ในวันเดียวกันหรือวันถัดไป

การแสดง JSON 
{
  "openDay": enum (DayOfWeek),
  "openTime": {
    object (TimeOfDay)
  },
  "closeDay": enum (DayOfWeek),
  "closeTime": {
    object (TimeOfDay)
  }
}
ช่อง
openDay

enum (DayOfWeek)

ต้องระบุ ระบุday of the week ช่วงเวลานี้จะเริ่มใน
openTime

object (TimeOfDay)

ต้องระบุ ค่าที่ใช้ได้คือ 00:00-24:00 โดย 24:00 แทนเที่ยงคืนของตอนท้ายของวันที่ระบุ
closeDay

enum (DayOfWeek)

ต้องระบุ บ่งบอกว่าเป็นวันday of the weekที่ช่วงเวลานี้จะสิ้นสุด
closeTime

object (TimeOfDay)

ต้องระบุ ค่าที่ใช้ได้คือ 00:00-24:00 โดย 24:00 แทนเที่ยงคืนของตอนท้ายของวันที่ระบุ

วันของสัปดาห์

แสดงวันของสัปดาห์

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

integer

ชั่วโมงของวันในรูปแบบ 24 ชั่วโมง ควรอยู่ในช่วง 0 ถึง 23 API อาจเลือกอนุญาตค่า "24:00:00" สำหรับสถานการณ์ต่างๆ เช่น เวลาปิดทำการ
minutes

integer

นาทีต่อชั่วโมง ต้องอยู่ระหว่าง 0 ถึง 59
seconds

integer

เวลาเป็นวินาที โดยปกติต้องอยู่ระหว่าง 0 ถึง 59 API อาจอนุญาตให้ใช้ค่า 60 หากอนุญาตให้มีวินาทีอธิกวาร
nanos

integer

เศษส่วนของวินาทีในหน่วยนาโนวินาที ต้องมีค่าตั้งแต่ 0 ถึง 999,999,999

SpecialHours

แสดงชุดระยะเวลาที่เวลาทำการของสถานที่ตั้งแตกต่างจากเวลาทำการปกติ

การแสดง JSON 
{
  "specialHourPeriods": [
    {
      object (SpecialHourPeriod)
    }
  ]
}
ช่อง
specialHourPeriods[]

object (SpecialHourPeriod)

ต้องระบุ รายการข้อยกเว้นสำหรับเวลาทำการปกติของธุรกิจ

SpecialHourPeriod

แสดงช่วงเวลาเดียวที่เวลาทำการของสถานที่ต่างจากเวลาทำการปกติ ช่วงเวลาพิเศษต้องแสดงช่วงเวลาน้อยกว่า 24 ชั่วโมง openTime และ startDate ต้องมาก่อน closeTime และ endDate closeTime และ endDate สามารถขยายเวลาจนถึง 11: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 (Date)
  },
  "openTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "closeTime": {
    object (TimeOfDay)
  },
  "closed": boolean
}
ช่อง
startDate

object (Date)

ต้องระบุ วันที่ในปฏิทินช่วงเวลาทำการพิเศษนี้จะเริ่มต้น
openTime

object (TimeOfDay)

ไม่บังคับ ค่าที่ใช้ได้คือ 00:00-24:00 โดย 24:00 แทนเที่ยงคืนของตอนท้ายของช่องวันที่ระบุ ต้องระบุหาก closed เป็นเท็จ
endDate

object (Date)

ไม่บังคับ วันที่ตามปฏิทินของช่วงเวลาพิเศษนี้จะสิ้นสุด หากไม่ได้ตั้งค่าช่อง endDate ค่าเริ่มต้นจะเป็นวันที่ที่ระบุใน startDate หากมีการตั้งค่า ช่องนี้ต้องเท่ากับหรือมากกว่า 1 วันหลังจาก startDate
closeTime

object (TimeOfDay)

ไม่บังคับ ค่าที่ใช้ได้คือ 00:00-24:00 โดย 24:00 แทนเที่ยงคืนของตอนท้ายของช่องวันที่ระบุ ต้องระบุหาก closed เป็นเท็จ
closed

boolean

ไม่บังคับ หากเป็น "จริง" ระบบจะไม่สนใจ endDate, openTime และ closeTime และวันที่ที่ระบุใน startDate จะถือเป็นปิดสถานที่ทั้งวัน

วันที่

แสดงวันที่ในปฏิทินบางส่วนหรือทั้งหมด เช่น วันเกิด มีการระบุเวลาของวันและเขตเวลาไว้ที่อื่นหรือไม่มีนัยสำคัญ วันที่จะสัมพันธ์กับปฏิทินเกรกอเรียน ซึ่งอาจเป็นอย่างใดอย่างหนึ่งต่อไปนี้

  • วันที่แบบเต็ม โดยมีค่าปี เดือน และวันที่ไม่ใช่ 0
  • 1 เดือนและวัน โดยมี 0 ปี (เช่น วันครบรอบ)
  • ปีหนึ่งๆ มี 0 เดือนและมี 0 วัน
  • 1 ปีและเดือน โดยมี 0 วัน (เช่น วันที่หมดอายุของบัตรเครดิต)

ประเภทที่เกี่ยวข้อง:

การแสดง JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
ช่อง
year

integer

ปีของวันที่ ต้องเป็นตัวเลขตั้งแต่ 1 ถึง 9999 หรือ 0 เพื่อระบุวันที่ที่ไม่มีปี
month

integer

เดือนของปี ต้องมีค่าตั้งแต่ 1 ถึง 12 หรือ 0 เพื่อระบุปีที่ไม่มีเดือนและวัน
day

integer

วันของเดือน ต้องมีค่าตั้งแต่ 1 ถึง 31 และจะใช้ได้สำหรับปีและเดือน หรือ 0 เพื่อระบุปีเพียงอย่างเดียว หรือ 1 ปีและเดือนที่วันไม่มีนัยสำคัญ

ServiceAreaBusiness

ธุรกิจที่ให้บริการตามสถานที่ให้บริการในสถานที่ตั้งของลูกค้า (เช่น ช่างทำกุญแจหรือช่างประปา)

การแสดง JSON 
{
  "businessType": enum (BusinessType),
  "places": {
    object (Places)
  },
  "regionCode": string
}
ช่อง
businessType

enum (BusinessType)

ต้องระบุ ระบุ [type] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] ของธุรกิจที่ให้บริการตามสถานที่
places

object (Places)

พื้นที่ที่ธุรกิจนี้ให้บริการนั้นระบุผ่านกลุ่มสถานที่
regionCode

string

เปลี่ยนแปลงไม่ได้ รหัสภูมิภาค 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 (PlaceInfo)
    }
  ]
}
ช่อง
placeInfos[]

object (PlaceInfo)

พื้นที่ที่แสดงด้วยรหัสสถานที่ จำกัดไว้ที่สูงสุด 20 สถานที่

PlaceInfo

กำหนดพื้นที่ที่แสดงด้วยรหัสสถานที่

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

string

ต้องระบุ ชื่อที่แปลแล้วของสถ านที่ เช่น Scottsdale, AZ
placeId

string

ต้องระบุ รหัสของสถานที่ ต้องตรงกับภูมิภาค (https://developers.google.com/places/web-service/supported_types#table3)

AdWordsLocationExtensions

ข้อมูลเพิ่มเติมที่แสดงใน AdWords

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

string

ต้องระบุ หมายเลขโทรศัพท์สำรองที่จะแสดงในส่วนขยายสถานที่ตั้งของ AdWords แทนที่จะเป็นหมายเลขโทรศัพท์หลักของสถานที่ตั้ง

LatLng

วัตถุที่แสดงคู่ละติจูด/ลองจิจูด ค่านี้จะแสดงเป็นคู่ของค่าคู่เพื่อแสดงองศาละติจูดและลองจิจูด ออบเจ็กต์นี้ต้องเป็นไปตาม มาตรฐาน WGS84 เว้นแต่จะระบุไว้เป็นอย่างอื่น ค่าต้องอยู่ในช่วงมาตรฐาน

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

number

ละติจูด หน่วยเป็นองศา โดยต้องอยู่ในช่วง [-90.0, +90.0]
longitude

number

ลองจิจูด หน่วยเป็นองศา โดยต้องอยู่ในช่วง [-180.0, +180.0]

OpenInfo

ข้อมูลเกี่ยวกับสถานะการเปิดของธุรกิจ

การแสดง JSON 
{
  "status": enum (OpenForBusiness),
  "canReopen": boolean,
  "openingDate": {
    object (Date)
  }
}
ช่อง
status

enum (OpenForBusiness)

ต้องระบุ ระบุว่าสถานที่เปิดให้บริการอยู่หรือไม่ สถานที่ทั้งหมดจะเปิดโดยค่าเริ่มต้น เว้นแต่จะอัปเดตให้ปิด
canReopen

boolean

เอาต์พุตเท่านั้น ระบุว่าธุรกิจนี้มีสิทธิ์กลับมาเปิดให้บริการอีกครั้งหรือไม่
openingDate

object (Date)

ไม่บังคับ วันที่เปิดสถานที่เป็นครั้งแรก หากไม่ทราบวันที่ที่แน่นอน คุณจะระบุได้เฉพาะเดือนและปี วันที่ต้องเป็นวันที่ที่ผ่านมาแล้วหรือไม่เกิน 1 ปีนับจากปัจจุบัน

OpenForBusiness

ระบุสถานะของสถานที่

Enum
OPEN_FOR_BUSINESS_UNSPECIFIED ไม่ได้ระบุ
OPEN บ่งบอกว่าสถานที่เปิดอยู่
CLOSED_PERMANENTLY ระบุว่าสถานที่ปิดถาวรแล้ว
CLOSED_TEMPORARILY บ่งบอกว่าสถานที่นี้ปิดชั่วคราวแล้ว

ข้อมูลเมตา

ข้อมูลเพิ่มเติมที่ผู้ใช้แก้ไขไม่ได้เกี่ยวกับสถานที่ตั้ง

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

boolean

เอาต์พุตเท่านั้น ระบุว่ารหัสสถานที่ที่เชื่อมโยงกับสถานที่นี้มีการอัปเดตที่จำเป็นต้องอัปเดตหรือปฏิเสธโดยไคลเอ็นต์หรือไม่ หากมีการตั้งค่าบูลีนนี้ คุณควรเรียกใช้เมธอด getGoogleUpdated เพื่อค้นหาข้อมูลที่ต้องยืนยัน
hasPendingEdits

boolean

เอาต์พุตเท่านั้น ระบุว่าพร็อพเพอร์ตี้ของสถานที่นี้อยู่ในสถานะรอดำเนินการแก้ไขหรือไม่
canDelete

boolean

เอาต์พุตเท่านั้น ระบุว่าจะลบสถานที่โดยใช้ API ได้หรือไม่
canOperateLocalPost

boolean

เอาต์พุตเท่านั้น ระบุว่าข้อมูลจัดการโพสต์ในเครื่องได้หรือไม่
canModifyServiceList

boolean

เอาต์พุตเท่านั้น ระบุว่าข้อมูลแก้ไขรายการบริการได้หรือไม่
canHaveFoodMenus

boolean

เอาต์พุตเท่านั้น ระบุว่าข้อมูลมีสิทธิ์ใช้เมนูอาหารหรือไม่
canOperateHealthData

boolean

เอาต์พุตเท่านั้น ระบุว่าสถานที่ตั้งนั้นดำเนินการเกี่ยวกับข้อมูลสุขภาพได้หรือไม่
canOperateLodgingData

boolean

เอาต์พุตเท่านั้น ระบุว่าสถานที่ให้บริการข้อมูลที่พักได้หรือไม่
placeId

string

เอาต์พุตเท่านั้น หากสถานที่นี้ปรากฏใน Google Maps ช่องนี้จะมีรหัสสถานที่ของตำแหน่งปรากฏขึ้น รหัสนี้สามารถใช้ใน API ของ Places ได้หลายชนิด

คุณสามารถตั้งค่าช่องนี้ในระหว่างการสร้างการเรียก แต่ตั้งค่าสำหรับการอัปเดตไม่ได้
duplicateLocation

string

เอาต์พุตเท่านั้น ทรัพยากรสถานที่ที่สถานที่นี้ซ้ำกัน
mapsUri

string

เอาต์พุตเท่านั้น ลิงก์ไปยังสถานที่ใน Maps
newReviewUri

string

เอาต์พุตเท่านั้น ลิงก์ไปยังหน้าใน Google Search ซึ่งลูกค้าสามารถเขียนรีวิวสำหรับสถานที่ตั้งได้
canHaveBusinessCalls

boolean

เอาต์พุตเท่านั้น ระบุว่าข้อมูลมีสิทธิ์ใช้การโทรของธุรกิจหรือไม่
hasVoiceOfMerchant

boolean

เอาต์พุตเท่านั้น ระบุว่าข้อมูลมี Voice of Merchant หรือไม่ หากบูลีนนี้เป็นเท็จ คุณควรเรียกใช้ locations.getVoiceOfMerchantState API เพื่อดูรายละเอียดว่าเหตุใดโดเมนเหล่านี้จึงไม่มี Voice of Merchant

โปรไฟล์

ข้อมูลทั้งหมดที่เกี่ยวข้องกับโปรไฟล์ของตำแหน่ง

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

string

ต้องระบุ คำอธิบายสถานที่ด้วยเสียงของคุณเอง คนอื่นแก้ไขไม่ได้

RelationshipData

ข้อมูลของสถานที่หลักและย่อยทั้งหมดที่เกี่ยวข้องกับสถานที่นี้

การแสดง JSON 
{
  "parentLocation": {
    object (RelevantLocation)
  },
  "childrenLocations": [
    {
      object (RelevantLocation)
    }
  ],
  "parentChain": string
}
ช่อง
parentLocation

object (RelevantLocation)

สถานที่ตั้งหลักที่สถานที่นี้มีความสัมพันธ์ด้วย
childrenLocations[]

object (RelevantLocation)

รายการสถานที่ตั้งย่อยที่สถานที่นี้มีความสัมพันธ์ด้วย
parentChain

string

ชื่อทรัพยากรของเชนที่สถานที่นี้เป็นสมาชิกอยู่ [วิธีค้นหารหัสเชน] [Locations.SearchChains]

RelevantLocation

ข้อมูลเกี่ยวกับสถานที่อื่นที่เกี่ยวข้องกับสถานที่ปัจจุบัน ความสัมพันธ์อาจเป็น DEPARTMENT_OF หรือ INDEPENDENT_ESTABLISHMENT_OF ใดก็ได้ และสถานที่ตั้งที่ระบุที่นี่อาจอยู่ในฝั่งใดฝั่งหนึ่ง (หลัก/ย่อย) ของสถานที่ตั้ง

การแสดง JSON 
{
  "placeId": string,
  "relationType": enum (RelationType)
}
ช่อง
placeId

string

ต้องระบุ ระบุตำแหน่งที่อยู่อีกด้านหนึ่งของความสัมพันธ์ด้วยรหัสสถานที่
relationType

enum (RelationType)

ต้องระบุ ประเภทของความสัมพันธ์

RelationType

ความสัมพันธ์ของประเภทที่จะต้องระบุ

Enum
RELATION_TYPE_UNSPECIFIED ยังไม่ระบุประเภท
DEPARTMENT_OF ข้อมูลนี้แสดงถึงความสัมพันธ์ระหว่างสถานที่ 2 แห่งที่มีพื้นที่ทางกายภาพเดียวกัน ใช้แบรนด์/การจัดการ/องค์กรระดับบนเดียวกัน แต่มีแอตทริบิวต์หลักต่างกัน เช่น เวลาทำการหรือหมายเลขโทรศัพท์ ตัวอย่างเช่น Costco Pharmacy เป็นแผนกใน Costco Wholesale
INDEPENDENT_ESTABLISHMENT_IN ซึ่งแสดงในกรณีที่สถานที่ตั้ง 2 แห่งตั้งอยู่ร่วมกันในสถานที่ตั้งจริงเดียวกัน แต่มาจากบริษัทที่ต่างกัน (เช่น Starbucks ใน Safeway ร้านค้าในห้างสรรพสินค้า)

MoreHours

ระยะเวลาที่สถานที่เปิดทำการสำหรับธุรกิจบางประเภท

การแสดง JSON 
{
  "hoursTypeId": string,
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
ช่อง
hoursTypeId

string

ต้องระบุ ประเภทเวลาทำการ ลูกค้าควรโทรหา {#link businessCategory:BatchGet} เพื่อรับประเภทเวลาทำการที่รองรับตามหมวดหมู่ของสถานที่ตั้ง
periods[]

object (TimePeriod)

ต้องระบุ จำนวนครั้งที่สถานที่นี้เปิดทำการ แต่ละช่วงเวลาแสดงช่วงเวลาซึ่งสถานที่เปิดทำการในระหว่างสัปดาห์

ServiceItem

ข้อความที่อธิบายรายการบริการเดียว ซึ่งใช้เพื่ออธิบายประเภทบริการที่ผู้ขายมีให้ ตัวอย่างเช่น การตัดผมเป็นบริการหนึ่ง

การแสดง JSON 
{
  "price": {
    object (Money)
  },

  // Union field service_item_info can be only one of the following:
  "structuredServiceItem": {
    object (StructuredServiceItem)
  },
  "freeFormServiceItem": {
    object (FreeFormServiceItem)
  }
  // End of list of possible types for union field service_item_info.
}
ช่อง
price

object (Money)

ไม่บังคับ แสดงราคาเป็นตัวเงินของรายการบริการ เราขอแนะนำให้ตั้งค่า currencyCode และหน่วยเมื่อระบุราคา ซึ่งจะถือว่าเป็นราคาคงที่สำหรับบริการ
ช่องการรวม service_item_info ควรตั้งค่าช่องใดช่องหนึ่งต่อไปนี้เสมอ service_item_info ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
structuredServiceItem

object (StructuredServiceItem)

ไม่บังคับ ช่องนี้จะกำหนดลักษณะตัวพิมพ์ของข้อมูลบริการที่มีโครงสร้าง
freeFormServiceItem

object (FreeFormServiceItem)

ไม่บังคับ ช่องนี้จะเป็นการตั้งค่าลักษณะตัวจำลองของข้อมูลบริการรูปแบบอิสระ

StructuredServiceItem

หมายถึงบริการที่มีโครงสร้างซึ่งผู้ขายเสนอ เช่น toilet_installation

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

string

ต้องระบุ ช่อง serviceTypeId คือรหัสที่ไม่ซ้ำกันที่ Google ให้ไว้ซึ่งพบใน ServiceType ข้อมูลนี้มาจากบริการ RPC ของ categories.batchGet
description

string

ไม่บังคับ คำอธิบายรายการบริการที่มีโครงสร้าง จํานวนอักขระสูงสุดคือ 300 ตัว

FreeFormServiceItem

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

การแสดง JSON 
{
  "category": string,
  "label": {
    object (Label)
  }
}
ช่อง
category

string

ต้องระบุ ฟิลด์นี้จะแสดงชื่อหมวดหมู่ (เช่น รหัสแบบคงที่ของหมวดหมู่) category และ serviceTypeId ควรตรงกับชุดค่าผสมที่เป็นไปได้ที่ระบุไว้ในข้อความ Category
label

object (Label)

ต้องระบุ ป้ายกำกับที่ติดแท็กภาษาสำหรับรายการ เราขอแนะนำว่าชื่อสินค้าควรมีอักขระไม่เกิน 140 ตัว และคำอธิบายที่มีอักขระไม่เกิน 250 ตัว ควรตั้งค่าช่องนี้เฉพาะเมื่ออินพุตเป็นรายการบริการที่กำหนดเอง ประเภทบริการที่เป็นมาตรฐานควรอัปเดตผ่าน serviceTypeId

ป้ายกำกับ

ป้ายกำกับที่จะใช้เมื่อแสดงรายการราคา ส่วน หรือสินค้า

การแสดง JSON 
{
  "displayName": string,
  "description": string,
  "languageCode": string
}
ช่อง
displayName

string

ต้องระบุ ชื่อที่แสดงสำหรับรายการราคา ส่วน หรือสินค้า
description

string

ไม่บังคับ คําอธิบายรายการราคา ส่วน หรือสินค้า
languageCode

string

ไม่บังคับ รหัสภาษา BCP-47 ที่สตริงเหล่านี้มีผลบังคับใช้ ตั้งค่าป้ายกำกับได้เพียง 1 ชุดต่อภาษาเท่านั้น

เงินทอง

แสดงจำนวนเงินพร้อมประเภทสกุลเงิน

การแสดง JSON 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
ช่อง
currencyCode

string

รหัสสกุลเงิน 3 ตัวอักษรที่กำหนดไว้ใน ISO 4217
units

string (int64 format)

หน่วยทั้งหมดของจำนวนเงิน เช่น หาก currencyCode เท่ากับ "USD" 1 หน่วยจะเป็น 1 ดอลลาร์สหรัฐ
nanos

integer

จำนวนหน่วยนาโน (10^-9) ของปริมาณ โดยค่าต้องอยู่ระหว่าง -999,999,999 ถึง +999,999,999 หาก units เป็นค่าบวก nanos ต้องเป็นค่าบวกหรือเป็น 0 หาก units เป็น 0 nanos อาจเป็นค่าบวก 0 หรือค่าลบ หาก units เป็นค่าลบ nanos ต้องเป็นค่าลบหรือ 0 เช่น $-1.75 จะแสดงเป็น units=-1 และ nanos=-750,000,000

เมธอด

create

 สร้างตำแหน่งใหม่ที่เป็นของผู้ใช้ที่เข้าสู่ระบบ

list

 แสดงสถานที่ตั้งสำหรับบัญชีที่ระบุ