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 ของเว็บไซต์ ข้อมูลสินค้า สถานที่ตั้ง/ที่อยู่หรือเส้นทาง หรือข้อมูลสถานที่ตั้ง (เช่น "ตู้เอทีเอ็มของ Chase ใน Duane Reade")
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)

ไม่บังคับ ละติจูดและลองจิจูดที่ผู้ใช้ระบุ เมื่อสร้างสถานที่ตั้ง ระบบจะไม่สนใจช่องนี้หากที่อยู่ที่ระบุเข้ารหัสพิกัดภูมิศาสตร์สำเร็จ ระบบจะแสดงผลช่องนี้ในคำขอ GET เท่านั้น หากค่า 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

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

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

คำแนะนำในการป้อนหรือแก้ไขที่อยู่

  • ใช้วิดเจ็ตที่อยู่ซึ่งพร้อมสำหรับการปรับให้เข้ากับภาษาต่างๆ เช่น 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

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

string

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

string

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

string

ไม่บังคับ ท้องถิ่นย่อยของที่อยู่ เช่น ย่าน เขต หรืออำเภอ
addressLines[]

string

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

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

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

การสร้างที่อยู่ที่มีเฉพาะ regionCode และ addressLines แล้วทำการเข้ารหัสพิกัดภูมิศาสตร์เป็นวิธีที่แนะนำในการจัดการที่อยู่ที่ไม่มีโครงสร้างโดยสมบูรณ์ (ตรงข้ามกับการเดาว่าส่วนใดของที่อยู่ควรเป็นท้องถิ่นหรือเขตบริหาร)
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 หมายถึงเที่ยงคืนของวันสุดท้ายในช่องวันที่ที่ระบุ หมายเหตุ: ในการแมป JSON ของ Proto3 ระบบจะไม่รวมค่าศูนย์เริ่มต้น (00:00) ซึ่งจะทำให้ openTime มีค่าเป็น {}
closeDay

enum (DayOfWeek)

ต้องระบุ ระบุday of the weekที่ระยะเวลานี้สิ้นสุดลง
closeTime

object (TimeOfDay)

ต้องระบุ ค่าที่ถูกต้องคือ 00:00-24:00 โดยที่ 24:00 หมายถึงเที่ยงคืนของวันสุดท้ายที่ระบุในช่องวัน หมายเหตุ: ในการแมป JSON ของ Proto3 ระบบจะละเว้นค่าศูนย์เริ่มต้น (00:00) ซึ่งจะสร้าง {} สำหรับ closeTime

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

แสดงวันในสัปดาห์

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 หากตั้งค่าไว้ ช่องนี้ต้องเท่ากับหรืออยู่หลัง startDate ไม่เกิน 1 วัน
closeTime

object (TimeOfDay)

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

boolean

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

วันที่

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

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

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

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

integer

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

integer

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

integer

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

ServiceAreaBusiness

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

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

enum (BusinessType)

ต้องระบุ ระบุ [ประเภท] [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

ออบเจ็กต์ที่แสดงคู่ละติจูด/ลองจิจูด ซึ่งจะแสดงเป็นคู่ของค่า Double เพื่อแสดงองศาละติจูดและองศาลองจิจูด ออบเจ็กต์นี้ต้องเป็นไปตาม มาตรฐาน 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,
  "isParticularlyPersonalPlace": boolean
}
ช่อง
hasGoogleUpdated

boolean

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

boolean

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

boolean

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

boolean

เอาต์พุตเท่านั้น เลิกใช้งาน: ระบบจะไม่ป้อนข้อมูลในช่องนี้อีกต่อไปและจะนำออกในเวอร์ชันต่อๆ ไป
canModifyServiceList

boolean

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

boolean

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

boolean

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

boolean

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

string

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

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

string

เอาต์พุตเท่านั้น แหล่งข้อมูลสถานที่ตั้งที่สถานที่ตั้งนี้ซ้ำกัน
mapsUri

string

เอาต์พุตเท่านั้น ลิงก์ไปยังตำแหน่งใน Maps
newReviewUri

string

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

boolean

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

boolean

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

boolean

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

โปรไฟล์

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

การแสดง 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 businessCategories:BatchGet} เพื่อดูประเภทเวลาทำการที่รองรับสำหรับหมวดหมู่ของสถานที่ตั้ง
periods[]

object (TimePeriod)

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

ServiceItem

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "structuredServiceItem": {
    object (StructuredServiceItem)
  },
  "freeFormServiceItem": {
    object (FreeFormServiceItem)
  }
  // End of mutually exclusive fields.
}
ฟิลด์
price

object (Money)

ไม่บังคับ แสดงราคาที่เป็นตัวเงินของรายการบริการ เราขอแนะนำให้ตั้งค่า currencyCode และ units เมื่อระบุราคา ซึ่งจะถือเป็นราคาคงที่สำหรับรายการบริการ
ควรตั้งค่าช่องใดช่องหนึ่งต่อไปนี้เสมอ ต่อไปนี้คือรายการช่องที่แยกกันโดยสิ้นเชิง ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
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

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

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

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