Package google.mybusiness.businessinformation.v1

ดัชนี

AttributesService

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

GetAttributes

rpc GetAttributes(GetAttributesRequest) returns (Attributes)

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

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/business.manage

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0
GetGoogleUpdatedAttributes

rpc GetGoogleUpdatedAttributes(GetGoogleUpdatedAttributesRequest) returns (Attributes)

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

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/business.manage

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0
ListAttributeMetadata

rpc ListAttributeMetadata(ListAttributeMetadataRequest) returns (ListAttributeMetadataResponse)

แสดงรายการแอตทริบิวต์ที่สามารถใช้ได้สำหรับสถานที่ตั้งที่มีหมวดหมู่หลักและประเทศที่ระบุ

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/business.manage

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0
UpdateAttributes

rpc UpdateAttributes(UpdateAttributesRequest) returns (Attributes)

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

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/business.manage

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

CategoriesService

API นี้ให้ข้อมูลเกี่ยวกับหมวดหมู่ที่รองรับสำหรับที่ตั้งธุรกิจบน Google สำหรับข้อมูลอ้างอิง โปรดดูที่ส่วนหมวดหมู่ของบทความนี้ https://support.google.com/business/answer/3038177

BatchGetCategories

rpc BatchGetCategories(BatchGetCategoriesRequest) returns (BatchGetCategoriesResponse)

แสดงผลรายการหมวดหมู่ธุรกิจสำหรับภาษาและรหัส GConcept ที่ระบุ

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/business.manage

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0
ListCategories

rpc ListCategories(ListCategoriesRequest) returns (ListCategoriesResponse)

แสดงผลรายการหมวดหมู่ธุรกิจ การค้นหาจะจับคู่ชื่อหมวดหมู่ แต่ไม่ตรงกับรหัสหมวดหมู่

การค้นหาจะจับคู่ด้านหน้าของชื่อหมวดหมู่เท่านั้น (กล่าวคือ 'อาหาร' อาจแสดงเป็น "ศูนย์อาหาร" แต่ไม่ใช่ "ร้านอาหารฟาสต์ฟู้ด")

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/business.manage

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

เชนธุรกิจ

บริการสําหรับการค้นหาข้อมูลเกี่ยวกับธุรกิจในเครือ

GetChain

rpc GetChain(GetChainRequest) returns (Chain)

รับเชนที่ระบุ แสดงผล NOT_FOUND หากไม่มีเชนอยู่

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/business.manage

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0
SearchChains

rpc SearchChains(SearchChainsRequest) returns (SearchChainsResponse)

ค้นหาเชนตามชื่อของเชน

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/business.manage

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

GoogleLocations

API นี้อนุญาตให้เข้าถึงและค้นหา GoogleLocation

SearchGoogleLocations

rpc SearchGoogleLocations(SearchGoogleLocationsRequest) returns (SearchGoogleLocationsResponse)

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

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/business.manage

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

ตำแหน่ง

API นี้ช่วยให้จัดการที่ตั้งธุรกิจบน Google ได้

CreateLocation

rpc CreateLocation(CreateLocationRequest) returns (Location)

สร้างตำแหน่งใหม่ที่เป็นของผู้ใช้ที่เข้าสู่ระบบ

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/business.manage

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0
DeleteLocation

rpc DeleteLocation(DeleteLocationRequest) returns (Empty)

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

หากลบสถานที่นี้โดยใช้ API ไม่ได้และมีการทำเครื่องหมายไว้ใน google.mybusiness.businessinformation.v1.LocationState ให้ใช้เว็บไซต์ Google Business Profile

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/business.manage

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0
GetGoogleUpdatedLocation

rpc GetGoogleUpdatedLocation(GetGoogleUpdatedLocationRequest) returns (GoogleUpdatedLocation)

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

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/business.manage

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0
รับตำแหน่งที่ตั้ง

rpc GetLocation(GetLocationRequest) returns (Location)

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

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/business.manage

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0
ListLocation

rpc ListLocations(ListLocationsRequest) returns (ListLocationsResponse)

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

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/business.manage

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0
UpdateLocation

rpc UpdateLocation(UpdateLocationRequest) returns (Location)

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

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/business.manage

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

AdWordsLocationExtensions

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

ช่อง
ad_phone

string

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

แอตทริบิวต์

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

ช่อง
name

string

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

AttributeValueType

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

Value

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

RepeatedEnumAttributeValue

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

UriAttributeValue

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

AttributeMetadata

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

ช่อง
parent

string

ตัวระบุที่ไม่ซ้ำกันสำหรับแอตทริบิวต์
value_type

AttributeValueType

ประเภทค่าของแอตทริบิวต์ ค่าที่กำหนดและดึงมาควรเป็นค่าประเภทนี้
display_name

string

ชื่อที่แสดงที่แปลแล้วของแอตทริบิวต์ (หากมี) ไม่เช่นนั้นจะใช้ชื่อที่แสดงเป็นภาษาอังกฤษ
group_display_name

string

ชื่อที่แสดงซึ่งแปลเป็นภาษาท้องถิ่นของกลุ่มที่มีแอตทริบิวต์นี้ (หากมี) หรือไม่เช่นนั้น จะใช้ชื่อกลุ่มภาษาอังกฤษ แอตทริบิวต์ที่เกี่ยวข้องจะรวบรวมเป็นกลุ่มและควรแสดงรวมกันภายใต้ส่วนหัวที่ระบุไว้ที่นี่
repeatable

bool

หากเป็น "จริง" แอตทริบิวต์จะรองรับหลายค่า หากเป็น "เท็จ" ควรระบุเพียงค่าเดียว
value_metadata[]

AttributeValueMetadata

สำหรับแอตทริบิวต์บางประเภท (เช่น enum) จะมีการแสดงรายการค่าที่รองรับและชื่อที่แสดงที่เกี่ยวข้องสำหรับค่าเหล่านั้น
deprecated

bool

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

AttributeValueMetadata

ข้อมูลเมตาสำหรับค่าแอตทริบิวต์ที่รองรับ

ช่อง
value

Value

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

string

ชื่อที่แสดงสำหรับค่านี้ (หากมี) หรือไม่เช่นนั้น ให้เป็นภาษาอังกฤษ ชื่อที่แสดงของค่ามีไว้เพื่อใช้ในบริบทของชื่อที่แสดงของแอตทริบิวต์

เช่น สำหรับ "Wi-Fi" enum ของแอตทริบิวต์ ซึ่งอาจมี "Paid" เพื่อแสดง Wi-Fi แบบชำระเงิน

AttributeValueType

ประเภทค่าของแอตทริบิวต์

Enum
ATTRIBUTE_VALUE_TYPE_UNSPECIFIED ไม่ได้ระบุ
BOOL ค่าสำหรับแอตทริบิวต์นี้เป็นค่าบูลีน
ENUM แอตทริบิวต์มีรายการค่าที่กำหนดไว้ล่วงหน้าของค่าที่ใช้ได้ ข้อมูลเมตาสำหรับแอตทริบิวต์นี้จะแสดงรายการค่าเหล่านี้
URL ค่าสำหรับแอตทริบิวต์นี้คือ URL
REPEATED_ENUM ค่าแอตทริบิวต์เป็น enum ที่มีหลายค่าที่เป็นไปได้ซึ่งตั้งค่าอย่างชัดเจนหรือไม่ตั้งค่าได้

Attributes

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

ช่อง
name

string

