Package google.mybusiness.v4

Lần gần đây nhất thuật toán so khớp được thực thi cho vị trí này.

FollowersMetadata

Siêu dữ liệu về người theo dõi của một vị trí.

Trường

name

string

Tên tài nguyên cho trường này. accounts/{account_id}/locations/{location_id}/followers/metadata

count

uint64

Tổng số người theo dõi cho vị trí.

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", "bữa trưa đặc biệt". Tên hiển thị chỉ được dài tối đa 140 ký tự và nội dung mô tả phải dài tối đa 1.000 ký tự. Cần ít nhất một bộ nhãn.
`source_url`	`string` Không bắt buộc. URL nguồn của trình đơn nếu có trang web cần truy cập.
`sections[]`	`FoodMenuSection` Bắt buộc. Các mục trong trình đơn.
`cuisines[]`	`Cuisine` Không bắt buộc. Thông tin về món ăn trên thực đơn món ăn. Bạn nên cung cấp trường này.

Món ăn

Thông tin về món ăn của một nhà hàng.

Enum
`CUISINE_UNSPECIFIED`	Không xác định món ăn
`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 theo phong cách 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 Triều Tiên
`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`	Thực phẩm chay
`VIETNAMESE`	Món ăn Việt
`OTHER_CUISINE`	Ẩm thực khác

FoodMenuItem

Mục của Phần. Đó có thể là chính món ăn đó hoặc có thể chứa nhiều FoodMenuItemOption.

Trường

labels[]

MenuLabel

Bắt buộc. Nhãn ngôn ngữ có gắn thẻ cho mục này trong trình đơn. Tên hiển thị chỉ được dài tối đa 140 ký tự và nội dung mô tả phải dài tối đa 1.000 ký tự. Cần ít nhất một bộ 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, lựa chọn này được xem là thuộc tính cơ sở và được điền sẵn vào mỗi lựa chọn.

options[]

FoodMenuItemOption

Không bắt buộc. Yêu cầu này dành cho một mặt hàng có nhiều lựa chọn và người dùng bắt buộc phải đưa ra lựa chọn. Ví dụ: "thông thường" so với "lớn" bánh pizza. Khi bạn chỉ định các lựa chọn, các 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 loại thực phẩm bổ sung khác trong trường này.

FoodMenuItemAttributes

Thuộc tính của món ăn/món ăn.

Trường
`price`	`Money` Bắt buộc. Giá của món ăn.
`spiciness`	`Spiciness` Không bắt buộc. Độ cay của món ăn.
`allergen[]`	`Allergen` Không bắt buộc. Chất gây dị ứng có liên quan đến 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 uống 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 lựa chọn món ăn. Bạn nên cung cấp trường này.
`ingredients[]`	`Ingredient` Không bắt buộ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ể phục vụ theo món ăn này.
`preparation_methods[]`	`PreparationMethod` Không bắt buộc. Phương thức chế biến món ăn.
`portion_size`	`PortionSize` Không bắt buộc. Kích thước của đơn đặt hàng, được thể hiện bằng đơn vị mặt hàng. (ví dụ: 4 "xiên", 6 "mảnh")
`media_keys[]`	`string` Không bắt buộc. Các phím đa phương tiện của nội dung nghe nhìn liên kết với món ăn. Chỉ hỗ trợ nội dung nghe nhìn từ ảnh. Khi có nhiều ảnh được liên kết, ảnh đầu tiên được coi là ảnh ưa thích.

name

string

Tên của tài khoản để tạo số tài khoản.

GetAccountRequest

Thông báo yêu cầu đối với accounts.GetAccount.

Trường

name

string

Tên tài khoản cần tìm nạp.

GetChainRequest

Thông báo yêu cầu đối với Places.GetChain.

Trường

name

string

Tên tài nguyên của chuỗi, ở định dạng chains/{chain_place_id}.

GetCustomerMediaItemRequest

Yêu cầu thông báo cho Media.GetCustomerMediaItem.

Trường

name

Các trường mà Google đã cập nhật.

HealthProviderAttributes

Các thuộc tính Nhà cung cấp sức khoẻ được liên kết với vị trí này.

Trường

name

string

Bắt buộc. Giá trị nhận dạng của Google cho vị trí này trong biểu mẫu: accounts/{account_id}/locations/{location_id}/healthProviderAttributes

insurance_networks[]

InsuranceNetwork

Không bắt buộc. Danh sách các mạng bảo hiểm được vị trí này chấp nhận.

InsuranceNetwork

Một mạng lưới bảo hiểm duy nhất. Mã tiếp theo: 5

Trường
`network_id`	`string` Bắt buộc. Mã của mạng bảo hiểm này do Google tạo.
`network_names`	`map<string, string>` Chỉ có đầu ra. Một sơ đồ tên hiển thị mạng theo ngôn ngữ được yêu cầu, trong đó ngôn ngữ là khoá và tên hiển thị được bản địa hoá là giá trị. Tên hiển thị bằng tiếng Anh được đặt theo mặc định.
`payer_names`	`map<string, string>` Chỉ có đầu ra. Sơ đồ tên hiển thị của người thanh toán theo các ngôn ngữ được yêu cầu, trong đó ngôn ngữ là khoá và tên hiển thị được bản địa hoá là giá trị. Tên hiển thị bằng tiếng Anh được đặt theo mặc định.
`state`	`NetworkState` Chỉ có đầu ra. Trạng thái của mạng bảo hiểm này.

InternalError

Mô tả lỗi nội bộ.

Trường

error_details[]

ErrorDetail

Thông tin chi tiết về từng lỗi.

Thư mời

Chỉ có đầu ra. Đại diện cho một lời mời đang chờ xử lý.

Trường
`name`	`string` Tên tài nguyên cho lời mời.
`role`	`AdminRole` Vai trò được mời đối với tài khoản.
Trường kết hợp `target`. Cho biết mục tiêu của lời mời này. `target` chỉ có thể là một trong những trạng thái sau đây:
`target_account`	`Account` Lời mời này dành cho tài khoản được điền thưa thớt.
`target_location`	`TargetLocation` Vị trí mục tiêu mà lời mời này dành cho.

TargetLocation

Đại diện cho vị trí mục tiêu cho lời mời đang chờ xử lý.

Trường

location_name

string

Tên của vị trí mà người dùng được mời.

location_address

string

Địa chỉ của vị trí mà người dùng được mời.

ListAccountAdminsRequest

Thông báo yêu cầu cho AccessControl.ListAccountAdmins.

Trường

parent

string

Tên của tài khoản mà bạn dùng để truy xuất danh sách quản trị viên.

ListAccountAdminsResponse

Thông báo phản hồi cho AccessControl.ListAccountAdmins.

Trường

admins[]

Tập hợp các thực thể Admin.

ListAccountsRequest

Yêu cầu thông báo cho accounts.ListAccounts.

Trường
`page_size`	`int32` Số lượng tài khoản cần tìm nạp trên mỗi trang. Giá trị mặc định là 20, tối thiểu là 2 và kích thước trang tối đa là 20.
`page_token`	`string` Nếu được chỉ định, trang tiếp theo của tài khoản sẽ được truy xuất. `pageToken` được trả về khi lệnh gọi đến `accounts.list` trả về nhiều kết quả hơn kích thước trang được yêu cầu.
`name`	`string` Tên tài nguyên của tài khoản mà bạn cần truy xuất danh sách các tài khoản có thể truy cập trực tiếp. Điều này chỉ có ý nghĩa đối với Tổ chức và Nhóm người dùng. Nếu trống, hàm sẽ trả về `ListAccounts` cho người dùng đã được xác thực.
`filter`	`string` Bộ lọc ràng buộc các tài khoản trả về. Phản hồi chỉ bao gồm các mục khớp với bộ lọc. Nếu `filter` trống, thì không có điều kiện ràng buộc nào được áp dụng và tất cả các tài khoản (được phân trang) sẽ được truy xuất cho tài khoản được yêu cầu. Ví dụ: một yêu cầu có bộ lọc `type=USER_GROUP` sẽ chỉ trả về nhóm người dùng.

ListAccountsResponse

Thông báo phản hồi cho accounts.ListAccounts.

Trường

accounts[]

Account

Một tập hợp những tài khoản mà người dùng có quyền truy cập. Tài khoản cá nhân của người dùng thực hiện truy vấn sẽ luôn là mục đầu tiên của kết quả, trừ phi tài khoản đó bị lọc ra.

next_page_token

string

Nếu số lượng tài khoản vượt quá kích thước trang đã 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 tài khoản tiếp theo trong lệnh gọi tiếp theo đến accounts.list. Nếu không còn tài khoản nào khác, thì trường này sẽ không xuất hiện trong phản hồi.

ListAnswersRequest

Yêu cầu thông báo đối với questionsAndAnswers.ListAnswers

Trường
`parent`	`string` Tên câu hỏi để tìm nạp câu trả lời.
`page_size`	`int32` Số lượng câu trả lời cần tìm nạp trên mỗi trang. Giá trị `page_size` mặc định và tối đa là 10.
`page_token`	`string` Nếu bạn chỉ định, trang tiếp theo của câu trả lời sẽ được truy xuất.
`order_by`	`string` Lệnh trả về câu trả lời. Các lựa chọn hợp lệ bao gồm "update_time desc" và "upvote_count", sẽ trả về các câu trả lời được sắp xếp giảm dần theo trường được yêu cầu. Thứ tự sắp xếp mặc định là "update_time desc".

ListAnswersResponse

Thông báo phản hồi cho questionsAndAnswers.ListAnswers

Trường

answers[]

Answer

Các câu trả lời được yêu cầu.

total_size

int32

Tổng số câu trả lời được đăng cho câu hỏi này trên tất cả các trang.

next_page_token

string

Nếu số lượng câu trả lời vượt quá kích thước trang tối đa đã 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 câu trả lời tiếp theo trong lệnh gọi tiếp theo. Nếu không còn câu trả lời nào nữa thì trường này sẽ không xuất hiện trong câu trả lời.

ListAttributeMetadataRequest

Thông báo yêu cầu choLocations.ListAttributeMetadata. Nếu bạn cung cấp tên tài nguyên vị trí, thì vị trí đó sẽ được dùng để điền các tiêu chí còn lại. Nếu không có, bạn phải cung cấp danh mục và quốc gia.

Trường
`name`	`string` Tên tài nguyên của vị trí để tra cứu các thuộc tính có sẵn.
`category_id`	`string` Mã nhận dạng ổn định của danh mục chính để tìm các thuộc tính hiện có.
`country`	`string` Mã quốc gia theo ISO 3166-1 alpha-2 để tìm các thuộc tính có sẵn.
`language_code`	`string` Mã BCP 47 của ngôn ngữ để lấy tên hiển thị thuộc tính. Nếu ngôn ngữ này không có sẵn, chúng sẽ được cung cấp bằng tiếng Anh.
`page_size`	`int32` Số thuộc tính cần đưa vào mỗi trang. Giá trị mặc định là 200, giá trị tối thiểu là 1.
`page_token`	`string` Nếu bạn chỉ định, hệ thống sẽ truy xuất trang tiếp theo của siêu dữ liệu thuộc tính. `pageToken` được trả về khi lệnh gọi đến `attributes.list` trả về nhiều kết quả hơn kích thước trang được yêu cầu.

ListAttributeMetadataResponse

Thông báo phản hồi choLocations.ListAttributeMetadata.

Trường

attributes[]

AttributeMetadata

Tập hợp siêu dữ liệu thuộc tính của các thuộc tính hiện có.

next_page_token

string

Nếu số lượng thuộc tính vượt quá kích thước trang đã yêu cầu, trường này sẽ được điền sẵn một mã thông báo để tìm nạp trang thuộc tính tiếp theo trong lệnh gọi tiếp theo tới attributes.list. Nếu không còn thuộc tính nào khác, trường này sẽ không xuất hiện trong phản hồi.

ListBusinessCategoriesRequest

Trường
`region_code`	`string` Mã quốc gia theo ISO 3166-1 alpha-2.
`language_code`	`string` Mã ngôn ngữ BCP 47. Nếu không có sẵn ngôn ngữ, thì ngôn ngữ mặc định sẽ là tiếng Anh.
`search_term`	`string` Chuỗi bộ lọc không bắt buộc từ người dùng.
`page_size`	`int32` Số lượng danh mục cần tìm nạp trên mỗi trang. Giá trị mặc định là 100, tối thiểu là 1 và kích thước trang tối đa là 100.
`page_token`	`string` Nếu bạn chỉ định, chúng tôi sẽ tìm nạp trang danh mục tiếp theo.
`view`	`CategoryView` Không bắt buộc. Chỉ định các phần của tài nguyên Danh mục cần được trả về trong phản hồi.

Thông báo yêu cầu cho securityNetworkService.ListInsurance Networks

Trường
`parent`	`string` Bắt buộc. Tên của địa điểm mà mạng bảo hiểm sẽ được liệt kê. Tên có dạng: accounts/{account_id}/locations/{location_id}
`language_code`	`string` Không bắt buộc. Mã BCP 47 cho ngôn ngữ. Nếu bạn không cung cấp mã ngôn ngữ thì mã sẽ là tiếng Anh theo mặc định. Ngay bây giờ chỉ có "en" được hỗ trợ.
`page_size`	`int32` Số lượng nhà cung cấp bảo hiểm trả lại trên mỗi trang. Giá trị mặc định là 5000. Kích thước trang tối đa là 10000.
`page_token`	`string` Nếu được chỉ định, sẽ trả về trang tiếp theo của mạng bảo hiểm.

ListInsuranceNetworksResponse

Thông báo phản hồi cho securityNetworkService.ListInsurance MCN

Trường

networks[]

InsuranceNetwork

Danh sách các mạng bảo hiểm được Google hỗ trợ.

next_page_token

string

Nếu có nhiều mạng bảo hiểm hơn kích thước trang đã 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 tiếp theo của mạng bảo hiểm trong lệnh gọi tiếp theo đến ListInsurance Networks.

ListInvitationsRequest

Thông báo yêu cầu AccessControl.ListInvitations.

Trường

parent

string

Tên của tài khoản mà danh sách lời mời được truy xuất từ đó.

target_type

TargetType

Chỉ định những loại mục tiêu sẽ xuất hiện trong phản hồi.

TargetType

Loại mục tiêu của lời mời.

Enum
`ALL`	Liệt kê lời mời cho tất cả các loại mục tiêu. Đây là tuỳ chọn mặc định.
`ACCOUNTS_ONLY`	Chỉ liệt kê lời mời cho các mục tiêu của loại Tài khoản.
`LOCATIONS_ONLY`	Chỉ liệt kê lời mời cho các mục tiêu của loại Vị trí.

ListInvitationsResponse

Thông báo phản hồi cho AccessControl.ListInvitations.

Trường

invitations[]

Invitation

Bộ sưu tập lời mời tham gia địa điểm đang chờ xử lý cho tài khoản. Số lượng lời mời được liệt kê ở đây không được vượt quá 1000.

ListLocalPostsRequest

Yêu cầu thông báo cho ListLocal posts

Trường

parent

string

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

page_size

int32

Số lượng bài đăng địa phương sẽ trả lại trên mỗi trang. Giá trị mặc định là 20. Kích thước 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 địa phương.

ListLocalPostsResponse

Thông báo phản hồi cho ListLocal posts

Trường

local_posts[]

LocalPost

Danh sách các bài đăng cục bộ được trả về.

next_page_token

string

Nếu có nhiều bài đăng cục bộ hơn kích thước trang đã yêu cầu, thì trường này sẽ được điền sẵn mã thông báo để tìm nạp trang tiếp theo của bài đăng cục bộ trong lệnh gọi tiếp theo tới ListLocalPosts.

ListLocationAdminsRequest

Yêu cầu thông báo cho AccessControl.ListLocationAdmins.

Trường

parent

string

Tên của vị trí để liệt kê quản trị viên.

ListLocationAdminsResponse

Thông báo phản hồi cho AccessControl.ListLocationAdmins.

Trường

admins[]

LocationDrivingDirectionMetrics

Tập hợp các thực thể Admin.

ListLocationRequest

Yêu cầu thông báo về địa điểm.ListLocations.

Trường
`parent`	`string` Tên tài khoản dùng để tìm nạp vị trí. Nếu `Account` là của `AccountType` CÁ NHÂN, thì chỉ những Vị trí thuộc sở hữu trực tiếp của Tài khoản mới được trả về, nếu không thì dữ liệu này sẽ trả về tất cả thông tin vị trí có thể truy cập được từ Tài khoản, theo cách trực tiếp hoặc gián tiếp.
`page_size`	`int32` Số lượng vị trí cần tìm nạp trên mỗi trang. Giá trị mặc định là 100, tối thiểu là 1 và kích thước trang tối đa là 100.
`page_token`	`string` Nếu được chỉ định, phương thức này sẽ tìm nạp `page` vị trí tiếp theo. Mã thông báo trang được các lệnh gọi trước đó trả về cho `ListLocations` khi có nhiều vị trí hơn số lượng vị trí có thể phù hợp với kích thước trang được yêu cầu.
`filter`	`string` Bộ lọc ràng buộc vị trí cần trả về. Phản hồi chỉ bao gồm các mục khớp với bộ lọc. Nếu `filter` trống, thì các điều kiện ràng buộc sẽ được áp dụng và tất cả các vị trí (được phân trang) sẽ được truy xuất cho tài khoản được yêu cầu. Để biết thêm thông tin về các trường hợp lệ và ví dụ về cách sử dụng, hãy xem Hướng dẫn về cách xử lý dữ liệu vị trí.
`language_code (deprecated)`	`string` Mục này không được dùng nữa! Mã ngôn ngữ BCP 47 để nhận thuộc tính vị trí hiển thị. Nếu ngôn ngữ này không có sẵn, chúng sẽ được cung cấp bằng ngôn ngữ của vị trí. Nếu cả hai tài khoản này đều không có sẵn, chúng sẽ được cung cấp bằng tiếng Anh. Không dùng nữa. Sau ngày 15 tháng 8 năm 2020, trường này sẽ không còn áp dụng nữa. Thay vào đó, ngôn ngữ của vị trí sẽ luôn được sử dụng.
`order_by`	`string` Thứ tự sắp xếp cho yêu cầu. Nhiều trường phải được phân tách bằng dấu phẩy, theo cú pháp SQL. Thứ tự sắp xếp mặc định là tăng dần. Để chỉ định thứ tự giảm dần, hậu tố " mô tả" cần được thêm vào. Các trường hợp lệ đối với order_by (theo vị trí) là location_name (tên_vị_trí) và store_code (mã cửa hàng). Ví dụ: "location_name, store_code Description" hoặc "location_name" hoặc "store_code description" (mô tả mã cửa hàng)

Phản hồi ListLocationsLocation

Thông báo phản hồi cho Location.ListLocations.

Trường

locations[]

Location

Vị trí.

next_page_token

string

Nếu số lượng vị trí vượt quá kích thước trang được yêu cầu, trường này sẽ được điền sẵn một mã thông báo để tìm nạp trang vị trí tiếp theo trong lệnh gọi tiếp theo tới ListLocations. Nếu không có vị trí nào khác, trường này sẽ không xuất hiện trong câu trả lời.

total_size

int32

Số lượng Vị trí gần đúng trong danh sách, bất kể việc phân trang.

ListMediaItemsRequest

Yêu cầu thông báo cho Media.ListMediaItems.

Trường

parent

string

Tên của vị trí chứa các mục nội dung đa phương tiệ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ợ các mục nội dung đa phương tiện có thể được thêm vào một vị trí bằng API Google 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 này sẽ trả về trang tiếp theo của mục nội dung đa phương tiệ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ể cách phân trang.

next_page_token

string

ListQuestionsRequest

Yêu cầu thông báo cho AnswersAndAnswers.ListQuestion

Trường
`parent`	`string` Tên của vị trí cần tìm nạp câu hỏi.
`page_size`	`int32` Số lượng câu hỏi cần tìm nạp trên mỗi trang. Giá trị `page_size` mặc định và tối đa là 10.
`page_token`	`string` Nếu bạn chỉ định, hệ thống sẽ truy xuất trang câu hỏi tiếp theo.
`answers_per_question`	`int32` Số lượng câu trả lời cần tìm nạp cho mỗi câu hỏi. Giá trị `answers_per_question` mặc định và tối đa là 10.
`filter`	`string` Bộ lọc ràng buộc các câu hỏi được trả về. Bộ lọc duy nhất hiện được hỗ trợ là "ignore_answered=true"
`order_by`	`string` Lệnh trả lại các câu hỏi. Các lựa chọn hợp lệ bao gồm "update_time desc" và "upvote_count desc" để trả về các câu hỏi được sắp xếp giảm dần theo trường được yêu cầu. Thứ tự sắp xếp mặc định là "update_time desc".

ListQuestionsResponse

Thông báo phản hồi cho AnswersAndAnswers.ListQuestion

Trường

questions[]

Question

Các câu hỏi bắt buộc,

total_size

int32

Tổng số câu hỏi được đăng cho vị trí này trên tất cả các trang.

next_page_token

string

Nếu số lượng câu hỏi vượt quá kích thước trang tối đa được yêu cầu, trường này sẽ được điền sẵn một mã thông báo để tìm nạp trang câu hỏi tiếp theo trong lần gọi tiếp theo. Nếu không còn câu hỏi nào nữa thì trường này sẽ không xuất hiện trong câu trả lời.

ListRecommendedGoogleLocationsRequest

Yêu cầu gửi tin nhắn để liệt kê các địa điểm được đề xuất cho một tài khoản Trang doanh nghiệp.

Trường

name

string

Tên của tài nguyên tài khoản để tìm nạp các vị trí được đề xuất trên Google.

page_size

int32

Số lượng vị trí cần tìm nạp trên mỗi trang. Giá trị mặc định là 25, tối thiểu là 1 và kích thước trang tối đa là 100.

page_token

string

Nếu được chỉ định, trang tiếp theo của vị trí sẽ được truy xuất.

ListRecommendedGoogleLocationsResponse

Thông báo phản hồi cho GoogleLocations.ListRecommendedGoogleLocations.

Trang doanh nghiệp này cũng chứa một số vị trí đã được những người dùng Trang doanh nghiệp khác xác nhận quyền sở hữu kể từ lần gần đây nhất họ được đề xuất cho tài khoản Trang doanh nghiệp này.

Trường

google_locations[]

GoogleLocation

Các vị trí được đề xuất cho tài khoản Trang doanh nghiệp. Mỗi đối tượng trong số này đại diện cho một GoogleLocation xuất hiện trên Maps. Các vị trí được sắp xếp theo thứ tự giảm dần mức độ liên quan đối với tài khoản Trang doanh nghiệp.

total_size

int32

Tổng số vị trí được đề xuất cho tài khoản Trang doanh nghiệp này, bất kể việc phân trang.

next_page_token

string

Trong quá trình phân trang, nếu có thêm vị trí có sẵn để tìm nạp trong trang tiếp theo, trường này được điền sẵn một mã thông báo để tìm nạp trang vị trí tiếp theo trong lệnh gọi tiếp theo. Nếu không còn vị trí nào khác cần được tìm nạp, thì trường này sẽ không xuất hiện trong phản hồi.

ListReviewsRequest

Yêu cầu thông báo cho Reviews.Listreview.

Trường
`parent`	`string` Tên của vị trí để tìm nạp bài đánh giá.
`page_size`	`int32` Số bài đánh giá cần tìm nạp trên mỗi trang. `page_size` tối đa là 50.
`page_token`	`string` Nếu được chỉ định, Google sẽ tìm nạp trang tiếp theo của bài đánh giá.
`order_by`	`string` Chỉ định trường để sắp xếp bài đánh giá. Nếu bạn chưa 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 đơn đặt hàng hợp lệ để sắp xếp là `rating`, `rating desc` và `update_time desc`.

ListReviewsResponse

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

Trường
`reviews[]`	`Review` Bài đánh giá.
`average_rating`	`double` Điểm xếp hạng trung bình theo sao của tất cả bài đánh giá cho địa điểm này trên 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ề địa điểm 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 tiếp theo của các bài đánh giá trong lệnh gọi đến ListReview tiếp theo. Nếu không có bài đánh giá nào khác, thì trường này sẽ không xuất hiện trong câu trả lời.

ListVerificationsRequest

Yêu cầu tin nhắn cho Verifys.ListVerifys.

Trường

parent

string

Tên tài nguyên của vị trí chứa yêu cầu xác minh.

page_size

int32

Số lượng thông tin xác minh cần đưa vào mỗi trang. Nếu bạn chưa đặt chính sách này, hãy trả về tất cả.

page_token

string

Nếu được chỉ định, sẽ trả về trang xác minh tiếp theo.

ListVerificationsResponse

Tin nhắn phản hồi cho Verifys.ListVerifys.

Trường

verifications[]

Verification

Danh sách quy trình xác minh.

next_page_token

string

Nếu số lần xác minh vượt quá kích thước trang đã 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 xác minh tiếp theo trong lệnh gọi tiếp theo. Nếu không còn thuộc tính nào khác, trường này sẽ không xuất hiện trong phản hồi.

LocalPost

Đại diện cho bài đăng địa phương của một vị trí.

Trường
`name`	`string` Chỉ có đầu ra. Giá trị nhận dạng trên Google cho bài đăng địa phương này trong biểu mẫu: `accounts/{account_id}/locations/{location_id}/localPosts/{local_post_id}`
`language_code`	`string` Ngôn ngữ của bài đăng địa phương.
`summary`	`string` Phần mô tả/nội dung của bài đăng đị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ỏ 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 thực hiện lần sửa đổi gần đây nhất đối với bài đăng do người dùng thực hiện.
`event`	`LocalPostEvent` Thông tin về sự kiện. Bắt buộc đối với loại chủ đề `EVENT` và `OFFER`.
`state`	`LocalPostState` Chỉ có đầu ra. Trạng thái của bài đăng, cho biết bài đăng đó nằm trong phần nào trong vòng đời của bài đăng đó.
`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 địa phương trong 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.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 thông báo mà bài đăng được tạo. Trường này chỉ áp dụng cho các bài đăng của topic_type Alert và hoạt động như một loại Cảnh báo phụ.
`offer`	`LocalPostOffer` Dữ liệu bổ sung cho bài đăng về ưu đãi. Bạn chỉ nên đặt thuộc tính này khi topic_type là OFFER.

