REST Resource: 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)

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

วิธีการ

delete

ลบสถานที่

get

แสดงผลตำแหน่งที่ระบุ

getAttributes

ค้นหาแอตทริบิวต์ทั้งหมดที่ตั้งค่าไว้สำหรับตำแหน่งที่ระบุ

getGoogleUpdated

รับตำแหน่งที่ระบุในเวอร์ชันที่ Google อัปเดต

patch

อัปเดตตำแหน่งที่ระบุ

updateAttributes

อัปเดตแอตทริบิวต์สำหรับสถานที่ที่ระบุ