ต้องระบุ ตัวระบุของ Google สำหรับสถานที่นี้ในรูปแบบ locations/{location_id}/attributes
attributes[]

Attribute

คอลเล็กชันแอตทริบิวต์ที่ต้องอัปเดต

BatchGetCategoriesRequest

ข้อความคำขอสำหรับ BusinessCategory.BatchGetBusinessCategory

ช่อง
names[]

string

ต้องระบุ ต้องตั้งชื่ออย่างน้อยหนึ่งชื่อ รหัส GConcept ที่ควรแสดงผลชื่อหมวดหมู่ที่แปลแล้ว หากต้องการแสดงรายละเอียดสำหรับมากกว่า 1 หมวดหมู่ ให้ใช้พารามิเตอร์นี้ซ้ำในคำขอ
language_code

string

ต้องระบุ รหัส BCP 47 ของภาษาที่ควรแสดงผลชื่อหมวดหมู่
region_code

string

ไม่บังคับ รหัสประเทศ ISO 3166-1 alpha-2 ที่ใช้อนุมานภาษาที่ไม่ใช่มาตรฐาน
view

CategoryView

ต้องระบุ ระบุว่าควรแสดงผลส่วนใดของทรัพยากรหมวดหมู่ในการตอบกลับ

BatchGetCategoriesResponse

ข้อความตอบกลับสำหรับ BusinessCategory.BatchGetBusinessCategory

ช่อง
categories[]

Category

หมวดหมู่ที่ตรงกับรหัส GConcept ที่ระบุไว้ในคำขอ ซึ่งจะไม่เรียงตามลำดับเดียวกันกับรหัสหมวดหมู่ในคำขอ

BusinessHours

แสดงระยะเวลาที่สถานที่นี้เปิดทำการอยู่ เก็บคอลเล็กชันของอินสแตนซ์ [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod]

ช่อง
periods[]

TimePeriod

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

หมวดหมู่

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

ช่อง
primary_category

Category

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

Category

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

หมวดหมู่

หมวดหมู่ที่อธิบายว่าธุรกิจนี้คืออะไร (ไม่ใช่สิ่งที่ทำ) โปรดดูรายการรหัสหมวดหมู่ที่ถูกต้องและการแมปกับชื่อที่มนุษย์อ่านได้ที่ categories.list

ช่อง
name

string

ต้องระบุ รหัสแบบคงที่ (ระบุโดย Google) สำหรับหมวดหมู่นี้ ต้องระบุค่าเมื่อแก้ไขหมวดหมู่ (เมื่อสร้างหรืออัปเดตสถานที่ตั้ง)
display_name

string

เอาต์พุตเท่านั้น ชื่อหมวดหมู่ที่มนุษย์อ่านได้ ระบบจะตั้งค่านี้เมื่ออ่านตำแหน่ง ขณะแก้ไขสถานที่ตั้ง คุณต้องตั้งค่า category_id
service_types[]

ServiceType

เอาต์พุตเท่านั้น รายการบริการทุกประเภทที่ใช้ได้กับหมวดหมู่ธุรกิจนี้
more_hours_types[]

MoreHoursType

เอาต์พุตเท่านั้น ประเภทเวลาทำการเพิ่มเติมที่ใช้ได้กับหมวดหมู่ธุรกิจนี้

CategoryView

Enum ที่จะช่วยจำกัดจำนวนข้อมูลที่เซิร์ฟเวอร์ส่งคืน

Enum
CATEGORY_VIEW_UNSPECIFIED ไม่ได้ระบุ เทียบเท่ากับ CATEGORY_METADATA_ONLY
BASIC การตอบกลับของเซิร์ฟเวอร์จะรวมเฉพาะช่อง Category_display_name, category_id และ language_code โดยไม่ใส่ช่องที่เกี่ยวข้องกับข้อมูลเมตาของบริการ
FULL แสดงช่องทั้งหมดในคำตอบ

โซ่

เครือคือแบรนด์ที่เชื่อมโยงกับสถานที่ตั้งของธุรกิจ

ช่อง
name

string

ต้องระบุ ชื่อทรัพยากรของเชนในรูปแบบ chains/{chain_id}
chain_names[]

ChainName

ชื่อของเชนธุรกิจ
websites[]

ChainUri

เว็บไซต์ของเครือธุรกิจ
location_count

int32

จำนวนสถานที่ตั้งที่เป็นส่วนหนึ่งของเครือธุรกิจนี้

ChainName

ชื่อที่จะใช้เมื่อแสดงเชน

ช่อง
display_name

string

ชื่อที่แสดงของเชนนี้
language_code

string

รหัส BCP 47 ของภาษาของชื่อ

ChainUri

URL ที่จะใช้เมื่อแสดงเชนธุรกิจ

ช่อง
uri

string

URI ของเชนนี้

CreateLocationRequest

ข้อความคำขอสำหรับ Locations.CreateLocation

ช่อง
parent

string

ต้องระบุ ชื่อบัญชีที่ใช้สร้างสถานที่ตั้งนี้
location

Location

ต้องระบุ ข้อมูลเมตาตำแหน่งใหม่
validate_only

bool

ไม่บังคับ หากจริง ระบบจะตรวจสอบคำขอโดยไม่สร้างสถานที่ตั้งจริง
request_id

string

ไม่บังคับ รหัสคำขอที่ไม่ซ้ำกันเพื่อให้เซิร์ฟเวอร์ตรวจหาคำขอที่ซ้ำกัน เราขอแนะนําให้ใช้ UUID ความยาวสูงสุด 50 อักขระ

DeleteLocationRequest

ข้อความคำขอสำหรับ Locations.DeleteLocation

ช่อง
name

string

ต้องระบุ ชื่อของสถานที่ที่จะลบ

ErrorCode

รหัสข้อผิดพลาดทั้งหมดที่ API แสดงผล

