REST Resource: accounts.locations

ทรัพยากร: ตำแหน่ง

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

การแสดง JSON 
{
  "name": string,
  "languageCode": string,
  "storeCode": string,
  "locationName": string,
  "primaryPhone": string,
  "additionalPhones": [
    string
  ],
  "address": {
    object (PostalAddress)
  },
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ],
  "websiteUrl": string,
  "regularHours": {
    object (BusinessHours)
  },
  "specialHours": {
    object (SpecialHours)
  },
  "serviceArea": {
    object (ServiceAreaBusiness)
  },
  "locationKey": {
    object (LocationKey)
  },
  "labels": [
    string
  ],
  "adWordsLocationExtensions": {
    object (AdWordsLocationExtensions)
  },
  "latlng": {
    object (LatLng)
  },
  "openInfo": {
    object (OpenInfo)
  },
  "locationState": {
    object (LocationState)
  },
  "attributes": [
    {
      object (Attribute)
    }
  ],
  "metadata": {
    object (Metadata)
  },
  "priceLists": [
    {
      object (PriceList)
    }
  ],
  "profile": {
    object (Profile)
  },
  "relationshipData": {
    object (RelationshipData)
  },
  "moreHours": [
    {
      object (MoreHours)
    }
  ]
}
ช่อง
name

string

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

ในบริบทของการจับคู่ ช่องนี้จะไม่ป้อนข้อมูล
languageCode

string

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

string

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

string

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

string

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

string

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

object (PostalAddress)

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

object (Category)

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

object (Category)

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

string

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

object (BusinessHours)

เวลาทําการของธุรกิจ
specialHours

object (SpecialHours)

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

object (ServiceAreaBusiness)

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

object (LocationKey)

ชุดของคีย์ที่เชื่อมโยงธุรกิจนี้กับผลิตภัณฑ์และบริการอื่นๆ ของ Google เช่น Google+ เพจและ Google Maps Places
labels[]

string

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

object (AdWordsLocationExtensions)

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

object (LatLng)

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

object (OpenInfo)

ธงที่บ่งบอกว่าสถานที่เปิดให้บริการอยู่ในขณะนี้หรือไม่
locationState

object (LocationState)

เอาต์พุตเท่านั้น ชุดของบูลีนที่แสดงสถานะของสถานที่
attributes[]

object (Attribute)

แอตทริบิวต์สำหรับสถานที่นี้
metadata

object (Metadata)

เอาต์พุตเท่านั้น ข้อมูลเพิ่มเติมที่ผู้ใช้แก้ไขไม่ได้
priceLists[]
(deprecated)

object (PriceList)

เลิกใช้งานแล้ว: ข้อมูลรายการราคาสำหรับสถานที่นี้
profile

object (Profile)

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

object (RelationshipData)

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

object (MoreHours)

เวลาทําการเพิ่มเติมสําหรับแผนกต่างๆ หรือลูกค้าที่เฉพาะเจาะจงของธุรกิจ

BusinessHours

แสดงระยะเวลาที่สถานที่แห่งนี้เปิดให้บริการ เก็บคอลเล็กชันของอินสแตนซ์ TimePeriod

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

object (TimePeriod)

ช่วงเวลาต่างๆ ที่สถานที่นี้เปิดทำการ แต่ละช่วงเวลาจะแสดงช่วงชั่วโมงที่สถานที่เปิดในระหว่างสัปดาห์

TimePeriod

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

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

enum (DayOfWeek)

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

string

เวลาในรูปแบบขยายของ ISO 8601 แบบ 24 ชั่วโมง (hh:mm) ค่าที่ใช้ได้คือ 00:00-24:00 โดยเวลา 24:00 น. หมายถึงเวลาเที่ยงคืนเมื่อสิ้นสุดช่องวันที่ระบุ
closeDay

enum (DayOfWeek)

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

string