LocalPostState

Cho biết bài đăng đang ở trạng thái nào

Enum
`LOCAL_POST_STATE_UNSPECIFIED`	Trạng thái không được chỉ định.
`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.

LocalPostEvent

Tất cả thông tin liên quan đến một sự kiện xuất hiện trong một bài đăng địa phương.

Trường

title

string

Tên sự kiện.

schedule

TimeInterval

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

LocalPostMetrics

Tất cả các chỉ số bắt buộc đối với một Bài đăng địa phương.

Trường

local_post_name

string

metric_values[]

MetricValue

Danh sách giá trị cho các chỉ số được yêu cầu.

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 cục bộ, 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`	Chưa xác định loại bài đăng.
`STANDARD`	Bài đăng chứa thông tin cơ bản, chẳng hạn như bản 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 chứa thông tin cơ bản, sự kiện và nội dung liên quan đến ưu đãi (ví dụ: mã giảm giá)
`ALERT`	Thông báo kịp thời và có mức độ ưu tiên cao liên quan đến sự kiện đang diễn ra. Không phải lúc nào bạn cũng có thể viết những loại bài đăng này.

Vị trí

Một vị trí. Hãy xem bài viết trên trung tâm trợ giúp để biết nội dung mô tả chi tiết về các trường này hoặc xem điểm cuối của danh mục để biết danh sách các danh mục kinh doanh hợp lệ.