Enum
ERROR_CODE_UNSPECIFIED ไม่มีรหัสข้อผิดพลาด
INVALID_ATTRIBUTE_NAME หนึ่งในแอตทริบิวต์ที่ระบุใช้กับสถานที่ตั้งนี้ไม่ได้ เฉพาะแอตทริบิวต์ที่แสดงผลในการตอบกลับ ListAttributeMetadata เท่านั้นที่นำไปใช้กับสถานที่ตั้งนี้ได้ ชื่อแอตทริบิวต์ที่มีปัญหาทั้งหมดจะแสดงในคีย์ attribute_names ใต้ข้อมูลเมตา
ASSOCIATE_OPERATION_ON_VERIFIED_LOCATION ข้อผิดพลาดนี้จะแสดงขึ้นเมื่อลูกค้าพยายามเชื่อมโยงตำแหน่งหรือล้างการเชื่อมโยงสถานที่ตั้งในสถานที่ตั้งที่อยู่ในสถานะยืนยันแล้ว
ASSOCIATE_LOCATION_INVALID_PLACE_ID place_id ที่ระบุในคำขอ associateLocation ไม่ตรงกับสถานที่ตั้งหรือไม่ถูกต้อง ตรวจสอบว่า place_id ที่ตั้งค่าตรงกับรหัสรายการหนึ่งที่แสดงในการตอบกลับ SearchGoogleLocations
LAT_LNG_UPDATES_NOT_PERMITTED โปรเจ็กต์นี้ไม่ได้รับอนุญาตให้อัปเดตช่องละติจูด/ลองจิจูดในตำแหน่ง คุณสามารถอัปเดตละติจูด/ลองจิจูดโดยใช้ฟังก์ชันวางหมุดใน UI หรือให้ที่อยู่กับเรา
PO_BOX_IN_ADDRESS_NOT_ALLOWED ใช้ตู้ปณ. ในที่อยู่ไม่ได้ คีย์ข้อมูลเมตารวมถึง "field_mask"
BLOCKED_REGION เนื่องจากข้อบังคับระหว่างประเทศที่เราจำเป็นต้องปฏิบัติตาม ทำให้เราไม่สามารถยอมรับธุรกิจจากภูมิภาคนี้ได้ คีย์ข้อมูลเมตารวมถึง "field_maks"
MISSING_BOTH_PHONE_AND_WEBSITE ธุรกิจ CUSTOMER_LOCATION_ONLY จำเป็นต้องมีโทรศัพท์หรือเว็บไซต์ คีย์ข้อมูลเมตารวมถึง "field_mask"
MISSING_STOREFRONT_ADDRESS_OR_SAB สถานที่ตั้งทั้งหมดต้องมีที่อยู่หน้าร้านหรือพื้นที่ให้บริการเป็นอย่างน้อย คีย์ข้อมูลเมตารวมถึง "field_mask"
LAT_LNG_TOO_FAR_FROM_ADDRESS คู่ละติจูด/ลองจิจูดและที่อยู่ห่างกันเกินไป คีย์ข้อมูลเมตารวมถึง "field_mask"
LAT_LNG_REQUIRED เลิกใช้งานแล้ว แทนที่ด้วย PIN_DROP_REQUIRED ไม่พบที่อยู่ที่ระบุ โปรดระบุละติจูด/ลองจิจูด คีย์ข้อมูลเมตารวมถึง "field_mask"
INVALID_CHARACTERS พบอักขระที่ไม่ถูกต้อง คีย์ข้อมูลเมตารวมถึง "field_mask" และ "invalid_characters"
FORBIDDEN_WORDS พบคำต้องห้าม คีย์ข้อมูลเมตารวมถึง "field_mask" และ "forbidden_words"
INVALID_INTERCHANGE_CHARACTERS พบอักขระที่ไม่ถูกต้อง คีย์ข้อมูลเมตารวมถึง "field_mask"
FIELDS_REQUIRED_FOR_CATEGORY ต้องกรอกข้อมูลในช่องเพิ่มเติมสำหรับหมวดหมู่สถานที่ตั้งนี้ คีย์ข้อมูลเมตาประกอบด้วย "field_mask", "value" และ "fields_required"
STOREFRONT_REQUIRED_FOR_CATEGORY หมวดหมู่ธุรกิจของคุณต้องมีสถานที่ตั้งหน้าร้านที่ลูกค้าไปเข้าชมได้ คีย์ข้อมูลเมตารวมถึง "field_mask"
ADDRESS_MISSING_REGION_CODE ที่อยู่ไม่มีรหัสภูมิภาค [region_code] ที่จำเป็น คีย์ข้อมูลเมตารวมถึง "field_mask"
ADDRESS_EDIT_CHANGES_COUNTRY ไม่สามารถย้ายที่อยู่ไปยังประเทศอื่น คีย์ข้อมูลเมตารวมถึง "field_mask"
SPECIAL_HOURS_SET_WITHOUT_REGULAR_HOURS สามารถระบุเวลาทำการพิเศษได้เมื่อสถานที่ตั้งมีเวลาทำการปกติเท่านั้น ข้อมูลเมตาว่างเปล่า
INVALID_TIME_SCHEDULE กำหนดเวลาไม่ถูกต้อง เวลาทับซ้อนกัน หรือเวลาสิ้นสุดอยู่ก่อนเวลาเริ่มต้น คีย์ข้อมูลเมตารวมถึง "field_mask"
INVALID_HOURS_VALUE รูปแบบหรือค่าเวลาทำการไม่ถูกต้อง คีย์ข้อมูลเมตารวมถึง "field_mask"
OVERLAPPED_SPECIAL_HOURS เวลาพิเศษจะทับซ้อนกันไม่ได้ คีย์ข้อมูลเมตารวมถึง "field_mask"
INCOMPATIBLE_MORE_HOURS_TYPE_FOR_CATEGORY หมวดหมู่หลักของธุรกิจของคุณไม่รองรับเวลาทำการนี้ คีย์ข้อมูลเมตารวมถึง "field_mask" และ "incompatible_hours_type"
DUPLICATE_CHILDREN_LOCATIONS Children_locations ซ้ำกันใน related_data คีย์ข้อมูลเมตารวมถึง "field_mask"
INCOMPATIBLE_SERVICE_AREA_AND_CATEGORY ธุรกิจที่ให้บริการตามสถานที่ไม่สามารถมีหมวดหมู่หลักที่เลือกได้ คีย์ข้อมูลเมตารวมถึง "field_mask"
INVALID_SERVICE_AREA_PLACE_ID Place_id ไม่ถูกต้องใน service_area คีย์ข้อมูลเมตารวมถึง "field_mask" และ "place_id"
INVALID_AREA_TYPE_FOR_SERVICE_AREA ประเภทพื้นที่สำหรับ service_area ไม่ถูกต้อง คีย์ข้อมูลเมตารวมถึง "field_mask" และ "place_id"
OPENING_DATE_TOO_FAR_IN_THE_FUTURE ป้อนวันที่เปิดภายในระยะเวลาไม่เกิน 1 ปี คีย์ข้อมูลเมตารวมถึง "field_mask"
OPENING_DATE_MISSING_YEAR_OR_MONTH วันที่เปิดต้องระบุปีหรือเดือน คีย์ข้อมูลเมตารวมถึง "field_mask"
OPENING_DATE_BEFORE_1AD วันที่เปิดต้องไม่ใช่ก่อนคริสต์ศักราชที่ 1 คีย์ข้อมูลเมตารวมถึง "field_mask"
TOO_MANY_ENTRIES มีรายการมากเกินไปสำหรับฟิลด์นี้ คีย์ข้อมูลเมตารวมถึง "field_mask" และ "max_count"
INVALID_PHONE_NUMBER ระบบไม่รู้จักหมายเลขโทรศัพท์ที่ป้อน คีย์ข้อมูลเมตารวมถึง "field_mask" และ "value"
INVALID_PHONE_NUMBER_FOR_REGION หมายเลขโทรศัพท์สำหรับภูมิภาคไม่ถูกต้อง คีย์ข้อมูลเมตารวมถึง "field_mask" และ "value"
MISSING_PRIMARY_PHONE_NUMBER ไม่มีหมายเลขโทรศัพท์หลัก คีย์ข้อมูลเมตารวมถึง "field_mask"
THROTTLED ไม่สามารถอัปเดตฟิลด์ได้ในขณะนี้ คีย์ข้อมูลเมตารวมถึง "field_mask" และ "value"
UNSUPPORTED_POINT_RADIUS_SERVICE_AREA ระบบไม่รองรับพื้นที่ให้บริการในรัศมีของจุดอีกต่อไป คีย์ข้อมูลเมตารวมถึง "field_mask"
INVALID_CATEGORY รหัสหมวดหมู่ไม่ถูกต้อง คีย์ข้อมูลเมตารวมถึง "field_mask" และ "value"
CANNOT_REOPEN ธุรกิจไม่สามารถเปิดใหม่ได้ คีย์ข้อมูลเมตารวมถึง "field_mask"
INVALID_BUSINESS_OPENING_DATE วันเปิดทำการของธุรกิจไม่ถูกต้อง คีย์ข้อมูลเมตารวมถึง "field_mask"
INVALID_LATLNG ละติจูดและลองจิจูดไม่ถูกต้อง คีย์ข้อมูลเมตารวมถึง "field_mask"
PROFILE_DESCRIPTION_CONTAINS_URL คำอธิบายธุรกิจไม่ควรมี URL คีย์ข้อมูลเมตารวมถึง "field_mask"
LODGING_CANNOT_EDIT_PROFILE_DESCRIPTION แก้ไขรายละเอียดโปรไฟล์ของสถานที่ตั้งไม่ได้ คีย์ข้อมูลเมตารวมถึง "field_mask"
INVALID_URL ลิงก์ไม่ถูกต้อง คีย์ข้อมูลเมตารวมถึง "field_mask"
INVALID_ADDRESS ที่อยู่ไม่ถูกต้อง คีย์ข้อมูลเมตารวมถึง "field_mask"
PARENT_CHAIN_CANNOT_BE_THE_LOCATION_ITSELF ParentChain ไม่สามารถเป็นตำแหน่งตัวเองได้ คีย์ข้อมูลเมตารวมถึง "field_mask" และ "value"
RELATION_CANNOT_BE_THE_LOCATION_ITSELF ความสัมพันธ์ต้องไม่เป็นสถานที่ตั้งของตัวเอง คีย์ข้อมูลเมตารวมถึง "field_mask" และ "value"
MISSING_ADDRESS_COMPONENTS ไม่มีค่าสำหรับคอมโพเนนต์ที่อยู่ คีย์ข้อมูลเมตารวมถึง "field_mask"
READ_ONLY_ADDRESS_COMPONENTS ไม่สามารถแก้ไขคอมโพเนนต์ที่อยู่แบบอ่านอย่างเดียว คีย์ข้อมูลเมตารวมถึง "field_mask"
STRING_TOO_LONG สตริงยาวเกินไป คีย์ข้อมูลเมตารวมถึง "field_mask" และ "max_length"
STRING_TOO_SHORT สตริงสั้นเกินไป คีย์ข้อมูลเมตารวมถึง "field_mask" และ "min_length"
REQUIRED_FIELD_MISSING_VALUE ค่าสำหรับช่องที่ต้องกรอกขาดหายไป คีย์ข้อมูลเมตารวมถึง "field_mask"
ATTRIBUTE_PROVIDER_URL_NOT_ALLOWED เพิ่มหรือแก้ไข URL ของผู้ให้บริการไม่ได้ คีย์ข้อมูลเมตาประกอบด้วย "attribute_name"
ATTRIBUTE_INVALID_ENUM_VALUE ค่าที่ไม่รู้จักสำหรับแอตทริบิวต์ enum คีย์ข้อมูลเมตาประกอบด้วย "attribute_name"
ATTRIBUTE_NOT_AVAILABLE แอตทริบิวต์ที่รองรับการปรับขนาดไม่ถูกต้องสำหรับสถานที่ตั้งนี้ คีย์ข้อมูลเมตาประกอบด้วย ""attribute_name"
ATTRIBUTE_CANNOT_BE_REPEATED ระบุแอตทริบิวต์ที่รองรับการปรับขนาดเพียงครั้งเดียว คีย์ข้อมูลเมตาประกอบด้วย "attribute_name"
ATTRIBUTE_TYPE_NOT_COMPATIBLE_FOR_CATEGORY แอตทริบิวต์ที่รองรับการปรับขนาดใช้ไม่ได้กับหมวดหมู่ที่ตั้งค่าไว้ในสถานที่ตั้ง คีย์ข้อมูลเมตาประกอบด้วย "attribute_name"
ADDRESS_REMOVAL_NOT_ALLOWED ไม่อนุญาตให้ธุรกิจของคุณนำที่อยู่ออก คีย์ข้อมูลเมตารวมถึง "field_mask"
AMBIGUOUS_TITLE ชื่อที่ดีที่สุดนั้นกำกวมสำหรับภาษาหนึ่งๆ คีย์ข้อมูลเมตารวมถึง "field_mask"
INVALID_CATEGORY_FOR_SAB SAB แท้จะมี gcid ที่เป็นประเภทย่อยของ gcid:establishment_poi ไม่ได้ คีย์ข้อมูลเมตารวมถึง "field_mask" และ "value"
RELATION_ENDPOINTS_TOO_FAR ปลายทางของความสัมพันธ์อยู่ห่างกันมากเกินไป คีย์ข้อมูลเมตารวมถึง "field_mask" และ "value"
INVALID_SERVICE_ITEM ไม่มีการตั้งค่า Structured_service_item และfree_form_service_item คีย์ข้อมูลเมตารวมถึง "field_mask"
SERVICE_ITEM_LABEL_NO_DISPLAY_NAME ป้ายกำกับไม่มีชื่อที่แสดง คีย์ข้อมูลเมตารวมถึง "field_mask"
SERVICE_ITEM_LABEL_DUPLICATE_DISPLAY_NAME ชื่อที่แสดงไม่ใช่ชื่อเฉพาะสำหรับป้ายกำกับทั้งหมดในรายการราคาทั้งหมด คีย์ข้อมูลเมตารวมถึง "field_mask"
SERVICE_ITEM_LABEL_INVALID_UTF8 ป้ายกำกับมีสัญลักษณ์ UTF-8 ที่ไม่ถูกต้อง คีย์ข้อมูลเมตารวมถึง "field_mask"
FREE_FORM_SERVICE_ITEM_WITH_NO_CATEGORY_ID ไม่มีช่อง category_id ในfree_form_service_item คีย์ข้อมูลเมตารวมถึง "field_mask"
FREE_FORM_SERVICE_ITEM_WITH_NO_LABEL ไม่มีป้ายกำกับในfree_form_service_item คีย์ข้อมูลเมตารวมถึง "field_mask"
SERVICE_ITEM_WITH_NO_SERVICE_TYPE_ID ไม่มีช่อง service_type_id ในstructured_service_item คีย์ข้อมูลเมตารวมถึง "field_mask"
INVALID_LANGUAGE รหัสภาษาไม่ถูกต้อง คีย์ข้อมูลเมตารวมถึง "field_mask"
PRICE_CURRENCY_MISSING ไม่มีรหัสสกุลเงิน ISO 4217 คีย์ข้อมูลเมตารวมถึง "field_mask"
PRICE_CURRENCY_INVALID รหัสสกุลเงินที่ระบุไม่ใช่รหัส ISO 4217 ที่ถูกต้อง คีย์ข้อมูลเมตารวมถึง "field_mask"
SERVICE_TYPE_ID_DUPLICATE รหัสประเภทบริการในสถานที่ตั้งซ้ำกัน คีย์ข้อมูลเมตารวมถึง "field_mask"
PIN_DROP_REQUIRED ไม่พบที่อยู่ที่ระบุ โปรดใช้ UI เพื่อระบุการปักหมุด คีย์ข้อมูลเมตารวมถึง "field_mask"
STALE_DATA มีอย่างน้อย 1 รายการได้รับการอัปเดตโดย Google เมื่อเร็วๆ นี้ เฉพาะเจ้าของธุรกิจนี้เท่านั้นที่สามารถทำการเปลี่ยนแปลงข้อมูลที่อยู่ใน "ฟิลด์" โดยไปที่ business.google.com คีย์ข้อมูลเมตารวมถึง "field_mask"
PHONE_NUMBER_EDITS_NOT_ALLOWED ปิดใช้ช่องหมายเลขโทรศัพท์สำหรับสถานที่นี้และไม่อนุญาตให้แก้ไข คีย์ข้อมูลเมตารวมถึง "field_mask"
MULTIPLE_ORGANIZATIONALLY_PART_OF_RELATION มีความสัมพันธ์มากกว่า 1 แบบที่เป็นต้นแบบของความสัมพันธ์เชิงตรรกะระหว่างสถานที่ 2 แห่ง (เช่น ด้อยประสิทธิภาพ, ทำงานที่) คีย์ข้อมูลเมตารวมถึง "field_mask" และ "value"

