Package google.mybusiness.businessinformation.v1

Các danh mục khớp với mã nhận dạng GConcept được cung cấp trong yêu cầu. Các mã này sẽ không được sắp xếp theo cùng thứ tự như mã danh mục trong yêu cầu.

BusinessHours

Thể hiện khoảng thời gian mà địa điểm này mở cửa kinh doanh. Lưu trữ một bộ sưu tập các phiên bản [TimePeriod][google.mybusiness.mybusinessinfo.v1.TimePeriod].

Các trường

Các trường
`periods[]`	`TimePeriod` Bắt buộc. Tập hợp thời gian mà vị trí này mở cửa kinh doanh. Mỗi khoảng thời gian đại diện cho một phạm vi giờ khi vị trí mở cửa trong tuần.

periods[]

TimePeriod

Bắt buộc. Tập hợp thời gian mà vị trí này mở cửa kinh doanh. Mỗi khoảng thời gian đại diện cho một phạm vi giờ khi vị trí mở cửa trong tuần.

Danh mục

Một tập hợp các danh mục mô tả doanh nghiệp. Trong quá trình cập nhật, bạn phải đặt cả hai trường. Khách hàng không được phép cập nhật từng danh mục chính hoặc danh mục bổ sung bằng cách sử dụng mặt nạ cập nhật.

Các trường

Các trường
`primary_category`	`Category` Bắt buộc. Danh mục mô tả chính xác nhất hoạt động kinh doanh cốt lõi mà địa điểm này tham gia.
`additional_categories[]`	`Category` Không bắt buộ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 nhớ sử dụng càng ít danh mục càng tốt để mô tả tổng thể hoạt động kinh doanh cốt lõi của bạn. Chọn danh mục càng cụ thể càng tốt, nhưng đại diện cho công việc kinh doanh chính của bạn.

primary_category

Bắt buộc. Danh mục mô tả chính xác nhất hoạt động kinh doanh cốt lõi mà địa điểm này tham gia.

additional_categories[]

Không bắt buộ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 nhớ sử dụng càng ít danh mục càng tốt để mô tả tổng thể hoạt động kinh doanh cốt lõi của bạn. Chọn danh mục càng cụ thể càng tốt, nhưng đại diện cho công việc kinh doanh chính của bạn.

Danh mục

Danh mục mô tả doanh nghiệp này là gì (không phải là ngành nghề). Để biết danh sách mã danh mục hợp lệ và ánh xạ tới tên mà con người có thể đọc được, hãy xem categories.list.

Các trường
`name`	`string` Bắt buộc. Mã nhận dạng ổn định (do Google cung cấp) cho danh mục này. Bạn phải chỉ định giá trị khi sửa đổi danh mục (khi tạo hoặc cập nhật vị trí).
`display_name`	`string` Chỉ có đầu ra. Tên danh mục mà con người có thể đọc được. Giá trị này được đặt khi đọc thông tin vị trí. Khi sửa đổi vị trí, bạn phải đặt `category_id`.
`service_types[]`	`ServiceType` Chỉ có đầu ra. Danh sách tất cả các loại dịch vụ có sẵn cho danh mục doanh nghiệp này.
`more_hours_types[]`	`MoreHoursType` Chỉ có đầu ra. Các loại giờ khác có sẵn cho danh mục kinh doanh này.

CategoryView

Một giá trị enum giúp giới hạn lượng dữ liệu được máy chủ trả về.

Enum
`CATEGORY_VIEW_UNSPECIFIED`	Chưa được chỉ định, tương đương với PARTNER_SIDATA_ONLY.
`BASIC`	Phản hồi của máy chủ sẽ chỉ bao gồm các trường Danh mục display_name, category_id và language_code. Thao tác này bỏ qua mọi trường liên quan đến siêu dữ liệu của loại dịch vụ.
`FULL`	Trả về tất cả các trường trong phản hồi.

Chuỗi

Chuỗi cửa hàng là một thương hiệu mà các địa điểm của doanh nghiệp của bạn có thể liên kết.

Các trường
`name`	`string` Bắt buộc. Tên tài nguyên của chuỗi, ở định dạng `chains/{chain_id}`.
`chain_names[]`	`ChainName` Tên của chuỗi.
`websites[]`	`ChainUri` Các trang web của chuỗi cửa hàng.
`location_count`	`int32` Số lượng địa điểm thuộc chuỗi này.

ChainName

Tên sẽ được sử dụng khi hiển thị chuỗi.

Các trường

Các trường
`display_name`	`string` Tên hiển thị của chuỗi này.
`language_code`	`string` Mã ngôn ngữ BCP 47 của tên.

display_name

string

Tên hiển thị của chuỗi này.

language_code

string

Mã ngôn ngữ BCP 47 của tên.

ChainUri

URL sẽ được dùng khi hiển thị chuỗi.

Các trường

Các trường
`uri`	`string` URI cho chuỗi này.

uri

string

URI cho chuỗi này.

CreateLocationRequest

Thông báo yêu cầu cho Places.CreateLocation.

Các trường
`parent`	`string` Bắt buộc. Tên của tài khoản mà bạn dùng để tạo vị trí này.
`location`	`Location` Bắt buộc. Siêu dữ liệu vị trí mới.
`validate_only`	`bool` Không bắt buộc. Nếu đúng, yêu cầu sẽ được xác thực nhưng không thực sự tạo vị trí.
`request_id`	`string` Không bắt buộc. Một mã yêu cầu duy nhất cho máy chủ để phát hiện các yêu cầu trùng lặp. Bạn nên dùng mã nhận dạng duy nhất (UUID). Độ dài tối đa là 50 ký tự.

DeleteLocationRequest

Thông báo yêu cầu cho Places.DeleteLocation.

Các trường

Các trường
`name`	`string` Bắt buộc. Tên của vị trí cần xoá.

name

string

Bắt buộc. Tên của vị trí cần xoá.

ErrorCode

Tất cả các mã lỗi mà API trả về.

