- Tài nguyên: Vị trí
- Biểu diễn dưới dạng JSON
- BusinessHours
- TimePeriod
- DayOfWeek
- SpecialHours
- SpecialHourPeriod
- ServiceAreaBusiness
- BusinessType
- PointRadius
- LatLng
- Địa điểm
- PlaceInfo
- LocationKey
- AdWordsLocationExtensions
- OpenInfo
- OpenForBusiness
- LocationState
- Thuộc tính
- RepeatedEnumAttributeValue
- UrlAttributeValue
- Siêu dữ liệu
- Sao chép
- Quyền truy cập
- PriceList
- Nhãn
- Phần
- SectionType
- Mặt hàng
- Tiền
- Hồ sơ
- RelationshipData
- MoreHours
- Phương thức
Tài nguyên: Vị trí
Một vị trí. Hãy xem bài viết trên trung tâm trợ giúp để biết nội dung mô tả chi tiết về các trường này hoặc xem điểm cuối của danh mục để biết danh sách các danh mục kinh doanh hợp lệ.
Biểu diễn dưới dạng JSON | |
---|---|
{ "name": string, "languageCode": string, "storeCode": string, "locationName": string, "primaryPhone": string, "additionalPhones": [ string ], "address": { object ( |
Trường | |
---|---|
name |
Giá trị nhận dạng của Google cho vị trí này trong biểu mẫu: Trong bối cảnh kết quả trùng khớp, trường này sẽ không được điền sẵn. |
languageCode |
Ngôn ngữ của vị trí. Được thiết lập trong quá trình tạo và không thể cập nhật. |
storeCode |
Giá trị nhận dạng bên ngoài của vị trí này. Giá trị này phải là giá trị duy nhất trong một tài khoản nhất định. Đây là phương tiện để liên kết vị trí với hồ sơ của riêng bạn. |
locationName |
Tên vị trí phải phản ánh tên doanh nghiệp trong thực tế, được sử dụng nhất quán trên mặt tiền cửa hàng, trang web và văn phòng phẩm cũng như được khách hàng biết đến. Bạn có thể đưa mọi thông tin bổ sung vào các trường khác của tài nguyên (ví dụ: |
primaryPhone |
Là số điện thoại kết nối trực tiếp nhất có thể với địa điểm kinh doanh riêng của bạn. Nếu có thể, hãy sử dụng số điện thoại tại địa phương thay vì số đường dây hỗ trợ của trung tâm chăm sóc khách hàng. |
additionalPhones[] |
Ngoài số điện thoại chính, bạn có thể sử dụng tối đa 2 số điện thoại (di động hoặc cố định, không được là số fax) để gọi cho doanh nghiệp của mình. |
address |
Một địa chỉ rõ ràng, chính xác để mô tả địa điểm doanh nghiệp của bạn. Không chấp nhận hòm thư bưu điện hoặc hòm thư đặt tại những vị trí xa xôi. Tại thời điểm này, bạn có thể chỉ định tối đa năm giá trị |
primaryCategory |
Danh mục mô tả đúng nhất về hoạt động kinh doanh cốt lõi của địa điểm này. |
additionalCategories[] |
Các danh mục bổ sung để mô tả doanh nghiệp của bạn. Danh mục giúp khách hàng tìm thấy kết quả chính xác, cụ thể cho dịch vụ mà họ quan tâm. Để thông tin doanh nghiệp của bạn luôn chính xác và cập nhật, hãy đảm bảo rằng bạn sử dụng càng ít danh mục càng tốt để mô tả tổng thể hoạt động kinh doanh cốt lõi của mình. Chọn danh mục càng cụ thể càng tốt, nhưng đại diện cho công việc kinh doanh chính của bạn. |
websiteUrl |
URL cho doanh nghiệp này. Nếu có thể, hãy sử dụng URL đại diện cho địa điểm kinh doanh riêng lẻ này thay vì trang web/URL chung chung đại diện cho tất cả các địa điểm hoặc thương hiệu. |
regularHours |
Giờ làm việc của doanh nghiệp. |
specialHours |
Giờ đặc biệt của doanh nghiệp. Thời điểm này thường bao gồm giờ hoạt động vào ngày lễ và những thời điểm khác ngoài giờ làm việc thông thường. Các giờ này sẽ thay thế giờ làm việc thông thường. |
serviceArea |
Doanh nghiệp thuộc lĩnh vực dịch vụ cung cấp dịch vụ tại vị trí của khách hàng. Nếu doanh nghiệp này là một doanh nghiệp thuộc lĩnh vực dịch vụ, thì trường này mô tả(các) khu vực mà doanh nghiệp đang cung cấp. |
locationKey |
Bộ sưu tập các khoá liên kết doanh nghiệp này với các sản phẩm khác của Google, chẳng hạn như trang Google+ và Google Maps Địa điểm. |
labels[] |
Tập hợp các chuỗi dạng tự do để cho phép bạn gắn thẻ doanh nghiệp của mình. Các nhãn này KHÔNG dành cho người dùng; chỉ bạn mới có thể xem chúng. Tối đa 255 ký tự (mỗi nhãn). |
adWordsLocationExtensions |
Thông tin bổ sung xuất hiện trong AdWords. |
latlng |
Vĩ độ và kinh độ do người dùng cung cấp. Khi tạo một vị trí, trường này bị bỏ qua nếu bạn đã cung cấp mã địa lý thành công. Trường này chỉ được trả về khi có yêu cầu get nếu giá trị |
openInfo |
Cờ cho biết liệu vị trí hiện có đang mở cửa kinh doanh hay không. |
locationState |
Chỉ có đầu ra. Một tập hợp boolean phản ánh trạng thái của một vị trí. |
attributes[] |
Các thuộc tính cho vị trí này. |
metadata |
Chỉ có đầu ra. Thông tin bổ sung mà người dùng không chỉnh sửa được. |
priceLists[] |
Không dùng nữa: Thông tin bảng giá cho vị trí này. |
profile |
Mô tả doanh nghiệp của bạn theo cách của riêng bạn và chia sẻ với người dùng câu chuyện độc đáo về doanh nghiệp và sản phẩm/dịch vụ của bạn. |
relationshipData |
Tất cả địa điểm và chuỗi liên quan đến địa điểm này. |
moreHours[] |
Giờ khác cho các phòng ban hoặc khách hàng cụ thể của một doanh nghiệp. |
BusinessHours
Thể hiện khoảng thời gian vị trí này mở cửa hoạt động. Lưu giữ một tập hợp gồm TimePeriod
thực thể.
Biểu diễn dưới dạng JSON | |
---|---|
{
"periods": [
{
object ( |
Trường | |
---|---|
periods[] |
Tập hợp thời gian vị trí này mở cửa hoạt động. Mỗi khoảng thời gian đại diện cho một khoảng giờ khi vị trí mở cửa trong tuần. |
TimePeriod
Thể hiện khoảng thời gian mà doanh nghiệp mở cửa, bắt đầu vào ngày/giờ mở cửa được chỉ định và đóng cửa vào ngày/giờ đóng cửa được chỉ định. Thời gian đóng cửa phải sau thời gian mở cửa, ví dụ như muộn hơn trong cùng một ngày hoặc vào ngày tiếp theo.
Biểu diễn dưới dạng JSON | |
---|---|
{ "openDay": enum ( |
Trường | |
---|---|
openDay |
Cho biết thời gian |
openTime |
Thời gian ở định dạng mở rộng ISO 8601 là 24 giờ (hh:mm). Giá trị hợp lệ là 00:00-24:00, trong đó 24:00 thể hiện nửa đêm ở cuối trường ngày được chỉ định. |
closeDay |
Cho biết thời gian này sẽ kết thúc vào |
closeTime |
Thời gian ở định dạng mở rộng ISO 8601 trong 24 giờ (hh:mm). Giá trị hợp lệ là 00:00-24:00, trong đó 24:00 thể hiện nửa đêm ở cuối trường ngày được chỉ định. |
DayOfWeek
Đại diện cho một ngày trong tuần.
Enum | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
Ngày trong tuần không được chỉ định. |
MONDAY |
Thứ Hai |
TUESDAY |
Tuesday (thứ Ba) |
WEDNESDAY |
Wednesday (thứ Tư) |
THURSDAY |
Thursday (thứ Năm) |
FRIDAY |
Friday (thứ Sáu) |
SATURDAY |
Saturday (thứ Bảy) |
SUNDAY |
Chủ Nhật |
SpecialHours
Đại diện cho một tập hợp khoảng thời gian khi giờ hoạt động của một vị trí khác với giờ làm việc thông thường của vị trí đó.
Biểu diễn dưới dạng JSON | |
---|---|
{
"specialHourPeriods": [
{
object ( |
Trường | |
---|---|
specialHourPeriods[] |
Danh sách các trường hợp ngoại lệ đối với giờ làm việc thông thường của doanh nghiệp. |
SpecialHourPeriod
Biểu thị một khoảng thời gian khi giờ hoạt động của một vị trí khác với giờ làm việc thông thường của vị trí đó. Khoảng giờ đặc biệt phải đại diện cho phạm vi ít hơn 24 giờ. openTime
và startDate
phải trước closeTime
và endDate
. closeTime
và endDate
có thể kéo dài đến 11:59 sáng vào ngày sau startDate
được chỉ định. Ví dụ: các giá trị nhập sau đây là hợp lệ:
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
Các giá trị nhập sau đây không hợp lệ:
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
Biểu diễn dưới dạng JSON | |
---|---|
{ "startDate": { object ( |
Trường | |
---|---|
startDate |
Ngày theo lịch cho khoảng thời gian đặc biệt này. |
openTime |
Thời gian hiển thị trên |
endDate |
Ngày theo lịch để khoảng thời gian đặc biệt này kết thúc. Nếu bạn không đặt trường |
closeTime |
Thời gian thực tế trên |
isClosed |
Nếu giá trị là true, thì |
ServiceAreaBusiness
Doanh nghiệp hoạt động trong khu vực kinh doanh cung cấp dịch vụ tại địa điểm của khách hàng (ví dụ: thợ khoá hoặc thợ sửa ống nước).
Biểu diễn dưới dạng JSON | |
---|---|
{ "businessType": enum ( |
Trường | ||
---|---|---|
businessType |
Cho biết |
|
Trường kết hợp coverageArea . Cho biết khu vực phủ sóng nơi doanh nghiệp cung cấp dịch vụ. coverageArea chỉ có thể là một trong những trạng thái sau đây: |
||
radius |
Chỉ có đầu ra. Khu vực mà doanh nghiệp này phục vụ tập trung quanh một điểm. |
|
places |
Khu vực mà doanh nghiệp này phục vụ, được xác định thông qua một nhóm địa điểm. |
BusinessType
Cho biết doanh nghiệp này chỉ cung cấp dịch vụ tại chỗ tại vị trí của khách hàng (ví dụ: xe kéo) hay tại cả địa chỉ và tại chỗ (ví dụ: cửa hàng pizza có khu vực ăn uống và đồng thời giao hàng cho khách hàng).
Enum | |
---|---|
BUSINESS_TYPE_UNSPECIFIED |
Chỉ có đầu ra. Chưa chỉ định. |
CUSTOMER_LOCATION_ONLY |
Chỉ cung cấp dịch vụ trong khu vực xung quanh (không phải tại địa chỉ doanh nghiệp). |
CUSTOMER_AND_BUSINESS_LOCATION |
Cung cấp dịch vụ tại địa chỉ doanh nghiệp và khu vực xung quanh. |
PointRadius
Bán kính xung quanh một điểm cụ thể (vĩ độ/kinh độ).
Biểu diễn dưới dạng JSON | |
---|---|
{
"latlng": {
object ( |
Trường | |
---|---|
latlng |
Vĩ độ/kinh độ chỉ định tâm của một khu vực được xác định bởi bán kính. |
radiusKm |
Khoảng cách tính bằng km của khu vực xung quanh điểm đó. |
LatLng
Đối tượng đại diện cho cặp vĩ độ/kinh độ. Giá trị này được biểu thị bằng cặp số đại diện cho vĩ độ và độ kinh độ. Trừ phi có quy định khác, đối tượng này phải tuân thủ tiêu chuẩn WGS84. Giá trị phải nằm trong phạm vi chuẩn hoá.
Biểu diễn dưới dạng JSON | |
---|---|
{ "latitude": number, "longitude": number } |
Trường | |
---|---|
latitude |
Vĩ độ tính bằng độ. Giá trị này phải nằm trong khoảng [-90.0, +90.0]. |
longitude |
Kinh độ tính bằng độ. Giá trị này phải nằm trong khoảng [-180.0, +180.0]. |
Địa điểm
Xác định sự kết hợp của các khu vực được biểu thị bằng một tập hợp địa điểm.
Biểu diễn dưới dạng JSON | |
---|---|
{
"placeInfos": [
{
object ( |
Trường | |
---|---|
placeInfos[] |
Các khu vực được biểu thị bằng mã địa điểm. Giới hạn tối đa 20 địa điểm. |
PlaceInfo
Xác định một khu vực được biểu thị bằng một mã địa điểm.
Biểu diễn dưới dạng JSON | |
---|---|
{ "name": string, "placeId": string } |
Trường | |
---|---|
name |
Tên đã bản địa hoá của địa điểm. Ví dụ: |
placeId |
Mã của địa điểm. Phải tương ứng với một khu vực. |
LocationKey
Tham chiếu chính thay thế/thay thế cho một vị trí.
Biểu diễn dưới dạng JSON | |
---|---|
{ "plusPageId": string, "placeId": string, "explicitNoPlaceId": boolean, "requestId": string } |
Trường | |
---|---|
plusPageId |
Chỉ có đầu ra. Nếu vị trí này được liên kết với trang Google+, thì vị trí này sẽ được điền bằng ID trang Google+ cho vị trí này. |
placeId |
Nếu vị trí này đã được xác minh và được kết nối đến/xuất hiện trên Google Maps, trường này được điền bằng ID địa điểm cho vị trí. Mã này có thể dùng trong nhiều Places API. Nếu vị trí này chưa được xác minh, trường này có thể được điền sẵn nếu vị trí đã được liên kết với một địa điểm xuất hiện trên Google Maps. Bạn có thể đặt trường này trong khi thực hiện lệnh gọi Tạo, nhưng không thể đặt trường này khi cập nhật. Bool |
explicitNoPlaceId |
Chỉ có đầu ra. Giá trị true cho biết rằng mã địa điểm chưa được đặt là có chủ ý, khác với việc chưa có mối liên kết nào được thực hiện. |
requestId |
Chỉ có đầu ra. |
AdWordsLocationExtensions
Thông tin bổ sung xuất hiện trong AdWords.
Biểu diễn dưới dạng JSON | |
---|---|
{ "adPhone": string } |
Trường | |
---|---|
adPhone |
Số điện thoại thay thế để hiển thị trên tiện ích vị trí AdWords thay vì số điện thoại chính của vị trí. |
OpenInfo
Thông tin liên quan đến trạng thái mở cửa của doanh nghiệp.
Biểu diễn dưới dạng JSON | |
---|---|
{ "status": enum ( |
Trường | |
---|---|
status |
Cho biết Vị trí hiện có đang mở cửa kinh doanh hay không. Tất cả các vị trí đều mở cửa theo mặc định, trừ phi bạn cập nhật thành đóng cửa. |
canReopen |
Chỉ có đầu ra. Cho biết doanh nghiệp này có đủ điều kiện để mở cửa lại hay không. |
openingDate |
Ngày vị trí mở cửa lần đầu tiên. Nếu không xác định được ngày chính xác, bạn chỉ có thể cung cấp tháng và năm. Ngày này phải trong quá khứ hoặc không quá 1 năm trong tương lai. |
OpenForBusiness
Cho biết trạng thái của một vị trí.
Enum | |
---|---|
OPEN_FOR_BUSINESS_UNSPECIFIED |
Chưa chỉ định. |
OPEN |
Cho biết vị trí đang mở cửa. |
CLOSED_PERMANENTLY |
Cho biết vị trí đã bị đóng cửa vĩnh viễn. |
CLOSED_TEMPORARILY |
Cho biết địa điểm này đã tạm thời đóng cửa. Bạn chỉ có thể áp dụng giá trị này cho các vị trí đã xuất bản (ví dụ: locationState.is_Publish = true). Khi cập nhật trường trạng thái thành giá trị này, ứng dụng phải đặt updateMask thành openInfo.status một cách rõ ràng. Không thể đặt mặt nạ cập nhật khác trong cuộc gọi cập nhật này. Đây là quy định hạn chế tạm thời và sẽ sớm được nới lỏng. |
LocationState
Chứa một tập hợp boolean phản ánh trạng thái của một Vị trí.
Biểu diễn dưới dạng 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 } |
Trường | |
---|---|
isGoogleUpdated |
Chỉ có đầu ra. Cho biết liệu ID địa điểm được liên kết với vị trí này có cập nhật hay không. |
isDuplicate |
Chỉ có đầu ra. Cho biết liệu vị trí có trùng lặp với một vị trí khác hay không. |
isSuspended |
Chỉ có đầu ra. Cho biết liệu vị trí có bị tạm ngưng hay không. Người dùng cuối sẽ không nhìn thấy vị trí bị tạm ngưng trong các sản phẩm của Google. Nếu bạn cho rằng có sự nhầm lẫn, hãy xem bài viết này trong trung tâm trợ giúp. |
canUpdate |
Chỉ có đầu ra. Cho biết liệu vị trí có thể được cập nhật hay không. |
canDelete |
Chỉ có đầu ra. Cho biết liệu vị trí có thể bị xóa bằng cách sử dụng API Google Doanh nghiệp của tôi hay không. |
isVerified |
Chỉ có đầu ra. Cho biết vị trí đã được xác minh hay chưa. |
needsReverification |
Chỉ có đầu ra. Cho biết liệu vị trí đó có cần phải xác minh lại hay không. |
isPendingReview |
Chỉ có đầu ra. Cho biết liệu hoạt động đánh giá vị trí có đang chờ xử lý hay không. |
isDisabled |
Chỉ có đầu ra. Cho biết vị trí có bị tắt hay không. |
isPublished |
Chỉ có đầu ra. Cho biết liệu vị trí có được xuất bản hay không. |
isDisconnected |
Chỉ có đầu ra. Cho biết liệu vị trí có bị ngắt kết nối với một địa điểm trên Google Maps hay không. |
isLocalPostApiDisabled |
Chỉ có đầu ra. Cho biết liệu accounts.locations.localPosts có bị tắt đối với vị trí này hay không. |
canModifyServiceList |
Chỉ có đầu ra. Cho biết trang thông tin có thể sửa đổi ServiceList (Danh sách dịch vụ) hay không. |
canHaveFoodMenus |
Chỉ có đầu ra. Cho biết trang thông tin có đủ điều kiện dùng thực đơn đồ ăn hay không. |
hasPendingEdits |
Chỉ có đầu ra. Cho biết liệu có bất kỳ cơ sở lưu trú nào của Vị trí này đang ở trạng thái đang chờ chỉnh sửa hay không. |
hasPendingVerification |
Chỉ có đầu ra. Cho biết liệu vị trí có yêu cầu xác minh đang chờ xử lý hay không. |
canOperateHealthData |
Chỉ có đầu ra. Cho biết liệu vị trí có thể hoạt động dựa trên Dữ liệu sức khoẻ hay không. |
canOperateLodgingData |
Chỉ có đầu ra. Cho biết liệu vị trí có thể hoạt động trên dữ liệu về Cơ sở lưu trú hay không. |
Thuộc tính
Thuộc tính vị trí. Thuộc tính cung cấp thêm thông tin về một vị trí. Các thuộc tính có thể được đặt cho một vị trí có thể thay đổi dựa trên các thuộc tính của vị trí đó (ví dụ: danh mục). Các thuộc tính hiện có là do Google xác định và có thể được thêm vào cũng như bị xoá mà không cần thay đổi API.
Biểu diễn dưới dạng JSON | |
---|---|
{ "attributeId": string, "valueType": enum ( |
Trường | |
---|---|
attributeId |
Mã nhận dạng của thuộc tính. Mã thuộc tính do Google cung cấp. |
valueType |
Chỉ có đầu ra. Loại giá trị mà thuộc tính này chứa. Bạn nên sử dụng hàm này để xác định cách diễn giải giá trị. |
values[] |
Các giá trị cho thuộc tính này. Loại giá trị được cung cấp phải khớp với loại giá trị dự kiến cho thuộc tính đó; hãy xem AttributeValueType. Đây là trường lặp lại mà có thể bạn phải cung cấp nhiều giá trị thuộc tính. Các loại thuộc tính chỉ hỗ trợ một giá trị. |
repeatedEnumValue |
Khi loại giá trị thuộc tính là RepEATED_ENUM, loại này chứa giá trị thuộc tính và các trường giá trị khác phải để trống. |
urlValues[] |
Khi loại giá trị thuộc tính là URL, trường này chứa(các) giá trị cho thuộc tính này và các trường giá trị khác phải để trống. |
RepeatedEnumAttributeValue
Giá trị của một thuộc tính có valueType
là RepEATED_ENUM. Danh sách này bao gồm hai danh sách mã giá trị: danh sách được đặt (true) và danh sách chưa được đặt (false). Các giá trị không có sẽ được coi là không xác định. Bạn phải chỉ định ít nhất một giá trị.
Biểu diễn dưới dạng JSON | |
---|---|
{ "setValues": [ string ], "unsetValues": [ string ] } |
Trường | |
---|---|
setValues[] |
Các giá trị enum đã được đặt. |
unsetValues[] |
Giá trị enum chưa được đặt. |
UrlAttributeValue
Giá trị cho một thuộc tính có valueType
URL.
Biểu diễn dưới dạng JSON | |
---|---|
{ "url": string } |
Trường | |
---|---|
url |
URL. |
Metadata
Thông tin bổ sung mà người dùng không thể chỉnh sửa về vị trí.
Biểu diễn dưới dạng JSON | |
---|---|
{
"duplicate": {
object ( |
Trường | |
---|---|
duplicate |
Thông tin về vị trí mà vị trí này trùng lặp. Chỉ xuất hiện khi |
mapsUrl |
Đường liên kết đến vị trí trên Maps. |
newReviewUrl |
Đường liên kết đến trang trên Google Tìm kiếm để khách hàng có thể viết bài đánh giá về vị trí đó. |
Nhân bản
Thông tin về vị trí mà vị trí này trùng lặp.
Biểu diễn dưới dạng JSON | |
---|---|
{
"locationName": string,
"placeId": string,
"access": enum ( |
Trường | |
---|---|
locationName |
Tên tài nguyên của vị trí mà đối tượng địa lý này trùng lặp. Chỉ được điền sẵn nếu người dùng đã xác thực có quyền truy cập vào vị trí đó và vị trí đó không bị xoá. |
placeId |
Mã địa điểm của vị trí bị trùng lặp. |
access |
Cho biết liệu người dùng có quyền truy cập vào vị trí mà người dùng sao chép hay không. |
Quyền truy cập
Cấp truy cập của người dùng vào vị trí mà bản sao đó. Thông tin này sẽ thay thế Quyền sở hữu và sẽ được dùng để thay thế.
Enum | |
---|---|
ACCESS_UNSPECIFIED |
Chưa chỉ định. |
ACCESS_UNKNOWN |
Không thể xác định liệu người dùng có quyền truy cập vào vị trí mà người dùng đó sao chép hay không. |
ALLOWED |
Người dùng có quyền truy cập vào thông tin vị trí trùng lặp. |
INSUFFICIENT |
Người dùng không có quyền truy cập vào vị trí bị trùng lặp. |
PriceList
Không dùng nữa: Danh sách thông tin về giá của mặt hàng. Danh sách giá có cấu trúc dưới dạng một hoặc nhiều danh sách giá, mỗi danh sách chứa một hoặc nhiều mục với một hoặc nhiều mục. Ví dụ: bảng giá thực phẩm có thể thể hiện thực đơn bữa sáng/bữa trưa/bữa tối, có các phần cho bánh mì kẹp thịt/bít tết/hải sản.
Biểu diễn dưới dạng JSON | |
---|---|
{ "priceListId": string, "labels": [ { object ( |
Trường | |
---|---|
priceListId |
Bắt buộc. Mã của danh sách giá. Không được sao chép danh sách giá, mục và mã mặt hàng trong Vị trí này. |
labels[] |
Bắt buộc. Nhãn được gắn thẻ theo ngôn ngữ cho danh sách giá. |
sourceUrl |
URL nguồn không bắt buộc của nơi danh sách giá được truy xuất. Ví dụ: đây có thể là URL của trang được tự động trích xuất để điền thông tin trình đơn. |
sections[] |
Bắt buộc. Các phần của bảng giá này. Mỗi danh sách giá phải chứa ít nhất một mục. |
Hãng nhạc
Nhãn được dùng khi đăng bảng giá, mục giá hoặc mặt hàng.
Biểu diễn dưới dạng JSON | |
---|---|
{ "displayName": string, "description": string, "languageCode": string } |
Trường | |
---|---|
displayName |
Bắt buộc. Tên hiển thị của danh sách giá, mục hoặc mặt hàng. |
description |
Không bắt buộc. Nội dung mô tả của bảng giá, mục hoặc mặt hàng. |
languageCode |
Không bắt buộc. Mã ngôn ngữ BCP-47 mà các chuỗi này áp dụng. Bạn chỉ có thể đặt một bộ nhãn cho mỗi ngôn ngữ. |
Phần
Một phần của danh sách giá chứa một hoặc nhiều mặt hàng.
Biểu diễn dưới dạng JSON | |
---|---|
{ "sectionId": string, "labels": [ { object ( |
Trường | |
---|---|
sectionId |
Bắt buộc. Mã nhận dạng của mục. Không được sao chép danh sách giá, mục và mã mặt hàng trong Vị trí này. |
labels[] |
Bắt buộc. Nhãn được gắn thẻ ngôn ngữ cho mục này. Tên phần và nội dung mô tả nên dài không quá 140 ký tự. Cần ít nhất một bộ nhãn. |
sectionType |
Không bắt buộc. Loại của mục danh sách giá hiện tại. Giá trị mặc định là FOOD. |
items[] |
Các mặt hàng nằm trong phần này của danh sách giá. |
SectionType
Loại mục.
Enum | |
---|---|
SECTION_TYPE_UNSPECIFIED |
Chưa chỉ định. |
FOOD |
Phần chứa các mặt hàng tượng trưng cho thực phẩm. |
SERVICES |
Phần chứa các mục đại diện cho dịch vụ. |
Mục
Một mục trong danh sách. Mỗi biến thể của một mặt hàng trong danh sách giá phải có Mặt hàng riêng với dữ liệu giá riêng.
Biểu diễn dưới dạng JSON | |
---|---|
{ "itemId": string, "labels": [ { object ( |
Trường | |
---|---|
itemId |
Bắt buộc. Mã nhận dạng của mục. Không được sao chép danh sách giá, mục và mã mặt hàng trong Vị trí này. |
labels[] |
Bắt buộc. Nhãn được gắn thẻ ngôn ngữ cho mục này. Tên mặt hàng không nên dài quá 140 ký tự và nội dung mô tả không được dài quá 250 ký tự. Cần ít nhất một bộ nhãn. |
price |
Không bắt buộc. Giá của mặt hàng. |
Tiền
Đại diện cho số tiền kèm theo loại đơn vị tiền tệ.
Biểu diễn dưới dạng JSON | |
---|---|
{ "currencyCode": string, "units": string, "nanos": integer } |
Trường | |
---|---|
currencyCode |
Mã đơn vị tiền tệ gồm ba chữ cái được xác định trong ISO 4217. |
units |
Toàn bộ đơn vị của số tiền. Ví dụ: nếu |
nanos |
Số lượng nano (10^-9) đơn vị của lượng. Giá trị phải nằm trong khoảng từ -999.999.999 đến +999.999.999. Nếu |
Hồ sơ
Tất cả thông tin liên quan đến hồ sơ của vị trí.
Biểu diễn dưới dạng JSON | |
---|---|
{ "description": string } |
Trường | |
---|---|
description |
Nội dung mô tả vị trí bằng giọng của bạn, không ai khác có thể chỉnh sửa được. |
RelationshipData
Thông tin về tất cả vị trí mẹ và con liên quan đến vị trí này.
Biểu diễn dưới dạng JSON | |
---|---|
{ "parentChain": string } |
Trường | |
---|---|
parentChain |
Tên tài nguyên của Chuỗi mà vị trí này là thành viên. |
MoreHours
Khoảng thời gian một vị trí mở cửa cho một số loại hình kinh doanh nhất định.
Biểu diễn dưới dạng JSON | |
---|---|
{
"hoursTypeId": string,
"periods": [
{
object ( |
Trường | |
---|---|
hoursTypeId |
Bắt buộc. Loại giờ. Khách hàng nên gọi {#link businessCATEGORIES:BatchGet} để biết các loại giờ được hỗ trợ cho các danh mục địa điểm của họ. |
periods[] |
Bắt buộc. Tập hợp thời gian vị trí này mở cửa. Mỗi khoảng thời gian biểu thị một khoảng giờ khi vị trí mở cửa trong tuần. |
Phương thức |
|
---|---|
|
Liên kết một vị trí với một mã địa điểm. |
|
Lấy tất cả các vị trí được chỉ định trong tài khoản đã cho. |
|
Trả về danh sách bài đánh giá được phân trang cho tất cả vị trí được chỉ định. |
|
Xoá mối liên kết giữa một vị trí và mã địa điểm của vị trí đó. |
|
Tạo một location mới thuộc sở hữu của tài khoản đã chỉ định và trả về thuộc tính này. |
|
Xoá một vị trí. |
|
Báo cáo tất cả các phương thức xác minh đủ điều kiện cho một vị trí bằng một ngôn ngữ cụ thể. |
|
Tìm tất cả các vị trí có thể trùng khớp với vị trí được chỉ định. |
|
Xem vị trí được chỉ định. |
|
Trả về thực đơn món ăn của một vị trí cụ thể. |
|
Tải phiên bản do Google cập nhật cho vị trí được chỉ định. |
|
Trả về các thuộc tính Nhà cung cấp sức khoẻ của một vị trí cụ thể. |
|
Lấy danh sách dịch vụ được chỉ định của một vị trí. |
|
Liệt kê các vị trí cho tài khoản đã chỉ định. |
|
Cập nhật vị trí được chỉ định. |
|
Trả về báo cáo chứa thông tin chi tiết về một hoặc nhiều chỉ số theo vị trí. |
(deprecated) |
Di chuyển vị trí từ tài khoản mà người dùng sở hữu sang một tài khoản khác mà người dùng đó quản lý. |
|
Cập nhật thực đơn món ăn của một địa điểm cụ thể. |
|
Cập nhật các thuộc tính Nhà cung cấp sức khoẻ của một vị trí cụ thể. |
|
Cập nhật danh sách dịch vụ được chỉ định của một vị trí. |
|
Bắt đầu quy trình xác minh cho một vị trí. |