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") อย่าใส่แท็กไลน์ทางการตลาด รหัสร้านค้า สัญลักษณ์พิเศษ เวลาทำการหรือสถานะเปิด/ปิดทำการ หมายเลขโทรศัพท์ URL ของเว็บไซต์ ข้อมูลบริการ/ผลิตภัณฑ์ สถานที่ตั้ง/ที่อยู่หรือเส้นทาง หรือข้อมูลการควบคุม (เช่น "ตู้ ATM ธนาคารไทยพาณิชย์")

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

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

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

คำแนะนำเกี่ยวกับการป้อน / แก้ไขที่อยู่: - ใช้วิดเจ็ตที่อยู่ที่พร้อมสำหรับการใช้งานให้เป็นสากล เช่น 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" สำหรับขนาดเล็กไปใหญ่) วิธีนี้จะทำให้บรรทัดของที่อยู่ที่เฉพาะเจาะจงมากที่สุดสามารถเลือกตามภาษาได้

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

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

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 น. หมายถึงเวลาเที่ยงคืนเมื่อสิ้นสุดช่องวันที่ระบุ

DayOfWeek

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

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 สามารถขยายเวลาไปจนถึง 23: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 ปี (เช่น วันครบรอบ)
  • 1 ปีเท่านั้น โดยมี 0 เดือนกับ 0 วัน
  • ปีและเดือนที่มี 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)

ต้องระบุ ระบุ [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

วัตถุที่แสดงคู่ละติจูด/ลองจิจูด ค่านี้แสดงเป็นเลขคู่ 1 คู่เพื่อแสดงองศาละติจูดและลองจิจูดองศา ออบเจ็กต์นี้ต้องเป็นไปตาม มาตรฐาน 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 บ่งบอกว่าสถานที่นี้ปิดชั่วคราว

Metadata

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

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

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

canOperateLodgingData

boolean

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

placeId

string

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

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

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 แห่งตั้งอยู่ร่วมกันในสถานที่ตั้งเดียวกัน แต่มาจากคนละบริษัท (เช่น สตาร์บัคส์สาขาเซ็นทรัล ร้านค้าในห้างสรรพสินค้า)

MoreHours

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

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

string

ต้องระบุ ประเภทเวลาทำการ ลูกค้าควรโทรหา {#link business categories: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)

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

ฟิลด์การรวม 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 ข้อมูลนี้มาจากบริการ categories.batchGet RPC

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 ที่สตริงเหล่านี้มีผล คุณจะตั้งค่าป้ายกำกับได้เพียงชุดเดียวต่อภาษา

สกุลเงิน

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

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

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