Enum
`ERROR_CODE_UNSPECIFIED`	Thiếu mã lỗi.
`INVALID_ATTRIBUTE_NAME`	Không thể áp dụng một trong các thuộc tính đã cung cấp cho vị trí này. Chỉ các thuộc tính được trả về trong phản hồi `ListAttributeMetadata` mới có thể được áp dụng cho vị trí này. Tất cả các tên thuộc tính có vấn đề sẽ được trả về trong khoá `attribute_names` trong siêu dữ liệu.
`ASSOCIATE_OPERATION_ON_VERIFIED_LOCATION`	Lỗi này được trả về khi ứng dụng khách cố gắng liên kết một vị trí hoặc xoá mối liên kết vị trí trên một vị trí đang ở trạng thái đã xác minh.
`ASSOCIATE_LOCATION_INVALID_PLACE_ID`	`place_id` được cung cấp trong yêu cầu `associateLocation` không phù hợp với vị trí hoặc không hợp lệ. Đảm bảo rằng `place_id` đang được đặt khớp với một trong các mã nhận dạng được trả về trong phản hồi `SearchGoogleLocations`.
`LAT_LNG_UPDATES_NOT_PERMITTED`	Dự án này không được phép cập nhật trường vĩ độ/lng trên Vị trí. Bạn có thể cập nhật vĩ độ/lng bằng chức năng thả ghim trong giao diện người dùng hoặc cung cấp cho chúng tôi địa chỉ.
`PO_BOX_IN_ADDRESS_NOT_ALLOWED`	Không thể sử dụng hộp thư bưu điện trong địa chỉ. Các khoá siêu dữ liệu bao gồm "field_mask".
`BLOCKED_REGION`	Do bắt buộc phải tuân thủ các lệnh trừng phạt quốc tế, chúng tôi không thể chấp nhận các doanh nghiệp từ khu vực này. Khoá siêu dữ liệu bao gồm "field_maks".
`MISSING_BOTH_PHONE_AND_WEBSITE`	Số điện thoại hoặc trang web là bắt buộc đối với các doanh nghiệp CUSTOMER_LOCATION_ONLY. Các khoá siêu dữ liệu bao gồm "field_mask".
`MISSING_STOREFRONT_ADDRESS_OR_SAB`	Tất cả Địa điểm đều phải có ít nhất một địa chỉ cửa hàng hoặc khu vực kinh doanh. Các khoá siêu dữ liệu bao gồm "field_mask".
`LAT_LNG_TOO_FAR_FROM_ADDRESS`	Cặp vĩ độ/kinh độ và địa chỉ quá xa nhau. Các khoá siêu dữ liệu bao gồm "field_mask".
`LAT_LNG_REQUIRED`	KHÔNG DÙNG NỮA. Được thay thế bằng PIN_DROP_REQUIRED. Không thể định vị địa chỉ đã chỉ định. Vui lòng cung cấp vĩ độ/kinh độ. Các khoá siêu dữ liệu bao gồm "field_mask".
`INVALID_CHARACTERS`	Tìm thấy các ký tự không hợp lệ. Khoá siêu dữ liệu bao gồm "field_mask" và "invalid_characters".
`FORBIDDEN_WORDS`	Đã phát hiện các từ bị cấm. Các khóa siêu dữ liệu bao gồm "field_mask" và "forbidden_words".
`INVALID_INTERCHANGE_CHARACTERS`	Tìm thấy các ký tự không hợp lệ. Các khoá siêu dữ liệu bao gồm "field_mask".
`FIELDS_REQUIRED_FOR_CATEGORY`	Các trường bổ sung là bắt buộc cho danh mục vị trí này. Các khóa siêu dữ liệu bao gồm "field_mask", "value" và "fields_required".
`STOREFRONT_REQUIRED_FOR_CATEGORY`	Danh mục kinh doanh của bạn phải có địa điểm mặt tiền cửa hàng để khách hàng có thể ghé thăm. Các khoá siêu dữ liệu bao gồm "field_mask".
`ADDRESS_MISSING_REGION_CODE`	Địa chỉ thiếu mã vùng bắt buộc. Các khoá siêu dữ liệu bao gồm "field_mask".
`ADDRESS_EDIT_CHANGES_COUNTRY`	Không thể chuyển địa chỉ sang quốc gia khác. Các khoá siêu dữ liệu bao gồm "field_mask".
`SPECIAL_HOURS_SET_WITHOUT_REGULAR_HOURS`	Bạn chỉ có thể chỉ định giờ đặc biệt nếu địa điểm có giờ làm việc thông thường. Siêu dữ liệu trống.
`INVALID_TIME_SCHEDULE`	Lịch biểu thời gian không hợp lệ, thời gian bị trùng lặp hoặc thời gian kết thúc sớm hơn thời gian bắt đầu. Các khoá siêu dữ liệu bao gồm "field_mask".
`INVALID_HOURS_VALUE`	Định dạng hoặc giá trị giờ không hợp lệ. Các khoá siêu dữ liệu bao gồm "field_mask".
`OVERLAPPED_SPECIAL_HOURS`	Giờ đặc biệt không được chồng chéo. Các khoá siêu dữ liệu bao gồm "field_mask".
`INCOMPATIBLE_MORE_HOURS_TYPE_FOR_CATEGORY`	Danh mục kinh doanh chính của doanh nghiệp không hỗ trợ loại giờ này. Các khoá siêu dữ liệu bao gồm "field_mask" và "incompatible_hours_type".
`DUPLICATE_CHILDREN_LOCATIONS`	Trùng lặp [child_locations] trong dữ liệu quan hệ. Các khoá siêu dữ liệu bao gồm "field_mask".
`INCOMPATIBLE_SERVICE_AREA_AND_CATEGORY`	Doanh nghiệp cung cấp dịch vụ tại cơ sở khách hàng không được có danh mục chính đã chọn. Các khoá siêu dữ liệu bao gồm "field_mask".
`INVALID_SERVICE_AREA_PLACE_ID`	place_id trong service_area không hợp lệ. Khoá siêu dữ liệu bao gồm "field_mask" và "place_id".
`INVALID_AREA_TYPE_FOR_SERVICE_AREA`	Loại khu vực cho service_area không hợp lệ. Khoá siêu dữ liệu bao gồm "field_mask" và "place_id".
`OPENING_DATE_TOO_FAR_IN_THE_FUTURE`	Nhập ngày khai trương cách thời điểm hiện tại không quá một năm. Các khoá siêu dữ liệu bao gồm "field_mask".
`OPENING_DATE_MISSING_YEAR_OR_MONTH`	Ngày khai trương phải là một năm hoặc một tháng được chỉ định. Các khoá siêu dữ liệu bao gồm "field_mask".
`OPENING_DATE_BEFORE_1AD`	Ngày khai trương không được trước năm 1 sau Công nguyên. Các khoá siêu dữ liệu bao gồm "field_mask".
`TOO_MANY_ENTRIES`	Quá nhiều mục nhập cho trường này. Các khóa siêu dữ liệu bao gồm "field_mask" và "max_count".
`INVALID_PHONE_NUMBER`	Không nhận dạng được mục nhập số điện thoại. Các khóa siêu dữ liệu bao gồm "field_mask" và "value".
`INVALID_PHONE_NUMBER_FOR_REGION`	Số điện thoại không hợp lệ cho vùng. Các khóa siêu dữ liệu bao gồm "field_mask" và "value".
`MISSING_PRIMARY_PHONE_NUMBER`	Thiếu số điện thoại chính. Các khoá siêu dữ liệu bao gồm "field_mask".
`THROTTLED`	Hiện không thể cập nhật trường này. Các khóa siêu dữ liệu bao gồm "field_mask" và "value".
`UNSUPPORTED_POINT_RADIUS_SERVICE_AREA`	Chúng tôi không còn hỗ trợ khu vực kinh doanh theo bán kính điểm nữa. Các khoá siêu dữ liệu bao gồm "field_mask".
`INVALID_CATEGORY`	Id danh mục không hợp lệ. Các khóa siêu dữ liệu bao gồm "field_mask" và "value".
`CANNOT_REOPEN`	Doanh nghiệp không thể mở cửa lại. Các khoá siêu dữ liệu bao gồm "field_mask".
`INVALID_BUSINESS_OPENING_DATE`	Ngày khai trương của doanh nghiệp không hợp lệ. Các khoá siêu dữ liệu bao gồm "field_mask".
`INVALID_LATLNG`	URL chính sách không hợp lệ Các khoá siêu dữ liệu bao gồm "field_mask".
`PROFILE_DESCRIPTION_CONTAINS_URL`	Nội dung mô tả doanh nghiệp không được chứa URL. Các khoá siêu dữ liệu bao gồm "field_mask".
`LODGING_CANNOT_EDIT_PROFILE_DESCRIPTION`	Bạn không thể chỉnh sửa nội dung mô tả hồ sơ của vị trí cơ sở lưu trú. Các khoá siêu dữ liệu bao gồm "field_mask".
`INVALID_URL`	Liên kết không hợp lệ. Các khoá siêu dữ liệu bao gồm "field_mask".
`INVALID_ADDRESS`	Địa chỉ không hợp lệ. Các khoá siêu dữ liệu bao gồm "field_mask".
`PARENT_CHAIN_CANNOT_BE_THE_LOCATION_ITSELF`	ParentChain không được là chính vị trí đó. Các khóa siêu dữ liệu bao gồm "field_mask" và "value".
`RELATION_CANNOT_BE_THE_LOCATION_ITSELF`	Mối quan hệ không thể là chính vị trí đó. Các khóa siêu dữ liệu bao gồm "field_mask" và "value".
`MISSING_ADDRESS_COMPONENTS`	Thiếu giá trị cho thành phần địa chỉ. Các khoá siêu dữ liệu bao gồm "field_mask".
`READ_ONLY_ADDRESS_COMPONENTS`	Không thể chỉnh sửa các thành phần địa chỉ chỉ đọc. Các khoá siêu dữ liệu bao gồm "field_mask".
`STRING_TOO_LONG`	Chuỗi này quá dài. Các khóa siêu dữ liệu bao gồm "field_mask" và "max_length".
`STRING_TOO_SHORT`	Chuỗi quá ngắn. Các khóa siêu dữ liệu bao gồm "field_mask" và "min_length".
`REQUIRED_FIELD_MISSING_VALUE`	Thiếu giá trị cho trường bắt buộc. Các khoá siêu dữ liệu bao gồm "field_mask".
`ATTRIBUTE_PROVIDER_URL_NOT_ALLOWED`	Không thể thêm hoặc chỉnh sửa URL của nhà cung cấp. Khoá siêu dữ liệu bao gồm "attribute_name".
`ATTRIBUTE_INVALID_ENUM_VALUE`	Thuộc tính enum có giá trị không xác định. Khoá siêu dữ liệu bao gồm "attribute_name".
`ATTRIBUTE_NOT_AVAILABLE`	Thuộc tính có thể mở rộng không hợp lệ cho vị trí này. Khoá siêu dữ liệu bao gồm ""attribute_name".
`ATTRIBUTE_CANNOT_BE_REPEATED`	Bạn chỉ được chỉ định thuộc tính có thể mở rộng một lần. Khoá siêu dữ liệu bao gồm "attribute_name".
`ATTRIBUTE_TYPE_NOT_COMPATIBLE_FOR_CATEGORY`	Thuộc tính có thể mở rộng không tương thích với các danh mục được đặt trên vị trí. Khoá siêu dữ liệu bao gồm "attribute_name".
`ADDRESS_REMOVAL_NOT_ALLOWED`	Không được phép xóa địa chỉ cho doanh nghiệp của bạn. Các khoá siêu dữ liệu bao gồm "field_mask".
`AMBIGUOUS_TITLE`	Tên phù hợp nhất cho một ngôn ngữ không rõ ràng. Các khoá siêu dữ liệu bao gồm "field_mask".
`INVALID_CATEGORY_FOR_SAB`	Một SAB tinh khiết không được chứa các gcid thuộc loại phụ của gcid:thập lập_poi. Các khóa siêu dữ liệu bao gồm "field_mask" và "value".
`RELATION_ENDPOINTS_TOO_FAR`	Các điểm cuối quan hệ ở quá xa nhau. Các khóa siêu dữ liệu bao gồm "field_mask" và "value".
`INVALID_SERVICE_ITEM`	Cả hai cấu trúc_service_item và free_form_service_item đều không được đặt. Các khoá siêu dữ liệu bao gồm "field_mask".
`SERVICE_ITEM_LABEL_NO_DISPLAY_NAME`	Nhãn thiếu tên hiển thị. Các khoá siêu dữ liệu bao gồm "field_mask".
`SERVICE_ITEM_LABEL_DUPLICATE_DISPLAY_NAME`	Tên hiển thị không phải là tên riêng biệt cho tất cả các nhãn trên tất cả các danh sách giá. Các khoá siêu dữ liệu bao gồm "field_mask".
`SERVICE_ITEM_LABEL_INVALID_UTF8`	Nhãn chứa các ký hiệu UTF-8 không hợp lệ. Các khoá siêu dữ liệu bao gồm "field_mask".
`FREE_FORM_SERVICE_ITEM_WITH_NO_CATEGORY_ID`	Thiếu trườngcategory_id trong free_form_service_item. Các khoá siêu dữ liệu bao gồm "field_mask".
`FREE_FORM_SERVICE_ITEM_WITH_NO_LABEL`	Thiếu nhãn trong free_form_service_item. Các khoá siêu dữ liệu bao gồm "field_mask".
`SERVICE_ITEM_WITH_NO_SERVICE_TYPE_ID`	Thiếu trường service_type_id trong cấu trúc_service_item. Các khoá siêu dữ liệu bao gồm "field_mask".
`INVALID_LANGUAGE`	Mã ngôn ngữ không hợp lệ. Các khoá siêu dữ liệu bao gồm "field_mask".
`PRICE_CURRENCY_MISSING`	Thiếu mã đơn vị tiền tệ ISO 4217. Các khoá siêu dữ liệu bao gồm "field_mask".
`PRICE_CURRENCY_INVALID`	Mã đơn vị tiền tệ mà bạn cung cấp không hợp lệ theo tiêu chuẩn ISO 4217. Các khoá siêu dữ liệu bao gồm "field_mask".
`SERVICE_TYPE_ID_DUPLICATE`	Mã loại dịch vụ không phải là duy nhất trong Vị trí. Các khoá siêu dữ liệu bao gồm "field_mask".
`PIN_DROP_REQUIRED`	Không thể định vị địa chỉ đã chỉ định. Vui lòng sử dụng giao diện người dùng để cung cấp số lần thả ghim. Các khoá siêu dữ liệu bao gồm "field_mask".
`STALE_DATA`	Google mới cập nhật một hoặc nhiều mục trong thời gian gần đây. Hiện tại, chỉ chủ sở hữu của doanh nghiệp này mới có thể thực hiện thay đổi đối với dữ liệu trong "trường" bằng cách truy cập vào business.google.com. Khoá siêu dữ liệu bao gồm "field_mask".
`PHONE_NUMBER_EDITS_NOT_ALLOWED`	Trường số điện thoại đã bị vô hiệu hoá cho vị trí này và không được phép chỉnh sửa. Các khoá siêu dữ liệu bao gồm "field_mask".
`MULTIPLE_ORGANIZATIONALLY_PART_OF_RELATION`	Có nhiều hơn một quan hệ mô hình hoá mối quan hệ logic giữa hai vị trí (ví dụ: xuyên tạc của, làm việc tại). Các khóa siêu dữ liệu bao gồm "field_mask" và "value".

