Package google.mybusiness.v4

Chỉ mục

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

rpc GetFoodMenus(GetFoodMenusRequest) returns (FoodMenus)

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.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

UpdateFoodMenus

rpc UpdateFoodMenus(UpdateFoodMenusRequest) returns (FoodMenus)

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.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

LocalPosts

API này cung cấp API quản lý của bài đăng tại địa phương.

CreateLocalPost

rpc CreateLocalPost(CreateLocalPostRequest) returns (LocalPost)

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 đó.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

DeleteLocalPost

rpc DeleteLocalPost(DeleteLocalPostRequest) returns (Empty)

Xoá một bài đăng tại địa phương. Trả về NOT_FOUND nếu bài đăng tại địa phương không tồn tại.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

GetLocalPost

rpc GetLocalPost(GetLocalPostRequest) returns (LocalPost)

Lấy bài đăng tại địa phương được chỉ định. Trả về NOT_FOUND nếu bài đăng tại địa phương không tồn tại.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

ListLocalPosts

rpc ListLocalPosts(ListLocalPostsRequest) returns (ListLocalPostsResponse)

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í.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

UpdateLocalPost

rpc UpdateLocalPost(UpdateLocalPostRequest) returns (LocalPost)

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.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

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

rpc CreateMediaItem(CreateMediaItemRequest) returns (MediaItem)

Tạo một mục nội dung nghe nhìn mới cho vị trí.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

DeleteMediaItem

rpc DeleteMediaItem(DeleteMediaItemRequest) returns (Empty)

Xoá mục nội dung nghe nhìn đã chỉ định.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

GetCustomerMediaItem

rpc GetCustomerMediaItem(GetCustomerMediaItemRequest) returns (MediaItem)

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.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

GetMediaItem

rpc GetMediaItem(GetMediaItemRequest) returns (MediaItem)

Trả về siêu dữ liệu cho mục nội dung nghe nhìn được yêu cầu.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

ListCustomerMediaItems

rpc ListCustomerMediaItems(ListCustomerMediaItemsRequest) returns (ListCustomerMediaItemsResponse)

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í.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

ListMediaItems

rpc ListMediaItems(ListMediaItemsRequest) returns (ListMediaItemsResponse)

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í.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

StartUploadMediaItemData

rpc StartUploadMediaItemData(StartUploadMediaItemDataRequest) returns (MediaItemDataRef)

Tạo MediaItemDataRef để tải mục nội dung nghe nhìn lên.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

UpdateMediaItem

rpc UpdateMediaItem(UpdateMediaItemRequest) returns (MediaItem)

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.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

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

rpc BatchGetReviews(BatchGetReviewsRequest) returns (BatchGetReviewsResponse)

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.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

DeleteReviewReply

rpc DeleteReviewReply(DeleteReviewReplyRequest) returns (Empty)

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.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

GetReview

rpc GetReview(GetReviewRequest) returns (Review)

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ề NOT_FOUND nếu bài đánh giá không tồn tại hoặc đã bị xoá.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

ListReviews

rpc ListReviews(ListReviewsRequest) returns (ListReviewsResponse)

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.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

UpdateReviewReply

rpc UpdateReviewReply(UpdateReviewReplyRequest) returns (ReviewReply)

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.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

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

string

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[]

string

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

int32

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

string

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

string

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à update_time desc. Các thứ tự hợp lệ để sắp xếp là rating, rating descupdate_time desc. rating sẽ trả về các bài đánh giá theo thứ tự tăng dần. Không hỗ trợ update_time(tức là thứ tự tăng dần).

ignore_rating_only_reviews
(deprecated)

bool

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[]

LocationReview

Bài đánh giá có thông tin vị trí.

next_page_token

string

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

ActionType

Loại hành động sẽ được thực hiện.

url

string

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 OFFER trong LocalPostTopicType để tạo một bài đăng có nội dung ưu đãi.

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

string

Tên của vị trí mà bạn muốn tạo bài đăng địa phương này.

local_post

LocalPost

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

string

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

MediaItem

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

string

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

string

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

string

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

int32

Mã trạng thái, phải là giá trị enum của ErrorCode.

field

string

Đườ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

string

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

string

Giá trị không thực hiện được yêu cầu.

field_index

int32

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[]

MenuLabel

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

string

Không bắt buộc. URL nguồn của thực đơn nếu có trang web để truy cập.

sections[]

FoodMenuSection

Bắt buộc. Các phần của trình đơn.

cuisines[]

Cuisine

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
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[]

MenuLabel

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

FoodMenuItemAttributes

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[]

FoodMenuItemOption

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

Money

Không bắt buộc. Giá của món ăn.

spiciness

Spiciness

Không bắt buộc. Mức độ cay của món ăn.

allergen[]

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[]

DietaryRestriction

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

NutritionFacts

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[]

Ingredient

Không bắt buộc. Các thành phần của món ăn.

serves_num_people

int32

Không bắt buộc. Số người có thể ăn món ăn này.

preparation_methods[]