เวลาในรูปแบบขยายของ ISO 8601 แบบ 24 ชั่วโมง (hh:mm) ค่าที่ใช้ได้คือ 00:00-24:00 โดยเวลา 24:00 น. หมายถึงเวลาเที่ยงคืนเมื่อสิ้นสุดช่องวันที่ระบุ

DayOfWeek

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

Enum
DAY_OF_WEEK_UNSPECIFIED ไม่ได้ระบุวันของสัปดาห์
MONDAY วันจันทร์
TUESDAY วันอังคาร
WEDNESDAY วันพุธ
THURSDAY พฤหัสบดี
FRIDAY วันศุกร์
SATURDAY เสาร์
SUNDAY วันอาทิตย์

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": string,
  "endDate": {
    object (Date)
  },
  "closeTime": string,
  "isClosed": boolean
}
ช่อง
startDate

object (Date)

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

string

เวลาจริงใน startDate เมื่อสถานที่เปิด แสดงในรูปแบบขยายของ ISO 8601 แบบ 24 ชั่วโมง (hh:mm) ค่าที่ถูกต้องคือ 00:00-24:00 โดย 24:00 หมายถึงเที่ยงคืนของตอนท้ายของช่องวันที่ระบุ ต้องระบุหาก isClosed เป็นเท็จ
endDate

object (Date)

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

string

เวลาจริงใน endDate เมื่อสถานที่ปิด แสดงในรูปแบบขยายของ ISO 8601 แบบ 24 ชั่วโมง (hh:mm) ค่าที่ถูกต้องคือ 00:00-24:00 โดย 24:00 หมายถึงเที่ยงคืนของตอนท้ายของช่องวันที่ระบุ ต้องระบุหาก isClosed เป็นเท็จ
isClosed

boolean

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

ServiceAreaBusiness

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

การแสดง JSON 
{
  "businessType": enum (BusinessType),

  // Union field coverageArea can be only one of the following:
  "radius": {
    object (PointRadius)
  },
  "places": {
    object (Places)
  }
  // End of list of possible types for union field coverageArea.
}
ช่อง
businessType

enum (BusinessType)

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

object (PointRadius)

เอาต์พุตเท่านั้น พื้นที่ที่ธุรกิจนี้ให้บริการโดยมีศูนย์กลางเป็นศูนย์กลาง
places

object (Places)

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

BusinessType

ระบุว่าธุรกิจนี้ให้บริการเฉพาะในสถานที่ของลูกค้า (เช่น รถลาก) หรือทั้งที่อยู่และในสถานที่ (เช่น ร้านพิซซ่าที่มีพื้นที่รับประทานอาหาร และให้บริการแก่ลูกค้าด้วย)

Enum
BUSINESS_TYPE_UNSPECIFIED เอาต์พุตเท่านั้น ไม่ได้ระบุ
CUSTOMER_LOCATION_ONLY ให้บริการเฉพาะในพื้นที่รอบๆ เท่านั้น (ไม่ใช่ที่ที่อยู่ธุรกิจ)
CUSTOMER_AND_BUSINESS_LOCATION ให้บริการในที่อยู่ธุรกิจและพื้นที่โดยรอบ

PointRadius

รัศมีรอบๆ จุดใดจุดหนึ่ง (ละติจูด/ลองจิจูด)

การแสดง JSON 
{
  "latlng": {
    object (LatLng)
  },
  "radiusKm": number
}
ช่อง
latlng

object (LatLng)

ละติจูด/ลองจิจูดที่ระบุศูนย์กลางของพื้นที่ซึ่งรัศมีกำหนด
radiusKm

number

ระยะทางเป็นกิโลเมตรของพื้นที่รอบๆ จุด

LatLng

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

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

number

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

number

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

สถานที่

ระบุการรวมพื้นที่ที่แสดงด้วยกลุ่มสถานที่

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

object (PlaceInfo)

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

PlaceInfo

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

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

string

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

string

รหัสของสถานที่ ต้องสอดคล้องกับภูมิภาค