GetAttributesRequest

Yêu cầu đối với AttributesService.GetAttributes.

Các trường

Các trường
`name`	`string` Bắt buộc. Giá trị nhận dạng của Google cho vị trí này ở dạng `locations/{location_id}/attributes`.

name

string

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

GetChainRequest

Thông báo yêu cầu cho Places.GetChain.

Các trường

Các trường
`name`	`string` Bắt buộc. Tên tài nguyên của chuỗi, ở định dạng `chains/{chain_place_id}`.

name

string

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

GetGoogleUpdatedAttributesRequest

Yêu cầu đối với AttributesService.GetGoogleUpdatedAttributes.

Các trường

Các trường
`name`	`string` Bắt buộc. Giá trị nhận dạng của Google cho vị trí này ở dạng `locations/{location_id}/attributes`.

name

string

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

GetGoogleUpdatedLocationRequest

Thông báo yêu cầu cho Places.GetGoogleUpdatedLocation.

Các trường

Các trường
`name`	`string` Bắt buộc. Tên của vị trí cần tìm nạp.
`read_mask`	`FieldMask` Bắt buộc. Đọc mặt nạ để chỉ định những trường sẽ được trả về trong phản hồi.

name

string

Bắt buộc. Tên của vị trí cần tìm nạp.

read_mask