PreparationMethod

Không bắt buộc. Phương pháp chế biến món ăn.

portion_size

PortionSize

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[]

string

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[]

MenuLabel

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

int32

Bắt buộc. Số lượng của phần.

unit[]

MenuLabel

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[]

MenuLabel

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

FoodMenuItemAttributes

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[]

MenuLabel

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[]

FoodMenuItem

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

string

Bắt buộc. Giá trị nhận dạng của Google cho vị trí này ở dạng: accounts/{account_id}/locations/{location_id}/foodMenus

menus[]

FoodMenu

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

string

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

string

Bắt buộc. Giá trị nhận dạng của Google cho vị trí này ở dạng: accounts/{account_id}/locations/{location_id}/foodMenus

read_mask

FieldMask

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

string

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

string

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

string

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[]

ErrorDetail

Chi tiết từng lỗi.

ListCustomerMediaItemsRequest

Thông báo yêu cầu cho Media.ListCustomerMediaItems.

Trường
parent

string

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

int32

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

string

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[]

MediaItem

Danh sách các mục nội dung nghe nhìn được trả về.

total_media_item_count

int32

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

string

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

string

Tên của vị trí có bài đăng tại địa phương sẽ được liệt kê.

page_size

int32

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

string

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[]

LocalPost

Danh sách bài đăng tại địa phương được trả về.

next_page_token

string

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 ListLocalPosts.

ListMediaItemsRequest

Thông báo yêu cầu cho Media.ListMediaItems.

Trường
parent

string

Tên của vị trí có các mục nội dung nghe nhìn sẽ được liệt kê.

page_size

int32

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

string

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[]

MediaItem

Danh sách các mục nội dung nghe nhìn được trả về.

total_media_item_count

int32

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

string

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

string

Tên của địa điểm cần tìm nạp bài đánh giá.

page_size

int32

Số lượng bài đánh giá cần tìm nạp trên mỗi trang. Số lượng page_size tối đa là 50.

page_token

string

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

string

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à update_time desc. Các thứ tự hợp lệ để sắp xếp là rating, rating descupdate_time desc.

ListReviewsResponse

Thông báo phản hồi cho Reviews.ListReviews.

Trường
reviews[]

Review

Các bài đánh giá.

average_rating

double

Đ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

int32

Tổng số bài đánh giá về vị trí này.

next_page_token

string

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

string

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: accounts/{account_id}/locations/{location_id}/localPosts/{local_post_id}

language_code

string

Ngôn ngữ của bài đăng tại địa phương.

summary

string

Nội dung mô tả/nội dung của bài đăng tại địa phương.

call_to_action

CallToAction

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ủ đề OFFER.

create_time

Timestamp

Chỉ có đầu ra. Thời gian tạo bài đăng.

update_time

Timestamp

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

Timestamp

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
(deprecated)

Timestamp

Chỉ có đầu ra. Không dùng nữa: Thay vào đó, hãy sử dụng event.recurring_instance_time. Trường này sẽ bị xoá trong một phiên bản sắp tới. 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.

event

LocalPostEvent

Thông tin sự kiện. Bắt buộc đối với các loại chủ đề EVENTOFFER.

state

LocalPostState

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[]

MediaItem

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

string

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

LocalPostTopicType

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

AlertType

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

LocalPostOffer

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

string

Tên của sự kiện.

schedule

TimeInterval

Ngày/giờ bắt đầu và kết thúc sự kiện.

recurrence_info

RecurrenceInfo

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

Timestamp

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

Timestamp

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

DailyOccurrencePattern

Mẫu lặp lại hằng ngày.

weekly_pattern

WeeklyOccurrencePattern

Mẫu số lần xuất hiện hằng tuần.

monthly_pattern

MonthlyOccurrencePattern

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

int32

Ngày trong tháng.

day_of_week_occurrence

DayOfWeekOccurrence

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[]

DayOfWeek

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

string

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

string

Không bắt buộc. Đường liên kết trực tuyến để sử dụng ưu đãi.

terms_conditions

string

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

string

Tên tài nguyên vị trí.

review

Review

Bài đánh giá về địa điểm.

MediaItem

Một mục nội dung nghe nhìn.

Trường
name

string

Tên tài nguyên của mục nội dung nghe nhìn này. accounts/{account_id}/locations/{location_id}/media/{media_key}

media_format

MediaFormat

Đị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

LocationAssociation

Bắt buộc khi gọi CreatePhoto. Mô tả cách mục nội dung nghe nhìn này được kết nối với vị trí của nó. Phải là một danh mục (ví dụ: EXTERIOR) hoặc mã nhận dạng của một mặt hàng trong bảng giá.

Đâ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ó CreateMediaItem. Đối với các loại nội dung nghe nhìn khác (ví dụ: ảnh trên bài đăng tại địa phương), thông tin này sẽ không xuất hiện.

google_url

string

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

string

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

Timestamp

Chỉ có đầu ra. Thời gian tạo của mục nội dung nghe nhìn này.

dimensions