GetAttributesRequest

คำขอ AttributesService.GetAttributes

ช่อง
name

string

ต้องระบุ ตัวระบุของ Google สำหรับสถานที่นี้ในรูปแบบ locations/{location_id}/attributes

GetChainRequest

ข้อความคำขอสำหรับ Locations.GetChain

ช่อง
name

string

ต้องระบุ ชื่อทรัพยากรของเชนในรูปแบบ chains/{chain_place_id}

GetGoogleUpdatedAttributesRequest

คำขอ AttributesService.GetGoogleUpdatedAttributes

ช่อง
name

string

ต้องระบุ ตัวระบุของ Google สำหรับสถานที่นี้ในรูปแบบ locations/{location_id}/attributes

GetGoogleUpdatedLocationRequest

ข้อความคำขอสำหรับ Locations.GetGoogleUpdatedLocation

ช่อง
name

string

ต้องระบุ ชื่อของสถานที่ที่จะดึงข้อมูล
read_mask

FieldMask

ต้องระบุ อ่านมาสก์เพื่อระบุช่องที่จะแสดงในคำตอบ

GetLocationRequest

ข้อความคำขอสำหรับ Locations.GetLocation

ช่อง
name

string

ต้องระบุ ชื่อของสถานที่ที่จะดึงข้อมูล
read_mask

