เปิดตัว Business Profile Performance API แล้ว ต้องย้ายข้อมูล
อ่านกําหนดการเลิกใช้งานและวิธีการย้ายข้อมูลจาก API v4 เวอร์ชันเก่าที่เลิกใช้งานไปแล้วไปยัง API v1 แบบใหม่
ช่วยเราปรับปรุงประสบการณ์ด้านเมนูอาหารด้วยการส่งแบบสํารวจนี้เพื่อให้เข้าใจมากขึ้นว่าจะให้ข้อมูลเกี่ยวกับตําแหน่ง เมนู และอาหารจานใดเกี่ยวกับผู้ขายที่คุณสนับสนุน

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) และอย่าเพิ่มข้อมูลที่ไม่จําเป็นลงในชื่อ (เช่น Preferred "Google " over"Google Inc. - Mountain View Corporate Headquar&&tt;) อย่าใส่แท็กไลน์การตลาด รหัสร้านค้า สัญลักษณ์พิเศษ เวลาทําการหรือสถานะเปิด/ปิด หมายเลขโทรศัพท์, URL ของเว็บไซต์, ข้อมูลบริการ/ผลิตภัณฑ์, สถานที่ตั้ง/ที่อยู่หรือเส้นทาง หรือข้อมูลสําคัญ (เช่น "Chase ATM ใน Duane Reade")

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)

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

เวลาทําการ

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

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

object (TimePeriod)

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

ระยะเวลา

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

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

enum (DayOfWeek)

ระบุ day of the week ในช่วงเวลานี้

openTime

string

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

closeDay

enum (DayOfWeek)

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

closeTime

string

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

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

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

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

เวลาทําการพิเศษ

แสดงถึงระยะเวลาในกรณีที่เวลาทําการของสถานที่แตกต่างจากเวลาทําการปกติ

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

object (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 เมื่อเปิดสถานที่ แสดงในรูปแบบ 24 ชั่วโมง ISO 8601 แบบขยาย (ชช:นน) ค่าที่ถูกต้องคือ 00:00-24:00 โดย 24:00 คือเที่ยงคืนเมื่อสิ้นสุดช่องวันที่ระบุ ต้องระบุหาก isClosed เป็นเท็จ

endDate

object (Date)

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

closeTime

string

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

isClosed

boolean

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

ธุรกิจที่ให้บริการตามสถานที่

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

การแสดง 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 ของธุรกิจที่ให้บริการตามสถานที่

ช่อง Union coverageArea ระบุพื้นที่ที่ครอบคลุมซึ่งธุรกิจให้บริการ coverageArea ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้น
radius

object (PointRadius)

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

places

object (Places)

พื้นที่ซึ่งธุรกิจนี้ให้บริการผ่านสถานที่ต่างๆ

ประเภทธุรกิจ

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

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

รัศมีจุด

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

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

object (LatLng)

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

radiusKm

number

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

ละติจูดและลองจิจูด

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

ข้อมูลสถานที่

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

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

string

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

placeId

string

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

คีย์สถานที่ตั้ง

การอ้างอิงคีย์สํารอง/มอบสิทธิ์สําหรับสถานที่ตั้ง

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

ส่วนขยายสถานที่ตั้งของ AdWords

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

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

string

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

ข้อมูลเปิด

ข้อมูลที่เกี่ยวข้องกับสถานะการเปิดทําการของธุรกิจ

การแสดง 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 อย่างชัดแจ้ง คุณจะตั้งค่ามาสก์อัปเดตอื่นๆ ในระหว่างการเรียกใช้การอัปเดตนี้ไม่ได้ นี่คือข้อจํากัดชั่วคราวซึ่งจะผ่อนคลายในเร็วๆ นี้

สถานะสถานที่ตั้ง

มีชุดบูลีนที่สอดคล้องกับสถานะของตําแหน่ง

การแสดง 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 ช่องนี้จะมีค่าสําหรับแอตทริบิวต์นี้ และต้องป้อนค่าช่องอื่นๆ

ค่าแอตทริบิวต์ซ้ํา

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

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

string

ค่า Enum ที่ตั้งค่าไว้

unsetValues[]

string

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

ค่าแอตทริบิวต์ URL

ค่าสําหรับแอตทริบิวต์ที่มี 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 ผู้ใช้ไม่มีสิทธิ์เข้าถึงตําแหน่งที่ซ้ํากัน

รายการราคา

เลิกใช้งานแล้ว: รายการข้อมูลราคาสินค้า รายการราคามีโครงสร้างเป็นลิสต์ราคาอย่างน้อย 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)

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

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

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

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

คําอธิบายสถานที่ตั้งด้วยเสียงของคุณเอง ผู้อื่นไม่สามารถแก้ไขได้

ข้อมูลความสัมพันธ์

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

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

string

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

เวลาทําการเพิ่มเติม

ช่วงเวลาที่ธุรกิจเปิดทําการบางประเภท

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

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