Bắt buộc. Đọc mặt nạ để chỉ định những trường sẽ được trả về trong phản hồi.

GetLocationRequest

Thông báo yêu cầu cho Places.GetLocation.

Các trường

Các trường
`name`	`string` Bắt buộc. Tên của vị trí cần tìm nạp.
`read_mask`	`FieldMask` Bắt buộc. Đọc mặt nạ để chỉ định những trường sẽ được trả về trong phản hồi.

name

string

Bắt buộc. Tên của vị trí cần tìm nạp.

read_mask

Bắt buộc. Đọc mặt nạ để chỉ định những trường sẽ được trả về trong phản hồi.

GoogleLocation

Đại diện cho Location có trên Google. Đây có thể là vị trí đã được người dùng hoặc người khác xác nhận quyền sở hữu hoặc có thể chưa được xác nhận quyền sở hữu.

Các trường

Các trường
`name`	`string` Tên tài nguyên của GoogleLocation này, ở định dạng `googleLocations/{googleLocationId}`.
`location`	`Location` Thông tin về `Location` được nhập thưa thớt. Có thể sử dụng lại trường này trong `CreateLocation` nếu hiện chưa có người dùng xác nhận quyền sở hữu trường này.
`request_admin_rights_uri`	`string` URL sẽ chuyển hướng người dùng đến giao diện người dùng yêu cầu quyền quản trị. Trường này chỉ hiển thị nếu vị trí đã được bất kỳ người dùng nào xác nhận quyền sở hữu, bao gồm cả người dùng hiện tại.

name

string

Tên tài nguyên của GoogleLocation này, ở định dạng googleLocations/{googleLocationId}.

location

Thông tin về Location được nhập thưa thớt. Có thể sử dụng lại trường này trong CreateLocation nếu hiện chưa có người dùng xác nhận quyền sở hữu trường này.

request_admin_rights_uri

string

URL sẽ chuyển hướng người dùng đến giao diện người dùng yêu cầu quyền quản trị. Trường này chỉ hiển thị nếu vị trí đã được bất kỳ người dùng nào xác nhận quyền sở hữu, bao gồm cả người dùng hiện tại.

GoogleUpdatedLocation

Đại diện cho một vị trí đã được Google sửa đổi.

Các trường

Các trường
`location`	`Location` Phiên bản do Google cập nhật của vị trí này.
`diff_mask`	`FieldMask` Các trường mà Google đã cập nhật.
`pending_mask`	`FieldMask` Các trường có nội dung chỉnh sửa đang chờ xử lý và chưa được đẩy lên Maps và Tìm kiếm.

location

Phiên bản do Google cập nhật của vị trí này.

diff_mask

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

pending_mask

Các trường có nội dung chỉnh sửa đang chờ xử lý và chưa được đẩy lên Maps và Tìm kiếm.

Nhãn

Nhãn được dùng khi hiển thị danh sách giá, mục hoặc mặt hàng.

Các trường

Các 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. Chỉ có thể đặt một bộ nhãn cho mỗi ngôn 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. Chỉ có thể đặt một bộ nhãn cho mỗi ngôn ngữ.

ListAttributeMetadataRequest

Yêu cầu AttributesService.ListAttributeMetadata.

Các trường
`parent`	`string` Tên tài nguyên của vị trí để tra cứu các thuộc tính hiện có. Nếu bạn đặt trường này, thì bạn không bắt buộc phải đặt danh mục, mã khu vực, mã ngôn ngữ và mã chương trình.
`category_name`	`string` Mã nhận dạng ổn định của danh mục chính để tìm các thuộc tính có sẵn. Phải ở định dạng danh mục/{category_id}.
`region_code`	`string` Mã quốc gia ISO 3166-1 alpha-2 để tìm các thuộc tính có sẵn.
`language_code`	`string` Mã ngôn ngữ BCP 47 để lấy tên hiển thị thuộc tính. Nếu không có ngôn ngữ này, họ sẽ được cung cấp bằng tiếng Anh.
`show_all`	`bool` Siêu dữ liệu cho tất cả thuộc tính hiện có sẽ được trả về khi trường này được đặt thành true, bỏ qua các trường mẹ và list_name. Các trường language_code và Region_code là bắt buộc khi bạn đặt chương trình show_all thành true.
`page_size`	`int32` Số lượng thuộc tính cần đưa vào mỗi trang. Giá trị mặc định là 200, tối thiểu là 1.
`page_token`	`string` Nếu được chỉ định, hệ thống sẽ truy xuất trang tiếp theo của siêu dữ liệu thuộc tính.