LocationKey

การอ้างอิงคีย์สำรอง/ตัวแทนสำหรับสถานที่

การแสดง JSON 
{
  "plusPageId": string,
  "placeId": string,
  "explicitNoPlaceId": boolean,
  "requestId": string
}
ช่อง
plusPageId

string

เอาต์พุตเท่านั้น หากสถานที่นี้มี Google+ เพจเชื่อมโยงอยู่ จะมีการเติมข้อมูลด้วยรหัส Google+ เพจของสถานที่นี้
placeId

string

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

หากสถานที่นี้ไม่ได้รับการยืนยัน ช่องนี้อาจป็อปปูเลตหากตำแหน่งดังกล่าวเชื่อมโยงกับสถานที่ที่ปรากฏใน Google Maps แล้ว

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

บูลีน explicitNoPlaceId เพิ่มเติมมีคุณสมบัติไม่ว่ารหัสสถานที่ที่ยังไม่ได้ตั้งค่าเกิดขึ้นโดยเจตนาหรือไม่
explicitNoPlaceId

boolean

เอาต์พุตเท่านั้น ค่า "จริง" แสดงว่ารหัสสถานที่ที่ไม่ได้ตั้งค่าเป็นรหัสที่มีการตั้งใจ ซึ่งแตกต่างจากยังไม่ได้สร้างการเชื่อมโยง
requestId

string

เอาต์พุตเท่านั้น requestId ที่ใช้สร้างสถานที่นี้ สถานที่ตั้งนี้อาจว่างเปล่าหากสร้างขึ้นนอก Google My Business API หรือสถานที่ตั้ง Business Profile

AdWordsLocationExtensions

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

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

string

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

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 บ่งบอกว่าสถานที่นี้ปิดชั่วคราว ค่านี้อาจใช้ได้กับสถานที่ที่เผยแพร่เท่านั้น (เช่น locationState.is_published = true) เมื่ออัปเดตช่องสถานะเป็นค่านี้ ไคลเอ็นต์จะต้องตั้งค่า updateMask เป็น openInfo.status อย่างชัดแจ้ง ไม่สามารถตั้งค่ามาสก์การอัปเดตอื่นๆ ในระหว่างการโทรเพื่ออัปเดตนี้ นี่คือข้อจำกัดชั่วคราวซึ่งจะผ่อนปรนในเร็วๆ นี้

LocationState

มีชุดบูลีนที่แสดงสถานะของสถานที่

การแสดง JSON 
{
  "isGoogleUpdated": boolean,
  "isDuplicate": boolean,
  "isSuspended": boolean,
  "canUpdate": boolean,
  "canDelete": boolean,
  "isVerified": boolean,
  "needsReverification": boolean,
  "isPendingReview": boolean,
  "isDisabled": boolean,
  "isPublished": boolean,
  "isDisconnected": boolean,
  "isLocalPostApiDisabled": boolean,
  "canModifyServiceList": boolean,
  "canHaveFoodMenus": boolean,
  "hasPendingEdits": boolean,
  "hasPendingVerification": boolean,
  "canOperateHealthData": boolean,
  "canOperateLodgingData": boolean
}
ช่อง
isGoogleUpdated

boolean

เอาต์พุตเท่านั้น ระบุว่ารหัสสถานที่ที่เชื่อมโยงกับสถานที่ตั้งนี้มีการอัปเดตหรือไม่
isDuplicate

boolean

เอาต์พุตเท่านั้น ระบุว่าสถานที่ซ้ำกับสถานที่อื่นหรือไม่
isSuspended

boolean

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

boolean

เอาต์พุตเท่านั้น ระบุว่าสามารถอัปเดตตำแหน่งได้หรือไม่
canDelete

boolean

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

boolean

เอาต์พุตเท่านั้น ระบุว่าสถานที่ได้รับการยืนยันหรือไม่
needsReverification

boolean

