REST Resource: accounts.locations

Tài nguyên: Vị trí

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

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "languageCode": string,
  "storeCode": string,
  "locationName": string,
  "primaryPhone": string,
  "additionalPhones": [
    string
  ],
  "address": {
    object (PostalAddress)
  },
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ],
  "websiteUrl": string,
  "regularHours": {
    object (BusinessHours)
  },
  "specialHours": {
    object (SpecialHours)
  },
  "serviceArea": {
    object (ServiceAreaBusiness)
  },
  "locationKey": {
    object (LocationKey)
  },
  "labels": [
    string
  ],
  "adWordsLocationExtensions": {
    object (AdWordsLocationExtensions)
  },
  "latlng": {
    object (LatLng)
  },
  "openInfo": {
    object (OpenInfo)
  },
  "locationState": {
    object (LocationState)
  },
  "attributes": [
    {
      object (Attribute)
    }
  ],
  "metadata": {
    object (Metadata)
  },
  "priceLists": [
    {
      object (PriceList)
    }
  ],
  "profile": {
    object (Profile)
  },
  "relationshipData": {
    object (RelationshipData)
  },
  "moreHours": [
    {
      object (MoreHours)
    }
  ]
}
Các trường
name

string

Giá trị nhận dạng của Google cho vị trí này ở dạng: accounts/{accountId}/locations/{locationId}

Trong trường hợp khớp, trường này sẽ không được điền sẵn.
languageCode

string

Ngôn ngữ của vị trí. Được đặt trong quá trình tạo và không thể cập nhật.
storeCode

string

Giá trị nhận dạng bên ngoài cho vị trí này. Giá trị nhận dạng này phải là duy nhất trong một tài khoản nhất định. Đây là phương thức để liên kết vị trí với hồ sơ của riêng bạn.
locationName

string

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").
primaryPhone

string

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

string

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