ListAttributeMetadataResponse

Phản hồi cho AttributesService.ListAttributeMetadata.

Các trường

attribute_metadata[]

AttributeMetadata

Tập hợp siêu dữ liệu thuộc tính cho 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 đượ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 tiếp theo của thuộc tính trong lệnh gọi tiếp theo đến attributes.list. Nếu không có thêm thuộc tính nào khác, trường này sẽ không xuất hiện trong phản hồi.

ListCategoriesRequest

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

Các trường
`region_code`	`string` Bắt buộc. Mã quốc gia theo ISO 3166-1 alpha-2.
`language_code`	`string` Bắt buộc. Mã ngôn ngữ BCP 47.
`filter`	`string` Không bắt buộc. Lọc chuỗi khỏi người dùng. Trường duy nhất được hỗ trợ là `displayName`. Ví dụ: `filter=displayName=foo`.
`page_size`	`int32` Không bắt buộc. 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` Không bắt buộc. Nếu được chỉ định, hệ thống sẽ tìm nạp trang tiếp theo của danh mục.
`view`	`CategoryView` Bắt buộc. Chỉ định những phần cho tài nguyên Danh mục sẽ được trả về trong phản hồi.

ListCategoriesResponse

Thông báo phản hồi cho BusinessCategory.ListCategory.

Các trường

Các trường
`categories[]`	`Category` Các danh mục phù hợp dựa trên thông số yêu cầu.
`next_page_token`	`string` Nếu số lượng danh mục 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 tiếp theo của danh mục trong lệnh gọi tiếp theo đến `ListCategories`.

categories[]

Các danh mục phù hợp dựa trên thông số yêu cầu.

next_page_token

string

Nếu số lượng danh mục 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 tiếp theo của danh mục trong lệnh gọi tiếp theo đến ListCategories.

ListLocationsRequest

Thông báo yêu cầu cho Location.ListLocations.

Các trường
`parent`	`string` Bắt buộc. Tên của tài khoản để tìm nạp vị trí. Nếu [Account] mẹ [google.mybusiness.accountmanagement.v1.Account] thuộc [AccountType] [google.mybusiness.accountmanagement.v1.Account.AccountType] PERSONAL, thì chỉ những Vị trí do Tài khoản sở hữu trực tiếp mới được trả về. Nếu không, dữ liệu này sẽ trả về tất cả vị trí có thể truy cập từ Tài khoản (dù trực tiếp hay gián tiếp).
`page_size`	`int32` Không bắt buộc. Số lượng vị trí cần tìm nạp trên mỗi trang. Giá trị mặc định là 10 nếu không được đặt. Tối thiểu là 1 và kích thước trang tối đa là 100.
`page_token`	`string` Không bắt buộc. 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 đó đến `ListLocations` trả về khi có nhiều vị trí hơn số lượng có thể vừa với kích thước trang được yêu cầu.
`filter`	`string` Không bắt buộc. Bộ lọc ràng buộc các vị trí 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, các quy tắc ràng buộc sẽ được áp dụng và tất cả vị trí (đã 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 làm việc với dữ liệu vị trí.
`order_by`	`string` Không bắt buộc. Thứ tự sắp xếp cho yêu cầu. Bạn phải phân tách nhiều trường 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, bạn phải thêm hậu tố " Tìm". Các trường hợp lệ cho order_by là title và store_code. Ví dụ: "title, store_code description" hoặc "title" (tiêu đề), "store_code description"
`read_mask`	`FieldMask` Bắt buộc. Đọc mặt nạ để chỉ định những trường sẽ được trả về trong phản hồi.

ListLocationsResponse

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

Các trường

Các 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, thì 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 đến `ListLocations` tiếp theo. Nếu không có vị trí nào khác, thì trường này sẽ không xuất hiện trong phản hồi.
`total_size`	`int32` Số lượng Địa điểm gần đúng trong danh sách bất kể cách phân trang. Trường này sẽ chỉ được trả về nếu `filter` được dùng làm tham số truy vấn.

locations[]

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, thì 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 đến ListLocations tiếp theo. Nếu không có vị trí nào khác, thì trường này sẽ không xuất hiện trong phản hồi.

total_size

int32

Số lượng Địa điểm gần đúng trong danh sách bất kể cách phân trang. Trường này sẽ chỉ được trả về nếu filter được dùng làm tham số truy vấn.

Vị trí

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

Các trường
`name`	`string` Giá trị nhận dạng của Google cho vị trí này ở dạng: `locations/{location_id}`.
`language_code`	`string` Không thể thay đổi. Ngôn ngữ của vị trí. Được đặt trong quá trình tạo và không thể cập nhật.
`store_code`	`string` Không bắt buộc. Giá trị nhận dạng bên ngoài của vị trí này. Giá trị nhận dạng này phải là giá trị duy nhất trong một tài khoản nhất định. Đây là phương thức để liên kết vị trí với hồ sơ của riêng bạn.
`title`	`string` Bắt buộc. Tên địa điểm phải phản ánh tên doanh nghiệp trong thực tế, được sử dụng nhất quán trên cửa hàng, trang web và văn phòng phẩm, đồng thời phải được khách hàng biết đến. Nếu thích hợp, có thể đưa vào các trường khác của tài nguyên (ví dụ: `Address`, `Categories`). Đừng thêm thông tin không cần thiết vào tên của bạn (ví dụ: hãy thích "Google" hơn "Google Inc. – Trụ sở chính của công ty tại 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/đang mở cửa, số điện thoại, URL của trang web, thông tin về dịch vụ/sản phẩm, vị trí/địa chỉ hoặc đường đi hay thông tin về nơi kiểm soát (ví dụ: "Chase ATM ở Duane Reade").
`phone_numbers`	`PhoneNumbers` Không bắt buộc. Những số điện thoại mà khách hàng có thể sử dụng để liên hệ với doanh nghiệp.
`categories`	`Categories` Không bắt buộc. Các danh mục khác nhau mô tả doanh nghiệp.
`storefront_address`	`PostalAddress` Không bắt buộc. Một địa chỉ rõ ràng, chính xác để mô tả địa điểm doanh nghiệp của bạn. Không chấp nhận hòm thư bưu điện hoặc hòm thư có vị trí ở xa. Tại thời điểm này, bạn có thể chỉ định tối đa năm giá trị `address_lines` trong địa chỉ. Bạn chỉ nên đặt trường này cho các doanh nghiệp có cửa hàng thực tế. Bạn không nên đặt trường này cho các vị trí thuộc loại `CUSTOMER_LOCATION_ONLY` nhưng nếu đặt, mọi giá trị đã cung cấp sẽ bị loại bỏ.
`website_uri`	`string` Không bắt buộc. URL cho doanh nghiệp này. Nếu có thể, hãy sử dụng một URL đại diện cho địa điểm kinh doanh riêng lẻ này thay vì một trang web/URL chung chung đại diện cho tất cả địa điểm, hoặc đại diện cho thương hiệu.
`regular_hours`	`BusinessHours` Không bắt buộc. Giờ làm việc của doanh nghiệp.
`special_hours`	`SpecialHours` Không bắt buộc. Giờ đặc biệt đối với doanh nghiệp. Thời gian này thường bao gồm giờ hoạt động vào ngày lễ và những thời điểm khác ngoài giờ làm việc thông thường. Các giờ này thay thế giờ làm việc thông thường. Không thể đặt trường này nếu không có giờ thông thường.
`service_area`	`ServiceAreaBusiness` Không bắt buộc. Các doanh nghiệp hoạt động trong khu vực kinh doanh cung cấp dịch vụ tại địa điểm của khách hàng. Nếu doanh nghiệp này là doanh nghiệp cung cấp dịch vụ tại cơ sở khách hàng, thì trường này mô tả(các) khu vực mà doanh nghiệp phục vụ.
`labels[]`	`string` Không bắt buộc. Một bộ sưu tập các chuỗi dạng tự do để cho phép bạn gắn thẻ doanh nghiệp của mình. Các nhãn này KHÔNG hiển thị cho người dùng; chỉ bạn mới có thể nhìn thấy chúng. Phải có từ 1-255 ký tự trên mỗi nhãn.
`ad_words_location_extensions`	`AdWordsLocationExtensions` Không bắt buộc. Thông tin bổ sung xuất hiện trong AdWords.
`latlng`	`LatLng` Không bắt buộc. Vĩ độ và kinh độ do người dùng cung cấp. Khi tạo vị trí, trường này sẽ bị bỏ qua nếu mã địa lý địa chỉ được cung cấp thành công. Trường này chỉ được trả về trong các yêu cầu nhận nếu giá trị `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 trên Google. Chỉ những khách hàng đã được phê duyệt mới có thể cập nhật trường này.
`open_info`	`OpenInfo` Không bắt buộc. Một lá cờ cho biết liệu địa điểm đó hiện có mở cửa kinh doanh hay không.
`metadata`	`Metadata` Chỉ có đầu ra. Thông tin bổ sung mà người dùng không thể chỉnh sửa.
`profile`	`Profile` Không bắt buộc. Mô tả doanh nghiệp theo phong cách riêng và chia sẻ với người dùng câu chuyện độc đáo về doanh nghiệp và sản phẩm/dịch vụ của bạn. Tất cả các danh mục đều bắt buộc phải sử dụng trường này, ngoại trừ các danh mục cơ sở lưu trú (ví dụ: khách sạn, nhà nghỉ ven đường, nhà trọ).
`relationship_data`	`RelationshipData` Không bắt buộc. Tất cả các vị trí và chuỗi cửa hàng có liên quan đến cửa hàng này.
`more_hours[]`	`MoreHours` Không bắt buộc. Thêm giờ làm việc cho các phòng ban hoặc khách hàng cụ thể của doanh nghiệp.
`service_items[]`	`ServiceItem` Không bắt buộc. Danh sách dịch vụ mà người bán hỗ trợ. Dịch vụ có thể là cắt tóc, lắp đặt máy nước nóng, v.v. Những mục dịch vụ trùng lặp sẽ tự động bị xoá.