เอาต์พุตเท่านั้น ระบุว่าสถานที่ต้องได้รับการยืนยันอีกครั้งหรือไม่
isPendingReview

boolean

เอาต์พุตเท่านั้น ระบุว่ามีการตรวจสอบสถานที่หรือไม่
isDisabled

boolean

เอาต์พุตเท่านั้น ระบุว่าปิดใช้งานตำแหน่งหรือไม่
isPublished

boolean

เอาต์พุตเท่านั้น ระบุว่ามีการเผยแพร่สถานที่หรือไม่
isDisconnected

boolean

เอาต์พุตเท่านั้น ระบุว่าสถานที่ยกเลิกการเชื่อมต่อกับสถานที่บน Google Maps หรือไม่
isLocalPostApiDisabled

boolean

เอาต์พุตเท่านั้น ระบุว่ามีการปิดใช้ accounts.locations.localPosts สำหรับสถานที่ตั้งนี้หรือไม่
canModifyServiceList

boolean

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

boolean

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

boolean

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

boolean

เอาต์พุตเท่านั้น ระบุว่าสถานที่มีคําขอการยืนยันที่รอดำเนินการหรือไม่
canOperateHealthData

boolean

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

boolean

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

แอตทริบิวต์

แอตทริบิวต์ตำแหน่ง แอตทริบิวต์ให้ข้อมูลเพิ่มเติมเกี่ยวกับสถานที่ตั้ง แอตทริบิวต์ที่ตั้งค่าในสถานที่ได้อาจแตกต่างกันไปตามพร็อพเพอร์ตี้ของสถานที่ตั้งนั้น (เช่น หมวดหมู่) Google จะเป็นผู้กำหนดแอตทริบิวต์ที่พร้อมใช้งาน และอาจเพิ่มและนำออกได้โดยไม่ต้องเปลี่ยนแปลง API

การแสดง JSON 
{
  "attributeId": string,
  "valueType": enum (AttributeValueType),
  "values": [
    value
  ],
  "repeatedEnumValue": {
    object (RepeatedEnumAttributeValue)
  },
  "urlValues": [
    {
      object (UrlAttributeValue)
    }
  ]
}
ช่อง
attributeId

string

รหัสของแอตทริบิวต์ รหัสแอตทริบิวต์มาจาก Google
valueType

enum (AttributeValueType)

เอาต์พุตเท่านั้น ประเภทของค่าที่แอตทริบิวต์นี้มีอยู่ ซึ่งควรใช้เพื่อกําหนดวิธีการตีความค่า
values[]

value (Value format)

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

object (RepeatedEnumAttributeValue)

เมื่อประเภทค่าแอตทริบิวต์คือ REPEATED_ENUM ค่าของแอตทริบิวต์จะมีค่าแอตทริบิวต์ และช่องค่าอื่นๆ จะต้องว่างเปล่า
urlValues[]

object (UrlAttributeValue)

เมื่อประเภทค่าแอตทริบิวต์คือ URL ช่องนี้จะมีค่าของแอตทริบิวต์นี้ และช่องค่าอื่นๆ ต้องว่างเปล่า

RepeatedEnumAttributeValue

ค่าสำหรับแอตทริบิวต์ที่มี valueType เป็น REPEATED_ENUM รหัสค่านี้ประกอบด้วยรายการรหัสค่า 2 รายการ ได้แก่ รายการที่ตั้งค่า (จริง) และรายการรหัสที่ไม่ได้ตั้งค่า (เท็จ) ค่าที่ขาดไปจะถือว่าเป็นค่าที่ไม่รู้จัก ต้องระบุอย่างน้อย 1 ค่า

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

string

ค่า enum ที่ตั้งไว้
unsetValues[]

string

ค่า enum ที่ไม่ได้ตั้งค่า

UrlAttributeValue

ค่าสำหรับแอตทริบิวต์ที่มี URL ที่ valueType

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

string

URL

Metadata

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