Dimensions

Chỉ có đầu ra. Kích thước (chiều rộng và chiều cao) tính bằng pixel.

insights
(deprecated)

MediaInsights

Chỉ có đầu ra. Số liệu thống kê cho mục nội dung nghe nhìn này.

attribution

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

string

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 data. Nguồn dữ liệu của mục nội dung nghe nhìn. Khi tạo một mục nội dung nghe nhìn mới, bạn phải cung cấp URL hoặc tham chiếu dữ liệu.

Ngoại trừ danh mục PROFILECOVER, tất cả ảnh phải có kích thước tối thiểu là 250px ở cạnh ngắn, với kích thước tệp tối thiểu là 10240 byte.

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. data chỉ có thể là một trong những trạng thái sau:

source_url

string

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 source_url được dùng khi tạo một mục nội dung nghe nhìn, thì mục đó sẽ được điền sẵn URL nguồn khi mục nội dung nghe nhìn được truy xuất.

Bạn không thể cập nhật trường này.

data_ref

MediaItemDataRef

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 StartUploadMediaItemData thu được.

Khi tạo một mục nội dung nghe nhìn, hãy

sourceUrl

hoặc

dataRef

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

string

Tên người dùng để gán mục nội dung nghe nhìn.

profile_photo_url

string

URL của hình thu nhỏ ảnh hồ sơ của người dùng được phân bổ.

takedown_url

string

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

string

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

int32

Chiều rộng của mục nội dung nghe nhìn, tính bằng pixel.

height_pixels

int32

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

Category

Danh mục của bức ảnh về địa điểm này.

price_list_item_id

string

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ơ.
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

int64

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

string

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 CreateMediaItem.

Ví dụ về việc tải byte lên: curl -X POST -T{path_to_file} "http://mybusiness.googleapis.com/upload/v1/media/{resource_name}?upload_type=media"

Đối với các lệnh gọi CreateMediaItem, hãy đặt lệnh gọi này làm MediaItem data_ref.

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

string

Bắt buộc. Tên hiển thị của thành phần.

description

string

Không bắt buộc. Thông tin bổ sung về thành phần.

language_code

string

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

CaloriesFact

Không bắt buộc. Lượng calo của món ăn.

total_fat

NutritionFact

Không bắt buộc. Thông tin về chất béo của một món ăn cụ thể.

cholesterol

NutritionFact

Không bắt buộc. Thông tin về cholesterol của một món ăn cụ thể.

sodium

NutritionFact

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

NutritionFact

Không bắt buộc. Thông tin về carbohydrate của một món ăn cụ thể.

protein

NutritionFact

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

int32

Bắt buộc. Lượng calo thấp hơn

upper_amount

int32

Không bắt buộc. Lượng calo tối đa

unit

EnergyUnit

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

double

Bắt buộc. Lượng dinh dưỡng thấp hơn

upper_amount

double

Không bắt buộc. Lượng dinh dưỡng tối đa

unit

MassUnit

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

string

Tên tài nguyên. Đối với trạng thái Cần xem xét, mã này có dạng accounts/{account_id}/locations/{location_id}/reviews/{review_id}

review_id

string

Giá trị nhận dạng duy nhất đã mã hoá.

reviewer

Reviewer

Tác giả bài đánh giá.

star_rating

StarRating

Điểm xếp hạng theo sao của bài đánh giá.

comment

string

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

Timestamp

Dấu thời gian cho biết thời điểm viết bài đánh giá.

update_time

Timestamp

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

ReviewReply

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[]

ReviewMediaItem

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

string

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

string

Chỉ có đầu ra. URL FIFE cho ảnh hoặc hình thu nhỏ video nếu có video_url.

thumbnail_label

string

Chỉ có đầu ra. Nhãn do tác giả cung cấp cho thumbnail_url.

video_url

string

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

string

Đường liên kết đến ảnh hồ sơ của người đánh giá. Chỉ được điền sẵn nếu is_anonymous là false.

display_name

string

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 là false.

is_anonymous

bool

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

string

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

Timestamp

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

State

Chỉ có đầu ra. Trạng thái của câu trả lời cho bài đánh giá.

policy_violation

PolicyViolation

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

string

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

Date

Ngày bắt đầu của khoảng thời gian này.

start_time

TimeOfDay

Thời gian bắt đầu của khoảng thời gian này.

end_date

Date

Ngày kết thúc của khoảng thời gian này.

end_time

TimeOfDay

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

FoodMenus

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

FieldMask

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

string

Tên của bài đăng tại địa phương cần cập nhật.

local_post

LocalPost

Thông tin mới nhất về bài đăng tại địa phương.

update_mask

FieldMask

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

string

Tên của mục nội dung nghe nhìn cần cập nhật.

media_item

MediaItem

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

FieldMask

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

string

Tên của bài đánh giá cần trả lời.

review_reply

ReviewReply

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[]

ErrorDetail

Nêu chi tiết từng lỗi xác thực riêng lẻ bằng mã lỗi số nguyên.