Metadata

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

Các trường
`has_google_updated`	`bool` Chỉ có đầu ra. Cho biết liệu mã địa điểm được liên kết với vị trí này có nội dung cập nhật cần khách hàng cập nhật hoặc từ chối hay không. Nếu đặt giá trị boolean này, bạn nên gọi phương thức `getGoogleUpdated` để tra cứu thông tin cần được xác minh.
`has_pending_edits`	`bool` Chỉ có đầu ra. Cho biết liệu có cơ sở lưu trú nào của Vị trí này ở trạng thái đang chờ chỉnh sửa hay không.
`can_delete`	`bool` Chỉ có đầu ra. Cho biết liệu vị trí có thể bị xoá bằng API hay không.
`can_operate_local_post`	`bool` Chỉ có đầu ra. Cho biết liệu danh sách có thể quản lý các bài đăng cục bộ hay không.
`can_modify_service_list`	`bool` Chỉ có đầu ra. Cho biết trang thông tin có thể sửa đổi 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 này có đủ điều kiện để hiển thị thực đơn đồ ăn hay không.
`can_operate_health_data`	`bool` Chỉ có đầu ra. Cho biết liệu vị trí có thể hoạt động trên dữ liệu sức khoẻ hay không.
`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 của Phòng cho thuê hay không.
`place_id`	`string` Chỉ có đầu ra. Nếu vị trí này xuất hiện trên Google Maps, thì trường này sẽ được điền mã địa điểm cho vị trí đó. Mã nhận dạng này có thể được dùng trong nhiều API Địa điểm. Bạn có thể đặt trường này trong lệnh gọi Create nhưng không thể đặt cho trường này.
`duplicate_location`	`string` Chỉ có đầu ra. Tài nguyên vị trí mà vị trí này trùng lặp.
`maps_uri`	`string` Chỉ có đầu ra. Đường liên kết đến thông tin vị trí trên Maps.
`new_review_uri`	`string` Chỉ có đầu ra. Đường liên kết đến trang trên Google Tìm kiếm nơi khách hàng có thể viết bài đánh giá về địa điểm đó.
`can_have_business_calls`	`bool` Chỉ có đầu ra. Cho biết liệu danh sách có đủ điều kiện để gọi điện cho doanh nghiệp hay không.
`has_voice_of_merchant`	`bool` Chỉ có đầu ra. Cho biết liệu danh sách có sử dụng Voice của người bán hay không. Nếu boolean này sai, bạn nên gọi API locations.getVoiceOfMerchantState để biết chi tiết về lý do tại sao chúng không có Voice of Merchant.

MoreHours

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

Các trường

Các trường
`hours_type_id`	`string` Bắt buộc. Loại giờ. Khách hàng nên gọi {#link businessCategory:BatchGet} để biết các loại giờ được hỗ trợ cho các danh mục vị trí của họ.
`periods[]`	`TimePeriod` Bắt buộc. Tập hợp thời gian mà vị trí này mở cửa. Mỗi khoảng thời gian đại diện cho một phạm vi giờ khi vị trí mở cửa trong tuần.

hours_type_id

string

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

periods[]

TimePeriod

Bắt buộc. Tập hợp thời gian mà vị trí này mở cửa. Mỗi khoảng thời gian đại diện cho một phạm vi giờ khi vị trí mở cửa trong tuần.

MoreHoursType

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

Các trường

hours_type_id

string

Chỉ có đầu ra. Một mã nhận dạng cố đị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ờ.

OpenInfo

Thông tin liên quan đến trạng thái khai trương của doanh nghiệp.

Các trường

status

OpenForBusiness

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

can_reopen

bool

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

opening_date

Date

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

OpenForBusiness

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

Enum
`OPEN_FOR_BUSINESS_UNSPECIFIED`	Chưa xác định.
`OPEN`	Cho biết vị trí đó đang mở cửa.
`CLOSED_PERMANENTLY`	Cho biết vị trí đã bị đóng vĩnh viễn.
`CLOSED_TEMPORARILY`	Cho biết vị trí này đã tạm thời đóng cửa.

PhoneNumbers

Tập hợp các số điện thoại của doanh nghiệp. Trong quá trình cập nhật, bạn phải đặt cả hai trường. Ứng dụng không thể chỉ cập nhật số điện thoại chính hoặc số điện thoại bổ sung bằng mặt nạ cập nhật. Định dạng số điện thoại quốc tế được ưu tiên, chẳng hạn như "+1 415 555 0132", xem thêm tại (https://developers.google.com/style/phone-numbers#international-phone-numbers).

Các trường

primary_phone

string

Bắt buộc. Số điện thoại kết nối với địa điểm kinh doanh riêng lẻ của bạn càng trực tiếp càng tốt. Nếu có thể, hãy sử dụng một số điện thoại địa phương thay vì số của đường dây hỗ trợ thuộc trung tâm tổng đài.

additional_phones[]

string

Không bắt buộc. Tối đa hai số điện thoại (di động hoặc cố định, không có số fax) có thể được gọi đến doanh nghiệp của bạn ngoài số điện thoại chính.

PlaceInfo

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

Các trường

place_name

string

Bắt buộc. Tên được bản địa hoá của địa điểm. Ví dụ: Scottsdale, AZ.

place_id

string

Bắt buộc. Mã của địa điểm. Phải tương ứng với một khu vực. (https://developers.google.com/places/web-service/supported_types#table3)

Địa điểm

Xác định phần hợp nhất các khu vực được biểu thị bằng một tập hợp các địa điểm.

Các 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.

Hồ sơ

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

Các trường

description

string

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

RelationshipData

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

Các trường

parent_location

RelevantLocation

Vị trí chính mà vị trí này có quan hệ.

children_locations[]

RelevantLocation

Danh sách các vị trí con mà vị trí này có liên quan.

parent_chain

string

Tên tài nguyên của Chuỗi có vị trí này. [Cách tìm Mã chuỗi] [Locations.SearchChains]

RelevantLocation

Thông tin về một vị trí khác liên quan đến vị trí hiện tại. Mối quan hệ có thể là bất kỳ một trong hai giá trị DEpartMENT_OF hoặc INDEPENDENT_ESTABLISHMENT_OF và vị trí được chỉ định ở đây có thể nằm ở một trong hai bên (gốc/con) của vị trí.

Các trường

place_id

string

Bắt buộc. Chỉ định vị trí ở phía bên kia của mối quan hệ theo placeID.

relation_type

RelationType

Bắt buộc. Loại mối quan hệ.

RelationType

Mối quan hệ của kiểu sẽ được chỉ định.

Enum
`RELATION_TYPE_UNSPECIFIED`	Chưa xác định loại.
`DEPARTMENT_OF`	Điều này thể hiện mối quan hệ giữa 2 địa điểm có cùng một khu vực thực tế, cùng một thương hiệu/quản lý/tổ chức cấp trên nhưng có các thuộc tính chính khác nhau như giờ mở cửa hoặc số điện thoại. Ví dụ: Hiệu thuốc Costco là một bộ phận trong Costco Merchandise.
`INDEPENDENT_ESTABLISHMENT_IN`	Điều này thể hiện trường hợp 2 địa điểm có cùng vị trí thực tế nhưng lại thuộc các công ty khác nhau (ví dụ: quán Starbucks ở Safeway, cửa hàng trong trung tâm mua sắm).

RepeatedEnumAttributeValue

Giá trị của 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ị: các mã được đặt (true) và những mã chưa được đặt (false). Những giá trị không xuất hiện sẽ bị coi là không xác định. Bạn phải chỉ định ít nhất một giá trị.

Các trường

set_values[]

string

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

unset_values[]

string

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

SearchChainsRequest

Thông báo yêu cầu cho Places.SearchChains.

Các trường

chain_name

string

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

page_size

int32

Số lượng chuỗi đã khớp tối đa sẽ 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.

Các 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ả phù hợp, trường này sẽ trống. Kết quả được liệt kê theo thứ tự mức độ liên quan.

SearchGoogleLocationsRequest

Thông báo yêu cầu cho GoogleLocations.SearchGoogleLocations.

Các trường
`page_size`	`int32` Số lượng kết quả trùng khớ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 thời gian. Không có quá trình phân trang.
Trường nhóm `search_query`. Cụm từ tìm kiếm. Điều này có thể được cung cấp dưới dạng đối tượng vị trí hoặc 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í cần tìm kiếm. Nếu được cung cấp, sẽ tìm các vị trí khớp với thông tin vị trí đã cung cấp.
`query`	`string` Cụm từ tìm kiếm bằng văn bản. Các 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 việc cung cấp một 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.

Các trường

google_locations[]

GoogleLocation

Tập hợp GoogleLocations có thể phù hợp với yêu cầu đã chỉ định, được liệt kê theo thứ tự từ chính xác nhất đến ít chính xác nhất.

ServiceAreaBusiness

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

Các trường

business_type

BusinessType

Bắt buộc. Cho biết [type] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] của doanh nghiệp cung cấp dịch vụ tại cơ sở khách hàng.

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.

region_code

string

Không thể thay đổi. Mã vùng CLDR của quốc gia/khu vực nơi doanh nghiệp khu vực kinh doanh này đặt trụ sở. Hãy truy cập vào http://cldr.unicode.org/ và http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html để biết thông tin chi tiết. Ví dụ: "CH" cho Thuỵ Sĩ.

Trường này là bắt buộc đối với các doanh nghiệp CUSTOMER_LOCATION_ONLY và bị bỏ qua nếu không có.

Khu vực được chỉ định ở đây có thể khác với các khu vực mà doanh nghiệp này phục vụ (ví dụ: doanh nghiệp hoạt động trong khu vực kinh doanh cung cấp dịch vụ ở các khu vực khác với khu vực mà họ đặt trụ sở).

Nếu vị trí này yêu cầu xác minh sau khi tạo, thì địa chỉ được cung cấp cho mục đích xác minh phải nằm trong khu vực này và chủ doanh nghiệp hoặc người đại diện được ủy quyền của họ phải nhận được thư qua đường bưu điện theo địa chỉ xác minh đã cung cấp.

BusinessType

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

Enum
`BUSINESS_TYPE_UNSPECIFIED`	Chỉ có đầu ra. Chưa xác định.
`CUSTOMER_LOCATION_ONLY`	Chỉ cung cấp dịch vụ trong khu vực xung quanh (không phải tại địa chỉ doanh nghiệp). Nếu một doanh nghiệp đang được cập nhật từ CUSTOMER_AND_BUSINESS_LOCATION thành CUSTOMER_LOCATION_ONLY, thì thông tin cập nhật vị trí phải bao gồm mặt nạ trường `storefront_address` và đặt trường này thành trống.
`CUSTOMER_AND_BUSINESS_LOCATION`	Cung cấp dịch vụ tại địa chỉ doanh nghiệp và khu vực lân cận.

ServiceItem

Thông báo mô tả một mục dịch vụ. Trường hợp này được 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ụ.

Các trườ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à unit khi đưa vào giá. Đây sẽ được coi là giá cố định cho mặt hàng dịch vụ.
Trường nhóm `service_item_info`. Bạn phải luôn đặt một trong các trường sau. `service_item_info` chỉ có thể là một trong những trạng thái sau đây:
`structured_service_item`	`StructuredServiceItem` Không bắt buộc. Trường này sẽ được đặt làm trường hợp sử dụng dữ liệu dịch vụ có cấu trúc.
`free_form_service_item`	`FreeFormServiceItem` Không bắt buộc. Trường này sẽ được đặt làm trường dữ liệu dịch vụ dạng tự do.

FreeFormServiceItem

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

Các trường

category

string

Bắt buộc. Trường này đại diện cho tên danh mục (tức là ID ổn định của danh mục). category và service_type_id phải khớp với các tổ hợp có thể được cung cấp trong thông báo Category.

label

Label

Bắt buộc. Các nhãn được gắn thẻ ngôn ngữ cho mặt hàng. Tên mục nên dài từ 140 ký tự trở xuống và nội dung mô tả không dài quá 250 ký tự. Bạ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ụ: Vệ sinh_cài đặt.

Các trường

service_type_id

string

Bắt buộc. Trường service_type_id là mã nhận dạng duy nhất do Google cung cấp và bạn có thể tìm thấy trong ServiceType. Thông tin này do dịch vụ RPC BatchGetCategories cung cấp.

description

string

Không bắt buộc. Nội dung mô tả về 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.

Các trường

service_type_id

string

Chỉ có đầu ra. Mã nhận dạng cố đị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 của loại dịch vụ.

SpecialHourPeriod

Đại diện cho một khoảng thời gian khi giờ hoạt động của một vị trí khác với giờ làm việc bình thường của vị trí đó. Khoảng giờ đặc biệt phải đại diện cho một phạm vi ít hơn 24 giờ. 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 dữ liệu đầu vào 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 thông tin nhập sau 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

Các trường
`start_date`	`Date` Bắt buộc. Ngày dương lịch trong khoảng thời gian giờ đặc biệt này bắt đầu.
`open_time`	`TimeOfDay` Không bắt buộc. Các giá trị hợp lệ là 00:00-24:00, trong đó 24:00 biểu thị nửa đêm vào cuối trường ngày được chỉ định. Bạn phải chỉ định nếu `closed` sai.
`end_date`	`Date` Không bắt buộc. Ngày theo lịch trong khoảng thời gian giờ đặc biệt này sẽ kết thúc. Nếu bạn không đặt trường `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 ngày `start_date`.
`close_time`	`TimeOfDay` Không bắt buộc. Các giá trị hợp lệ là 00:00-24:00, trong đó 24:00 biểu thị nửa đêm vào cuối trường ngày được chỉ định. Bạn phải chỉ định nếu `closed` sai.
`closed`	`bool` Không bắt buộc. Nếu đúng, `end_date`, `open_time` và `close_time` sẽ bị bỏ qua và ngày chỉ định trong `start_date` được coi là vị trí đóng cửa trong 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 bình thường của vị trí đó.