object (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ư 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ị addressLines trong địa chỉ.
primaryCategory

object (Category)

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

object (Category)

Danh mục bổ sung để mô tả doanh nghiệp của bạn. Danh mục giúp khách hàng tìm thấy kết quả chính xác, cụ thể cho dịch vụ mà họ quan tâm. Để thông tin doanh nghiệp của bạn luôn chính xác và cập nhật, hãy nhớ sử dụng càng ít danh mục càng tốt để mô tả tổng thể hoạt động kinh doanh cốt lõi của bạn. Chọn danh mục càng cụ thể càng tốt, nhưng đại diện cho công việc kinh doanh chính của bạn.
websiteUrl

string

URL cho doanh nghiệp này. Nếu có thể, hãy sử dụng một URL đại diện cho địa điểm kinh doanh riêng lẻ này thay vì một trang web/URL chung chung đại diện cho tất cả địa điểm, hoặc đại diện cho thương hiệu.
regularHours

object (BusinessHours)

Giờ làm việc của doanh nghiệp.
specialHours

object (SpecialHours)

Giờ đặc biệt đối với doanh nghiệp. Thời gian này thường bao gồm giờ hoạt động vào ngày lễ và những thời điểm khác ngoài giờ làm việc thông thường. Các giờ này thay thế giờ làm việc thông thường.
serviceArea

object (ServiceAreaBusiness)

Các doanh nghiệp hoạt động trong khu vực kinh doanh cung cấp dịch vụ tại địa điểm của khách hàng. Nếu doanh nghiệp này là doanh nghiệp cung cấp dịch vụ tại cơ sở khách hàng, thì trường này mô tả(các) khu vực mà doanh nghiệp phục vụ.
locationKey

object (LocationKey)

Bộ sưu tập khóa liên kết doanh nghiệp này với các sản phẩm khác của Google, chẳng hạn như trang Google+ và Google Maps Địa điểm.
labels[]

string

Một bộ sưu tập các chuỗi dạng tự do để cho phép bạn gắn thẻ doanh nghiệp của mình. Các nhãn này KHÔNG hiển thị cho người dùng; chỉ bạn mới có thể nhìn thấy chúng. Tối đa 255 ký tự (mỗi nhãn).
adWordsLocationExtensions

object (AdWordsLocationExtensions)

Thông tin bổ sung xuất hiện trong AdWords.
latlng

object (LatLng)

Vĩ độ và kinh độ do người dùng cung cấp. Khi tạo vị trí, trường này sẽ bị bỏ qua nếu mã địa lý địa chỉ được cung cấp thành công. Trường này chỉ được trả về trong các yêu cầu nhận nếu giá trị 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 của Trang doanh nghiệp. Không thể cập nhật trường này.
openInfo

object (OpenInfo)

Một lá cờ cho biết liệu địa điểm đó hiện có mở cửa kinh doanh hay không.
locationState

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

object (Attribute)

Thuộc tính cho vị trí này.
metadata

object (Metadata)

Chỉ có đầu ra. Thông tin bổ sung mà người dùng không thể chỉnh sửa.
priceLists[]
(deprecated)

object (PriceList)

Không dùng nữa: Thông tin về bảng giá cho vị trí này.
profile

object (Profile)

Mô tả doanh nghiệp theo phong cách riêng và chia sẻ với người dùng câu chuyện độc đáo về doanh nghiệp và sản phẩm/dịch vụ của bạn.
relationshipData

object (RelationshipData)

Tất cả các vị trí và chuỗi cửa hàng có liên quan đến cửa hàng này.
moreHours[]

object (MoreHours)

Thêm giờ làm việc cho các phòng ban hoặc khách hàng cụ thể của doanh nghiệp.

BusinessHours

Thể hiện khoảng thời gian mà địa điểm này mở cửa kinh doanh. Lưu giữ một tập hợp các bản sao TimePeriod.

Biểu diễn dưới dạng JSON 
{
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
Các trường
periods[]

object (TimePeriod)

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

TimePeriod

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

Biểu diễn dưới dạng JSON 
{
  "openDay": enum (DayOfWeek),
  "openTime": string,
  "closeDay": enum (DayOfWeek),
  "closeTime": string
}
Các trường
openDay

enum (DayOfWeek)

Cho biết day of the week bắt đầu từ ngày này.
openTime

string

Thời gian ở định dạng mở rộng 24 giờ ISO 8601 (hh:mm). Các giá trị hợp lệ là 00:00-24:00, trong đó 24:00 biểu thị nửa đêm vào cuối trường ngày được chỉ định.
closeDay

enum (DayOfWeek)

Cho biết day of the week sẽ kết thúc vào ngày này.
closeTime

string

Thời gian ở định dạng mở rộng 24 giờ ISO 8601 (hh:mm). Các giá trị hợp lệ là 00:00-24:00, trong đó 24:00 biểu thị nửa đêm vào cuối trường ngày được chỉ định.

DayOfWeek

Đại diện cho một ngày trong tuần.

Enum
DAY_OF_WEEK_UNSPECIFIED Chưa xác định ngày trong tuần.
MONDAY Thứ Hai
TUESDAY Thứ Ba
WEDNESDAY Thứ Tư
THURSDAY Thursday (thứ Năm)
FRIDAY Thứ Sáu
SATURDAY Saturday (thứ Bảy)
SUNDAY Chủ Nhật

SpecialHours

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

Biểu diễn dưới dạng JSON 
{
  "specialHourPeriods": [
    {
      object (SpecialHourPeriod)
    }
  ]
}
Các trường
specialHourPeriods[]

object (SpecialHourPeriod)

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

SpecialHourPeriod

Đại diện cho một khoảng thời gian khi giờ hoạt động của một vị trí khác với giờ làm việc bình thường của vị trí đó. Khoảng giờ đặc biệt phải đại diện cho một phạm vi ít hơn 24 giờ. openTime và startDate phải trước closeTime và endDate. closeTime và endDate có thể kéo dài đến 11:59 sáng vào ngày sau startDate được chỉ định. Ví dụ: các dữ liệu đầu vào sau đây là hợp lệ:

startDate=2015-11-23, openTime=08:00, closeTime=18:00
startDate=2015-11-23, endDate=2015-11-23, openTime=08:00,
closeTime=18:00 startDate=2015-11-23, endDate=2015-11-24,
openTime=13:00, closeTime=11:59

Các thông tin nhập sau không hợp lệ:

startDate=2015-11-23, openTime=13:00, closeTime=11:59
startDate=2015-11-23, endDate=2015-11-24, openTime=13:00,
closeTime=12:00 startDate=2015-11-23, endDate=2015-11-25,
openTime=08:00, closeTime=18:00
Biểu diễn dưới dạng JSON 
{
  "startDate": {
    object (Date)
  },
  "openTime": string,
  "endDate": {
    object (Date)
  },
  "closeTime": string,
  "isClosed": boolean
}
Các trường
startDate

object (Date)

Ngày dương lịch trong khoảng thời gian giờ đặc biệt này bắt đầu.
openTime

string

Thời gian treo trên startDate khi một vị trí mở ra, được biểu thị ở định dạng mở rộng ISO 8601 24 giờ. (hh:mm) Các giá trị hợp lệ là 00:00-24:00, trong đó 24:00 biểu thị nửa đêm ở thời điểm kết thúc của trường ngày được chỉ định. Bạn phải chỉ định nếu isClosed sai.
endDate

object (Date)

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 endDate, giá trị mặc định sẽ là ngày được chỉ định trong startDate. Nếu được đặt, trường này phải bằng hoặc tối đa là 1 ngày sau ngày startDate.
closeTime

string

Thời gian treo tường vào endDate khi một địa điểm đóng cửa, được biểu thị ở định dạng mở rộng ISO 8601 24 giờ. (hh:mm) Các giá trị hợp lệ là 00:00-24:00, trong đó 24:00 biểu thị nửa đêm ở thời điểm kết thúc của trường ngày được chỉ định. Bạn phải chỉ định nếu isClosed sai.
isClosed

boolean

Nếu đúng, endDate, openTime và closeTime sẽ bị bỏ qua và ngày chỉ định trong startDate được coi là vị trí đóng cửa trong cả ngày.

ServiceAreaBusiness

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

Biểu diễn dưới dạng JSON 
{
  "businessType": enum (BusinessType),

  // Union field coverageArea can be only one of the following:
  "radius": {
    object (PointRadius)
  },
  "places": {
    object (Places)
  }
  // End of list of possible types for union field coverageArea.
}
Các trường
businessType

enum (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 nhóm coverageArea. Cho biết khu vực phục vụ mà doanh nghiệp cung cấp dịch vụ. coverageArea chỉ có thể là một trong những trạng thái sau đây:
radius

object (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

object (Places)

Khu vực mà doanh nghiệp này phục vụ được xác định thông qua một nhóm địa điểm.

BusinessType

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

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

PointRadius

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

Biểu diễn dưới dạng JSON 
{
  "latlng": {
    object (LatLng)
  },
  "radiusKm": number
}
Các trường
latlng

object (LatLng)

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

number

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

LatLng

Một đối tượng đại diện cho cặp vĩ độ/kinh độ. Đây là một cặp số kép để biểu thị độ vĩ độ và độ kinh độ. Trừ phi có quy định khác, đối tượng này phải tuân thủ tiêu chuẩn WGS84. Giá trị phải nằm trong phạm vi chuẩn hoá.

Biểu diễn dưới dạng JSON 
{
  "latitude": number,
  "longitude": number
}
Các trường
latitude

number

Vĩ độ tính theo độ. Giá trị này phải nằm trong khoảng [-90,0, +90,0].
longitude

number

Kinh độ theo độ. Giá trị này phải nằm trong khoảng [-180,0, +180,0].

Địa điểm

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

Biểu diễn dưới dạng JSON 
{
  "placeInfos": [
    {
      object (PlaceInfo)
    }
  ]
}
Các trường
placeInfos[]

object (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.

PlaceInfo

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

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "placeId": string
}
Các trường
name

string

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

string

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

LocationKey

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

Biểu diễn dưới dạng JSON 
{
  "plusPageId": string,
  "placeId": string,
  "explicitNoPlaceId": boolean,
  "requestId": string
}
Các trường
plusPageId

string

Chỉ có đầu ra. Nếu vị trí này được liên kết với một trang Google+, thì vị trí này sẽ được điền bằng ID trang Google+ cho vị trí này.
placeId

string

Nếu vị trí này đã được xác minh và được kết nối với/xuất hiện trên Google Maps, thì trường này sẽ được điền mã địa điểm cho vị trí đó. Mã nhận dạng này có thể được dùng trong nhiều API Địa điểm.

Nếu vị trí này chưa được xác minh, trường này có thể được điền sẵn nếu vị trí đã được liên kết với một địa điểm đã xuất hiện trên Google Maps.

Bạn có thể đặt trường này trong lệnh gọi Create nhưng không thể đặt cho trường này.

Giá trị boolean explicitNoPlaceId bổ sung đủ điều kiện cho biết mã địa điểm chưa được đặt có được cân nhắc hay không.
explicitNoPlaceId

boolean

Chỉ có đầu ra. Giá trị true cho biết mã địa điểm chưa được đặt là có chủ ý, khác với việc chưa liên kết nào.
requestId

string

Chỉ có đầu ra. requestId được 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 Địa điểm trong Trang doanh nghiệp.

AdWordsLocationExtensions

Thông tin bổ sung xuất hiện trong AdWords.

Biểu diễn dưới dạng JSON 
{
  "adPhone": string
}
Các trường
adPhone

string

Số điện thoại thay thế để hiển thị trên tiện ích địa điểm AdWords thay vì số điện thoại chính của địa điểm.

OpenInfo

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

Biểu diễn dưới dạng JSON 
{
  "status": enum (OpenForBusiness),
  "canReopen": boolean,
  "openingDate": {
    object (Date)
  }
}
Các trường
status

enum (OpenForBusiness)

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

boolean

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

object (Date)

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

OpenForBusiness

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

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

LocationState

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

Biểu diễn dưới dạng JSON 
{
  "isGoogleUpdated": boolean,
  "isDuplicate": boolean,
  "isSuspended": boolean,
  "canUpdate": boolean,
  "canDelete": boolean,
  "isVerified": boolean,
  "needsReverification": boolean,
  "isPendingReview": boolean,
  "isDisabled": boolean,
  "isPublished": boolean,
  "isDisconnected": boolean,
  "isLocalPostApiDisabled": boolean,
  "canModifyServiceList": boolean,
  "canHaveFoodMenus": boolean,
  "hasPendingEdits": boolean,
  "hasPendingVerification": boolean,
  "canOperateHealthData": boolean,
  "canOperateLodgingData": boolean
}
Các trường
isGoogleUpdated

boolean

Chỉ có đầu ra. Cho biết liệu mã địa điểm được liên kết với vị trí này có nội dung cập nhật hay không.
isDuplicate

boolean

Chỉ có đầu ra. Cho biết vị trí đó có trùng lặp với một vị trí khác hay không.
isSuspended

boolean

Chỉ có đầu ra. Cho biết vị trí có bị tạm ngưng hay không. Người dùng cuối sẽ không nhìn thấy vị trí bị tạm ngưng trong các sản phẩm của Google. Nếu bạn cho rằng đã có sự nhầm lẫn, hãy xem bài viết này trên trung tâm trợ giúp.
canUpdate

boolean

Chỉ có đầu ra. Cho biết liệu vị trí có thể được cập nhật hay không.
canDelete

boolean

Chỉ có đầu ra. Cho biết liệu có thể xóa vị trí bằng cách sử dụng API Google Doanh nghiệp của tôi hay không.
isVerified

boolean

Chỉ có đầu ra. Cho biết vị trí đã được xác minh hay chưa.
needsReverification

boolean

Chỉ có đầu ra. Cho biết vị trí này có yêu cầu xác minh lại hay không.
isPendingReview

boolean

Chỉ có đầu ra. Cho biết liệu quy trình xem xét vị trí đó có đang chờ xử lý hay không.
isDisabled

boolean

Chỉ có đầu ra. Cho biết liệu vị trí có bị tắt hay không.
isPublished

boolean

Chỉ có đầu ra. Cho biết liệu vị trí có được xuất bản hay không.
isDisconnected

boolean

Chỉ có đầu ra. Cho biết liệu vị trí có bị ngắt kết nối với một địa điểm trên Google Maps hay không.
isLocalPostApiDisabled

boolean

Chỉ có đầu ra. Cho biết liệu accounts.locations.localPosts có bị tắt cho vị trí này hay không.
canModifyServiceList

boolean

Chỉ có đầu ra. Cho biết liệu trang thông tin có thể sửa đổi một ServiceList hay không.
canHaveFoodMenus

boolean

Chỉ có đầu ra. Cho biết trang thông tin này có đủ điều kiện để hiển thị thực đơn đồ ăn hay không.
hasPendingEdits

boolean

Chỉ có đầu ra. Cho biết liệu có cơ sở lưu trú nào của Vị trí này ở trạng thái đang chờ chỉnh sửa hay không.
hasPendingVerification

boolean

Chỉ có đầu ra. Cho biết liệu vị trí có yêu cầu xác minh đang chờ xử lý hay không.
canOperateHealthData

boolean

Chỉ có đầu ra. Cho biết liệu vị trí có thể hoạt động trên dữ liệu sức khoẻ hay không.
canOperateLodgingData

boolean

Chỉ có đầu ra. Cho biết liệu vị trí có thể hoạt động trên dữ liệu của Phòng cho thuê hay không.

Thuộc tính

Thuộc tính vị trí. Thuộc tính cung cấp thông tin bổ sung về một vị trí. Những thuộc tính bạn có thể đặt cho một vị trí có thể thay đổi tuỳ theo các cơ sở lưu trú của vị trí đó (ví dụ: danh mục). Các thuộc tính hiện có là do Google xác định và có thể được thêm vào cũng như bị xoá mà không cần thay đổi API.

Biểu diễn dưới dạng JSON 
{
  "attributeId": string,
  "valueType": enum (AttributeValueType),
  "values": [
    value
  ],
  "repeatedEnumValue": {
    object (RepeatedEnumAttributeValue)
  },
  "urlValues": [
    {
      object (UrlAttributeValue)
    }
  ]
}
Các trường
attributeId

string

Mã nhận dạng của thuộc tính. Mã thuộc tính do Google cung cấp.
valueType

enum (AttributeValueType)

Chỉ có đầu ra. Loại giá trị mà thuộc tính này chứa. Bạn nên sử dụng thuộc tính này để xác định cách diễn giải giá trị.
values[]

value (Value format)

Các giá trị cho thuộc tính này. Loại giá trị được cung cấp phải khớp với loại giá trị dự kiến cho thuộc tính đó; xem AttributeValueType. Đây là trường lặp lại mà bạn có thể cung cấp nhiều giá trị thuộc tính. Các loại thuộc tính chỉ hỗ trợ một giá trị.
repeatedEnumValue

object (RepeatedEnumAttributeValue)

Khi loại giá trị thuộc tính là REPEATED_ENUM, thuộc tính này sẽ chứa giá trị thuộc tính và các trường giá trị khác phải để trống.
urlValues[]

object (UrlAttributeValue)

Khi loại giá trị thuộc tính là URL, trường này sẽ chứa(các) giá trị cho thuộc tính này và các trường giá trị khác phải để trống.

RepeatedEnumAttributeValue

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

Biểu diễn dưới dạng JSON 
{
  "setValues": [
    string
  ],
  "unsetValues": [
    string
  ]
}
Các trường
setValues[]

string

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

string

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

UrlAttributeValue

Giá trị của thuộc tính có valueType là URL.

Biểu diễn dưới dạng JSON 
{
  "url": string
}
Các trường
url

string

URL.

Metadata

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

Biểu diễn dưới dạng JSON 
{
  "duplicate": {
    object (Duplicate)
  },
  "mapsUrl": string,
  "newReviewUrl": string
}
Các trường
duplicate
(deprecated)

object (Duplicate)

Thông tin về vị trí mà vị trí này trùng lặp. Chỉ hiển thị khi locationState.is_duplicate là giá trị true. 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 bản sao.
mapsUrl

string

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

string

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

Nhân bản

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

Biểu diễn dưới dạng JSON 
{
  "locationName": string,
  "placeId": string,
  "access": enum (Access)
}
Các trường
locationName

string

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

string

Mã địa điểm của vị trí mà đối tượng này trùng lặp.
access

enum (Access)

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

Quyền truy cập

Cấp truy cập của người dùng vào vị trí mà nó trùng lặp. Phần tử này thay thế cho Quyền sở hữu và bạn nên dùng thông tin này.

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

PriceList

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

Biểu diễn dưới dạng JSON 
{
  "priceListId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "sourceUrl": string,
  "sections": [
    {
      object (Section)
    }
  ]
}
Các trường
priceListId

string

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

object (Label)

Bắt buộc. Các nhãn được gắn thẻ ngôn ngữ cho danh sách giá.
sourceUrl

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 đã tự động được trích xuất dữ liệu để điền thông tin trình đơn.
sections[]

object (Section)

Bắt buộc. Các mục trong bảng giá này. Mỗi bảng giá phải chứa ít nhất một mục.

Nhãn

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

Biểu diễn dưới dạng JSON 
{
  "displayName": string,
  "description": string,
  "languageCode": string
}
Các trường
displayName

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

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

Mục

Một mục trong bảng giá chứa một hoặc nhiều mặt hàng.

Biểu diễn dưới dạng JSON 
{
  "sectionId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "sectionType": enum (SectionType),
  "items": [
    {
      object (Item)
    }
  ]
}
Các trường
sectionId

string

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

object (Label)

Bắt buộc. Nhãn có gắn thẻ ngôn ngữ cho mục này. Bạn chỉ nên sử dụng tối đa 140 ký tự cho tên và nội dung mô tả của mục. Bắt buộc phải có ít nhất một bộ nhãn.
sectionType

enum (SectionType)

Không bắt buộc. Loại phần danh sách giá hiện tại. Giá trị mặc định là FOOD.
items[]

object (Item)

Các mặt hàng nằm trong phần này của danh sách giá.

SectionType

Loại phần.

Enum
SECTION_TYPE_UNSPECIFIED Chưa xác định.
FOOD Phần này chứa các mục đại diện cho thực phẩm.
SERVICES Phần này chứa các mục đại diện cho dịch vụ.

Mục

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

Biểu diễn dưới dạng JSON 
{
  "itemId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "price": {
    object (Money)
  }
}
Các trường
itemId

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

object (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ắt buộc phải có ít nhất một bộ nhãn.
price

object (Money)

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

Tiền

Biểu thị số tiền cùng với loại đơn vị tiền tệ.

Biểu diễn dưới dạng JSON 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Các trường
currencyCode

string

Mã đơn vị tiền tệ gồm ba chữ cái được xác định trong ISO 4217.
units

string (int64 format)

Toàn bộ đơn vị của số tiền. Ví dụ: nếu currencyCode là "USD", thì 1 đơn vị là một đô la Mỹ.
nanos

integer

Số lượng nano (10^-9) đơn vị của lượng. Giá trị phải nằm trong khoảng từ -999.999.999 đến +999.999.999. Nếu units là số dương, nanos phải là số dương hoặc 0. Nếu units bằng 0, thì nanos có thể là số dương, 0 hoặc âm. Nếu units là số âm, nanos phải là số âm hoặc 0. Ví dụ: $-1,75 được biểu diễn dưới dạng units=-1 và nanos=-750.000.000.

Hồ sơ

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

Biểu diễn dưới dạng JSON 
{
  "description": string
}
Các trường
description

string

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

RelationshipData

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

Biểu diễn dưới dạng JSON 
{
  "parentChain": string
}
Các trường
parentChain

string

Tên tài nguyên của Chuỗi có vị trí này. How to find Chain ID

MoreHours

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

Biểu diễn dưới dạng JSON 
{
  "hoursTypeId": string,
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
Các trường
hoursTypeId

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

object (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.

Phương thức

associate

 Liên kết một vị trí với một mã địa điểm.

batchGet

 Lấy tất cả vị trí chỉ định trong tài khoản cụ thể.

batchGetReviews

 Trả về danh sách các bài đánh giá được phân trang cho tất cả các vị trí đã chỉ định.

clearAssociation

 Xoá mối liên kết giữa một vị trí và mã địa điểm của vị trí đó.

create

 Tạo một location mới do tài khoản được chỉ định sở hữu rồi trả về thuộc tính đó.

delete

 Xoá vị trí.

fetchVerificationOptions

 Báo cáo tất cả các phương thức xác minh đủ điều kiện cho một vị trí bằng một ngôn ngữ cụ thể.

findMatches

 Tìm thấy tất cả vị trí có thể trùng khớp với vị trí đã chỉ định.

get

 Lấy vị trí đã chỉ định.

getFoodMenus

 Trả về trình đơn thức ăn của một vị trí cụ thể.

getGoogleUpdated

 Nhận phiên bản do Google cập nhật của vị trí đã chỉ định.

getHealthProviderAttributes

 Trả về các thuộc tính Nhà cung cấp sức khoẻ của một vị trí cụ thể.

getServiceList

 Nhận danh sách dịch vụ được chỉ định của một vị trí.

list

 Liệt kê các vị trí cho tài khoản được chỉ định.

patch

 Cập nhật vị trí đã chỉ định.

reportInsights

 Trả về báo cáo chứa thông tin chi tiết về một hoặc nhiều chỉ số theo vị trí.

transfer
(deprecated)

 Di chuyển vị trí từ tài khoản mà người dùng sở hữu sang một tài khoản khác mà người dùng đó quản lý.

updateFoodMenus

 Cập nhật thực đơn món ăn của một địa điểm cụ thể.

updateHealthProviderAttributes

 Cập nhật các thuộc tính Nhà cung cấp dịch vụ sức khoẻ của một vị trí cụ thể.

updateServiceList

 Cập nhật danh sách dịch vụ được chỉ định của một vị trí.

verify

 Bắt đầu quá trình xác minh cho một vị trí.