FieldMask

ต้องระบุ อ่านมาสก์เพื่อระบุช่องที่จะแสดงในคำตอบ

GoogleLocation

แสดง Location ที่มีอยู่ใน Google ซึ่งอาจเป็นสถานที่ที่ถูกอ้างสิทธิ์โดยผู้ใช้ บุคคลอื่น หรืออาจถูกถอนการอ้างสิทธิ์

ช่อง
name

string

ชื่อทรัพยากรของ GoogleLocation นี้ในรูปแบบ googleLocations/{googleLocationId}
location

Location

ข้อมูล Location ที่มีการป้อนข้อมูลเล็กน้อย คุณใช้ช่องนี้ซ้ำได้ใน CreateLocation หากยังไม่ได้อ้างสิทธิ์จากผู้ใช้
request_admin_rights_uri

string

URL ที่จะเปลี่ยนเส้นทางผู้ใช้ไปยัง UI ของคำขอสิทธิ์ของผู้ดูแลระบบ ช่องนี้จะปรากฏเฉพาะในกรณีที่มีผู้ใช้อ้างสิทธิ์ในสถานที่ดังกล่าวแล้ว รวมทั้งผู้ใช้ปัจจุบันด้วย

GoogleUpdatedLocation

แสดงสถานที่ที่ Google ปรับเปลี่ยน

ช่อง
location

Location

เวอร์ชันที่ Google อัปเดตของสถานที่นี้
diff_mask

FieldMask

ช่องที่ Google อัปเดต
pending_mask

FieldMask

ฟิลด์ที่มีการแก้ไขที่รอดำเนินการซึ่งยังไม่ได้พุชไปยัง Maps และ Search

ป้ายกำกับ

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

ช่อง
display_name

string

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

string

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

string

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

ListAttributeMetadataRequest

คำขอ AttributesService.ListAttributeMetadata

ช่อง
parent

string

ชื่อทรัพยากรของตำแหน่งเพื่อค้นหาแอตทริบิวต์ที่พร้อมใช้งาน หากตั้งค่าช่องนี้ไว้ ไม่จําเป็นต้องตั้งค่า category_name, ภูมิภาค_code, language_code และ show_all
category_name

string

รหัสแบบคงที่ของหมวดหมู่หลักสำหรับค้นหาแอตทริบิวต์ที่พร้อมใช้งาน ต้องอยู่ในรูปแบบหมวดหมู่/{category_id}
region_code

string

รหัสประเทศ ISO 3166-1 alpha-2 เพื่อค้นหาแอตทริบิวต์ที่ใช้ได้
language_code

string

รหัสภาษา BCP 47 ที่ใช้รับชื่อที่แสดงของแอตทริบิวต์ แต่หากไม่มีภาษาดังกล่าว ก็จะเป็นภาษาอังกฤษ
show_all

bool

ระบบจะแสดงข้อมูลเมตาสำหรับแอตทริบิวต์ที่ใช้ได้ทั้งหมดเมื่อตั้งค่าช่องนี้เป็น "จริง" โดยไม่คำนึงถึงช่องหลักและ category_name ต้องระบุ language_code และregion_code เมื่อตั้งค่า show_all เป็น "จริง"
page_size

int32

จำนวนแอตทริบิวต์ที่จะใส่ใน 1 หน้า ค่าเริ่มต้นคือ 200 และต่ำสุดคือ 1
page_token

string

หากระบุไว้ ระบบจะดึงข้อมูลหน้าถัดไปของข้อมูลเมตาของแอตทริบิวต์

ListAttributeMetadataResponse

การตอบกลับสำหรับ AttributesService.ListAttributeMetadata

ช่อง
attribute_metadata[]

AttributeMetadata

คอลเล็กชันข้อมูลเมตาของแอตทริบิวต์สำหรับแอตทริบิวต์ที่พร้อมใช้งาน
next_page_token

string

หากจำนวนแอตทริบิวต์เกินขนาดหน้าที่ขอ ระบบจะเติมข้อมูลในช่องนี้ด้วยโทเค็นเพื่อดึงข้อมูลแอตทริบิวต์หน้าถัดไปในการเรียก attributes.list ครั้งถัดไป หากไม่มีแอตทริบิวต์อื่นเพิ่มเติม ระบบจะไม่แสดงช่องนี้ในการตอบกลับ

ListCategoriesRequest

ข้อความคำขอสำหรับ BusinessCategory.ListCategory

ช่อง
region_code

string

ต้องระบุ รหัสประเทศ ISO 3166-1 alpha-2
language_code

string

ต้องระบุ รหัสภาษา BCP 47
filter

string

ไม่บังคับ กรองสตริงจากผู้ใช้ ช่องเดียวที่รองรับคือ displayName เช่น filter=displayName=foo
page_size

int32

ไม่บังคับ จำนวนหมวดหมู่ที่จะดึงข้อมูลต่อ 1 หน้า ค่าเริ่มต้นคือ 100, ต่ำสุดคือ 1 และขนาดสูงสุดของหน้าเว็บคือ 100
page_token

string

ไม่บังคับ หากระบุไว้ ระบบจะดึงข้อมูลหมวดหมู่ถัดไป
view

CategoryView

ต้องระบุ ระบุว่าควรแสดงผลส่วนใดของทรัพยากรหมวดหมู่ในการตอบกลับ

ListCategoriesResponse

ข้อความตอบกลับสำหรับ BusinessCategory.ListCategory