Trường
`name`	`string` Giá trị nhận dạng của Google cho vị trí này trong biểu mẫu: `accounts/{account_id}/locations/{location_id}` Trong bối cảnh kết quả trùng khớp, trường này sẽ không được điền sẵn.
`language_code`	`string` Ngôn ngữ của vị trí. Được thiết lập trong quá trình tạo và không thể cập nhật.
`store_code`	`string` Giá trị nhận dạng bên ngoài của vị trí này. Giá trị này phải là giá trị duy nhất trong một tài khoản nhất định. Đây là phương tiện để liên kết vị trí với hồ sơ của riêng bạn.
`location_name`	`string` Tên vị trí phải phản ánh tên doanh nghiệp trong thực tế, được sử dụng nhất quán trên mặt tiền cửa hàng, trang web và văn phòng phẩm cũng như được khách hàng biết đến. Bạn có thể đưa mọi thông tin bổ sung vào các trường khác của tài nguyên (ví dụ: `Address`, `Categories`) nếu phù hợp. Đừng thêm thông tin không cần thiết vào tên của bạn (ví dụ: ưu tiên sử dụng "Google" hơn là "Google Inc. - Trụ sở công ty Mountain View"). Đừng thêm dòng giới thiệu tiếp thị, mã cửa hàng, ký tự đặc biệt, giờ hoạt động hoặc trạng thái đóng cửa/mở cửa, số điện thoại, URL của trang web, thông tin dịch vụ/sản phẩm, vị trí/địa chỉ hoặc thông tin chỉ đường hay thông tin về cách quản lý (ví dụ: "Chase ATM ở Duane Reade").
`primary_phone`	`string` Là số điện thoại kết nối trực tiếp nhất có thể với địa điểm kinh doanh riêng của bạn. Nếu có thể, hãy sử dụng số điện thoại tại địa phương thay vì số đường dây hỗ trợ của trung tâm chăm sóc khách hàng.
`additional_phones[]`	`string` Ngoài số điện thoại chính, bạn có thể sử dụng tối đa 2 số điện thoại (di động hoặc cố định, không được là số fax) để gọi cho doanh nghiệp của mình.
`address`	`PostalAddress` Một địa chỉ rõ ràng, chính xác để mô tả địa điểm doanh nghiệp của bạn. Không chấp nhận hòm thư bưu điện hoặc hòm thư đặt tại những vị trí xa xôi. Tại thời điểm này, bạn có thể chỉ định tối đa năm giá trị `address_lines` trong địa chỉ.
`primary_category`	`Category` Danh mục mô tả đúng nhất về hoạt động kinh doanh cốt lõi của địa điểm này.
`additional_categories[]`	`Category` Các danh mục bổ sung để mô tả doanh nghiệp của bạn. Danh mục giúp khách hàng tìm thấy kết quả chính xác, cụ thể cho dịch vụ mà họ quan tâm. Để thông tin doanh nghiệp của bạn luôn chính xác và cập nhật, hãy đảm bảo rằng bạn sử dụng càng ít danh mục càng tốt để mô tả tổng thể hoạt động kinh doanh cốt lõi của mình. Chọn danh mục càng cụ thể càng tốt, nhưng đại diện cho công việc kinh doanh chính của bạn.
`website_url`	`string` URL cho doanh nghiệp này. Nếu có thể, hãy sử dụng URL đại diện cho địa điểm kinh doanh riêng lẻ này thay vì trang web/URL chung chung đại diện cho tất cả các địa điểm hoặc thương hiệu.
`regular_hours`	`BusinessHours` Giờ làm việc của doanh nghiệp.
`special_hours`	`SpecialHours` Giờ đặc biệt của doanh nghiệp. Thời điểm này thường bao gồm giờ hoạt động vào ngày lễ và những thời điểm khác ngoài giờ làm việc thông thường. Các giờ này sẽ thay thế giờ làm việc thông thường.
`service_area`	`ServiceAreaBusiness` Doanh nghiệp thuộc lĩnh vực dịch vụ cung cấp dịch vụ tại vị trí của khách hàng. Nếu doanh nghiệp này là một doanh nghiệp thuộc lĩnh vực dịch vụ, thì trường này mô tả(các) khu vực mà doanh nghiệp đang cung cấp.
`location_key`	`LocationKey` Bộ sưu tập các khoá liên kết doanh nghiệp này với các sản phẩm khác của Google, chẳng hạn như trang Google+ và Google Maps Địa điểm.
`labels[]`	`string` Tập hợp các chuỗi dạng tự do để cho phép bạn gắn thẻ doanh nghiệp của mình. Các nhãn này KHÔNG dành cho người dùng; chỉ bạn mới có thể xem chúng. Tối đa 255 ký tự (mỗi nhãn).
`ad_words_location_extensions`	`AdWordsLocationExtensions` Thông tin bổ sung xuất hiện trong AdWords.
`latlng`	`LatLng` Vĩ độ và kinh độ do người dùng cung cấp. Khi tạo một vị trí, trường này bị bỏ qua nếu bạn đã cung cấp mã địa lý thành công. Trường này chỉ được trả về khi có yêu cầu get nếu giá trị `latlng` do người dùng cung cấp được chấp nhận trong quá trình tạo hoặc giá trị `latlng` được cập nhật thông qua trang web Trang doanh nghiệp. Không thể cập nhật trường này.
`open_info`	`OpenInfo` Cờ cho biết liệu vị trí hiện có đang mở cửa kinh doanh hay không.
`location_state`	`LocationState` Chỉ có đầu ra. Một tập hợp boolean phản ánh trạng thái của một vị trí.
`attributes[]`	`Attribute` Các thuộc tính cho vị trí này.
`metadata`	`Metadata` Chỉ có đầu ra. Thông tin bổ sung mà người dùng không chỉnh sửa được.
`price_lists[] (deprecated)`	`PriceList` Các nội dung chỉnh sửa dịch vụ được thực hiện qua trường này có thể bị chậm trễ trong quá trình truyền tải. Vui lòng tham khảo API Thông tin doanh nghiệp phiên bản 1. Không dùng nữa: Thông tin bảng giá cho vị trí này.
`profile`	`Profile` Mô tả doanh nghiệp của bạn theo cách của riêng bạn và chia sẻ với người dùng câu chuyện độc đáo về doanh nghiệp và sản phẩm/dịch vụ của bạn.
`relationship_data`	`RelationshipData` Tất cả địa điểm và chuỗi liên quan đến địa điểm này.
`more_hours[]`	`MoreHours` Giờ khác cho các phòng ban hoặc khách hàng cụ thể của một doanh nghiệp.

Metadata

Thông tin bổ sung mà người dùng không thể chỉnh sửa về vị trí.

Trường

duplicate
(deprecated)

Duplicate

Thông tin về vị trí mà vị trí này trùng lặp. Chỉ xuất hiện khi location_state.is_duplicate đúng. Không dùng nữa: Chúng tôi không còn hỗ trợ thông tin chi tiết cho các trường hợp trùng lặp.

maps_url

string

Đường liên kết đến vị trí trên Maps.

new_review_url

string

Đường liên kết đến trang trên Google Tìm kiếm để khách hàng có thể viết bài đánh giá về vị trí đó.