การแสดง JSON 
{
  "duplicate": {
    object (Duplicate)
  },
  "mapsUrl": string,
  "newReviewUrl": string
}
ช่อง
duplicate
(deprecated)

object (Duplicate)

ข้อมูลเกี่ยวกับสถานที่ที่สถานที่นี้ซ้ำ แสดงเมื่อ locationState.is_duplicate เป็นจริงเท่านั้น เลิกใช้งานแล้ว: เราไม่สนับสนุนข้อมูลโดยละเอียดเกี่ยวกับรายการที่ซ้ำอีกต่อไป
mapsUrl

string

ลิงก์ไปยังสถานที่ใน Maps
newReviewUrl

string

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

ทำซ้ำ

ข้อมูลเกี่ยวกับสถานที่ที่สถานที่นี้ซ้ำ

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

string

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

string

รหัสสถานที่ของสถานที่ที่ซ้ำกัน
access

enum (Access)

ระบุว่าผู้ใช้มีสิทธิ์เข้าถึงสถานที่ที่ซ้ำกับสถานที่อื่นหรือไม่

การเข้าถึง

ระดับการเข้าถึงสถานที่ที่ซ้ำกันของผู้ใช้ พื้นที่นี้มาแทนที่การเป็นเจ้าของและควรนำมาใช้แทน

Enum
ACCESS_UNSPECIFIED ไม่ได้ระบุ
ACCESS_UNKNOWN ไม่สามารถระบุได้ว่าผู้ใช้มีสิทธิ์เข้าถึงสถานที่ที่ซ้ำกับสถานที่อื่นหรือไม่
ALLOWED ผู้ใช้มีสิทธิ์เข้าถึงสถานที่ที่ซ้ำกับสถานที่อื่น
INSUFFICIENT ผู้ใช้ไม่มีสิทธิ์เข้าถึงสถานที่ที่ซ้ำกับสถานที่อื่น

PriceList

เลิกใช้งานแล้ว: รายการข้อมูลราคาสินค้า รายการราคามีโครงสร้างเป็นรายการราคาอย่างน้อย 1 รายการ โดยแต่ละส่วนจะมีส่วนอย่างน้อย 1 ส่วนที่มีรายการอย่างน้อย 1 รายการ เช่น รายการราคาอาหารอาจแสดงเมนูอาหารเช้า/อาหารกลางวัน/อาหารค่ำ ซึ่งมีส่วนสำหรับเบอร์เกอร์/สเต็ก/อาหารทะเล

การแสดง JSON 
{
  "priceListId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "sourceUrl": string,
  "sections": [
    {
      object (Section)
    }
  ]
}
ช่อง
priceListId

string

ต้องระบุ รหัสสำหรับรายการราคา รหัสรายการราคา ส่วน และรหัสรายการจะซ้ำกันภายในสถานที่ตั้งนี้ไม่ได้
labels[]

object (Label)

ต้องระบุ ป้ายกำกับที่ติดแท็กภาษาสำหรับรายการราคา
sourceUrl

string

URL แหล่งที่มาของที่ไม่บังคับซึ่งมีการเรียกข้อมูลรายการราคา ตัวอย่างเช่น อาจเป็น URL ของหน้าเว็บที่ระบบคัดลอกมาโดยอัตโนมัติเพื่อป้อนข้อมูลเมนู
sections[]

object (Section)

ต้องระบุ ส่วนต่างๆ สำหรับรายการราคานี้ รายการราคาแต่ละรายการต้องมีอย่างน้อย 1 ส่วน

ป้ายกำกับ

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

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

string

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

string

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

string

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

ส่วน

ส่วนของรายการราคาที่มีสินค้าอย่างน้อย 1 รายการ

การแสดง JSON 
{
  "sectionId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "sectionType": enum (SectionType),
  "items": [
    {
      object (Item)
    }
  ]
}
ช่อง
sectionId

string

ต้องระบุ รหัสของหัวข้อ รหัสรายการราคา ส่วน และรหัสรายการจะซ้ำกันภายในสถานที่ตั้งนี้ไม่ได้
labels[]