ช่อง
categories[]

Category

หมวดหมู่ที่ตรงกันตามพารามิเตอร์ที่ขอ
next_page_token

string

หากมีหมวดหมู่เกินขนาดหน้าที่ขอ จะมีการเติมข้อมูลในช่องนี้ด้วยโทเค็นเพื่อดึงข้อมูลหมวดหมู่หน้าถัดไปในการเรียก ListCategories ครั้งถัดไป

ListLocationsRequest

ข้อความคำขอสำหรับ Locations.ListLocations

ช่อง
parent

string

ต้องระบุ ชื่อบัญชีที่จะดึงข้อมูลสถานที่ หาก [บัญชี] ผู้ปกครอง [google.mybusiness.accountmanagement.v1.Account] เป็นของ [AccountType] [google.mybusiness.accountmanagement.v1.Account.AccountType] PERSONAL จะส่งคืนเฉพาะสถานที่ที่บัญชีเป็นเจ้าของโดยตรงเท่านั้น มิฉะนั้นจะแสดงสถานที่ที่เข้าถึงได้ทั้งหมดจากบัญชี ไม่ว่าจะโดยตรงหรือโดยอ้อม
page_size

int32

ไม่บังคับ จำนวนสถานที่ที่จะดึงข้อมูลต่อ 1 หน้า ค่าเริ่มต้นคือ 10 หากไม่ได้ตั้งค่าไว้ ค่าต่ำสุดคือ 1 และมีขนาดหน้าเว็บสูงสุดคือ 100
page_token

string

ไม่บังคับ หากระบุไว้ ระบบจะดึงสถานที่ตั้ง page แห่งถัดไป โทเค็นของหน้าเว็บจะส่งคืนจากการเรียกไปยัง ListLocations ครั้งก่อน เมื่อมีสถานที่มากเกินกว่าจะพอดีกับขนาดหน้าที่ร้องขอ
filter

string

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

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับช่องที่ถูกต้องและการใช้งานตัวอย่าง โปรดดูคู่มือการใช้ข้อมูลตำแหน่ง
order_by

string

ไม่บังคับ กำลังจัดเรียงคำขอ ช่องหลายช่องควรคั่นด้วยคอมมาโดยใช้ไวยากรณ์ SQL ต่อไปนี้ ลำดับการจัดเรียงเริ่มต้นคือจากน้อยไปมาก หากต้องการระบุลำดับจากมากไปน้อย ให้ใส่คำต่อท้าย " มากไปน้อย" ควรเพิ่มลงไป ฟิลด์ที่ถูกต้องสําหรับ order_by คือ title และ store_code เช่น "title, store_code desc" หรือ "title" หรือ "store_code desc"
read_mask

FieldMask

ต้องระบุ อ่านมาสก์เพื่อระบุช่องที่จะแสดงในคำตอบ

การตอบกลับ ListLocations

ข้อความตอบกลับสำหรับ Locations.ListLocations

ช่อง
locations[]

Location

สถานที่
next_page_token

string

ถ้าจำนวนสถานที่ตั้งเกินขนาดหน้าเว็บที่ขอ ฟิลด์นี้จะมีโทเค็นเพื่อดึงข้อมูลหน้าถัดไปของสถานที่ตั้งในการเรียก ListLocations ครั้งต่อๆ ไป หากไม่มีตำแหน่งเพิ่มเติม ช่องนี้จะไม่ปรากฏในคำตอบ
total_size

int32

จำนวนตำแหน่งโดยประมาณในรายการโดยไม่คำนึงถึงการใส่เลขหน้า ระบบจะแสดงผลช่องนี้เฉพาะในกรณีที่ใช้ filter เป็นพารามิเตอร์การค้นหา

ตำแหน่ง

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

ช่อง
name

string

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

string

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

string

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

string

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

PhoneNumbers

ไม่บังคับ หมายเลขโทรศัพท์ต่างๆ ที่ลูกค้าสามารถใช้เพื่อติดต่อธุรกิจได้
categories

Categories

ไม่บังคับ หมวดหมู่ต่างๆ ที่อธิบายธุรกิจ
storefront_address

PostalAddress

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

string

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

BusinessHours

ไม่บังคับ เวลาทําการของธุรกิจ
special_hours

SpecialHours

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

ServiceAreaBusiness

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

string

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

AdWordsLocationExtensions

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

LatLng

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

OpenInfo

ไม่บังคับ ธงที่บ่งชี้ว่าสถานที่เปิดให้บริการอยู่หรือไม่
metadata

Metadata

เอาต์พุตเท่านั้น ข้อมูลเพิ่มเติมที่ผู้ใช้แก้ไขไม่ได้
profile

Profile

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

ต้องกรอกข้อมูลในช่องนี้สำหรับทุกหมวดหมู่ ยกเว้นหมวดหมู่ที่พัก (เช่น โรงแรม โมเทล โรงแรมขนาดเล็ก)
relationship_data

RelationshipData

ไม่บังคับ สถานที่และเครือทั้งหมดที่เกี่ยวข้องกับสถานที่นี้
more_hours[]

MoreHours

ไม่บังคับ เวลาทําการเพิ่มเติมสําหรับแผนกต่างๆ หรือลูกค้าบางกลุ่ม
service_items[]

ServiceItem

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

ข้อมูลเมตา

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

ช่อง
has_google_updated

bool

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

bool

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

bool

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

bool

เอาต์พุตเท่านั้น ระบุว่าข้อมูลจัดการโพสต์ในเครื่องได้หรือไม่
can_modify_service_list

bool

เอาต์พุตเท่านั้น ระบุว่าข้อมูลแก้ไขรายการบริการได้หรือไม่
can_have_food_menus

bool

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

bool

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

bool

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

string

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

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

string

เอาต์พุตเท่านั้น ทรัพยากรสถานที่ที่สถานที่นี้ซ้ำกัน
maps_uri

string

เอาต์พุตเท่านั้น ลิงก์ไปยังสถานที่ใน Maps
new_review_uri

string

เอาต์พุตเท่านั้น ลิงก์ไปยังหน้าใน Google Search ซึ่งลูกค้าสามารถเขียนรีวิวสำหรับสถานที่ตั้งได้
can_have_business_calls

bool

เอาต์พุตเท่านั้น ระบุว่าข้อมูลมีสิทธิ์ใช้การโทรของธุรกิจหรือไม่
has_voice_of_merchant

bool

เอาต์พุตเท่านั้น ระบุว่าข้อมูลมี Voice of Merchant หรือไม่ หากบูลีนนี้เป็นเท็จ คุณควรเรียกใช้ locations.getVoiceOfMerchantState API เพื่อดูรายละเอียดว่าเหตุใดโดเมนเหล่านี้จึงไม่มี Voice of Merchant

MoreHours

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

ช่อง
hours_type_id

string

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

TimePeriod

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

MoreHoursType

ประเภทเวลาทำการเพิ่มเติมที่ธุรกิจนำเสนอได้นอกเหนือจากเวลาทำการปกติ

ช่อง
hours_type_id

string

เอาต์พุตเท่านั้น รหัสแบบคงที่ที่ Google มีให้สำหรับเวลาทำการประเภทนี้
display_name

string

เอาต์พุตเท่านั้น ชื่อที่แสดงที่เป็นภาษาอังกฤษซึ่งมนุษย์อ่านได้สำหรับประเภทเวลาทำการ
localized_display_name

string