Các trường

special_hour_periods[]

SpecialHourPeriod

Bắt buộc. Danh sách các trường hợp ngoại lệ đối với giờ hoạt động thông thường của doanh nghiệp.

TimePeriod

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

Các trường
`open_day`	`DayOfWeek` Bắt buộc. Cho biết `day of the week` bắt đầu từ ngày này.
`open_time`	`TimeOfDay` Bắt buộc. Các giá trị hợp lệ là 00:00-24:00, trong đó 24:00 biểu thị nửa đêm vào cuối trường ngày được chỉ định.
`close_day`	`DayOfWeek` Bắt buộc. Cho biết `day of the week` sẽ kết thúc vào ngày này.
`close_time`	`TimeOfDay` Bắt buộc. Các giá trị hợp lệ là 00:00-24:00, trong đó 24:00 biểu thị nửa đêm vào cuối trường ngày được chỉ định.

UpdateAttributesRequest

Yêu cầu đối với AttributesService.UpdateAttributes.

Các trường

attributes

Attributes

Tập hợp các thuộc tính cần được cập nhật.

attribute_mask

Bắt buộc. Tên thuộc tính của những thuộc tính mà bạn muốn cập nhật. Người đại diện: attributes/{attribute}.

Nội dung cập nhật: Tất cả thuộc tính được cung cấp trong trường thuộc tính mà bạn muốn cập nhật phải được đặt trong attribute_mask. Các thuộc tính được thiết lập trong danh sách trên nhưng không nằm trong attribute_mask sẽ bị bỏ qua.

Xoá: Nếu bạn muốn xoá một số thuộc tính, các thuộc tính đó phải được chỉ định trong attribute_mask và không có mục nhập nào khớp trong danh sách thuộc tính. Nếu muốn xoá tất cả thuộc tính đã đặt cho một vị trí, bạn nên tra cứu mọi thuộc tính áp dụng cho vị trí đó rồi thêm các thuộc tính đó vào attribute_mask bằng trường thuộc tính trống.

UpdateLocationRequest

Thông báo yêu cầu cho Places.UpdateLocation.

Các trường

location

Bắt buộc. Thông tin vị trí đã cập nhật.

update_mask