Chỉ mục
FoodMenuService(giao diện)LocalPosts(giao diện)Media(giao diện)Reviews(giao diện)AlertType(enum)Allergen(enum)BatchGetReviewsRequest(thông báo)BatchGetReviewsResponse(thông báo)CallToAction(thông báo)CallToAction.ActionType(enum)CreateLocalPostRequest(thông báo)CreateMediaItemRequest(thông báo)DeleteLocalPostRequest(thông báo)DeleteMediaItemRequest(thông báo)DeleteReviewReplyRequest(thông báo)DietaryRestriction(enum)ErrorDetail(thông báo)ErrorDetail.ErrorCode(enum)FoodMenu(thông báo)FoodMenu.Cuisine(enum)FoodMenuItem(thông báo)FoodMenuItemAttributes(thông báo)FoodMenuItemAttributes.Ingredient(thông báo)FoodMenuItemAttributes.PortionSize(thông báo)FoodMenuItemOption(thông báo)FoodMenuSection(thông báo)FoodMenus(thông báo)GetCustomerMediaItemRequest(thông báo)GetFoodMenusRequest(thông báo)GetLocalPostRequest(thông báo)GetMediaItemRequest(thông báo)GetReviewRequest(thông báo)InternalError(thông báo)ListCustomerMediaItemsRequest(thông báo)ListCustomerMediaItemsResponse(thông báo)ListLocalPostsRequest(thông báo)ListLocalPostsResponse(thông báo)ListMediaItemsRequest(thông báo)ListMediaItemsResponse(thông báo)ListReviewsRequest(thông báo)ListReviewsResponse(thông báo)LocalPost(thông báo)LocalPost.LocalPostState(enum)LocalPostEvent(thông báo)LocalPostEvent.RecurrenceInfo(thông báo)LocalPostEvent.RecurrenceInfo.DailyOccurrencePattern(thông báo)LocalPostEvent.RecurrenceInfo.MonthlyOccurrencePattern(thông báo)LocalPostEvent.RecurrenceInfo.MonthlyOccurrencePattern.DayOfWeekOccurrence(enum)LocalPostEvent.RecurrenceInfo.WeeklyOccurrencePattern(thông báo)LocalPostOffer(thông báo)LocalPostTopicType(enum)LocationReview(thông báo)MediaItem(thông báo)MediaItem.Attribution(thông báo)MediaItem.Dimensions(thông báo)MediaItem.LocationAssociation(thông báo)MediaItem.LocationAssociation.Category(enum)MediaItem.MediaFormat(enum)MediaItem.MediaInsights(thông báo)MediaItemDataRef(thông báo)MenuLabel(thông báo)NutritionFacts(thông báo)NutritionFacts.CaloriesFact(thông báo)NutritionFacts.EnergyUnit(enum)NutritionFacts.MassUnit(enum)NutritionFacts.NutritionFact(thông báo)PreparationMethod(enum)Review(thông báo)Review.ReviewMediaItem(thông báo)Review.Reviewer(thông báo)Review.StarRating(enum)ReviewReply(thông báo)ReviewReply.PolicyViolation(enum)ReviewReply.State(enum)Spiciness(enum)StartUploadMediaItemDataRequest(thông báo)TimeInterval(thông báo)UpdateFoodMenusRequest(thông báo)UpdateLocalPostRequest(thông báo)UpdateMediaItemRequest(thông báo)UpdateReviewReplyRequest(thông báo)ValidationError(thông báo)
FoodMenuService
API này cho phép lấy và cập nhật thực đơn của các địa điểm doanh nghiệp.
Xin lưu ý rằng Location.PriceList cũng đại diện cho "thực đơn" trong một trong các loại của thực đơn nhưng có số lượng trường hạn chế. Nó dùng chung bộ nhớ hạ lưu với FoodMenus. Sau khi quá trình di chuyển sang FoodMenuService hoàn tất, các ứng dụng không nên sử dụng Location.PriceList để cập nhật dữ liệu thực đơn nữa, vì điều này có thể dẫn đến mất dữ liệu ngoài ý muốn.
| GetFoodMenus |
|---|
|
Trả về thực đơn đồ ăn của một địa điểm cụ thể. Chỉ gọi phương thức này nếu location.location_state.can_have_food_menu là true.
|
| UpdateFoodMenus |
|---|
|
Cập nhật thực đơn của một địa điểm cụ thể. Chỉ gọi phương thức này nếu location.location_state.can_have_food_menu là true.
|
LocalPosts
API này cung cấp API quản lý của bài đăng tại địa phương.
| CreateLocalPost |
|---|
|
Tạo một bài đăng tại địa phương mới được liên kết với vị trí đã chỉ định và trả về bài đăng đó.
|
| DeleteLocalPost |
|---|
|
Xoá một bài đăng tại địa phương. Trả về
|
| GetLocalPost |
|---|
|
Lấy bài đăng tại địa phương được chỉ định. Trả về
|
| ListLocalPosts |
|---|
|
Trả về danh sách các bài đăng tại địa phương liên kết với một vị trí.
|
| UpdateLocalPost |
|---|
|
Cập nhật bài đăng tại địa phương được chỉ định và trả về bài đăng tại địa phương đã cập nhật.
|
Nội dung nghe nhìn
Dịch vụ này cho phép quản lý nội dung nghe nhìn (ảnh và video) được liên kết với một vị trí.
| CreateMediaItem |
|---|
|
Tạo một mục nội dung nghe nhìn mới cho vị trí.
|
| DeleteMediaItem |
|---|
|
Xoá mục nội dung nghe nhìn đã chỉ định.
|
| GetCustomerMediaItem |
|---|
|
Trả về siêu dữ liệu cho mục nội dung nghe nhìn của khách hàng được yêu cầu.
|
| GetMediaItem |
|---|
|
Trả về siêu dữ liệu cho mục nội dung nghe nhìn được yêu cầu.
|
| ListCustomerMediaItems |
|---|
|
Trả về danh sách các mục nội dung nghe nhìn do khách hàng đóng góp và được liên kết với một vị trí.
|
| ListMediaItems |
|---|
|
Trả về danh sách các mục nội dung nghe nhìn được liên kết với một vị trí.
|
| StartUploadMediaItemData |
|---|
|
Tạo
|
| UpdateMediaItem |
|---|
|
Cập nhật siêu dữ liệu của mục nội dung nghe nhìn được chỉ định. Bạn chỉ có thể dùng phương thức này để cập nhật Danh mục của một mục nội dung nghe nhìn, ngoại trừ trường hợp danh mục mới không được là COVER hoặc PROFILE.
|
Bài đánh giá
API này cung cấp các thao tác CRUD cho Bài đánh giá. google.mybusiness.v4.Reviews.
| BatchGetReviews |
|---|
|
Trả về danh sách bài đánh giá được phân trang cho tất cả các vị trí được chỉ định. Thao tác này chỉ hợp lệ nếu các vị trí được chỉ định đã được xác minh.
|
| DeleteReviewReply |
|---|
|
Xoá câu trả lời cho bài đánh giá đã chỉ định. Thao tác này chỉ hợp lệ nếu vị trí được chỉ định đã được xác minh.
|
| GetReview |
|---|
|
Trả về bài đánh giá được chỉ định. Thao tác này chỉ hợp lệ nếu vị trí được chỉ định đã được xác minh. Trả về
|
| ListReviews |
|---|
|
Trả về danh sách bài đánh giá được phân trang cho địa điểm được chỉ định. Thao tác này chỉ hợp lệ nếu vị trí được chỉ định đã được xác minh.
|
| UpdateReviewReply |
|---|
|
Cập nhật câu trả lời cho bài đánh giá được chỉ định. Câu trả lời sẽ được tạo nếu chưa có. Thao tác này chỉ hợp lệ nếu vị trí được chỉ định đã được xác minh.
|
AlertType
Loại sự kiện mà bài đăng cảnh báo được tạo ra.
| Enum | |
|---|---|
ALERT_TYPE_UNSPECIFIED |
Bạn chưa chỉ định thông báo nào. |
COVID_19 |
Cảnh báo liên quan đến đại dịch bệnh do vi-rút corona 2019. Bài đăng về Covid chỉ hỗ trợ trường tóm tắt và trường lời kêu gọi hành động. Khi những cảnh báo này không còn phù hợp, bạn sẽ không thể tạo bài đăng Cảnh báo mới cho loại COVID-19. Tuy nhiên, người bán vẫn có thể quản lý các bài đăng hiện có về COVID-19. |
Chất gây dị ứng
Thông tin về chất gây dị ứng liên quan đến một mặt hàng thực phẩm.
| Enum | |
|---|---|
ALLERGEN_UNSPECIFIED |
Chưa chỉ định chất gây dị ứng |
DAIRY |
Chất gây dị ứng liên quan đến sữa |
EGG |
Chất gây dị ứng liên quan đến trứng |
FISH |
Chất gây dị ứng liên quan đến cá |
PEANUT |
Chất gây dị ứng liên quan đến đậu phộng |
SHELLFISH |
Chất gây dị ứng liên quan đến hải sản có vỏ |
SOY |
Chất gây dị ứng liên quan đến đậu nành |
TREE_NUT |
Chất gây dị ứng liên quan đến hạt cây |
WHEAT |
Chất gây dị ứng liên quan đến lúa mì |
BatchGetReviewsRequest
Thông báo yêu cầu cho Reviews.BatchGetReviews.
| Trường | |
|---|---|
name |
Tên của tài khoản mà bạn muốn truy xuất danh sách bài đánh giá ở nhiều vị trí. |
location_names[] |
Một tập hợp các vị trí để tìm nạp bài đánh giá, được chỉ định theo tên. |
page_size |
Số lượng bài đánh giá cần tìm nạp trên mỗi trang. Giá trị mặc định là 50. |
page_token |
Nếu được chỉ định, phương thức này sẽ tìm nạp trang tiếp theo của các bài đánh giá. |
order_by |
Không bắt buộc. Chỉ định trường để sắp xếp bài đánh giá. Nếu bạn không chỉ định, thứ tự của các bài đánh giá được trả về sẽ mặc định là |
ignore_rating_only_reviews |
Có bỏ qua những bài đánh giá chỉ có điểm xếp hạng hay không. |
BatchGetReviewsResponse
Thông báo phản hồi cho Reviews.BatchGetReviews.
| Trường | |
|---|---|
location_reviews[] |
Bài đánh giá có thông tin vị trí. |
next_page_token |
Nếu số lượng bài đánh giá vượt quá kích thước trang được yêu cầu, thì trường này sẽ được điền sẵn một mã thông báo để tìm nạp trang bài đánh giá tiếp theo trong các lệnh gọi tiếp theo. Nếu không còn bài đánh giá nào khác, trường này sẽ không xuất hiện trong phản hồi. |
CallToAction
Một hành động được thực hiện khi người dùng nhấp vào bài đăng
| Trường | |
|---|---|
action_type |
Loại hành động sẽ được thực hiện. |
url |
URL mà người dùng sẽ được chuyển hướng đến khi nhấp vào. Bạn không nên đặt trường này cho Lời kêu gọi hành động trong cuộc gọi. |
ActionType
Loại hành động sẽ được thực hiện.
| Enum | |
|---|---|
ACTION_TYPE_UNSPECIFIED |
Chưa chỉ định loại. |
BOOK |
Bài đăng này muốn người dùng đặt lịch hẹn/bàn/v.v. |
ORDER |
Bài đăng này muốn người dùng đặt hàng. |
SHOP |
Bài đăng này muốn người dùng duyệt xem danh mục sản phẩm. |
LEARN_MORE |
Bài đăng này muốn người dùng tìm hiểu thêm (trên trang web của họ). |
SIGN_UP |
Bài đăng này muốn người dùng đăng ký/đăng nhập/tham gia một hoạt động nào đó. |
GET_OFFER |
Không dùng nữa. Sử dụng |
CALL |
Bài đăng này muốn người dùng gọi điện cho doanh nghiệp. |
CreateLocalPostRequest
Thông báo yêu cầu cho CreateLocalPost.
| Trường | |
|---|---|
parent |
Tên của vị trí mà bạn muốn tạo bài đăng địa phương này. |
local_post |
Siêu dữ liệu mới của bài đăng tại địa phương. |
CreateMediaItemRequest
Thông báo yêu cầu cho Media.CreateMediaItem.
| Trường | |
|---|---|
parent |
Tên tài nguyên của vị trí nơi mục nội dung nghe nhìn này sẽ được tạo. |
media_item |
Mục nội dung nghe nhìn cần tạo. |
DeleteLocalPostRequest
Thông báo yêu cầu cho DeleteLocalPost.
| Trường | |
|---|---|
name |
Tên của bài đăng địa phương cần xoá. |
DeleteMediaItemRequest
Thông báo yêu cầu cho Media.DeleteMediaItem.
| Trường | |
|---|---|
name |
Tên của mục nội dung nghe nhìn cần xoá. |
DeleteReviewReplyRequest
Thông báo yêu cầu cho Reviews.DeleteReviewReply.
| Trường | |
|---|---|
name |
Tên của câu trả lời cho bài đánh giá cần xoá. |
DietaryRestriction
Thông tin về chế độ ăn của một món ăn.
| Enum | |
|---|---|
DIETARY_RESTRICTION_UNSPECIFIED |
Chưa xác định loại chế độ ăn |
HALAL |
Ký hiệu món ăn là món ăn halal. |
KOSHER |
Ký hiệu món ăn là món ăn kiêng kiểu Do Thái. |
ORGANIC |
Ký hiệu món ăn hữu cơ. |
VEGAN |
Ký hiệu món ăn thuần chay. |
VEGETARIAN |
Ký hiệu món ăn chay. |
ErrorDetail
Nêu chi tiết một lỗi dẫn đến quá trình xác thực hoặc lỗi nội bộ.
| Trường | |
|---|---|
code |
Mã trạng thái, phải là giá trị enum của |
field |
Đường dẫn đến một trường trong phần nội dung yêu cầu. Giá trị này là một chuỗi các giá trị nhận dạng được phân tách bằng dấu chấm, xác định một trường vùng đệm giao thức. Ví dụ: "error_details.field" sẽ xác định trường này. |
message |
Nội dung mô tả lý do khiến trường này gây ra lỗi. Thông báo này bằng tiếng Anh và có thể không phù hợp để hiển thị cho người dùng. |
value |
Giá trị không thực hiện được yêu cầu. |
field_index |
Nếu trường yêu cầu đã tạo ra lỗi này được lặp lại, thì trường này sẽ chứa chỉ mục dựa trên 0 của mục trong trường đó khiến quá trình xác thực không thành công. |
ErrorCode
Mã lỗi cho ErrorDetail:
- 1 đến 199: mã lỗi phổ biến áp dụng cho tất cả các trường.
- 1000 đến 1099: mã lỗi liên quan đến ảnh.
- 1100 đến 1199: mã lỗi liên quan đến địa chỉ và vĩ độ/kinh độ.
- 1200 đến 1299: mã lỗi liên quan đến danh mục.
- 1300 đến 1399: mã lỗi liên quan đến thao tác.
| Enum | |
|---|---|
ERROR_CODE_UNSPECIFIED |
Mã lỗi chung. |
MISSING_VALUE |
Bạn chưa cung cấp một giá trị bắt buộc. |
INVALID_VALUE |
Đã cung cấp giá trị không hợp lệ. |
INVALID_CHARACTERS |
Tìm thấy các ký tự không hợp lệ. |
TOO_MANY_ITEMS |
Bạn đã cung cấp nhiều hơn số lượng tối đa các mục trong một trường lặp lại. |
READ_ONLY |
Bạn không thể sửa đổi trường chỉ đọc. |
OVERLAPPING_RANGES |
Các mục trong một trường lặp lại là các dải ô chồng chéo nhau. |
INVERTED_RANGE |
Phạm vi bạn cung cấp bị đảo ngược. Điều này cũng bao gồm trường hợp có một phạm vi trống. |
VALUE_OUTSIDE_ALLOWED_RANGE |
Giá trị bạn cung cấp nằm ngoài phạm vi cho phép. |
MISSING_DEPENDENT_FIELD |
Không có trường phụ thuộc bắt buộc. |
FIELD_HAS_DEPENDENCIES |
Trường bắt buộc theo trường phụ thuộc và không thể xoá. |
UNSUPPORTED_VALUE |
Giá trị bạn cung cấp có thể hợp lệ nhưng không được hỗ trợ do các ràng buộc khác. |
EXPIRED_VALUE |
Giá trị bạn cung cấp đã hết hạn và không còn hợp lệ. |
PHOTO_FETCH_FAILED |
Không tìm nạp được ảnh từ URL đã chỉ định. |
PHOTO_UPLOAD_FAILED |
Không tải được ảnh lên từ URL đã chỉ định. |
GEOCODE_ERROR |
Đã xảy ra lỗi khi tự động xác định vĩ độ/kinh độ. |
LAT_LNG_OUTSIDE_COUNTRY |
Vĩ độ/kinh độ bạn cung cấp không nằm ở quốc gia bạn cung cấp. |
LAT_LNG_REQUIRED |
Bạn phải cung cấp vĩ độ và kinh độ. |
LAT_LNG_TOO_FAR_FROM_ADDRESS |
Cặp vĩ độ/kinh độ và địa chỉ cách nhau quá xa. |
CATEGORY_NOT_VERIFIED |
Danh mục bạn cung cấp chưa được xác minh. |
OPERATION_EXECUTION_ERROR |
Lỗi thực thi thao tác chung. |
OPERATION_UNSUPPORTED_UNDER_ACCOUNT_CONDITION |
Thao tác này không được hỗ trợ do điều kiện tài khoản. |
LOCATION_DISABLED_FOR_LOCAL_POST_API |
Đã tắt dịch vụ vị trí cho Local Post API. |
STALE_DATA |
Giá trị đề xuất của một số trường đã cũ so với giá trị hiện có. |
FoodMenu
Thực đơn của một doanh nghiệp phục vụ các món ăn.
| Trường | |
|---|---|
labels[] |
Bắt buộc. Nhãn được gắn thẻ ngôn ngữ cho trình đơn. Ví dụ: "thực đơn", "món đặc biệt vào bữa trưa". Tên hiển thị không được vượt quá 140 ký tự, còn nội dung mô tả không được vượt quá 1.000 ký tự. Bạn phải có ít nhất một nhóm nhãn. |
source_url |
Không bắt buộc. URL nguồn của thực đơn nếu có trang web để truy cập. |
sections[] |
Bắt buộc. Các phần của trình đơn. |
cuisines[] |
Không bắt buộc. Thông tin về ẩm thực cho thực đơn. Bạn nên cung cấp trường này. |
Món ăn
Thông tin về ẩm thực của một nhà hàng.
| Enum | |
|---|---|
CUISINE_UNSPECIFIED |
Món ăn không xác định |
AMERICAN |
Ẩm thực Hoa Kỳ |
ASIAN |
Món ăn Á |
BRAZILIAN |
Món ăn Brazil |
BREAK_FAST |
Bữa sáng |
BRUNCH |
Bữa sáng muộn |
CHICKEN |
Gà |
CHINESE |
Ẩm thực Trung Quốc |
FAMILY |
Ẩm thực gia đình |
FAST_FOOD |
Đồ ăn nhanh |
FRENCH |
Ẩm thực Pháp |
GREEK |
Món Hy Lạp |
GERMAN |
Món ăn Đức |
HAMBURGER |
Hamburger |
INDIAN |
Ẩm thực Ấn Độ |
INDONESIAN |
Món ăn Indonesia |
ITALIAN |
Ẩm thực Ý |
JAPANESE |
Ẩm thực Nhật Bản |
KOREAN |
Ẩm thực Hàn Quốc |
LATIN_AMERICAN |
Ẩm thực Mỹ Latinh |
MEDITERRANEAN |
Món ăn vùng Địa Trung Hải |
MEXICAN |
Ẩm thực Mexico |
PAKISTANI |
Món ăn Pakistan |
PIZZA |
Pizza |
SEAFOOD |
Hải sản |
SPANISH |
Món ăn Tây Ban Nha |
SUSHI |
Sushi |
THAI |
Món ăn Thái |
TURKISH |
Món ăn Thổ Nhĩ Kỳ |
VEGETARIAN |
Đồ ăn chay |
VIETNAMESE |
Món ăn Việt |
OTHER_CUISINE |
Món ăn khác |
FoodMenuItem
Mục của một phần. Đó có thể là món ăn hoặc có thể chứa nhiều FoodMenuItemOption.
| Trường | |
|---|---|
labels[] |
Bắt buộc. Nhãn được gắn thẻ ngôn ngữ cho mục này trong trình đơn. Tên hiển thị không được vượt quá 140 ký tự, còn nội dung mô tả không được vượt quá 1.000 ký tự. Bạn phải có ít nhất một nhóm nhãn. |
attributes |
Bắt buộc. Thuộc tính chi tiết của mặt hàng. Khi bạn chỉ định các lựa chọn về mặt hàng, đây được coi là thuộc tính cơ sở và sẽ được điền sẵn cho từng lựa chọn. |
options[] |
Không bắt buộc. Đây là một mặt hàng có nhiều lựa chọn khác nhau và người dùng phải lựa chọn. Ví dụ: pizza "thường" so với pizza "lớn". Khi bạn chỉ định các lựa chọn, nhãn và thuộc tính ở cấp mặt hàng sẽ tự động trở thành nhãn và thuộc tính của lựa chọn đầu tiên. Khách hàng chỉ cần chỉ định các lựa chọn thực phẩm bổ sung khác trong trường này. |
FoodMenuItemAttributes
Thuộc tính của một món ăn.
| Trường | |
|---|---|
price |
Không bắt buộc. Giá của món ăn. |
spiciness |
Không bắt buộc. Mức độ cay của món ăn. |
allergen[] |
Không bắt buộc. Chất gây dị ứng có trong món ăn. Bạn nên cung cấp trường này. |
dietary_restriction[] |
Không bắt buộc. Thông tin về chế độ ăn của món ăn. Bạn nên cung cấp trường này. |
nutrition_facts |
Không bắt buộc. Thông tin dinh dưỡng của món ăn. Bạn nên cung cấp trường này. |
ingredients[] |
Không bắt buộc. Các thành phần của món ăn. |
serves_num_people |
Không bắt buộc. Số người có thể ăn món ăn này. |
preparation_methods[] |
Không bắt buộc. Phương pháp chế biến món ăn. |
portion_size |
Không bắt buộc. Quy mô của đơn đặt hàng, được biểu thị bằng số lượng mặt hàng. (ví dụ: 4 "xiên", 6 "miếng") |
media_keys[] |
Không bắt buộc. Khoá nội dung nghe nhìn của nội dung nghe nhìn được liên kết với món ăn. Chỉ hỗ trợ nội dung nghe nhìn là ảnh. Khi có nhiều bức ảnh được liên kết, bức ảnh đầu tiên sẽ được coi là bức ảnh ưu tiên. |
Nguyên liệu
Thông báo này biểu thị thông tin về thành phần của một món ăn.
| Trường | |
|---|---|
labels[] |
Bắt buộc. Nhãn mô tả thành phần. Tên hiển thị không được vượt quá 140 ký tự, còn nội dung mô tả không được vượt quá 1.000 ký tự. Bạn phải có ít nhất một nhóm nhãn. |
PortionSize
Kích cỡ khẩu phần của một món ăn.
| Trường | |
|---|---|
quantity |
Bắt buộc. Số lượng của phần. |
unit[] |
Bắt buộc. Trường name_info lặp lại là dành cho đơn vị bằng nhiều ngôn ngữ. |
FoodMenuItemOption
Lựa chọn của một mặt hàng. Bạn phải chọn một cách rõ ràng.
| Trường | |
|---|---|
labels[] |
Bắt buộc. Nhãn được gắn thẻ ngôn ngữ cho lựa chọn này trong mục trình đơn. Ví dụ: "beef pad thai", "veggie pad thai", "small pizza", "large pizza". Tên hiển thị không được vượt quá 140 ký tự, còn nội dung mô tả không được vượt quá 1.000 ký tự. Bạn phải có ít nhất một nhóm nhãn. |
attributes |
Bắt buộc. Thuộc tính chi tiết của lựa chọn mặt hàng. Các thuộc tính riêng lẻ chưa được chỉ định sẽ được kế thừa từ các thuộc tính cấp mặt hàng làm cơ sở. |
FoodMenuSection
Phần của một trình đơn. Đơn hàng có thể chứa nhiều mặt hàng/món ăn.
| Trường | |
|---|---|
labels[] |
Bắt buộc. Nhãn được gắn thẻ ngôn ngữ cho phần trình đơn này. Tên hiển thị không được vượt quá 140 ký tự, còn nội dung mô tả không được vượt quá 1.000 ký tự. Bạn phải có ít nhất một nhóm nhãn. |
items[] |
Bắt buộc. Các mục trong phần. Mỗi phần phải có ít nhất một mục. |
FoodMenus
Thực đơn của một doanh nghiệp phục vụ các món ăn.
| Trường | |
|---|---|
name |
Bắt buộc. Giá trị nhận dạng của Google cho vị trí này ở dạng: |
menus[] |
Không bắt buộc. Một bộ sưu tập thực đơn món ăn. |
GetCustomerMediaItemRequest
Thông báo yêu cầu cho Media.GetCustomerMediaItem.
| Trường | |
|---|---|
name |
Tên tài nguyên của mục nội dung đa phương tiện được yêu cầu của khách hàng. |
GetFoodMenusRequest
Thông báo yêu cầu cho FoodMenu.GetFoodMenus
| Trường | |
|---|---|
name |
Bắt buộc. Giá trị nhận dạng của Google cho vị trí này ở dạng: |
read_mask |
Không bắt buộc. Các trường cụ thể cần trả về. Nếu bạn không chỉ định mặt nạ, thì phương thức này sẽ trả về toàn bộ FoodMenu (tương tự như "*"). Bạn không thể chỉ định riêng từng mục trong trường lặp lại. Ví dụ: "name" và "menus" là các mặt nạ hợp lệ, còn "menus.sections" là không hợp lệ. |
GetLocalPostRequest
Thông báo yêu cầu cho LocalPosts.GetLocalPost.
| Trường | |
|---|---|
name |
Tên của bài đăng địa phương cần tìm nạp. |
GetMediaItemRequest
Thông báo yêu cầu cho Media.GetMediaItem.
| Trường | |
|---|---|
name |
Tên của mục nội dung nghe nhìn được yêu cầu. |
GetReviewRequest
Thông báo yêu cầu cho Reviews.GetReview.
| Trường | |
|---|---|
name |
Tên của bài đánh giá cần tìm nạp. |
InternalError
Mô tả các lỗi nội bộ.
| Trường | |
|---|---|
error_details[] |
Chi tiết từng lỗi. |
ListCustomerMediaItemsRequest
Thông báo yêu cầu cho Media.ListCustomerMediaItems.
| Trường | |
|---|---|
parent |
Tên của vị trí có các mục nội dung nghe nhìn của khách hàng sẽ được liệt kê. |
page_size |
Số lượng mục nội dung nghe nhìn cần trả về trên mỗi trang. Giá trị mặc định là 100, kích thước trang tối đa được hỗ trợ là 200. |
page_token |
Nếu được chỉ định, hàm sẽ trả về trang tiếp theo của các mục nội dung nghe nhìn. |
ListCustomerMediaItemsResponse
Thông báo phản hồi cho Media.ListCustomerMediaItems.
| Trường | |
|---|---|
media_items[] |
Danh sách các mục nội dung nghe nhìn được trả về. |
total_media_item_count |
Tổng số mục nội dung nghe nhìn cho vị trí này, bất kể việc phân trang. Con số này chỉ là ước chừng, đặc biệt là khi có nhiều trang kết quả. |
next_page_token |
Nếu có nhiều mục nội dung nghe nhìn hơn kích thước trang được yêu cầu, thì trường này sẽ được điền sẵn bằng một mã thông báo để tìm nạp trang tiếp theo của các mục nội dung nghe nhìn trong một lệnh gọi tiếp theo đến ListCustomerMediaItems. |
ListLocalPostsRequest
Thông báo yêu cầu cho ListLocalPosts
| Trường | |
|---|---|
parent |
Tên của vị trí có bài đăng tại địa phương sẽ được liệt kê. |
page_size |
Số lượng bài đăng tại địa phương cần trả về trên mỗi trang. Giá trị mặc định là 20. Số trang tối thiểu là 1 và tối đa là 100. |
page_token |
Nếu được chỉ định, hàm sẽ trả về trang tiếp theo của bài đăng tại địa phương. |
ListLocalPostsResponse
Thông báo phản hồi cho ListLocalPosts
| Trường | |
|---|---|
local_posts[] |
Danh sách bài đăng tại địa phương được trả về. |
next_page_token |
Nếu có nhiều bài đăng tại địa phương hơn kích thước trang được yêu cầu, thì trường này sẽ được điền sẵn bằng một mã thông báo để tìm nạp trang tiếp theo của bài đăng tại địa phương trong một lệnh gọi tiếp theo đến |
ListMediaItemsRequest
Thông báo yêu cầu cho Media.ListMediaItems.
| Trường | |
|---|---|
parent |
Tên của vị trí có các mục nội dung nghe nhìn sẽ được liệt kê. |
page_size |
Số lượng mục nội dung nghe nhìn cần trả về trên mỗi trang. Giá trị mặc định là 100. Đây cũng là số lượng tối đa được hỗ trợ cho các mục nội dung nghe nhìn có thể thêm vào một vị trí bằng API Doanh nghiệp của tôi. Kích thước trang tối đa là 2500. |
page_token |
Nếu được chỉ định, hàm sẽ trả về trang tiếp theo của các mục nội dung nghe nhìn. |
ListMediaItemsResponse
Thông báo phản hồi cho Media.ListMediaItems.
| Trường | |
|---|---|
media_items[] |
Danh sách các mục nội dung nghe nhìn được trả về. |
total_media_item_count |
Tổng số mục nội dung nghe nhìn cho vị trí này, bất kể việc phân trang. |
next_page_token |
Nếu có nhiều mục nội dung nghe nhìn hơn kích thước trang được yêu cầu, thì trường này sẽ được điền sẵn bằng một mã thông báo để tìm nạp trang tiếp theo của các mục nội dung nghe nhìn trong một lệnh gọi tiếp theo đến ListMediaItems. |
ListReviewsRequest
Thông báo yêu cầu cho Reviews.ListReviews.
| Trường | |
|---|---|
parent |
Tên của địa điểm cần tìm nạp bài đánh giá. |
page_size |
Số lượng bài đánh giá cần tìm nạp trên mỗi trang. Số lượng |
page_token |
Nếu được chỉ định, phương thức này sẽ tìm nạp trang tiếp theo của các bài đánh giá. |
order_by |
Chỉ định trường để sắp xếp bài đánh giá. Nếu bạn không chỉ định, thứ tự của các bài đánh giá được trả về sẽ mặc định là |
ListReviewsResponse
Thông báo phản hồi cho Reviews.ListReviews.
| Trường | |
|---|---|
reviews[] |
Các bài đánh giá. |
average_rating |
Điểm xếp hạng trung bình theo sao của tất cả các bài đánh giá về địa điểm này theo thang điểm từ 1 đến 5, trong đó 5 là điểm xếp hạng cao nhất. |
total_review_count |
Tổng số bài đánh giá về vị trí này. |
next_page_token |
Nếu số lượng bài đánh giá vượt quá kích thước trang được yêu cầu, thì trường này sẽ được điền sẵn một mã thông báo để tìm nạp trang bài đánh giá tiếp theo trong một lệnh gọi tiếp theo đến ListReviews. Nếu không còn bài đánh giá nào, thì trường này sẽ không xuất hiện trong phản hồi. |
LocalPost
Đại diện cho một bài đăng tại địa phương cho một vị trí.
| Trường | |
|---|---|
name |
Chỉ có đầu ra. Mã nhận dạng của Google cho bài đăng tại địa phương này ở dạng: |
language_code |
Ngôn ngữ của bài đăng tại địa phương. |
summary |
Nội dung mô tả/nội dung của bài đăng tại địa phương. |
call_to_action |
URL mà người dùng được chuyển đến khi nhấp vào chương trình khuyến mãi. Bị bỏ qua đối với loại chủ đề |
create_time |
Chỉ có đầu ra. Thời gian tạo bài đăng. |
update_time |
Chỉ có đầu ra. Thời gian người dùng sửa đổi bài đăng lần gần đây nhất. |
scheduled_time |
Nếu được đặt, tham số này sẽ xác định thời điểm một bài đăng được xuất bản. Người dùng có thể đặt chế độ này để lên lịch đăng bài trước. |
recurring_instance_time |
Chỉ có đầu ra. Không dùng nữa: Thay vào đó, hãy sử dụng |
event |
Thông tin sự kiện. Bắt buộc đối với các loại chủ đề |
state |
Chỉ có đầu ra. Trạng thái của bài đăng, cho biết bài đăng đang ở giai đoạn nào trong vòng đời. |
media[] |
Nội dung nghe nhìn liên kết với bài đăng. source_url là trường dữ liệu duy nhất được hỗ trợ cho LocalPost MediaItem. |
search_url |
Chỉ có đầu ra. Đường liên kết đến bài đăng tại địa phương trên Google Tìm kiếm. Bạn có thể dùng đường liên kết này để chia sẻ bài đăng qua mạng xã hội, email, tin nhắn văn bản, v.v. |
topic_type |
Bắt buộc. Loại chủ đề của bài đăng: tiêu chuẩn, sự kiện, ưu đãi hoặc cảnh báo. |
alert_type |
Loại cảnh báo mà bài đăng được tạo. Trường này chỉ áp dụng cho các bài đăng có topic_type là Cảnh báo và hoạt động như một loại phụ của Cảnh báo. |
Trường nhóm topic_type_specific_fields. Các trường cụ thể cho một loại chủ đề. topic_type_specific_fields chỉ có thể là một trong những trạng thái sau: |
|
offer |
Dữ liệu bổ sung cho bài đăng ưu đãi. Bạn chỉ nên đặt thông tin này khi topic_type là OFFER. |
LocalPostState
Cho biết trạng thái của bài đăng.
| Enum | |
|---|---|
LOCAL_POST_STATE_UNSPECIFIED |
Chưa chỉ định tiểu bang. |
REJECTED |
Bài đăng này đã bị từ chối do vi phạm chính sách nội dung. |
LIVE |
Bài đăng này đã được xuất bản và hiện đang xuất hiện trong kết quả tìm kiếm. |
PROCESSING |
Bài đăng này đang được xử lý và không xuất hiện trong kết quả tìm kiếm. |
SCHEDULED |
Bài đăng này được lên lịch cho tương lai và không xuất hiện trong kết quả tìm kiếm. |
RECURRING |
Đây là một bài đăng định kỳ và hiện đang xuất hiện trong kết quả tìm kiếm. |
LocalPostEvent
Tất cả thông tin liên quan đến một sự kiện xuất hiện trong bài đăng tại địa phương.
| Trường | |
|---|---|
title |
Tên của sự kiện. |
schedule |
Ngày/giờ bắt đầu và kết thúc sự kiện. |
recurrence_info |
Không bắt buộc. Lưu trữ thông tin về tần suất của một bài đăng định kỳ. Chỉ được đặt nếu bài đăng là bài đăng định kỳ. |
recurring_instance_time |
Chỉ có đầu ra. Thời gian cập nhật lần gần đây nhất của phiên bản định kỳ của bài đăng. |
RecurrenceInfo
Biểu thị thông tin định kỳ cho một bài đăng tại địa phương.
| Trường | |
|---|---|
series_end_time |
Không bắt buộc. Thời gian kết thúc của chuỗi sự kiện lặp lại. |
Trường nhóm occurrence_pattern. Mẫu xuất hiện của bài đăng định kỳ. occurrence_pattern chỉ có thể là một trong những trạng thái sau: |
|
daily_pattern |
Mẫu lặp lại hằng ngày. |
weekly_pattern |
Mẫu số lần xuất hiện hằng tuần. |
monthly_pattern |
Mẫu định kỳ hằng tháng. |
DailyOccurrencePattern
Loại này không có trường nào.
Biểu thị một mẫu lặp lại hằng ngày.
MonthlyOccurrencePattern
Biểu thị một mẫu lặp lại hằng tháng.
| Trường | |
|---|---|
Trường nhóm monthly_option. Lựa chọn lặp lại cho mẫu lặp lại hằng tháng. monthly_option chỉ có thể là một trong những trạng thái sau: |
|
day_of_month |
Ngày trong tháng. |
day_of_week_occurrence |
Ngày trong tuần diễn ra trong tháng. Ngày trong tuần được ngầm hiểu là ngày trong tuần của thời gian bắt đầu sự kiện. Ví dụ: nếu một sự kiện bắt đầu vào thứ Sáu và day_of_week_occurrence là SECOND, thì sự kiện đó sẽ lặp lại vào thứ Sáu thứ hai của mỗi tháng. |
DayOfWeekOccurrence
Ngày trong tuần diễn ra trong tháng.
| Enum | |
|---|---|
DAY_OF_WEEK_OCCURRENCE_UNSPECIFIED |
Ngày trong tuần chưa được chỉ định. |
FIRST |
Ngày đầu tiên trong tuần của tháng. |
SECOND |
Ngày thứ hai trong tuần của tháng. |
THIRD |
Ngày thứ ba trong tuần của tháng. |
FOURTH |
Ngày thứ tư trong tuần của tháng. |
LAST |
Ngày cuối cùng của tuần trong tháng. |
WeeklyOccurrencePattern
Biểu thị một mẫu sự kiện diễn ra hằng tuần.
| Trường | |
|---|---|
days_of_week[] |
Không bắt buộc. Danh sách các ngày trong tuần của sản phẩm/sự kiện. Nếu trống, bài đăng sẽ lặp lại vào cùng ngày trong tuần như schedule.start_time của sự kiện. |
LocalPostOffer
Các trường cụ thể cho bài đăng về ưu đãi.
| Trường | |
|---|---|
coupon_code |
Không bắt buộc. Mã ưu đãi có thể sử dụng tại cửa hàng hoặc trực tuyến. |
redeem_online_url |
Không bắt buộc. Đường liên kết trực tuyến để sử dụng ưu đãi. |
terms_conditions |
Không bắt buộc. Điều khoản và điều kiện của ưu đãi. |
LocalPostTopicType
Loại chủ đề của bài đăng tại địa phương, được dùng để chọn các mẫu khác nhau nhằm tạo và hiển thị bài đăng.
| Enum | |
|---|---|
LOCAL_POST_TOPIC_TYPE_UNSPECIFIED |
Bạn chưa chỉ định loại bài đăng. |
STANDARD |
Bài đăng chứa thông tin cơ bản, chẳng hạn như nội dung tóm tắt và hình ảnh. |
EVENT |
Bài đăng chứa thông tin cơ bản và một sự kiện. |
OFFER |
Bài đăng có chứa thông tin cơ bản, nội dung liên quan đến sự kiện và ưu đãi (ví dụ: mã giảm giá) |
ALERT |
Thông báo có mức độ ưu tiên cao và kịp thời liên quan đến một sự kiện đang diễn ra. Không phải lúc nào bạn cũng có thể tạo những loại bài đăng này. |
LocationReview
Biểu thị một bài đánh giá có thông tin vị trí.
| Trường | |
|---|---|
name |
Tên tài nguyên vị trí. |
review |
Bài đánh giá về địa điểm. |
MediaItem
Một mục nội dung nghe nhìn.
| Trường | |
|---|---|
name |
Tên tài nguyên của mục nội dung nghe nhìn này. |
media_format |
Định dạng của mục nội dung nghe nhìn này. Phải được đặt khi mục nội dung nghe nhìn được tạo và chỉ có thể đọc trong tất cả các yêu cầu khác. Không thể cập nhật. |
location_association |
Bắt buộc khi gọi Đây là thông tin bắt buộc khi thêm nội dung nghe nhìn mới vào một vị trí có |
google_url |
Chỉ có đầu ra. URL do Google lưu trữ cho mục nội dung nghe nhìn này. URL này không cố định vì có thể thay đổi theo thời gian. Đối với video, đây sẽ là hình ảnh xem trước có biểu tượng phát phủ lên. |
thumbnail_url |
Chỉ có đầu ra. Nếu được cung cấp, đây là URL của hình thu nhỏ cho mục nội dung nghe nhìn này. |
create_time |
Chỉ có đầu ra. Thời gian tạo của mục nội dung nghe nhìn này. |
dimensions |
Chỉ có đầu ra. Kích thước (chiều rộng và chiều cao) tính bằng pixel. |
insights |
Chỉ có đầu ra. Số liệu thống kê cho mục nội dung nghe nhìn này. |
attribution |
Chỉ có đầu ra. Thông tin phân bổ cho các mục nội dung nghe nhìn của khách hàng. Bạn phải hiển thị thông tin phân bổ này cho người dùng và không được xoá hoặc sửa đổi thông tin phân bổ. |
description |
Nội dung mô tả cho mục nội dung nghe nhìn này. Bạn không thể sửa đổi nội dung mô tả thông qua API Doanh nghiệp của tôi, nhưng có thể đặt nội dung mô tả khi tạo một mục nội dung nghe nhìn mới không phải là ảnh bìa. |
Trường nhóm Ngoại trừ danh mục Tất cả ảnh được tải lên đều phải tuân thủ các nguyên tắc của Google Doanh nghiệp của tôi về ảnh. |
|
source_url |
URL có thể truy cập công khai để truy xuất mục nội dung nghe nhìn. Khi tạo một trong các đối tượng này, bạn phải đặt data_ref để chỉ định nguồn của mục nội dung nghe nhìn. Nếu Bạn không thể cập nhật trường này. |
data_ref |
Chỉ có đầu vào. Tham chiếu đến dữ liệu nhị phân của mục nội dung nghe nhìn do phương thức Khi tạo một mục nội dung nghe nhìn, hãy
hoặc
phải được đặt. |
Phân bổ
Thông tin ghi nhận quyền tác giả cho các mục nội dung nghe nhìn của khách hàng, chẳng hạn như tên và ảnh hồ sơ của người đóng góp.
| Trường | |
|---|---|
profile_name |
Tên người dùng để gán mục nội dung nghe nhìn. |
profile_photo_url |
URL của hình thu nhỏ ảnh hồ sơ của người dùng được phân bổ. |
takedown_url |
URL của trang gỡ bỏ, nơi bạn có thể báo cáo mục nội dung nghe nhìn nếu mục đó không phù hợp. |
profile_url |
URL của trang hồ sơ trên Google Maps của người dùng được phân bổ. |
Kích thước
Kích thước của mục nội dung nghe nhìn.
| Trường | |
|---|---|
width_pixels |
Chiều rộng của mục nội dung nghe nhìn, tính bằng pixel. |
height_pixels |
Chiều cao của mục nội dung nghe nhìn, tính bằng pixel. |
LocationAssociation
Cách mục nội dung nghe nhìn được liên kết với vị trí của mục đó.
| Trường | |
|---|---|
Trường nhóm location_attachment_type. Nội dung nghe nhìn về địa điểm phải có danh mục hoặc mã nhận dạng của một mục trong bảng giá mà nội dung đó được liên kết. Nội dung nghe nhìn không có thông tin vị trí (ví dụ: ảnh trong bài đăng tại địa phương) không được có cả hai. location_attachment_type chỉ có thể là một trong những trạng thái sau: |
|
category |
Danh mục của bức ảnh về địa điểm này. |
price_list_item_id |
Mã nhận dạng của một mục trong bảng giá mà bức ảnh này về vị trí được liên kết. |
Danh mục
Enum cho danh mục mục nội dung nghe nhìn.
| Enum | |
|---|---|
CATEGORY_UNSPECIFIED |
Danh mục chưa xác định. |
COVER |
Ảnh bìa. Mỗi vị trí chỉ có một ảnh bìa. |
PROFILE |
Ảnh hồ sơ. Một vị trí chỉ có một ảnh hồ sơ. |
LOGO |
Ảnh biểu trưng. |
EXTERIOR |
Nội dung nghe nhìn bên ngoài. |
INTERIOR |
Nội dung nghe nhìn bên trong. |
PRODUCT |
Nội dung nghe nhìn về sản phẩm. |
AT_WORK |
Nội dung nghe nhìn "ở nơi làm việc". |
FOOD_AND_DRINK |
Nội dung nghe nhìn về đồ ăn và thức uống. |
MENU |
Nội dung nghe nhìn trong trình đơn. |
COMMON_AREA |
Nội dung nghe nhìn tại khu vực chung. |
ROOMS |
Nội dung nghe nhìn trong phòng. |
TEAMS |
Nội dung nghe nhìn của nhóm. |
ADDITIONAL |
Nội dung nghe nhìn bổ sung, chưa được phân loại. |
MediaFormat
Enum cho định dạng nội dung nghe nhìn.
| Enum | |
|---|---|
MEDIA_FORMAT_UNSPECIFIED |
Không chỉ định định dạng. |
PHOTO |
Mục nội dung nghe nhìn là ảnh. Trong phiên bản này, chỉ có ảnh được hỗ trợ. |
VIDEO |
Mục nội dung nghe nhìn là một video. |
MediaInsights
Thông tin chi tiết và số liệu thống kê cho mục nội dung nghe nhìn không được dùng nữa.
| Trường | |
|---|---|
view_count |
Chỉ có đầu ra. Số lần người dùng đã xem mục nội dung nghe nhìn. |
MediaItemDataRef
Tham chiếu đến dữ liệu nhị phân của ảnh MediaItem được tải lên thông qua API Doanh nghiệp của tôi.
Tạo một tham chiếu dữ liệu bằng cách sử dụng StartUploadMediaItemData và sử dụng tham chiếu này khi tải byte lên [UpdateMedia] rồi gọi CreateMediaItem.
| Trường | |
|---|---|
resource_name |
Mã nhận dạng duy nhất cho dữ liệu nhị phân của mục nội dung nghe nhìn này. Được dùng để tải dữ liệu ảnh lên bằng [UpdateMedia] và khi tạo một mục nội dung nghe nhìn mới từ các byte đó bằng Ví dụ về việc tải byte lên: Đối với các lệnh gọi |
MenuLabel
Nhãn sẽ được dùng khi hiển thị trình đơn và nhiều thành phần phụ của trình đơn đó.
| Trường | |
|---|---|
display_name |
Bắt buộc. Tên hiển thị của thành phần. |
description |
Không bắt buộc. Thông tin bổ sung về thành phần. |
language_code |
Không bắt buộc. Mã BCP 47 của ngôn ngữ. Nếu không có ngôn ngữ đó, hệ thống sẽ mặc định dùng tiếng Anh. |
NutritionFacts
Thông báo này thể hiện thông tin dinh dưỡng của một món ăn.
| Trường | |
|---|---|
calories |
Không bắt buộc. Lượng calo của món ăn. |
total_fat |
Không bắt buộc. Thông tin về chất béo của một món ăn cụ thể. |
cholesterol |
Không bắt buộc. Thông tin về cholesterol của một món ăn cụ thể. |
sodium |
Không bắt buộc. Thông tin về hàm lượng natri của một món ăn cụ thể. |
total_carbohydrate |
Không bắt buộc. Thông tin về carbohydrate của một món ăn cụ thể. |
protein |
Không bắt buộc. Thông tin về protein của một món ăn cụ thể. |
CaloriesFact
Thông báo này biểu thị thông tin về lượng calo trong một phạm vi có giới hạn trên và giới hạn dưới. Bạn phải chỉ định số tiền thấp hơn. Cả số tiền thấp hơn và số tiền cao hơn đều là số không âm.
| Trường | |
|---|---|
lower_amount |
Bắt buộc. Lượng calo thấp hơn |
upper_amount |
Không bắt buộc. Lượng calo tối đa |
unit |
Bắt buộc. Đơn vị của thông tin về lượng calo đã cho. |
EnergyUnit
Các đơn vị có thể có của năng lượng thực phẩm (calo).
| Enum | |
|---|---|
ENERGY_UNIT_UNSPECIFIED |
Chưa chỉ định đơn vị năng lượng |
CALORIE |
Calo |
JOULE |
Jun |
MassUnit
Các đơn vị khối lượng có thể có.
| Enum | |
|---|---|
MASS_UNIT_UNSPECIFIED |
Chưa chỉ định đơn vị khối lượng |
GRAM |
Gam |
MILLIGRAM |
Miligam |
NutritionFact
Thông báo này biểu thị thông tin dinh dưỡng có phạm vi giới hạn trên và giới hạn dưới, đồng thời có thể được biểu thị bằng đơn vị khối lượng. Bạn phải chỉ định số tiền thấp hơn. Cả số tiền thấp hơn và số tiền cao hơn đều là số không âm.
| Trường | |
|---|---|
lower_amount |
Bắt buộc. Lượng dinh dưỡng thấp hơn |
upper_amount |
Không bắt buộc. Lượng dinh dưỡng tối đa |
unit |
Bắt buộc. Đơn vị của thông tin dinh dưỡng được cung cấp. |
PreparationMethod
Phương pháp chuẩn bị món ăn.
| Enum | |
|---|---|
PREPARATION_METHOD_UNSPECIFIED |
Phương pháp chuẩn bị chưa được chỉ định |
BAKED |
Phương pháp nướng |
BARBECUED |
Phương pháp nướng |
BASTED |
Phương pháp rưới nước |
BLANCHED |
Phương pháp chần |
BOILED |
Phương pháp luộc |
BRAISED |
Phương pháp hầm |
CODDLED |
Phương pháp nuông chiều |
FERMENTED |
Phương pháp lên men |
FRIED |
Phương pháp chiên |
GRILLED |
Phương pháp nướng |
KNEADED |
Phương pháp nhào |
MARINATED |
Phương pháp ướp |
PAN_FRIED |
Phương pháp chiên |
PICKLED |
Phương thức được chọn |
PRESSURE_COOKED |
Phương pháp nấu bằng nồi áp suất |
ROASTED |
Phương pháp rang |
SAUTEED |
Phương pháp xào |
SEARED |
Phương pháp áp chảo |
SIMMERED |
Phương pháp hầm |
SMOKED |
Phương pháp xông khói |
STEAMED |
Phương pháp hấp |
STEEPED |
Phương pháp ngâm |
STIR_FRIED |
Phương pháp xào |
OTHER_METHOD |
Phương thức khác |
Xem xét
Chỉ có đầu ra. Đại diện cho một bài đánh giá về một địa điểm.
| Trường | |
|---|---|
name |
Tên tài nguyên. Đối với trạng thái Cần xem xét, mã này có dạng |
review_id |
Giá trị nhận dạng duy nhất đã mã hoá. |
reviewer |
Tác giả bài đánh giá. |
star_rating |
Điểm xếp hạng theo sao của bài đánh giá. |
comment |
Nội dung của bài đánh giá ở dạng văn bản thuần tuý có phần đánh dấu. |
create_time |
Dấu thời gian cho biết thời điểm viết bài đánh giá. |
update_time |
Dấu thời gian cho biết lần gần đây nhất bài đánh giá được sửa đổi. |
review_reply |
Câu trả lời của chủ sở hữu/người quản lý vị trí này cho bài đánh giá này. |
review_media_items[] |
Chỉ có đầu ra. Các mục nội dung nghe nhìn liên kết với bài đánh giá. |
review_reply_url |
Chỉ có đầu ra. URL để trả lời bài đánh giá. |
ReviewMediaItem
Biểu thị một mục nội dung nghe nhìn (ảnh hoặc video) được liên kết với một bài đánh giá.
| Trường | |
|---|---|
thumbnail_url |
Chỉ có đầu ra. URL FIFE cho ảnh hoặc hình thu nhỏ video nếu có |
thumbnail_label |
Chỉ có đầu ra. Nhãn do tác giả cung cấp cho |
video_url |
Chỉ có đầu ra. URL của video có thể phát. |
Người đánh giá
Đại diện cho tác giả của bài đánh giá.
| Trường | |
|---|---|
profile_photo_url |
Đường liên kết đến ảnh hồ sơ của người đánh giá. Chỉ được điền sẵn nếu |
display_name |
Tên của người đánh giá. Chỉ điền tên thật của người đánh giá nếu |
is_anonymous |
Cho biết liệu người đánh giá có chọn ẩn danh hay không. |
StarRating
Điểm xếp hạng theo sao trên 5 sao, trong đó 5 là điểm xếp hạng cao nhất.
| Enum | |
|---|---|
STAR_RATING_UNSPECIFIED |
Chưa chỉ định. |
ONE |
1/5 sao. |
TWO |
Hai sao trên tối đa năm sao. |
THREE |
3 sao trên tổng số 5 sao. |
FOUR |
4/5 sao. |
FIVE |
Điểm xếp hạng tối đa theo sao. |
ReviewReply
Đại diện cho câu trả lời của chủ sở hữu/người quản lý vị trí đối với một bài đánh giá.
| Trường | |
|---|---|
comment |
Nội dung thư trả lời ở dạng văn bản thuần tuý có phần đánh dấu. Độ dài tối đa là 4096 byte. |
update_time |
Chỉ có đầu ra. Dấu thời gian cho biết lần gần đây nhất câu trả lời được sửa đổi. |
review_reply_state |
Chỉ có đầu ra. Trạng thái của câu trả lời cho bài đánh giá. |
policy_violation |
Không bắt buộc. Chỉ có đầu ra. Lỗi vi phạm chính sách dẫn đến việc bị từ chối. Chỉ được điền sẵn nếu review_reply_state là REJECTED. |
PolicyViolation
Biểu thị các lỗi vi phạm chính sách được chuẩn hoá. Các giá trị mới có thể được thêm vào trong tương lai. Các ứng dụng cần chuẩn bị để xử lý các giá trị không xác định.
| Enum | |
|---|---|
POLICY_VIOLATION_UNSPECIFIED |
Biểu thị một lỗi vi phạm chính sách không xác định. |
ACCOUNT_RESTRICTED_AND_SUSPENDED |
Một Tài khoản Google liên kết với Trang doanh nghiệp này đã bị hạn chế, dẫn đến việc Trang doanh nghiệp bị tạm ngưng. |
ACCOUNT_RESTRICTED_AND_EDIT_REJECTED |
Một Tài khoản Google liên kết với Trang doanh nghiệp này đã bị hạn chế, khiến các nội dung chỉnh sửa bị từ chối. Không giống như ACCOUNT_RESTRICTED_AND_SUSPENDED, Trang doanh nghiệp vẫn hoạt động và không bị tạm ngưng. |
ASSOCIATED_ACCOUNT_SUSPENDED |
Tài khoản Google liên kết với Trang doanh nghiệp này không ở trạng thái tốt. Các Trang doanh nghiệp liên kết với tài khoản đó đã bị tạm ngưng. |
BUSINESS_INELIGIBLE |
Doanh nghiệp của bạn không đủ điều kiện sử dụng Trang doanh nghiệp. |
OWNERSHIP_REVOKED |
Một Tài khoản Google khác đã xác nhận quyền sở hữu Trang doanh nghiệp này. Bạn không thể quản lý trang doanh nghiệp này nữa. |
LOCATION_SUSPENDED |
Trang doanh nghiệp này đã bị tạm ngưng. |
LOCATION_DISABLED |
Trang doanh nghiệp này đã bị vô hiệu hoá. |
LOCATION_VERIFICATION_REQUIRED |
Trang doanh nghiệp này chưa được xác minh. |
PO_BOX |
Trang doanh nghiệp của bạn đã bị tạm ngưng vì địa chỉ doanh nghiệp không được là hộp thư bưu điện. |
GOOGLE_PAY_SUSPENSION |
Các Trang doanh nghiệp liên kết với Hồ sơ thanh toán của bạn đã bị tạm ngưng. |
EDITING_RESTRICTION |
Trang doanh nghiệp này hiện không nhận được thông tin cập nhật công khai. Google đã tắt tính năng chỉnh sửa cho địa điểm này để ngăn chặn nội dung vi phạm chính sách. |
ILLEGAL_BUSINESS_HOURS_EDIT |
Bạn không thể chỉnh sửa giờ hoạt động cho danh mục kinh doanh của mình. |
FAKE_ENGAGEMENT |
Chúng tôi không cho phép nội dung vi phạm chính sách về hoạt động tương tác ảo. Hoạt động tương tác ảo bao gồm nội dung có tặng thưởng, nội dung có mục đích thao túng điểm xếp hạng về một địa điểm và nội dung khác không thể hiện trải nghiệm chân thực. |
ADULT_THEMED |
Chúng tôi không cho phép nội dung vi phạm chính sách về nội dung có chủ đề người lớn. Chủ đề người lớn bao gồm cả nội dung tình dục không phản cảm và nội dung người lớn khác. |
SEXUALLY_EXPLICIT |
Chúng tôi không cho phép nội dung vi phạm chính sách về nội dung khiêu dâm. Nội dung khiêu dâm bao gồm ảnh khoả thân hoặc nội dung mô tả các hoạt động tình dục. |
ADVERTISING_AND_SOLICITATION |
Chúng tôi không cho phép nội dung vi phạm chính sách về hành vi quảng cáo hoặc chào mời. Hành vi quảng cáo và chào mời bao gồm nội dung thương mại hoặc nội dung quảng cáo hay nội dung được đăng để đổi lấy lợi ích. |
DANGEROUS |
Chúng tôi không cho phép nội dung vi phạm chính sách về nội dung nguy hiểm. Nội dung nguy hiểm cổ xuý, tạo điều kiện hoặc khuyến khích việc thực hiện hành động gây hại. |
GIBBERISH_AND_REPETITIVE |
Chúng tôi không cho phép nội dung vi phạm chính sách về nội dung không rõ ràng hoặc lặp lại. Nội dung không rõ ràng hoặc lặp lại làm loãng thông tin hữu ích mà người khác có thể tìm thấy trên Google. |
REPETITIVE |
Chúng tôi không cho phép nội dung vi phạm chính sách về nội dung lặp lại. Nội dung lặp lại bao gồm nội dung giống hệt hoặc tương tự nhau được một hoặc nhiều tài khoản thêm nhiều lần. |
UNCLEAR |
Chúng tôi không cho phép nội dung vi phạm chính sách về nội dung không rõ ràng. Nội dung không rõ ràng bao gồm các ký tự ngẫu nhiên hoặc nội dung khác thiếu ý nghĩa. |
ILLEGAL |
Chúng tôi không cho phép nội dung vi phạm chính sách về nội dung bất hợp pháp. |
OFF_TOPIC |
Chúng tôi không cho phép nội dung vi phạm chính sách về nội dung lạc đề. Nội dung lạc đề bao gồm các bình luận khái quát về chính trị hoặc xã hội và hành vi khoe khoang về cá nhân. |
OFFENSIVE |
Chúng tôi không cho phép nội dung vi phạm chính sách về nội dung phản cảm. Nội dung phản cảm có thể khiến người khác cảm thấy cực kỳ tức giận, bị xúc phạm hoặc không được tôn trọng một cách hợp lý. |
VIOLENCE_AND_GORE |
Chúng tôi không cho phép nội dung vi phạm chính sách về nội dung bạo lực và máu me. Nội dung bạo lực và đẫm máu bao gồm nội dung liên quan đến người hay động vật mang tính cực đoan và mô tả hành vi bạo lực, máu, các bộ phận hoặc nội tạng trên cơ thể một cách chân thực. |
CHILD_SAFETY |
Chúng tôi không cho phép nội dung vi phạm chính sách về sự an toàn cho trẻ em. Nội dung này bao gồm vấn đề khiến trẻ em gặp rủi ro, hành vi bóc lột hay lạm dụng trẻ em, hoặc việc sử dụng các dịch vụ của Google để gây nguy hiểm cho trẻ em. |
HARASSMENT |
Chúng tôi không cho phép nội dung vi phạm chính sách về hành vi quấy rối. Nội dung này bao gồm hành vi bắt nạt, đe doạ, khiêu dâm hoặc khiến một người cảm thấy lo sợ cho sự an toàn của họ. |
HATE_SPEECH |
Chúng tôi không cho phép nội dung vi phạm chính sách về lời nói hận thù. Lời nói hận thù bao gồm việc cổ xuý hoặc dung túng cho hành vi bạo lực, phân biệt đối xử, miệt thị hoặc kích động hận thù dựa trên một đặc điểm được bảo vệ hay các đặc điểm khác liên quan đến hành vi phân biệt đối xử hoặc kỳ thị có hệ thống. |
IMPERSONATION |
Chúng tôi không cho phép nội dung vi phạm chính sách về hành vi mạo danh. Hành vi mạo danh bao gồm việc sử dụng danh tính giả để gây hiểu lầm cho người khác hoặc thu được lợi ích không chính đáng. |
MISINFORMATION |
Chúng tôi không cho phép nội dung vi phạm chính sách về thông tin sai lệch. Thông tin sai lệch bao gồm những thông tin sai sự thật hoặc không chính xác và có thể gây hại đáng kể cho cá nhân, doanh nghiệp hoặc xã hội. |
MISREPRESENTATION |
Chúng tôi không cho phép nội dung vi phạm chính sách về hành vi trình bày sai. Hành vi trình bày sai bao gồm nội dung trình bày gây hiểu nhầm hoặc nội dung không đầy đủ nhằm mục đích thu được lợi ích không chính đáng. |
OBSCENITY_AND_PROFANITY |
Chúng tôi không cho phép nội dung vi phạm chính sách về ngôn từ tục tĩu hoặc ngôn từ thô tục. Ngôn từ thô tục và khiêu dâm bao gồm những từ hoặc cử chỉ bị xem là phản cảm hoặc khiếm nhã trong xã hội theo từng địa phương. |
PERSONAL_INFO |
Chúng tôi không cho phép nội dung vi phạm chính sách về thông tin cá nhân. Thông tin cá nhân bao gồm thông tin riêng tư hoặc thông tin mật, chẳng hạn như chi tiết thẻ tín dụng, bệnh án hoặc giấy tờ tuỳ thân do chính phủ cấp, cho dù đó là thông tin của bạn hay của người khác. |
REGULATED_GOODS_AND_SERVICES |
Chúng tôi không cho phép nội dung vi phạm chính sách về hàng hoá và dịch vụ thuộc diện quản lý. Nội dung này bao gồm lời kêu gọi hành động hoặc ưu đãi để bán các sản phẩm hoặc dịch vụ chịu sự kiểm soát của pháp luật tại địa phương. |
GENERIC_VANDALISM |
Chúng tôi không cho phép nội dung vi phạm chính sách về nội dung lăng mạ hoặc có chất lượng thấp. |
GENERIC_FRAUD |
Chúng tôi không cho phép nội dung vi phạm chính sách về nội dung và hành vi lừa đảo. Nội dung lừa đảo cố ý gây hiểu lầm hoặc lừa gạt người khác. |
PHOTOS_AND_VIDEOS_CRITERIA |
Chúng tôi không cho phép nội dung không tuân thủ các tiêu chí về ảnh và video. |
MODERATION_ERROR |
Đã xảy ra lỗi trong khi xử lý nội dung của bạn. |
PRIVACY |
Chúng tôi không cho phép nội dung vi phạm chính sách quyền riêng tư về Nội dung do người dùng đóng góp trên Maps. |
GENERIC_VIOLATION |
Nội dung của bạn vi phạm các chính sách của Google nên không được phép hiển thị. |
GENERIC_QUALITY |
Chúng tôi không cho phép những nội dung vi phạm chính sách về nội dung chất lượng thấp. |
IDENTITY_CHANGE |
Thay đổi mà bạn thực hiện khác biệt rất nhiều so với doanh nghiệp đã tạo. Trường hợp này vi phạm chính sách của chúng tôi. |
GEOGRAPHIC_LOCATION_CHANGE |
Cho biết vị trí địa lý thực tế (địa chỉ hoặc vĩ độ/kinh độ) của doanh nghiệp đã thay đổi đáng kể kể từ khi trang doanh nghiệp được tạo. |
Tiểu bang
Biểu thị trạng thái kiểm duyệt của câu trả lời cho bài đánh giá.
| Enum | |
|---|---|
REVIEW_REPLY_STATE_UNSPECIFIED |
Cho biết rằng trạng thái không được chỉ định. |
PENDING |
Cho biết rằng câu trả lời đang chờ kiểm duyệt. |
REJECTED |
Cho biết rằng câu trả lời đã bị từ chối. |
APPROVED |
Cho biết rằng câu trả lời đã được phê duyệt. |
Độ cay
Mức độ cay của một món ăn.
| Enum | |
|---|---|
SPICINESS_UNSPECIFIED |
Cấp độ không xác định |
MILD |
Ký hiệu cay nhẹ. |
MEDIUM |
Ký hiệu cho độ cay trung bình. |
HOT |
Ký hiệu của vị cay nóng. Cấp độ cay nhất. |
StartUploadMediaItemDataRequest
Thông báo yêu cầu cho Media.StartUploadMediaItemData.
| Trường | |
|---|---|
parent |
Tên tài nguyên của vị trí mà mục nội dung nghe nhìn này sẽ được thêm vào. |
TimeInterval
Một khoảng thời gian, bao gồm cả giá trị đầu và giá trị cuối. Bạn phải điền tất cả các trường để có thể sử dụng.
| Trường | |
|---|---|
start_date |
Ngày bắt đầu của khoảng thời gian này. |
start_time |
Thời gian bắt đầu của khoảng thời gian này. |
end_date |
Ngày kết thúc của khoảng thời gian này. |
end_time |
Thời gian kết thúc của khoảng thời gian này. |
UpdateFoodMenusRequest
Thông báo yêu cầu cho FoodMenu.UpdateFoodMenus
| Trường | |
|---|---|
food_menus |
Bắt buộc. Thông tin thực đơn mới nhất. Bạn có thể huỷ đặt trình đơn bằng cách cập nhật mà không có mục nào trong trình đơn. |
update_mask |
Không bắt buộc. Các trường cụ thể cần cập nhật. Nếu không có mặt nạ nào được chỉ định, thì thao tác này được coi là một bản cập nhật đầy đủ và tất cả các trường đều được đặt thành các giá trị được truyền vào, có thể bao gồm cả việc huỷ đặt các trường trống trong yêu cầu. Bạn không thể cập nhật từng mục riêng lẻ trong trường lặp lại. Lưu ý: "name" của FoodMenus là mã nhận dạng tài nguyên không thể cập nhật. |
UpdateLocalPostRequest
Thông báo yêu cầu cho UpdateLocalPost.
| Trường | |
|---|---|
name |
Tên của bài đăng tại địa phương cần cập nhật. |
local_post |
Thông tin mới nhất về bài đăng tại địa phương. |
update_mask |
Các trường cụ thể cần cập nhật. Bạn phải chỉ định từng trường đang được cập nhật trong mặt nạ. |
UpdateMediaItemRequest
Thông báo yêu cầu cho Media.UpdateMediaItem.
| Trường | |
|---|---|
name |
Tên của mục nội dung nghe nhìn cần cập nhật. |
media_item |
Mục nội dung nghe nhìn cần cập nhật. Bạn chỉ có thể cập nhật danh mục hoặc mã mặt hàng trong bảng giá. |
update_mask |
Các trường cụ thể cần cập nhật. Nếu không có mặt nạ nào được chỉ định, thì thao tác này sẽ được coi là một bản cập nhật đầy đủ và tất cả các trường có thể chỉnh sửa sẽ được đặt thành các giá trị được truyền vào. |
UpdateReviewReplyRequest
Thông báo yêu cầu cho Reviews.UpdateReviewReply.
| Trường | |
|---|---|
name |
Tên của bài đánh giá cần trả lời. |
review_reply |
Câu trả lời cho bài đánh giá. Nếu đã có một câu trả lời, thì câu trả lời mới này sẽ thay thế câu trả lời cũ. |
ValidationError
Mô tả các lỗi xác thực trong yêu cầu của ứng dụng.
| Trường | |
|---|---|
error_details[] |
Nêu chi tiết từng lỗi xác thực riêng lẻ bằng mã lỗi số nguyên. |