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

enum (DayOfWeek)

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

string

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

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

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

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 สามารถขยายเวลาจนถึง 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": 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

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

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

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

บูลีน explicitNoPlaceId เพิ่มเติมจะพิจารณาว่ารหัสสถานที่ที่ไม่ได้ตั้งค่าเป็นเจตนาหรือไม่
explicitNoPlaceId

boolean

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

string

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

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

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

ข้อมูลเมตา

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

การแสดง 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 ชุดต่อภาษาเท่านั้น

ส่วน

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

object (TimePeriod)

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

เมธอด

associate

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

batchGet

 ดึงสถานที่ตั้งที่ระบุในบัญชีที่ระบุ

batchGetReviews

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

clearAssociation

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

create

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

delete

 ลบสถานที่ตั้ง

fetchVerificationOptions

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

findMatches

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

get

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

getFoodMenus

 แสดงเมนูอาหารของสถานที่หนึ่งๆ

getGoogleUpdated

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

getHealthProviderAttributes

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

getServiceList

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

list

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

patch

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

reportInsights

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

transfer
(deprecated)

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

updateFoodMenus

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

updateHealthProviderAttributes

 อัปเดตแอตทริบิวต์ผู้ให้บริการสาธารณสุขของสถานที่ตั้งหนึ่งๆ

updateServiceList

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

verify

 เริ่มกระบวนการยืนยันสำหรับสถานที่