Nhân bản

Thông tin về vị trí mà vị trí này trùng lặp.

Trường

location_name

string

Tên tài nguyên của vị trí mà đối tượng địa lý này trùng lặp. Chỉ được điền sẵn nếu người dùng đã xác thực có quyền truy cập vào vị trí đó và vị trí đó không bị xoá.

place_id

string

Mã địa điểm của vị trí bị trùng lặp.

access

Access

Cho biết liệu người dùng có quyền truy cập vào vị trí mà người dùng sao chép hay không.

Quyền truy cập

Cấp truy cập của người dùng vào vị trí mà bản sao đó. Thông tin này sẽ thay thế Quyền sở hữu và sẽ được dùng để thay thế.

Enum
`ACCESS_UNSPECIFIED`	Chưa chỉ định.
`ACCESS_UNKNOWN`	Không thể xác định liệu người dùng có quyền truy cập vào vị trí mà người dùng đó sao chép hay không.
`ALLOWED`	Người dùng có quyền truy cập vào thông tin vị trí trùng lặp.
`INSUFFICIENT`	Người dùng không có quyền truy cập vào vị trí bị trùng lặp.

RelationshipData

Thông tin về tất cả vị trí mẹ và con liên quan đến vị trí này.

Trường

parent_chain

string

Tên tài nguyên của Chuỗi mà vị trí này là thành viên. How to find Chain ID

LocationDrivingDirectionMetrics

Một vị trí được lập chỉ mục cùng với những khu vực nơi mọi người thường đến. Con số này được thu thập bằng cách đếm số yêu cầu chỉ đường lái xe đến vị trí này từ mỗi khu vực.

Trường

location_name

string

Tên tài nguyên vị trí chứa giá trị chỉ số này.

top_direction_sources[]

TopDirectionSources

Các yêu cầu về hướng lái xe theo khu vực nguồn. Theo quy ước, các kết quả này được sắp xếp theo số lượng và có tối đa 10 kết quả.

time_zone

string

Múi giờ (mã múi giờ IANA, ví dụ: "Châu Âu/London") của vị trí.

TopDirectionSources

Các khu vực hàng đầu nơi bắt nguồn các yêu cầu về hướng lái xe.

Trường

day_count

int32

Dữ liệu số ngày được tổng hợp.

region_counts[]

RegionCount

Các khu vực được sắp xếp theo thứ tự giảm dần theo số lượng.

RegionCount

Một khu vực có số lượng yêu cầu liên quan.

Trường

latlng

LatLng

Trung tâm khu vực.

label

string

Nhãn khu vực mà con người có thể đọc được.

count

int64

Số yêu cầu chỉ đường lái xe từ khu vực này.

LocationKey

Tham chiếu chính thay thế/thay thế cho một vị trí.

Trường
`plus_page_id`	`string` Chỉ có đầu ra. Nếu vị trí này được liên kết với trang Google+, thì vị trí này sẽ được điền bằng ID trang Google+ cho vị trí này.
`place_id`	`string` Nếu vị trí này đã được xác minh và được kết nối đến/xuất hiện trên Google Maps, trường này được điền bằng ID địa điểm cho vị trí. Mã này có thể dùng trong nhiều Places API. Nếu vị trí này chưa được xác minh, trường này có thể được điền sẵn nếu vị trí đã được liên kết với một địa điểm xuất hiện trên Google Maps. Bạn có thể đặt trường này trong khi thực hiện lệnh gọi Tạo, nhưng không thể đặt trường này khi cập nhật. Bool `explicit_no_place_id` bổ sung đủ điều kiện cho dù mã địa điểm chưa được đặt là có chủ ý hay không.
`explicit_no_place_id`	`bool` Chỉ có đầu ra. Giá trị true cho biết rằng mã địa điểm chưa được đặt là có chủ ý, khác với việc chưa có mối liên kết nào được thực hiện.
`request_id`	`string` Chỉ có đầu ra. `request_id` dùng để tạo vị trí này. Có thể trống nếu vị trí này được tạo bên ngoài API Google Doanh nghiệp của tôi hoặc Vị trí Trang doanh nghiệp.

LocationMetrics

Một loạt các Chỉ số và MetricsMetrics liên quan đến Vị trí trong một phạm vi thời gian nào đó.

Trường

location_name

string

Tên của tài nguyên vị trí chứa các giá trị này.

time_zone

string

Múi giờ IANA cho vị trí này.

metric_values[]

MetricValue

Danh sách giá trị cho các chỉ số được yêu cầu.

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ề vị trí đó.

LocationState

Chứa một tập hợp boolean phản ánh trạng thái của một Vị trí.

Trường
`is_google_updated`	`bool` Chỉ có đầu ra. Cho biết liệu ID địa điểm được liên kết với vị trí này có cập nhật hay không.
`is_duplicate`	`bool` Chỉ có đầu ra. Cho biết liệu vị trí có trùng lặp với một vị trí khác hay không.
`is_suspended`	`bool` Chỉ có đầu ra. Cho biết liệu vị trí có bị tạm ngưng hay không. Người dùng cuối sẽ không nhìn thấy vị trí bị tạm ngưng trong các sản phẩm của Google. Nếu bạn cho rằng có sự nhầm lẫn, hãy xem bài viết này trong trung tâm trợ giúp.
`can_update`	`bool` Chỉ có đầu ra. Cho biết liệu vị trí có thể được cập nhật hay không.
`can_delete`	`bool` Chỉ có đầu ra. Cho biết liệu vị trí có thể bị xóa bằng cách sử dụng API Google Doanh nghiệp của tôi hay không.
`is_verified`	`bool` Chỉ có đầu ra. Cho biết vị trí đã được xác minh hay chưa.
`needs_reverification`	`bool` Chỉ có đầu ra. Cho biết liệu vị trí đó có cần phải xác minh lại hay không.
`is_pending_review`	`bool` Chỉ có đầu ra. Cho biết liệu hoạt động đánh giá vị trí có đang chờ xử lý hay không.
`is_disabled`	`bool` Chỉ có đầu ra. Cho biết vị trí có bị tắt hay không.
`is_published`	`bool` Chỉ có đầu ra. Cho biết liệu vị trí có được xuất bản hay không.
`is_disconnected`	`bool` Chỉ có đầu ra. Cho biết liệu vị trí có bị ngắt kết nối với một địa điểm trên Google Maps hay không.
`is_local_post_api_disabled`	`bool` Chỉ có đầu ra. Cho biết liệu accounts.locations.localPosts có bị tắt đối với vị trí này hay không.
`can_modify_service_list`	`bool` Chỉ có đầu ra. Cho biết trang thông tin có thể sửa đổi ServiceList (Danh sách dịch vụ) hay không.
`can_have_food_menus`	`bool` Chỉ có đầu ra. Cho biết trang thông tin có đủ điều kiện dùng thực đơn đồ ăn hay không.
`has_pending_edits`	`bool` Chỉ có đầu ra. Cho biết liệu có bất kỳ cơ sở lưu trú nào của Vị trí này đang ở trạng thái đang chờ chỉnh sửa hay không.
`has_pending_verification`	`bool` Chỉ có đầu ra. Cho biết liệu vị trí có yêu cầu xác minh đang chờ xử lý hay không.
`can_operate_health_data`	`bool` Chỉ có đầu ra. Cho biết liệu vị trí có thể hoạt động dựa trên Dữ liệu sức khoẻ hay không.
`can_operate_lodging_data`	`bool` Chỉ có đầu ra. Cho biết liệu vị trí có thể hoạt động trên dữ liệu về Cơ sở lưu trú hay không.

MatchedLocation

Biểu thị kết quả trùng khớp có thể xảy ra với một vị trí.

Trường

location

Location

Vị trí có mật độ dân cư thưa thớt có thể là kết quả trùng khớp. Các trường không được điền sẵn bao gồm nhưng không giới hạn ở: tên (không truy xuất được vị trí trùng khớp qua GetLocation hoặc BatchGetLocations); store_code; Thông tin chi tiết về khu vực phủ sóng service_area; labels; ad_words_location_extensions; photos

is_exact_match

bool

Thông tin này có khớp chính xác không?

MediaItem

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