เอาต์พุตเท่านั้น ชื่อที่แสดงซึ่งแปลเป็นภาษาท้องถิ่นซึ่งมนุษย์อ่านได้สำหรับประเภทเวลาทำการ

OpenInfo

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

ช่อง
status

OpenForBusiness

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

bool

เอาต์พุตเท่านั้น ระบุว่าธุรกิจนี้มีสิทธิ์กลับมาเปิดให้บริการอีกครั้งหรือไม่
opening_date

Date

ไม่บังคับ วันที่เปิดสถานที่เป็นครั้งแรก หากไม่ทราบวันที่ที่แน่นอน คุณจะระบุได้เฉพาะเดือนและปี วันที่ต้องเป็นวันที่ที่ผ่านมาแล้วหรือไม่เกิน 1 ปีนับจากปัจจุบัน

OpenForBusiness

ระบุสถานะของสถานที่

Enum
OPEN_FOR_BUSINESS_UNSPECIFIED ไม่ได้ระบุ
OPEN บ่งบอกว่าสถานที่เปิดอยู่
CLOSED_PERMANENTLY ระบุว่าสถานที่ปิดถาวรแล้ว
CLOSED_TEMPORARILY บ่งบอกว่าสถานที่นี้ปิดชั่วคราวแล้ว

PhoneNumbers