object (Label)

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

enum (SectionType)

ไม่บังคับ ประเภทของส่วนรายการราคาปัจจุบัน ค่าเริ่มต้นคือ FOOD
items[]

object (Item)

สินค้าที่อยู่ภายในส่วนนี้ของรายการราคา

SectionType

ประเภทของส่วน

Enum
SECTION_TYPE_UNSPECIFIED ไม่ได้ระบุ
FOOD ส่วนมีรายการอาหาร
SERVICES ส่วนมีรายการที่แสดงถึงบริการ

รายการ

รายการเดียว แต่ละรูปแบบของสินค้าในรายการราคาควรมีรายการเป็นของตัวเองพร้อมข้อมูลราคา

การแสดง JSON 
{
  "itemId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "price": {
    object (Money)
  }
}
ช่อง
itemId

string

ต้องระบุ รหัสของสินค้า รหัสรายการราคา ส่วน และรหัสรายการจะซ้ำกันภายในสถานที่ตั้งนี้ไม่ได้
labels[]

object (Label)

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

object (Money)

ไม่บังคับ ราคาของสินค้า

สกุลเงิน

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

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

โปรไฟล์

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

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

string

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

RelationshipData

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

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

string

ชื่อทรัพยากรของเชนที่สถานที่ตั้งนี้เป็นสมาชิก How to find Chain ID

MoreHours

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

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

string

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

object (TimePeriod)

ต้องระบุ ช่วงเวลาต่างๆ ที่สถานที่นี้เปิด แต่ละช่วงเวลาจะแสดงช่วงชั่วโมงที่สถานที่เปิดในระหว่างสัปดาห์

วิธีการ

associate

 เชื่อมโยงสถานที่ตั้งกับรหัสสถานที่

batchGet

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

batchGetReviews

 แสดงรายการรีวิวที่ใส่เลขหน้าสำหรับสถานที่ทั้งหมดที่ระบุไว้

clearAssociation

 ล้างการเชื่อมโยงระหว่างสถานที่ตั้งและรหัสสถานที่

create

 สร้าง location ใหม่ที่เป็นของบัญชีที่ระบุ และส่งกลับมา

delete

 ลบสถานที่

fetchVerificationOptions

 รายงานตัวเลือกการยืนยันที่มีสิทธิ์ทั้งหมดสำหรับสถานที่ตั้งในภาษาใดภาษาหนึ่ง

findMatches

 ค้นหาสถานที่ตั้งที่เป็นไปได้ทั้งหมดที่ตรงกับสถานที่ตั้งที่ระบุ

get

 รับตำแหน่งที่ระบุ

getFoodMenus

 แสดงเมนูอาหารของสถานที่ที่ระบุ

getGoogleUpdated

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

getHealthProviderAttributes

 แสดงผลแอตทริบิวต์ของผู้ให้บริการ Health ของตำแหน่งที่เฉพาะเจาะจง

getServiceList

 รับรายการบริการที่ระบุของสถานที่

list

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

patch

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

reportInsights

 แสดงรายงานที่มีข้อมูลเชิงลึกของเมตริกอย่างน้อย 1 รายการตามสถานที่ตั้ง

transfer
(deprecated)

 ย้ายสถานที่จากบัญชีที่ผู้ใช้เป็นเจ้าของไปยังบัญชีอื่นที่ผู้ใช้รายเดียวกันดูแลอยู่

updateFoodMenus

 อัปเดตเมนูอาหารของสถานที่ที่เจาะจง

updateHealthProviderAttributes

 อัปเดตแอตทริบิวต์ผู้ให้บริการข้อมูลสุขภาพของสถานที่ตั้งที่เฉพาะเจาะจง

updateServiceList

 อัปเดตรายการบริการที่ระบุของสถานที่

verify

 เริ่มกระบวนการยืนยันสถานที่ตั้ง