- 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 (Giá trị lặp lại)
- UrlAttributeValue (Giá trị url thuộc tính)
- Siêu dữ liệu
- Sao chép
- Quyền truy cập
- PriceList
- Nhãn
- Mục
- SectionType
- Mặt hàng
- Tiền
- Hồ sơ
- RelationshipData
- MoreHours
- Phương thức
Tài nguyên: Vị trí
Vị trí. Hãy xem bài viết trong 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 doanh nghiệp 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 ( |
Các trường | |
---|---|
name |
Giá trị nhận dạng của Google cho vị trí này ở dạng: Trong trường hợp khớp, trường này sẽ không được điền sẵn. |
languageCode |
Ngôn ngữ của vị trí. Được đặt 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 cho vị trí này. Giá trị nhận dạng này phải là duy nhất trong một tài khoản nhất định. Đây là phương thức để liên kết vị trí với hồ sơ của riêng bạn. |
locationName |
Tên địa điểm phải phản ánh tên doanh nghiệp trong thực tế, được sử dụng nhất quán trên cửa hàng, trang web và văn phòng phẩm, đồng thời phải được khách hàng biết đến. Nếu thích hợp, có thể đưa vào các trường khác của tài nguyên (ví dụ: |
primaryPhone |
Số điện thoại kết nối với địa điểm kinh doanh riêng lẻ của bạn càng trực tiếp càng tốt. Nếu có thể, hãy sử dụng một số điện thoại địa phương thay vì số của đường dây hỗ trợ thuộc trung tâm tổng đài. |
additionalPhones[] |
Tối đa hai số điện thoại (di động hoặc cố định, không có số fax) có thể được gọi đến doanh nghiệp của bạn ngoài số điện thoại chí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ư có vị trí ở xa. 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ả chính xác nhất hoạt động kinh doanh cốt lõi mà địa điểm này tham gia. |
additionalCategories[] |
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 nhớ 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 bạn. 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 một URL đại diện cho địa điểm kinh doanh riêng lẻ này thay vì một trang web/URL chung chung đại diện cho tất cả địa điểm, hoặc đại diện cho thương hiệu. |
regularHours |
Giờ làm việc của doanh nghiệp. |
specialHours |
Giờ đặc biệt đối với doanh nghiệp. Thời gian 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 thay thế giờ làm việc thông thường. |
serviceArea |
Các 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. Nếu doanh nghiệp này là doanh nghiệp cung cấp dịch vụ tại cơ sở khách hàng, thì trường này mô tả(các) khu vực mà doanh nghiệp phục vụ. |
locationKey |
Bộ sưu tập khóa 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[] |
Một bộ sưu tậ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 hiển thị cho người dùng; chỉ bạn mới có thể nhìn thấy 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 vị trí, trường này sẽ bị bỏ qua nếu mã địa lý địa chỉ được cung cấp thành công. Trường này chỉ được trả về trong các yêu cầu nhận nếu giá trị |
openInfo |
Một lá cờ cho biết liệu địa điểm đó hiện có 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[] |
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 thể chỉnh sửa. |
priceLists[] |
Không dùng nữa: Thông tin về bảng giá cho vị trí này. |
profile |
Mô tả doanh nghiệp theo phong cách riêng 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ả các vị trí và chuỗi cửa hàng có liên quan đến cửa hàng này. |
moreHours[] |
Thêm giờ làm việc cho các phòng ban hoặc khách hàng cụ thể của doanh nghiệp. |
BusinessHours
Thể hiện khoảng thời gian mà địa điểm này mở cửa kinh doanh. Lưu giữ một tập hợp các bản sao TimePeriod
.
Biểu diễn dưới dạng JSON | |
---|---|
{
"periods": [
{
object ( |
Các trường | |
---|---|
periods[] |
Tập hợp thời gian mà vị trí này mở cửa kinh doanh. Mỗi khoảng thời gian đại diện cho một phạm vi 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 từ 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ư sau này trong cùng ngày hoặc vào một ngày tiếp theo.
Biểu diễn dưới dạng JSON | |
---|---|
{ "openDay": enum ( |
Các trường | |
---|---|
openDay |
Cho biết |
openTime |
Thời gian ở định dạng mở rộng 24 giờ ISO 8601 (hh:mm). Các giá trị hợp lệ là 00:00-24:00, trong đó 24:00 biểu thị nửa đêm vào cuối trường ngày được chỉ định. |
closeDay |
Cho biết |
closeTime |
Thời gian ở định dạng mở rộng 24 giờ ISO 8601 (hh:mm). Các giá trị hợp lệ là 00:00-24:00, trong đó 24:00 biểu thị nửa đêm vào 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 |
Chưa xác định ngày trong tuần. |
MONDAY |
Thứ Hai |
TUESDAY |
Thứ Ba |
WEDNESDAY |
Thứ Tư |
THURSDAY |
Thursday (thứ Năm) |
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 bình thường của vị trí đó.
Biểu diễn dưới dạng JSON | |
---|---|
{
"specialHourPeriods": [
{
object ( |
Các trường | |
---|---|
specialHourPeriods[] |
Danh sách các trường hợp ngoại lệ đối với giờ hoạt động thông thường của doanh nghiệp. |
SpecialHourPeriod
Đại diện cho 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 bình thường của vị trí đó. Khoảng giờ đặc biệt phải đại diện cho một 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 dữ liệu đầu vào 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 thông tin nhập sau 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 ( |
Các trường | |
---|---|
startDate |
Ngày dương lịch trong khoảng thời gian giờ đặc biệt này bắt đầu. |
openTime |
Thời gian treo trên |
endDate |
Ngày theo lịch trong khoảng thời gian giờ đặc biệt này sẽ kết thúc. Nếu bạn không đặt trường |
closeTime |
Thời gian treo tường vào |
isClosed |
Nếu đúng, |
ServiceAreaBusiness
Doanh nghiệp cung cấp dịch vụ tại cơ sở khách hàng 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 ( |
Các trường | ||
---|---|---|
businessType |
Cho biết |
|
Trường nhóm coverageArea . Cho biết khu vực phục vụ mà 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 liệu doanh nghiệp này chỉ cung cấp dịch vụ tại địa điểm của khách hàng (ví dụ: xe kéo) hay tại cả một địa chỉ và tại chỗ (ví dụ: cửa hàng pizza có khu vực ăn uống và cũng có dịch vụ giao hàng cho khách hàng).
Enum | |
---|---|
BUSINESS_TYPE_UNSPECIFIED |
Chỉ có đầu ra. Chưa xác đị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 lân cận. |
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 ( |
Các trường | |
---|---|
latlng |
Vĩ độ/kinh độ chỉ định tâm của khu vực được xác định bằng bán kính. |
radiusKm |
Khoảng cách tính bằng km của khu vực xung quanh điểm. |
LatLng
Một đối tượng đại diện cho cặp vĩ độ/kinh độ. Đây là một cặp số kép để biểu thị độ 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 } |
Các trường | |
---|---|
latitude |
Vĩ độ tính theo độ. Giá trị này phải nằm trong khoảng [-90,0, +90,0]. |
longitude |
Kinh độ theo độ. Giá trị này phải nằm trong khoảng [-180,0, +180,0]. |
Địa điểm
Xác định phần hợp nhất các khu vực được biểu thị bằng một tập hợp các địa điểm.
Biểu diễn dưới dạng JSON | |
---|---|
{
"placeInfos": [
{
object ( |
Các 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 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 } |
Các trường | |
---|---|
name |
Tên được 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
Thay thế/thay thế tham chiếu chính cho một vị trí.
Biểu diễn dưới dạng JSON | |
---|---|
{ "plusPageId": string, "placeId": string, "explicitNoPlaceId": boolean, "requestId": string } |
Các trường | |
---|---|
plusPageId |
Chỉ có đầu ra. Nếu vị trí này được liên kết với một 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 với/xuất hiện trên Google Maps, thì trường này sẽ được điền mã địa điểm cho vị trí đó. Mã nhận dạng này có thể được dùng trong nhiều API Địa điểm. 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 lệnh gọi Create nhưng không thể đặt cho trường này. Giá trị boolean |
explicitNoPlaceId |
Chỉ có đầu ra. Giá trị true cho biết mã địa điểm chưa được đặt là có chủ ý, khác với việc chưa liên kết nào. |
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 } |
Các trường | |
---|---|
adPhone |
Số điện thoại thay thế để hiển thị trên tiện ích địa điểm AdWords thay vì số điện thoại chính của địa điểm. |
OpenInfo
Thông tin liên quan đến trạng thái khai trương của doanh nghiệp.
Biểu diễn dưới dạng JSON | |
---|---|
{ "status": enum ( |
Các trường | |
---|---|
status |
Cho biết liệu Vị trí đó hiện có đang mở cửa kinh doanh hay không. Tất 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 liệu doanh nghiệp này có đủ điều kiện để mở lại hay không. |
openingDate |
Ngày mà vị trí mở cửa lần đầu tiên. Nếu không xác định được ngày chính xác thì bạn chỉ có thể cung cấp tháng và năm. Ngày phải là ngày trong quá khứ hoặc không quá một 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 xác định. |
OPEN |
Cho biết vị trí đó đang mở cửa. |
CLOSED_PERMANENTLY |
Cho biết vị trí đã bị đóng vĩnh viễn. |
CLOSED_TEMPORARILY |
Cho biết vị trí này đã tạm thời đóng cửa. Giá trị này chỉ có thể được áp dụng cho các vị trí đã xuất bản (ví dụ: locationState.is_Publication = 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 một cách rõ ràng thành openInfo.status . Bạn không thể đặt mặt nạ cập nhật nào khác trong lệnh 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 các giá trị 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 } |
Các trường | |
---|---|
isGoogleUpdated |
Chỉ có đầu ra. Cho biết liệu mã địa điểm được liên kết với vị trí này có nội dung cập nhật hay không. |
isDuplicate |
Chỉ có đầu ra. Cho biết 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 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 trên 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 có thể xóa vị trí 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 vị trí này có yêu cầu xác minh lại hay không. |
isPendingReview |
Chỉ có đầu ra. Cho biết liệu quy trình xem xét vị trí đó có đang chờ xử lý hay không. |
isDisabled |
Chỉ có đầu ra. Cho biết liệu 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 cho vị trí này hay không. |
canModifyServiceList |
Chỉ có đầu ra. Cho biết liệu trang thông tin có thể sửa đổi một ServiceList hay không. |
canHaveFoodMenus |
Chỉ có đầu ra. Cho biết trang thông tin này có đủ điều kiện để hiển thị thực đơn đồ ăn hay không. |
hasPendingEdits |
Chỉ có đầu ra. Cho biết liệu có cơ sở lưu trú nào của Vị trí này ở 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 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 của Phòng cho thuê hay không. |
Thuộc tính
Thuộc tính vị trí. Thuộc tính cung cấp thông tin bổ sung về một vị trí. Những thuộc tính bạn có thể đặt cho một vị trí có thể thay đổi tuỳ theo các cơ sở lưu trú 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 ( |
Các 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 thuộc tính 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 đó; xem AttributeValueType. Đây là trường lặp lại mà bạn có thể 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, thuộc tính này sẽ 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 sẽ 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 thuộc tính có valueType
là REPEATED_ENUM. Danh sách này bao gồm hai danh sách mã giá trị: các mã được đặt (true) và những mã chưa được đặt (false). Những giá trị không xuất hiện sẽ bị 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 ] } |
Các trường | |
---|---|
setValues[] |
Giá trị enum được đặt. |
unsetValues[] |
Giá trị enum chưa được đặt. |
UrlAttributeValue
Giá trị của thuộc tính có valueType
là URL.
Biểu diễn dưới dạng JSON | |
---|---|
{ "url": string } |
Các 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 ( |
Các trường | |
---|---|
duplicate |
Thông tin về vị trí mà vị trí này trùng lặp. Chỉ hiển thị khi |
mapsUrl |
Đường liên kết đến thông tin vị trí trên Maps. |
newReviewUrl |
Đường liên kết đến trang trên Google Tìm kiếm nơi khách hàng có thể viết bài đánh giá về địa điểm đó. |
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 ( |
Các trường | |
---|---|
locationName |
Tên tài nguyên của vị trí mà đối tượng này trùng lặp. Chỉ được điề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í mà đối tượng này trùng lặp. |
access |
Cho biết liệu người dùng có quyền truy cập vào vị trí trùng lặ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à nó trùng lặp. Phần tử này thay thế cho Quyền sở hữu và bạn nên dùng thông tin này.
Enum | |
---|---|
ACCESS_UNSPECIFIED |
Chưa xác đị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 dụng trùng lặp hay không. |
ALLOWED |
Người dùng có quyền truy cập vào thông tin vị trí mà ứng dụng trùng lặp. |
INSUFFICIENT |
Người dùng không có quyền truy cập vào thông tin vị trí 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 như 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ặt hàng. 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, với các mục về bánh mì kẹp thịt/bữa bít tết/hải sản.
Biểu diễn dưới dạng JSON | |
---|---|
{ "priceListId": string, "labels": [ { object ( |
Các trường | |
---|---|
priceListId |
Bắt buộc. Mã của bảng 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. Các nhãn được gắn thẻ 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 đã tự động được trích xuất dữ liệu để điền thông tin trình đơn. |
sections[] |
Bắt buộc. Các mục trong bảng giá này. Mỗi bảng giá phải chứa ít nhất một mục. |
Nhãn
Nhãn được dùng khi hiển thị danh sách giá, mục hoặc mặt hàng.
Biểu diễn dưới dạng JSON | |
---|---|
{ "displayName": string, "description": string, "languageCode": string } |
Các 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. Chỉ có thể đặt một bộ nhãn cho mỗi ngôn ngữ. |
Mục
Một mục trong bảng 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 ( |
Các trường | |
---|---|
sectionId |
Bắt buộc. Mã nhận dạng của phần đó. 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. Bạn chỉ nên sử dụng tối đa 140 ký tự cho tên và nội dung mô tả của mục. Bắt buộc phải có ít nhất một bộ nhãn. |
sectionType |
Không bắt buộc. Loại phần 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 phần.
Enum | |
---|---|
SECTION_TYPE_UNSPECIFIED |
Chưa xác định. |
FOOD |
Phần này chứa các mục đại diện cho thực phẩm. |
SERVICES |
Phần này 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 ( |
Các 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. Các nhãn được gắn thẻ ngôn ngữ cho mặt hàng. Tên mục nên dài từ 140 ký tự trở xuống và nội dung mô tả không dài quá 250 ký tự. Bắt buộc phải có ít nhất một bộ nhãn. |
price |
Không bắt buộc. Giá của mặt hàng. |
Tiền
Biểu thị số tiền cùng với loại đơn vị tiền tệ.
Biểu diễn dưới dạng JSON | |
---|---|
{ "currencyCode": string, "units": string, "nanos": integer } |
Các 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 } |
Các trường | |
---|---|
description |
Mô tả vị trí bằng giọng của chính bạn, không ai khác có thể chỉnh sửa được. |
RelationshipData
Thông tin về tất cả vị trí của nhà xuất bản mẹ và nhà xuất bản con liên quan đến vị trí này.
Biểu diễn dưới dạng JSON | |
---|---|
{ "parentChain": string } |
Các trường | |
---|---|
parentChain |
Tên tài nguyên của Chuỗi có vị trí này. |
MoreHours
Khoảng thời gian mà 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 ( |
Các trường | |
---|---|
hoursTypeId |
Bắt buộc. Loại giờ. Khách hàng nên gọi {#link businessCategory:BatchGet} để biết các loại giờ được hỗ trợ cho các danh mục vị trí của họ. |
periods[] |
Bắt buộc. Tập hợp thời gian mà vị trí này mở cửa. Mỗi khoảng thời gian đại diện cho một phạm vi 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ả vị trí chỉ định trong tài khoản cụ thể. |
|
Trả về danh sách các bài đánh giá được phân trang cho tất cả các vị trí đã 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 do tài khoản được chỉ định sở hữu rồi trả về thuộc tính đó. |
|
Xoá 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 thấy tất cả vị trí có thể trùng khớp với vị trí đã chỉ định. |
|
Lấy vị trí đã chỉ định. |
|
Trả về trình đơn thức ăn của một vị trí cụ thể. |
|
Nhận phiên bản do Google cập nhật của vị trí đã 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ể. |
|
Nhận 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 được chỉ định. |
|
Cập nhật vị trí đã 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 dịch vụ 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 quá trình xác minh cho một vị trí. |