Trường
`name`	`string` Tên tài nguyên cho mục nội dung đa phương tiệ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 đa phương tiện này. Bạn phải đặt chế độ này khi tạo mục nội dung đa phương tiện và ở chế độ chỉ đọc đối với tất cả các yêu cầu khác. Không cập nhật được.
`location_association`	`LocationAssociation` Bắt buộc khi gọi `CreatePhoto`. Mô tả cách mục nội dung đa phương tiện này kết nối với vị trí của mục. Phải là một danh mục (ví dụ: EXTERIOR) hoặc mã nhận dạng của một mục trong danh sách giá. Đây là yêu cầu bắt buộc khi thêm nội dung nghe nhìn mới vào một vị trí bằng `CreateMediaItem`. Đối với các loại nội dung nghe nhìn khác, ví dụ như ảnh trên bài đăng tại địa phương, thuộc tính 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 đa phương tiện này. URL này không thể thay đổi 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 ở lớp phủ.
`thumbnail_url`	`string` Chỉ có đầu ra. URL của hình thu nhỏ cho mục nội dung đa phương tiện này (nếu được cung cấp).
`create_time`	`Timestamp` Chỉ có đầu ra. Thời gian tạo của mục nội dung đa phương tiệ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`	`MediaInsights` Chỉ có đầu ra. Số liệu thống kê cho mục nội dung đa phương tiệ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ị thuộc tính này theo như đã cung cấp cho người dùng của mình và không được xoá hoặc thay đổi thuộc tính đó.
`description`	`string` Nội dung mô tả cho mục nội dung đa phương tiện này. Bạn không thể sửa đổi nội dung mô tả thông qua API Google 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 kết hợp `data`. Nguồn dữ liệu của mục nội dung đa phương tiện. Khi tạo một mục nội dung đa phương tiệ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 `PROFILE` và `COVER`, tất cả ảnh đều 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 nhất là 10240 byte. Tất cả ảnh được tải lên phải tuân thủ Nguyên tắc về ảnh trên Trang doanh nghiệp. `data` chỉ có thể là một trong những trạng thái sau đây:
`source_url`	`string` URL có thể truy cập công khai nơi có thể truy xuất mục nội dung đa phương tiện. Khi tạo một trong số các tham số này hoặc data_ref, bạn phải đặt để chỉ định nguồn của mục nội dung đa phương tiện. Nếu bạn sử dụng `source_url` khi tạo một mục nội dung đa phương tiện, thì mục này sẽ được điền sẵn URL nguồn đó khi truy xuất mục nội dung đa phương tiện. Không thể cập nhật trường này.
`data_ref`	`MediaItemDataRef` Chỉ nhập. Thông tin tham chiếu đến dữ liệu nhị phân của mục nội dung đa phương tiện lấy được bằng phương thức `StartUploadMediaItemData`. Khi tạo một mục nội dung nghe nhìn: `sourceUrl` hoặc `dataRef` phải được đặt.

Phân bổ

Thông tin ghi công cho các mục nội dung đa phương tiệ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 đa phương tiện.
`profile_photo_url`	`string` URL 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 mục nội dung đa phương tiện có thể bị báo cáo nếu nội dung đó không phù hợp.
`profile_url`	`string` URL 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 đa phương tiện.

Trường

width_pixels

int32

Chiều rộng của mục nội dung đa phương tiện, tính bằng pixel.

height_pixels

int32

Chiều cao của mục nội dung đa phương tiện, tính bằng pixel.

LocationAssociation

Cách mục nội dung đa phương tiện liên kết với vị trí của mục đó.

Trường

Trường kết hợp location_attachment_type. Phương tiện vị trí phải có danh mục hoặc mã của mục danh sách giá liên kết với phương tiện đó. Nội dung nghe nhìn không liên quan đến vị trí (ví dụ: ảnh 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 đây:

category

Category

Danh mục chứa ảnh vị trí này.

price_list_item_id

string

Mã của mặt hàng trong danh sách giá có liên kết với ảnh vị trí này.

Danh mục

Enum cho danh mục mục nội dung đa phương tiện.

Enum
`CATEGORY_UNSPECIFIED`	Danh mục không xác định.
`COVER`	Ảnh bìa. Một 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`	Phương tiện bên ngoài.
`INTERIOR`	Nội dung nghe nhìn nội thất.
`PRODUCT`	Nội dung nghe nhìn của sản phẩm.
`AT_WORK`	"Tại nơi làm việc" nội dung đa phương tiện.
`FOOD_AND_DRINK`	Nội dung nghe nhìn về thực phẩm và đồ uống.
`MENU`	Nội dung nghe nhìn trên trình đơn.
`COMMON_AREA`	Nội dung nghe nhìn 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`	Chưa xác định định dạng.
`PHOTO`	Mục nội dung đa phương tiện là một ảnh. Trong phiên bản này, chỉ ảnh được hỗ trợ.
`VIDEO`	Mục nội dung đa phương tiệ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 đa phương tiện.

Trường

view_count

int64

Chỉ có đầu ra. Số lần mục nội dung đa phương tiện được xem.

MediaItemDataRef

Tham chiếu đến dữ liệu ảnh nhị phân của MediaItem được tải lên thông qua API Google Doanh nghiệp của tôi.

Tạo một tham chiếu dữ liệu bằ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 đa phương tiện này. 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ề cách 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 lệnh gọi CreateMediaItem, hãy đặt giá trị này thành MediaItem data_ref.

MenuLabel

Nhãn được sử dụng khi hiển thị trình đơn và các 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ã ngôn ngữ BCP 47. Nếu không có sẵn ngôn ngữ, thì ngôn ngữ mặc định sẽ là tiếng Anh.

Chỉ số

Chỉ số dữ liệu về một tài nguyên.

Enum
`METRIC_UNSPECIFIED`	Không có chỉ số nào được chỉ định.
`ALL`	Viết tắt để yêu cầu tất cả các chỉ số có sẵn. Những chỉ số có trong TẤT CẢ sẽ khác nhau và tuỳ thuộc vào tài nguyên yêu cầu thông tin chi tiết.
`QUERIES_DIRECT`	Số lần tài nguyên được hiển thị khi trực tiếp tìm kiếm vị trí.
`QUERIES_INDIRECT`	Số lần tài nguyên được hiển thị là kết quả của tìm kiếm theo danh mục (ví dụ: nhà hàng).
`QUERIES_CHAIN`	Số lần một tài nguyên được hiển thị là kết quả của việc tìm kiếm chuỗi chứa tài nguyên đó hoặc thương hiệu mà tài nguyên đó bán. Ví dụ: Starbucks, Adidas. Đây là một tập hợp con của queries_CONTINUE.
`VIEWS_MAPS`	Số lần tài nguyên được xem trên Google Maps.
`VIEWS_SEARCH`	Số lần tài nguyên được xem trên Google Tìm kiếm.
`ACTIONS_WEBSITE`	Số lần người dùng nhấp vào trang web.
`ACTIONS_PHONE`	Số lần người dùng đã nhấp vào số điện thoại.
`ACTIONS_DRIVING_DIRECTIONS`	Số lần yêu cầu chỉ đường lái xe.
`PHOTOS_VIEWS_MERCHANT`	Số lượt xem các mục nội dung đa phương tiện do người bán tải lên.
`PHOTOS_VIEWS_CUSTOMERS`	Số lượt xem các mục nội dung đa phương tiện do khách hàng tải lên.
`PHOTOS_COUNT_MERCHANT`	Tổng số mục nội dung nghe nhìn hiện đang xuất hiện trên YouTube mà người bán đã tải lên.
`PHOTOS_COUNT_CUSTOMERS`	Tổng số mục nội dung nghe nhìn hiện đang phát trực tiếp mà khách hàng đã tải lên.
`LOCAL_POST_VIEWS_SEARCH`	Số lần người dùng đã xem bài đăng địa phương đó trên Google Tìm kiếm.
`LOCAL_POST_ACTIONS_CALL_TO_ACTION`	Số lần người dùng đã nhấp vào nút kêu gọi hành động trên Google.

MetricOption

Tuỳ chọn để chỉ định cách dữ liệu xuất hiện trong câu trả lời.

Enum
`METRIC_OPTION_UNSPECIFIED`	Chưa chỉ định tùy chọn chỉ số nào. Sẽ được mặc định là AGGREGATED_TOTAL trong một yêu cầu.
`AGGREGATED_TOTAL`	Giá trị trả về được tổng hợp trong toàn bộ khung thời gian. Đây là giá trị mặc định.
`AGGREGATED_DAILY`	Trả về các giá trị có dấu thời gian hằng ngày trong phạm vi thời gian.
`BREAKDOWN_DAY_OF_WEEK`	Các giá trị sẽ được trả về dưới dạng bảng chi tiết theo ngày trong tuần. Chỉ hợp lệ đối với ACTIONS_PHONE.
`BREAKDOWN_HOUR_OF_DAY`	Giá trị sẽ được trả về dưới dạng bảng chi tiết theo giờ trong ngày. Chỉ hợp lệ đối với ACTIONS_PHONE.

MetricRequest

Yêu cầu trả về giá trị cho một chỉ số và các tuỳ chọn về cách trả về các giá trị đó.

Trường

metric

Metric

Chỉ số được yêu cầu.

options[]

MetricOption

Cách các giá trị sẽ xuất hiện khi được trả về.

MetricValue

Giá trị cho một Chỉ số duy nhất tại thời điểm bắt đầu.

Trường

metric

Metric

Chỉ số mà giá trị được áp dụng.

total_value

DimensionalMetricValue

Tổng giá trị tổng hợp cho chỉ số này. Đặt cho tùy chọn AGGREGATED_TOTAL.

dimensional_values[]

DimensionalMetricValue

Giá trị phương diện cho chỉ số này.

MoreHours

Khoảng thời gian một vị trí mở cửa cho một số loại hình kinh doanh nhất định.

Trường

hours_type_id

string

Bắt buộc. Loại giờ. Khách hàng nên gọi {#link businessCATEGORIES:BatchGet} để biết các loại giờ được hỗ trợ cho các danh mục địa điểm của họ.

periods[]

TimePeriod

Bắt buộc. Tập hợp thời gian vị trí này mở cửa. Mỗi khoảng thời gian biểu thị một khoảng giờ khi vị trí mở cửa trong tuần.

MoreHoursType

Ngoài giờ làm việc thông thường, doanh nghiệp có thể cung cấp các loại giờ khác.

Trường

hours_type_id

string

Chỉ có đầu ra. Mã ổn định do Google cung cấp cho loại giờ này.

display_name

string

Chỉ có đầu ra. Tên hiển thị bằng tiếng Anh mà con người có thể đọc được cho loại giờ.

localized_display_name

string

Chỉ có đầu ra. Tên hiển thị đã bản địa hoá mà con người có thể đọc được cho loại giờ.

NetworkState

Trạng thái của một mạng lưới bảo hiểm liên quan đến vị trí này.

Enum
`NETWORK_STATE_UNSPECIFIED`	Giá trị mặc định.
`ACCEPTED`	Vị trí này chấp nhận mạng này.
`PENDING_ADD`	Có một yêu cầu đang chờ xử lý để thêm mạng này vào danh sách được chấp nhận.
`PENDING_DELETE`	Có một yêu cầu đang chờ xử lý để xoá mạng này khỏi danh sách được chấp nhận.
`NOT_ACCEPTED`	Vị trí này không chấp nhận mạng này.

NotificationType

Loại thông báo được gửi đến chủ đề Cloud Pub/Sub.

Enum
`NOTIFICATION_TYPE_UNSPECIFIED`	Không có loại thông báo nào. Sẽ không khớp với bất kỳ thông báo nào.
`GOOGLE_UPDATE`	Vị trí có nội dung cập nhật của Google cần xem xét. Trường location_name trên thông báo sẽ cung cấp tên tài nguyên của vị trí với nội dung cập nhật của Google.
`NEW_REVIEW`	Một bài đánh giá mới đã được thêm vào vị trí này. Trường review_name trên thông báo sẽ cung cấp tên tài nguyên của bài đánh giá đã được thêm, còn location_name sẽ có tên tài nguyên của vị trí đó.
`UPDATED_REVIEW`	Một bài đánh giá về vị trí này đã được cập nhật. Trường review_name trên thông báo sẽ cung cấp tên tài nguyên của bài đánh giá đã được thêm, còn location_name sẽ có tên tài nguyên của vị trí đó.
`NEW_CUSTOMER_MEDIA`	Một người dùng Google Maps đã thêm một mục nội dung nghe nhìn mới vào vị trí. Thông báo sẽ cung cấp tên tài nguyên của mục nội dung đa phương tiện mới.
`NEW_QUESTION`	Một câu hỏi mới được thêm vào vị trí. Thông báo sẽ cung cấp tên tài nguyên của câu hỏi.
`UPDATED_QUESTION`	Một câu hỏi về vị trí đã được cập nhật. Thông báo sẽ cung cấp tên tài nguyên của câu hỏi.
`NEW_ANSWER`	Câu trả lời mới được thêm vào vị trí. Thông báo sẽ cung cấp tên tài nguyên của câu hỏi và câu trả lời.
`UPDATED_ANSWER`	Câu trả lời của vị trí đã được cập nhật. Thông báo sẽ cung cấp tên tài nguyên của câu hỏi và câu trả lời.
`UPDATED_LOCATION_STATE`	LocationState của vị trí đã được cập nhật. Thông báo sẽ chứa mặt nạ trường của các trường LocationState đã cập nhật.

Thông báo

Một chủ đề trên Google Cloud Pub/Sub, trong đó bạn có thể đăng thông báo khi một vị trí được cập nhật hoặc có bài đánh giá mới. Sẽ chỉ có một tài nguyên chế độ cài đặt thông báo cho mỗi tài khoản.

Trường

name

string

Chỉ có đầu ra. Tên tài nguyên thông báo.

topic_name

string

Chủ đề Google Cloud Pub/Sub sẽ nhận được thông báo khi cập nhật thông tin về các vị trí do tài khoản này quản lý. Nếu bạn không đặt chính sách này thì sẽ không có thông báo nào được đăng.

Tài khoản mybusiness-api-pubsub@system.gserviceaccount.com phải có ít nhất quyền Phát hành đối với chủ đề Cloud Pub/Sub.

notification_types[]

NotificationType

Các loại thông báo sẽ được gửi đến chủ đề Cloud Pub/Sub. Bạn phải chỉ định ít nhất một mã. Để ngừng nhận hoàn toàn thông báo, hãy sử dụng DeleteNotifications.

NutritionFacts

Thông báo này tượng trưng cho 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ề lượng cholesterol của một món ăn cụ thể.
`sodium`	`NutritionFact` Không bắt buộc. Thông tin về 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ề lượng 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 có giới hạn trên và giới hạn dưới. Phải chỉ định số tiền thấp hơn. Cả số tiền dưới và số tiền trên đều là số không âm.

Trường

lower_amount

int32

Bắt buộc. Giảm lượng calo

upper_amount

int32

Không bắt buộc. Lượng calo trên

unit

EnergyUnit

Bắt buộc. Đơn vị của thông tin về lượng calo đã cho.

EnergyUnit

Đơn vị năng lượng thực phẩm có thể sử dụng (calo).

Enum
`ENERGY_UNIT_UNSPECIFIED`	Chưa chỉ định đơn vị năng lượng
`CALORIE`	Calo
`JOULE`	Joule

MassUnit

Đơn vị khối lượng có thể dùng.

Enum
`MASS_UNIT_UNSPECIFIED`	Không xác định đơn vị khối lượng
`GRAM`	gram
`MILLIGRAM`	Miligam

NutritionFact

Thông báo này biểu thị thông tin dinh dưỡng qua 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. Phải chỉ định số tiền thấp hơn. Cả số tiền dưới và số tiền trê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 trên

unit

MassUnit

Bắt buộc. Đơn vị của thông tin dinh dưỡng đã cho.

OpenInfo

Thông tin liên quan đến trạng thái mở cửa của doanh nghiệp.

Trường

status

OpenForBusiness

Cho biết Vị trí hiện có đang mở cửa kinh doanh hay không. Tất cả các vị trí đều mở cửa theo mặc định, trừ phi bạn cập nhật thành đóng cửa.

can_reopen

bool

Chỉ có đầu ra. Cho biết doanh nghiệp này có đủ điều kiện để mở cửa lại hay không.

opening_date

Date

Ngày vị trí mở cửa lần đầu tiên. Nếu không xác định được ngày chính xác, bạn chỉ có thể cung cấp tháng và năm. Ngày này phải trong quá khứ hoặc không quá 1 năm trong tương lai.

OpenForBusiness

Cho biết trạng thái của một vị trí.

Enum
`OPEN_FOR_BUSINESS_UNSPECIFIED`	Chưa chỉ định.
`OPEN`	Cho biết vị trí đang mở cửa.
`CLOSED_PERMANENTLY`	Cho biết vị trí đã bị đóng cửa vĩnh viễn.
`CLOSED_TEMPORARILY`	Cho biết địa điểm này đã tạm thời đóng cửa. Bạn chỉ có thể áp dụng giá trị này cho các vị trí đã xuất bản (ví dụ: location_state.is_ publish = true). Khi cập nhật trường trạng thái thành giá trị này, ứng dụng phải đặt `update_mask` thành `open_info.status` một cách rõ ràng. Không thể đặt mặt nạ cập nhật khác trong cuộc gọi cập nhật này. Đây là quy định hạn chế tạm thời và sẽ sớm được nới lỏng.

PermissionLevel

Cho biết cấp truy cập của người dùng đã xác thực đối với tài khoản này.

Enum
`PERMISSION_LEVEL_UNSPECIFIED`	Chưa chỉ định.
`OWNER_LEVEL`	Người dùng có quyền ở cấp chủ sở hữu.
`MEMBER_LEVEL`	Người dùng có quyền ở cấp thành viên.

PhoneInput

Mục nhập để xác minh PHONE_CALL/SMS.

Trường

phone_number

string

Số điện thoại sẽ được gọi hoặc được gửi SMS. Đây phải là một trong các số điện thoại trong các lựa chọn đủ điều kiện.

PlaceInfo

Xác định một khu vực được biểu thị bằng một mã địa điểm.

Trường

name

string

Tên đã bản địa hoá của địa điểm. Ví dụ: Scottsdale, AZ.

place_id

string

Mã của địa điểm. Phải tương ứng với một khu vực.

Địa điểm

Xác định sự kết hợp của các khu vực được biểu thị bằng một tập hợp địa điểm.

Trường

place_infos[]

PlaceInfo

Các khu vực được biểu thị bằng mã địa điểm. Giới hạn tối đa 20 địa điểm.

PointRadius

Bán kính xung quanh một điểm cụ thể (vĩ độ/kinh độ).

Trường

latlng

LatLng

Vĩ độ/kinh độ chỉ định tâm của một khu vực được xác định bởi bán kính.

radius_km

float

Khoảng cách tính bằng km của khu vực xung quanh điểm đó.

PreparationMethod

Phương pháp chuẩn bị món ăn.

Enum
`PREPARATION_METHOD_UNSPECIFIED`	Chưa chỉ định phương pháp chuẩn bị
`BAKED`	Phương pháp bắt sáng
`BARBECUED`	Phương pháp nướng
`BASTED`	Phương pháp xác thực
`BLANCHED`	Phương pháp phủ màu
`BOILED`	Phương pháp luộc
`BRAISED`	Phương pháp om
`CODDLED`	Phương thức phân tách
`FERMENTED`	Phương pháp lên men
`FRIED`	Phương thức đã chiên
`GRILLED`	Phương thức nướng
`KNEADED`	Phương pháp nhào
`MARINATED`	Phương pháp tẩm ướp
`PAN_FRIED`	Phương pháp rán
`PICKLED`	Phương pháp chọn
`PRESSURE_COOKED`	Phương pháp nấu bằng áp suất
`ROASTED`	Phương thức rang
`SAUTEED`	Phương thức trộn
`SEARED`	Phương pháp hàn
`SIMMERED`	Phương thức đun nhỏ
`SMOKED`	Phương pháp xông khói
`STEAMED`	Phương pháp hấp
`STEEPED`	Phương thức dốc
`STIR_FRIED`	Phương pháp món xào
`OTHER_METHOD`	Phương pháp khác

PriceList

Không dùng nữa: Danh sách thông tin về giá của mặt hàng. Danh sách giá có cấu trúc dưới dạng một hoặc nhiều danh sách giá, mỗi danh sách chứa một hoặc nhiều mục với một hoặc nhiều mục. Ví dụ: bảng giá thực phẩm có thể thể hiện thực đơn bữa sáng/bữa trưa/bữa tối, có các phần cho bánh mì kẹp thịt/bít tết/hải sản.

Trường
`price_list_id`	`string` Bắt buộc. Mã của danh sách giá. Không được sao chép danh sách giá, mục và mã mặt hàng trong Vị trí này.
`labels[]`	`Label` Bắt buộc. Nhãn được gắn thẻ theo ngôn ngữ cho danh sách giá.
`source_url`	`string` URL nguồn không bắt buộc của nơi danh sách giá được truy xuất. Ví dụ: đây có thể là URL của trang được tự động trích xuất để điền thông tin trình đơn.
`sections[]`	`Section` Bắt buộc. Các phần của bảng giá này. Mỗi danh sách giá phải chứa ít nhất một mục.

Hãng nhạc

Nhãn được dùng khi đăng bảng giá, mục giá hoặc mặt hàng.

Trường

display_name

string

Bắt buộc. Tên hiển thị của danh sách giá, mục hoặc mặt hàng.

description

string

Không bắt buộc. Nội dung mô tả của bảng giá, mục hoặc mặt hàng.

language_code

string

Không bắt buộc. Mã ngôn ngữ BCP-47 mà các chuỗi này áp dụng. Bạn chỉ có thể đặt một bộ nhãn cho mỗi ngôn ngữ.

Phần

Một phần của danh sách giá chứa một hoặc nhiều mặt hàng.

Trường
`section_id`	`string` Bắt buộc. Mã nhận dạng của mục. Không được sao chép danh sách giá, mục và mã mặt hàng trong Vị trí này.
`labels[]`	`Label` Bắt buộc. Nhãn được gắn thẻ ngôn ngữ cho mục này. Tên phần và nội dung mô tả nên dài không quá 140 ký tự. Cần ít nhất một bộ nhãn.
`section_type`	`SectionType` Không bắt buộc. Loại của mục danh sách giá hiện tại. Giá trị mặc định là FOOD.
`items[]`	`Item` Các mặt hàng nằm trong phần này của danh sách giá.

Mục

Một mục trong danh sách. Mỗi biến thể của một mặt hàng trong danh sách giá phải có Mặt hàng riêng với dữ liệu giá riêng.

Trường

item_id

string

Bắt buộc. Mã nhận dạng của mục. Không được sao chép danh sách giá, mục và mã mặt hàng trong Vị trí này.

labels[]

Label

Bắt buộc. Nhãn được gắn thẻ ngôn ngữ cho mục này. Tên mặt hàng không nên dài quá 140 ký tự và nội dung mô tả không được dài quá 250 ký tự. Cần ít nhất một bộ nhãn.

price

Money

Không bắt buộc. Giá của mặt hàng.

SectionType

Loại mục.

Enum
`SECTION_TYPE_UNSPECIFIED`	Chưa chỉ định.
`FOOD`	Phần chứa các mặt hàng tượng trưng cho thực phẩm.
`SERVICES`	Phần chứa các mục đại diện cho dịch vụ.

Hồ sơ

Tất cả thông tin liên quan đến hồ sơ của vị trí.

Trường

description

string

Nội dung mô tả vị trí bằng giọng của bạn, không ai khác có thể chỉnh sửa được.

Câu hỏi

Biểu thị một câu hỏi duy nhất và một số câu trả lời cho câu hỏi đó.

Trường
`name`	`string` Chỉ có đầu ra. Tên duy nhất của câu hỏi. accounts//locations//questions/*
`author`	`Author` Chỉ có đầu ra. Người đặt câu hỏi.
`upvote_count`	`int32` Chỉ có đầu ra. Số lượt tán thành cho câu hỏi.
`text`	`string` Nội dung câu hỏi. Nội dung mô tả phải chứa ít nhất 3 từ và tổng độ dài phải lớn hơn hoặc bằng 10 ký tự. Độ dài tối đa là 4096 ký tự.
`create_time`	`Timestamp` Chỉ có đầu ra. Dấu thời gian khi câu hỏi được viết.
`update_time`	`Timestamp` Chỉ có đầu ra. Dấu thời gian cho thời điểm sửa đổi câu hỏi lần gần đây nhất.
`top_answers[]`	`Answer` Chỉ có đầu ra. Danh sách câu trả lời cho câu hỏi, được sắp xếp theo số lượt tán thành. Đây có thể không phải là danh sách đầy đủ các câu trả lời tuỳ thuộc vào các tham số của yêu cầu (answers_per_question)
`total_answer_count`	`int32` Chỉ có đầu ra. Tổng số câu trả lời được đăng cho câu hỏi này.

RepeatedEnumAttributeValue

Giá trị của một thuộc tính có value_type là RepEATED_ENUM. Danh sách này bao gồm hai danh sách mã giá trị: danh sách được đặt (true) và danh sách chưa được đặt (false). Các giá trị không có sẽ được coi là không xác định. Bạn phải chỉ định ít nhất một giá trị.

Trường

set_values[]

string

Các giá trị enum đã được đặt.

unset_values[]

string

Giá trị enum chưa được đặt.

ReportGoogleLocationRequest

Yêu cầu tin nhắn để báo cáo một GoogleLocation.

Trường
`name`	`string` Tên tài nguyên của một [GoogleLocation], ở định dạng `googleLocations/{googleLocationId}`.
`location_group_name`	`string` Không bắt buộc. Tên tài nguyên của nhóm vị trí mà vị trí này trên Google đang được báo cáo, ở định dạng `accounts/{account_id}`.
`report_reason_elaboration`	`string` Không bắt buộc. Mục nhập văn bản để giải thích lý do người dùng báo cáo vị trí này. Độ dài tối đa là 512 ký tự.
`report_reason_language_code`	`string` Không bắt buộc. Mã BCP 47 của ngôn ngữ được sử dụng trong `report_reason_elaboration`.
Trường kết hợp `report_reason`. Lý do vị trí này đang được báo cáo. Bạn phải cung cấp lý do. `report_reason` chỉ có thể là một trong những trạng thái sau đây:
`report_reason_bad_location`	`BadLocationReason` Lý do người dùng báo cáo vị trí này khi vấn đề xảy ra với chính vị trí đó.
`report_reason_bad_recommendation`	`BadRecommendationReason` Lý do người dùng báo cáo vị trí này khi có vấn đề với đề xuất. Báo cáo này sẽ hữu ích nếu vị trí đã được đề xuất cho tài khoản Trang doanh nghiệp.

BadLocationReason

Một tập hợp các lý do có thể có để báo cáo một vị trí khi có vấn đề về chất lượng dữ liệu tại chính vị trí đó.

Enum
`BAD_LOCATION_REASON_UNSPECIFIED`	Chưa chỉ định.
`NOT_A_LOCATION`	Vị trí được đề xuất không phải là vị trí thực tế.
`PERMANENTLY_CLOSED`	Vị trí được đề xuất đã bị đóng vĩnh viễn.
`DOES_NOT_EXIST`	Vị trí được đề xuất không tồn tại.
`SPAM`	Vị trí được đề xuất là spam, giả mạo hoặc xúc phạm.
`NOT_A_BUSINESS`	Vị trí được đề xuất là một địa điểm riêng tư hoặc nhà riêng.
`MOVED`	Vị trí được đề xuất đã chuyển đến một vị trí mới. Phải đi kèm với `report_reason_elaboration` chỉ định địa chỉ mới.
`DUPLICATE`	Vị trí được đề xuất trùng lặp với một vị trí khác.

BadRecommendationReason

Một số lý do có thể khiến báo cáo một vị trí khi có vấn đề về chất lượng của nội dung đề xuất (khi vị trí này được đề xuất cho người dùng).

Enum
`BAD_RECOMMENDATION_REASON_UNSPECIFIED`	Chưa chỉ định.
`NOT_A_STORE_FRONT`	Vị trí được đề xuất không phải là mặt tiền của cửa hàng.
`NOT_PART_OF_SUGGESTED_CHAIN`	Vị trí đề xuất không thuộc chuỗi được đề xuất trong `chain_display_name` ở vị trí được trả về. Phải đi kèm với `report_reason_elaboration` chỉ định tên của chuỗi chính xác.
`IRRELEVANT`	Vị trí được đề xuất không liên quan đến người dùng. Phải kèm theo `report_reason_elaboration` thể hiện lý do khiến đề xuất không liên quan.

ReportLocalPostInsightsRequest

Yêu cầu thông báo cho Insights.ReportLocalPostInsights

Trường

name

string

Bắt buộc. Tên của vị trí cần tìm nạp thông tin chi tiết.

local_post_names[]

string

Bắt buộc. Danh sách các bài đăng cần tìm nạp dữ liệu thông tin chi tiết. Tất cả bài đăng phải thuộc về vị trí có tên được chỉ định trong trường name.

basic_request

BasicMetricsRequest

Yêu cầu cung cấp thông tin chi tiết cơ bản về chỉ số trong báo cáo. Yêu cầu này áp dụng cho tất cả bài đăng được yêu cầu.

ReportLocalPostInsightsResponse

Thông báo phản hồi cho Insights.ReportLocalPostInsights

Trường

name

string

local_post_metrics[]

LocalPostMetrics

Một mục nhập cho mỗi bài đăng được yêu cầu tương ứng với vị trí này.

time_zone

string

Múi giờ (mã múi giờ IANA, ví dụ: 'Châu Âu/London') của vị trí.

ReportLocationInsightsRequest

Yêu cầu thông báo cho Insights.ReportLocationInsights.

Trường
`name`	`string` Tên tài nguyên tài khoản.
`location_names[]`	`string` Một tập hợp các vị trí để tìm nạp thông tin chi tiết (được chỉ định theo tên vị trí).
`basic_request`	`BasicMetricsRequest` Yêu cầu cung cấp thông tin chi tiết cơ bản về chỉ số trong báo cáo.
`driving_directions_request`	`DrivingDirectionMetricsRequest` Yêu cầu thêm thông tin chi tiết về các yêu cầu chỉ đường lái xe vào báo cáo.

ReportLocationInsightsResponse

Tin nhắn phản hồi cho Insights.ReportLocationInsights.

Trường

location_metrics[]

LocationMetrics

Tập hợp các giá trị của chỉ số theo vị trí.

location_driving_direction_metrics[]

Tập hợp giá trị cho các chỉ số liên quan đến hướng lái xe.

Bài đánh giá

Chỉ có đầu ra. Biểu thị bài đánh giá cho một vị trí.

Trường
`name`	`string` Tên tài nguyên. Để được xem xét, nó 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 bài đánh giá ở dạng văn bản thuần tuý có đánh dấu.
`create_time`	`Timestamp` Dấu thời gian khi bài đánh giá được viết.
`update_time`	`Timestamp` Dấu thời gian của thời điểm sửa đổi gần đây nhất của bài đánh giá.
`review_reply`	`ReviewReply` Chủ sở hữu/người quản lý trả lời của vị trí này cho bài đánh giá này.

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 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à giá trị false.

is_anonymous

bool

Cho biết liệu người đánh giá có chọn tiếp tục ẩn danh hay không.

StarRating

Điểm xếp hạng theo sao trên 5 sao, trong đó 5 sao là điểm xếp hạng cao nhất.

Enum
`STAR_RATING_UNSPECIFIED`	Chưa chỉ định.
`ONE`	1 trên 5 sao.
`TWO`	Tối đa 2 sao trong tổng số 5 sao.
`THREE`	Tối đa 3 sao trong tổng số 5 sao.
`FOUR`	Tối đa 4 sao trong tổng số 5 sao.
`FIVE`	Điểm xếp hạng theo sao tối đa.

ReviewReply

Thể hiện nội dung trả lời của chủ sở hữu/người quản lý vị trí cho 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ó đánh dấu. Độ dài tối đa là 4096 byte.

update_time

Chỉ có đầu ra. Dấu thời gian sửa đổi lần gần đây nhất câu trả lời.

SearchChainsRequest

Thông báo yêu cầu đối với locations.SearchChains.

Trường

chain_display_name

string

Tìm một chuỗi theo tên. Các truy vấn chính xác/một phần/mờ/có liên quan được hỗ trợ. Ví dụ: "walmart", "wal-mart", "walmmmart", "沃尔玛"

result_count

int32

Số lượng chuỗi phù hợp tối đa cần trả về từ truy vấn này. Giá trị mặc định là 10. Giá trị tối đa có thể là 500.

SearchChainsResponse

Thông báo phản hồi cho Places.SearchChains.

Trường

chains[]

Chain

Các chuỗi khớp với string_display_name được truy vấn trong SearchChainsRequest. Nếu không có kết quả nào phù hợp, trường này sẽ trống. Các kết quả được liệt kê theo mức độ liên quan.

SearchGoogleLocationsRequest

Yêu cầu thông báo cho GoogleLocations.SearchGoogleLocations.

Trường
`result_count`	`int32` Số lượng kết quả phù hợp cần trả về. Giá trị mặc định là 3, tối đa là 10. Xin lưu ý rằng độ trễ có thể tăng lên nếu bạn yêu cầu thêm. Không có tính năng phân trang.
Trường kết hợp `search_query`. Cụm từ tìm kiếm. Giá trị này có thể được cung cấp dưới dạng đối tượng vị trí hoặc dưới dạng truy vấn chuỗi. `search_query` chỉ có thể là một trong những trạng thái sau đây:
`location`	`Location` Vị trí để tìm kiếm. Nếu được cung cấp, hệ thống sẽ tìm những vị trí khớp với thông tin vị trí mà bạn cung cấp.
`query`	`string` Cụm từ tìm kiếm bằng văn bản cần tìm. Kết quả tìm kiếm từ một chuỗi truy vấn sẽ kém chính xác hơn so với khi cung cấp vị trí chính xác, nhưng có thể cung cấp nhiều kết quả khớp không chính xác hơn.

SearchGoogleLocationsResponse

Thông báo phản hồi cho GoogleLocations.SearchGoogleLocations.

Trường

google_locations[]

GoogleLocation

Tập hợp các vị trí trên Google có khả năng phù hợp với yêu cầu đã chỉ định, được liệt kê theo thứ tự từ nhiều nhất đến ít nhất.

ServiceAreaBusiness

Doanh nghiệp hoạt động trong khu vực kinh doanh cung cấp dịch vụ tại địa điểm của khách hàng (ví dụ: thợ khoá hoặc thợ sửa ống nước).

Trường
`business_type`	`BusinessType` Cho biết `type` của doanh nghiệp cung cấp dịch vụ tại cơ sở khách hàng.
Trường kết hợp `coverageArea`. Cho biết khu vực phủ sóng nơi doanh nghiệp cung cấp dịch vụ. `coverageArea` chỉ có thể là một trong những trạng thái sau đây:
`radius`	`PointRadius` Chỉ có đầu ra. Khu vực mà doanh nghiệp này phục vụ tập trung quanh một điểm.
`places`	`Places` Khu vực mà doanh nghiệp này phục vụ, được xác định thông qua một nhóm địa điểm.

BusinessType

Cho biết doanh nghiệp này chỉ cung cấp dịch vụ tại chỗ tại vị trí của khách hàng (ví dụ: xe kéo) hay tại cả địa chỉ và tại chỗ (ví dụ: cửa hàng pizza có khu vực ăn uống và đồng thời giao hàng cho khách hàng).

Enum
`BUSINESS_TYPE_UNSPECIFIED`	Chỉ có đầu ra. Chưa chỉ định.
`CUSTOMER_LOCATION_ONLY`	Chỉ cung cấp dịch vụ trong khu vực xung quanh (không phải tại địa chỉ doanh nghiệp).
`CUSTOMER_AND_BUSINESS_LOCATION`	Cung cấp dịch vụ tại địa chỉ doanh nghiệp và khu vực xung quanh.

ServiceBusinessContext

Dữ liệu bổ sung để xác minh doanh nghiệp cung cấp dịch vụ.

Trường

address

PostalAddress

Địa chỉ xác minh của vị trí. Địa chỉ này được dùng để bật thêm các tùy chọn xác minh khác hoặc gửi bưu thiếp.

ServiceList

Danh sách dịch vụ chứa một hoặc nhiều mục dịch vụ.

Trường

name

string

Bắt buộc. Giá trị nhận dạng của Google cho vị trí này trong biểu mẫu: accounts/{account_id}/locations/{location_id}/serviceList

service_items[]

ServiceItem

Các mục dịch vụ có trong danh sách dịch vụ này. Các mục dịch vụ trùng lặp sẽ tự động bị xoá.

ServiceItem

Thông báo mô tả một hạng mục dịch vụ. Thuộc tính này dùng để mô tả loại dịch vụ mà người bán cung cấp. Ví dụ: cắt tóc có thể là một dịch vụ.

Trường
`is_offered`	`bool` Không bắt buộc. Trường này quyết định liệu người bán có cung cấp dịch vụ nhập liệu hay không.
`price`	`Money` Không bắt buộc. Đại diện cho giá tiền của mục dịch vụ. Bạn nên đặt Currency_code và đơn vị khi thêm giá.
Trường kết hợp `service_item_info`. Bạn phải luôn đặt một trong các trường sau đây. `service_item_info` chỉ có thể là một trong những trạng thái sau đây:
`structured_service_item`	`StructuredServiceItem` Trường này sẽ là trường hợp của dữ liệu dịch vụ có cấu trúc.
`free_form_service_item`	`FreeFormServiceItem` Trường này sẽ được đặt thành trường hợp dữ liệu dịch vụ dạng tự do.

FreeFormServiceItem

Đại diện cho dịch vụ biểu mẫu tuỳ ý do người bán cung cấp. Đây là những dịch vụ không được cung cấp trong dữ liệu dịch vụ về cấu trúc của chúng tôi. Người bán tự nhập tên cho các dịch vụ đó thông qua nền tảng của người bán theo địa lý.

Trường

category_id

string

Bắt buộc. category_id và service_type_id phải khớp với các tổ hợp có thể có được cung cấp trong thông báo Category.

label

Label

Bắt buộc. Nhãn được gắn thẻ ngôn ngữ cho mục này. Tên mặt hàng không nên dài quá 140 ký tự và nội dung mô tả không được dài quá 250 ký tự. Bạn chỉ nên đặt trường này nếu dữ liệu đầu vào là một mục dịch vụ tuỳ chỉnh. Bạn phải cập nhật các loại dịch vụ được chuẩn hoá thông qua service_type_id.

StructuredServiceItem

Đại diện cho một dịch vụ có cấu trúc do người bán cung cấp. Ví dụ: chế độ cài đặt nhà vệ sinh.

Trường

service_type_id

string

Bắt buộc. Trường service_type_id là một mã nhận dạng duy nhất do Google cung cấp có trong ServiceTypeMetadata. Thông tin này do dịch vụ rpc BatchGetBusinessCategory cung cấp.

description

string

Không bắt buộc. Nội dung mô tả mục dịch vụ có cấu trúc. Giới hạn là 300 ký tự.

ServiceType

Thông báo mô tả loại dịch vụ mà doanh nghiệp cung cấp.

Trường

service_type_id

string

Chỉ có đầu ra. Mã ổn định (do Google cung cấp) cho loại dịch vụ này.

display_name

string

Chỉ có đầu ra. Tên hiển thị mà con người có thể đọc được cho loại dịch vụ.

SpecialHourPeriod

Biểu thị một khoảng thời gian khi giờ hoạt động của một vị trí khác với giờ làm việc thông thường của vị trí đó. Khoảng giờ đặc biệt phải đại diện cho phạm vi ít hơn 24 giờ. open_time và start_date phải trước close_time và end_date. close_time và end_date có thể kéo dài đến 11:59 sáng vào ngày sau start_date được chỉ định. Ví dụ: các giá trị nhập sau đây là hợp lệ:

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

Các giá trị nhập sau đây không hợp lệ:

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

Trường
`start_date`	`Date` Ngày theo lịch cho khoảng thời gian đặc biệt này.
`open_time`	`string` Thời gian hiển thị trên `start_date` khi một vị trí mở cửa, được biểu thị ở định dạng mở rộng 24 giờ ISO 8601. (hh:mm) Giá trị hợp lệ là 00:00-24:00, trong đó 24:00 thể hiện nửa đêm ở cuối trường ngày được chỉ định. Bạn phải chỉ định giá trị này nếu `is_closed` là false.
`end_date`	`Date` Ngày theo lịch để khoảng thời gian đặc biệt này kết thúc. Nếu bạn không đặt trường `end_date`, giá trị mặc định sẽ là ngày được chỉ định trong `start_date`. Nếu được đặt, trường này phải bằng hoặc tối đa là 1 ngày sau `start_date`.
`close_time`	`string` Thời gian thực tế trên `end_date` khi một vị trí đóng cửa, được biểu thị ở định dạng mở rộng 24 giờ theo chuẩn ISO 8601. (hh:mm) Giá trị hợp lệ là 00:00-24:00, trong đó 24:00 thể hiện nửa đêm ở cuối trường ngày được chỉ định. Bạn phải chỉ định giá trị này nếu `is_closed` là false.
`is_closed`	`bool` Nếu giá trị là true, thì `end_date`, `open_time` và `close_time` sẽ bị bỏ qua và ngày được chỉ định trong `start_date` được coi là vị trí đóng cửa cả ngày.

SpecialHours

Đại diện cho một tập hợp khoảng thời gian khi giờ hoạt động của một vị trí khác với giờ làm việc thông thường của vị trí đó.

Trường

special_hour_periods[]

SpecialHourPeriod

Danh sách các trường hợp ngoại lệ đối với giờ làm việc thông thường của doanh nghiệp.

Độ nhạy

Độ cay của một mặt hàng thực phẩm.

Enum
`SPICINESS_UNSPECIFIED`	Chưa xác định cấp độ
`MILD`	Nghĩa là vị cay nhẹ.
`MEDIUM`	Nghĩa là có độ cay vừa phải.
`HOT`	Tức là món cay nóng. Mức độ sôi nổi nhất.

StartUploadMediaItemDataRequest

Thông báo yêu cầu đối với Media.StartUploadMediaItemData.

Trường

parent

string

Tên tài nguyên của vị trí mà mục nội dung đa phương tiện này sẽ được thêm vào.

TimeInterval

Một khoảng thời gian, bao gồm cả hai giá trị này. Mã này phải chứa tất cả các trường thì mới hợp lệ.

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.

TimePeriod

Thể hiện khoảng thời gian mà doanh nghiệp mở cửa, bắt đầu vào ngày/giờ mở cửa được chỉ định và đóng cửa vào ngày/giờ đóng cửa được chỉ định. Thời gian đóng cửa phải sau thời gian mở cửa, ví dụ như muộn hơn trong cùng một ngày hoặc vào ngày tiếp theo.

Trường
`open_day`	`DayOfWeek` Cho biết thời gian `day of the week` bắt đầu của khoảng thời gian này.
`open_time`	`string` Thời gian ở định dạng mở rộng ISO 8601 là 24 giờ (hh:mm). Giá trị hợp lệ là 00:00-24:00, trong đó 24:00 thể hiện nửa đêm ở cuối trường ngày được chỉ định.
`close_day`	`DayOfWeek` Cho biết thời gian này sẽ kết thúc vào `day of the week`.
`close_time`	`string` Thời gian ở định dạng mở rộng ISO 8601 là 24 giờ (hh:mm). Giá trị hợp lệ là 00:00-24:00, trong đó 24:00 thể hiện nửa đêm ở cuối trường ngày được chỉ định.

TimeRange

Một khoảng thời gian. Dữ liệu sẽ được lấy trong dải ô đó dưới dạng nghịch đảo mở một nửa (tức là [start_time, end_time)).

Trường

start_time

Dấu thời gian bắt đầu của phạm vi ngày bắt đầu (bao gồm cả ngày này).

end_time

Dấu thời gian bắt đầu của hệ thống khi kết thúc phạm vi ngày (không bao gồm).

TransferLocationRequest

Thông báo yêu cầu đối với Places.TransferLocation.

Trường

name

string

Tên của vị trí cần chuyển.

to_account

string

Tên của tài nguyên tài khoản để chuyển vị trí sang (ví dụ: "accounts/8675309").

UpdateAccountAdminRequest

Thông báo yêu cầu cho AccessControl.UpdateAccountAdmin.

Trường

name

string

Tên tài nguyên của quản trị viên cần cập nhật.

admin

Quản trị viên đã cập nhật. Lưu ý: Trường duy nhất có thể chỉnh sửa là role. Tất cả những trường khác sẽ bị bỏ qua.

UpdateAccountRequest

Yêu cầu thông báo cho accounts.UpdateAccount.

Trường

name

string

Tên của tài khoản cần cập nhật.

account

Account

Thông tin tài khoản được cập nhật. Lưu ý: Trường duy nhất có thể chỉnh sửa là account_name.

validate_only

bool

Nếu đúng, yêu cầu sẽ được xác thực mà không thực sự cập nhật tài khoản.

UpdateFoodMenusRequest

Thông báo yêu cầu đối với FoodMenu.UpdateFoodMenus

Trường

food_menus

FoodMenus

Bắt buộc. Thông tin cập nhật về thực đơn. Bạn có thể huỷ thiết lập thực đơn bằng cách cập nhật mà không chọn bất kỳ mục nào trong thực đơn.

update_mask

HealthProviderAttributes

Không bắt buộc. Các trường cụ thể cần cập nhật. Nếu bạn không chỉ định mặt nạ, 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 đặt thành các giá trị được truyền vào, có thể bao gồm việc huỷ thiết lập các trường trống trong yêu cầu. Không thể cập nhật riêng từng mục trong trường lặp lại. Lưu ý: "name" của FoodMenus là giá trị nhận dạng tài nguyên không thể cập nhật.

UpdateHealthProviderAttributesRequest

Yêu cầu thông báo về HealthProviderAttributes.UpdateHealthProviderAttributes

Trường

health_provider_attributes

Bắt buộc. Các thuộc tính nhà cung cấp dịch vụ y tế được cập nhật.

update_mask

Không bắt buộc. Các trường cụ thể cần cập nhật. Nếu bạn không chỉ định mặt nạ, 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 đặt thành các giá trị được truyền vào, có thể bao gồm việc huỷ thiết lập các trường trống trong yêu cầu. Trong phiên bản 1, chỉ có trường security_networks để cập nhật. Các thuộc tính khác sẽ được hỗ trợ sau.

UpdateLocalPostRequest

Yêu cầu tin nhắn cho UpdateLocalPost.

Trường

name

string

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

local_post

LocalPost

Thông tin cập 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ạ.

UpdateLocationAdminRequest

Yêu cầu thông báo cho AccessControl.UpdateLocationAdmin.

Trường

name

string

Tên tài nguyên của quản trị viên cần cập nhật.

admin

Quản trị viên đã cập nhật. Lưu ý: Trường duy nhất có thể chỉnh sửa là role. Tất cả những trường khác sẽ bị bỏ qua.

UpdateLocationRequest

Yêu cầu thông báo cho Places.UpdateLocation.

Trường
`name`	`string` Tên của vị trí cần cập nhật.
`location`	`Location` Thông tin vị trí được cập nhật.
`update_mask`	`FieldMask` Các trường cụ thể cần cập nhật. Nếu bạn không chỉ định mặt nạ, 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 đặt thành các giá trị được truyền vào, có thể bao gồm việc huỷ thiết lập các trường trống trong yêu cầu.
`validate_only`	`bool` Nếu đúng, yêu cầu sẽ được xác thực mà không thực sự cập nhật vị trí.
`attribute_mask`	`FieldMask` Mã nhận dạng của các thuộc tính cần cập nhật. Chỉ các thuộc tính được ghi chú trong mặt nạ mới được cập nhật. Nếu một thuộc tính có trong mặt nạ nhưng không có ở vị trí, thì thuộc tính đó sẽ bị xoá. Mặt nạ trống sẽ cập nhật tất cả các thuộc tính. Bất cứ khi nào trường này được đặt, update_mask phải bao gồm các thuộc tính làm một trong các trường cần cập nhật.

UpdateMediaItemRequest

Yêu cầu thông báo cho Media.UpdateMediaItem.

Trường

name

string

Tên của mục nội dung đa phương tiệ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 danh sách giá.

update_mask

Các trường cụ thể cần cập nhật. Nếu bạn không chỉ định mặt nạ, 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.

UpdateNotificationsRequest

Yêu cầu thông báo cho accounts.UpdateNotifications.

Trường

name

string

Tên tài nguyên cho chế độ cài đặt thông báo.

notifications

Notifications

Chế độ cài đặt thông báo đã cập nhật.

UpdateQuestionRequest

Yêu cầu tin nhắn cho questionsAndAnswers.UpdateQuestion

Trường

name

string

Tên của câu hỏi cần cập nhật.

question

Question

Câu hỏi được cập nhật.

UpdateReviewReplyRequest

Yêu cầu gửi tin nhắn cho Reviews.UpdateReviewReview.

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ó câu trả lời, thì câu trả lời này sẽ thay thế câu trả lời cũ.

UpdateServiceListRequest

Cập nhật thông báo yêu cầu danh sách dịch vụ.

Trường

service_list

ServiceList

Không bắt buộc. Thông tin về danh sách dịch vụ được cập nhật. Nếu để trống trường này, API sẽ xoá ServiceList. Nếu ServiceList được đặt, API sẽ thay thế ServiceList ban đầu bằng ServiceList đã đặt.

update_mask