คอลเล็กชันหมายเลขโทรศัพท์สำหรับธุรกิจ ในระหว่างการอัปเดต ต้องตั้งค่าทั้ง 2 ฟิลด์ ไคลเอ็นต์ไม่สามารถอัปเดตเฉพาะหมายเลขโทรศัพท์หลักหรือหมายเลขโทรศัพท์เพิ่มเติมโดยใช้มาสก์การอัปเดต ใช้รูปแบบหมายเลขโทรศัพท์ระหว่างประเทศ เช่น "+1 415 555 0132" ดูข้อมูลเพิ่มเติมใน (https://developers.google.com/style/phone-numbers#international-phone-numbers)

ช่อง
primary_phone

string

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

string

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

PlaceInfo

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

ช่อง
place_name

string

ต้องระบุ ชื่อที่แปลแล้วของสถ านที่ เช่น Scottsdale, AZ
place_id

string

ต้องระบุ รหัสของสถานที่ ต้องตรงกับภูมิภาค (https://developers.google.com/places/web-service/supported_types#table3)

สถานที่

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

ช่อง
place_infos[]

PlaceInfo

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

โปรไฟล์

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

ช่อง
description

string

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

RelationshipData

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

ช่อง
parent_location

RelevantLocation

สถานที่ตั้งหลักที่สถานที่นี้มีความสัมพันธ์ด้วย
children_locations[]

RelevantLocation

รายการสถานที่ตั้งย่อยที่สถานที่นี้มีความสัมพันธ์ด้วย
parent_chain

string

ชื่อทรัพยากรของเชนที่สถานที่นี้เป็นสมาชิกอยู่ [วิธีค้นหารหัสเชน] [Locations.SearchChains]

RelevantLocation

ข้อมูลเกี่ยวกับสถานที่อื่นที่เกี่ยวข้องกับสถานที่ปัจจุบัน ความสัมพันธ์อาจเป็น DEPARTMENT_OF หรือ INDEPENDENT_ESTABLISHMENT_OF ใดก็ได้ และสถานที่ตั้งที่ระบุที่นี่อาจอยู่ในฝั่งใดฝั่งหนึ่ง (หลัก/ย่อย) ของสถานที่ตั้ง

ช่อง
place_id

string

ต้องระบุ ระบุตำแหน่งที่อยู่อีกด้านหนึ่งของความสัมพันธ์ด้วยรหัสสถานที่
relation_type

RelationType

ต้องระบุ ประเภทของความสัมพันธ์

RelationType

ความสัมพันธ์ของประเภทที่จะต้องระบุ

Enum
RELATION_TYPE_UNSPECIFIED ยังไม่ระบุประเภท
DEPARTMENT_OF ข้อมูลนี้แสดงถึงความสัมพันธ์ระหว่างสถานที่ 2 แห่งที่มีพื้นที่ทางกายภาพเดียวกัน ใช้แบรนด์/การจัดการ/องค์กรระดับบนเดียวกัน แต่มีแอตทริบิวต์หลักต่างกัน เช่น เวลาทำการหรือหมายเลขโทรศัพท์ ตัวอย่างเช่น Costco Pharmacy เป็นแผนกใน Costco Wholesale
INDEPENDENT_ESTABLISHMENT_IN ซึ่งแสดงในกรณีที่สถานที่ตั้ง 2 แห่งตั้งอยู่ร่วมกันในสถานที่ตั้งจริงเดียวกัน แต่มาจากบริษัทที่ต่างกัน (เช่น Starbucks ใน Safeway ร้านค้าในห้างสรรพสินค้า)

RepeatedEnumAttributeValue

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

ช่อง
set_values[]

string

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

string

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

SearchChainsRequest

ข้อความคำขอสำหรับ Locations.SearchChains

ช่อง
chain_name

string

ต้องระบุ ค้นหาเครือธุรกิจตามชื่อ รองรับการค้นหาที่ตรงทั้งหมด/บางส่วน/ไม่แน่นอน/ที่เกี่ยวข้อง เช่น "walmart", "wal-mart", "walmmmart", "沃尔玛"
page_size

int32

จำนวนสูงสุดของเชนที่ตรงกันที่จะแสดงจากการค้นหานี้ ค่าเริ่มต้นคือ 10 ค่าสูงสุดที่เป็นไปได้คือ 500

SearchChainsResponse

ข้อความตอบกลับสำหรับ Locations.SearchChains

ช่อง
chains[]

Chain

เชนที่ตรงกับChain_display_name ที่ค้นหาใน SearchChainsRequest หากไม่มีรายการที่ตรงกัน ช่องนี้จะว่างเปล่า ผลลัพธ์จะแสดงตามลำดับความเกี่ยวข้อง

SearchGoogleLocationsRequest

ข้อความคำขอสำหรับ GoogleLocations.SearchGoogleLocations

ช่อง
page_size

int32

จำนวนรายการที่ตรงกันที่จะส่งคืน ค่าเริ่มต้นคือ 3 แต่สูงสุด 10 รายการ โปรดทราบว่าเวลาในการตอบสนองอาจเพิ่มขึ้นหากมีการร้องขอเพิ่มเติม โดยไม่มีการใส่เลขหน้า
ช่องการรวม search_query คำค้นหา ซึ่งสามารถระบุเป็นออบเจ็กต์ตำแหน่งหรือการค้นหาสตริงก็ได้ search_query ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
location

Location

ตำแหน่งที่จะค้นหา หากระบุ ระบบจะค้นหาสถานที่ตั้งที่ตรงกับรายละเอียดสถานที่ตั้งที่ให้ไว้
query

string

ข้อความค้นหาที่จะค้นหา ผลการค้นหาจากสตริงการค้นหาจะมีความแม่นยำน้อยกว่าการระบุตำแหน่งที่แน่นอน แต่ก็สามารถแสดงการจับคู่ที่ไม่ตรงกันมากกว่า

SearchGoogleLocationsResponse

ข้อความตอบกลับสำหรับ GoogleLocations.SearchGoogleLocations

ช่อง
google_locations[]

GoogleLocation

คอลเล็กชันของ GoogleLocations ที่อาจตรงกับคำขอที่ระบุ โดยเรียงลำดับจากความแม่นยำมากที่สุดไปน้อยที่สุด

ServiceAreaBusiness

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

ช่อง
business_type

BusinessType

ต้องระบุ ระบุ [type] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] ของธุรกิจที่ให้บริการตามสถานที่
places

Places

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

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 การอัปเดตสถานที่ตั้งต้องมีฟิลด์มาสก์ storefront_address และตั้งค่าให้ฟิลด์ว่างเปล่า
CUSTOMER_AND_BUSINESS_LOCATION ให้บริการในที่อยู่ธุรกิจและบริเวณโดยรอบ

ServiceItem

ข้อความที่อธิบายรายการบริการเดียว ซึ่งใช้เพื่ออธิบายประเภทบริการที่ผู้ขายมีให้ ตัวอย่างเช่น การตัดผมเป็นบริการหนึ่ง

ช่อง
price

Money

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

StructuredServiceItem

ไม่บังคับ ช่องนี้จะกำหนดลักษณะตัวพิมพ์ของข้อมูลบริการที่มีโครงสร้าง
free_form_service_item

FreeFormServiceItem

ไม่บังคับ ช่องนี้จะเป็นการตั้งค่าลักษณะตัวจำลองของข้อมูลบริการรูปแบบอิสระ

FreeFormServiceItem

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

ช่อง
category

string

ต้องระบุ ฟิลด์นี้จะแสดงชื่อหมวดหมู่ (เช่น รหัสแบบคงที่ของหมวดหมู่) category และ service_type_id ควรตรงกับชุดค่าผสมที่เป็นไปได้ที่ระบุไว้ในข้อความ Category
label

Label

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

StructuredServiceItem

หมายถึงบริการที่มีโครงสร้างซึ่งผู้ขายเสนอ เช่น toilet_installation

ช่อง
service_type_id

string

ต้องระบุ ช่อง service_type_id คือรหัสที่ไม่ซ้ำกันที่ Google ให้ไว้ซึ่งพบใน ServiceType ข้อมูลนี้มาจากบริการ RPC ของ BatchGetCategories
description

string

ไม่บังคับ คำอธิบายรายการบริการที่มีโครงสร้าง จํานวนอักขระสูงสุดคือ 300 ตัว

ServiceType

ข้อความที่อธิบายประเภทบริการที่ธุรกิจเสนอ

ช่อง
service_type_id

string

เอาต์พุตเท่านั้น รหัสแบบคงที่ (มาจาก Google) สำหรับบริการประเภทนี้
display_name

string

เอาต์พุตเท่านั้น ชื่อที่แสดงที่มนุษย์อ่านได้สำหรับประเภทบริการ

SpecialHourPeriod

แสดงช่วงเวลาเดียวที่เวลาทำการของสถานที่ต่างจากเวลาทำการปกติ ช่วงเวลาพิเศษต้องแสดงช่วงเวลาน้อยกว่า 24 ชั่วโมง open_time และ start_date ต้องมาก่อน close_time และ end_date close_time และ end_date สามารถขยายเวลาจนถึง 11:59 น. ของวันหลัง start_date ที่ระบุ ตัวอย่างเช่น อินพุตต่อไปนี้ถูกต้อง

start_date=2015-11-23, open_time=08:00, close_time=18:00
start_date=2015-11-23, end_date=2015-11-23, open_time=08:00,
close_time=18:00 start_date=2015-11-23, end_date=2015-11-24,
open_time=13:00, close_time=11:59

อินพุตต่อไปนี้ไม่ถูกต้อง

start_date=2015-11-23, open_time=13:00, close_time=11:59
start_date=2015-11-23, end_date=2015-11-24, open_time=13:00,
close_time=12:00 start_date=2015-11-23, end_date=2015-11-25,
open_time=08:00, close_time=18:00
ช่อง
start_date

Date

ต้องระบุ วันที่ในปฏิทินช่วงเวลาทำการพิเศษนี้จะเริ่มต้น
open_time

TimeOfDay

ไม่บังคับ ค่าที่ใช้ได้คือ 00:00-24:00 โดย 24:00 แทนเที่ยงคืนของตอนท้ายของช่องวันที่ระบุ ต้องระบุหาก closed เป็นเท็จ
end_date

Date

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

TimeOfDay

ไม่บังคับ ค่าที่ใช้ได้คือ 00:00-24:00 โดย 24:00 แทนเที่ยงคืนของตอนท้ายของช่องวันที่ระบุ ต้องระบุหาก closed เป็นเท็จ
closed

bool

ไม่บังคับ หากเป็น "จริง" ระบบจะไม่สนใจ end_date, open_time และ close_time และวันที่ที่ระบุใน start_date จะถือเป็นปิดสถานที่ทั้งวัน

SpecialHours

แสดงชุดระยะเวลาที่เวลาทำการของสถานที่ตั้งแตกต่างจากเวลาทำการปกติ

ช่อง
special_hour_periods[]

SpecialHourPeriod

ต้องระบุ รายการข้อยกเว้นสำหรับเวลาทำการปกติของธุรกิจ

TimePeriod

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

ช่อง
open_day

DayOfWeek

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

TimeOfDay

ต้องระบุ ค่าที่ใช้ได้คือ 00:00-24:00 โดย 24:00 แทนเที่ยงคืนของตอนท้ายของวันที่ระบุ
close_day

DayOfWeek

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

TimeOfDay

ต้องระบุ ค่าที่ใช้ได้คือ 00:00-24:00 โดย 24:00 แทนเที่ยงคืนของตอนท้ายของวันที่ระบุ

UpdateAttributesRequest

คำขอ AttributesService.UpdateAttributes

ช่อง
attributes

Attributes

คอลเล็กชันแอตทริบิวต์ที่ต้องอัปเดต
attribute_mask

FieldMask

ต้องระบุ ชื่อแอตทริบิวต์ของแอตทริบิวต์ที่ต้องการอัปเดต เป็นตัวแทนโดย attributes/{attribute}

การอัปเดต: แอตทริบิวต์ทั้งหมดที่ระบุในช่องแอตทริบิวต์ที่ต้องการอัปเดตต้องตั้งค่าใน attribute_mask แอตทริบิวต์ที่ตั้งค่าไว้ในรายการด้านบนแต่ไม่ได้อยู่ใน attribute_mask จะถูกละเว้น

ลบ: หากต้องการลบแอตทริบิวต์บางรายการ คุณต้องระบุแอตทริบิวต์เหล่านั้นใน attribute_mask โดยที่ไม่มีรายการที่ตรงกันในรายการแอตทริบิวต์ หากต้องการลบแอตทริบิวต์ทั้งหมดที่ตั้งค่าไว้ในสถานที่ คุณควรค้นหาแอตทริบิวต์ที่เกี่ยวข้องทั้งหมดสำหรับสถานที่ตั้ง แล้วเพิ่มแอตทริบิวต์เหล่านั้นลงใน attribute_mask ด้วยช่องแอตทริบิวต์ที่ว่างเปล่า

UpdateLocationRequest

ข้อความคำขอสำหรับ Locations.UpdateLocation

ช่อง
location

Location

ต้องระบุ ข้อมูลตำแหน่งที่อัปเดต
update_mask

FieldMask

ต้องระบุ ช่องข้อมูลที่ต้องการอัปเดต
validate_only

bool

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

UriAttributeValue

ค่าของแอตทริบิวต์ที่มี URL value_type

ช่อง
uri

string

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