REST Resource: accounts.locations

Tài nguyên: 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ệ.

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)
    }
  ]
}
Trường
name

string

Giá trị nhận dạng của Google cho vị trí này trong biểu mẫu: accounts/{accountId}/locations/{locationId}

Trong bối cảnh kết quả trùng khớp, trường này sẽ không được điền sẵn.

languageCode

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.

storeCode

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.

locationName

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

primaryPhone

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.

additionalPhones[]

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

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

primaryCategory

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

additionalCategories[]

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

websiteUrl

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.

regularHours

object (BusinessHours)

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

specialHours

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

serviceArea

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

locationKey

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

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

openInfo

object (OpenInfo)

Cờ cho biết liệu vị trí hiện có đang 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)

Các 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 chỉnh sửa được.

priceLists[]
(deprecated)

object (PriceList)

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

profile

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

relationshipData

object (RelationshipData)

Tất cả địa điểm và chuỗi liên quan đến địa điểm này.

moreHours[]

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

BusinessHours

Thể hiện khoảng thời gian vị trí này mở cửa hoạt động. Lưu giữ một tập hợp gồm TimePeriod thực thể.

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

object (TimePeriod)

Tập hợp thời gian vị trí này mở cửa hoạt động. Mỗi khoảng thời gian đại diện cho một khoảng 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 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.

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

enum (DayOfWeek)

Cho biết thời gian day of the week bắt đầu của khoảng thời gian này.

openTime

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.

closeDay

enum (DayOfWeek)

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

closeTime

string

Thời gian ở định dạng mở rộng ISO 8601 trong 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.

DayOfWeek

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

Enum
DAY_OF_WEEK_UNSPECIFIED Ngày trong tuần không được chỉ định.
MONDAY Thứ Hai
TUESDAY Tuesday (thứ Ba)
WEDNESDAY Wednesday (thứ Tư)
THURSDAY Thursday (thứ Năm)
FRIDAY 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 thông thường của vị trí đó.

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

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

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ờ. openTimestartDate phải trước closeTimeendDate. closeTimeendDate có thể kéo dài đến 11:59 sáng vào ngày sau startDate được chỉ định. Ví dụ: các giá trị nhập 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 giá trị nhập sau đây 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
}
Trường
startDate

object (Date)

Ngày theo lịch cho khoảng thời gian đặc biệt này.

openTime

string

Thời gian hiển thị trên startDate 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 isClosed là false.

endDate

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

closeTime

string

Thời gian thực tế trên endDate 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 isClosed là false.

isClosed

boolean

Nếu giá trị là true, thì endDate, openTimecloseTime sẽ bị bỏ qua và ngày được chỉ định trong startDate được coi là vị trí đóng cửa cả ngày.

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

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

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

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
}
Trường
latlng

object (LatLng)

Vĩ độ/kinh độ chỉ định tâm của một khu vực được xác định bởi 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

Đối tượng đại diện cho cặp vĩ độ/kinh độ. Giá trị này được biểu thị bằng cặp số đại diện cho 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
}
Trường
latitude

number

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

longitude

number

Kinh độ tính bằng độ. Giá trị này phải nằm trong khoảng [-180.0, +180.0].

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

Biểu diễn dưới dạng JSON
{
  "placeInfos": [
    {
      object (PlaceInfo)
    }
  ]
}
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 một 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
}
Trường
name

string

Tên đã 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

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

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

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.

placeId

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 explicitNoPlaceId bổ sung đủ điều kiện cho dù mã địa điểm chưa được đặt là có chủ ý hay không.

explicitNoPlaceId

boolean

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.

requestId

string

Chỉ có đầu ra. requestId 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.

AdWordsLocationExtensions

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

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

string

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

OpenInfo

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

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

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

canReopen

boolean

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.

openingDate

object (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ụ: locationState.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 updateMask thành openInfo.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.

LocationState

Chứa một tập hợp 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
}
Trường
isGoogleUpdated

boolean

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.

isDuplicate

boolean

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.

isSuspended

boolean

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.

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

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 liệu vị trí đó có cần phải xác minh lại hay không.

isPendingReview

boolean

Chỉ có đầu ra. Cho biết liệu hoạt động đánh giá vị trí có đang chờ xử lý hay không.

isDisabled

boolean

Chỉ có đầu ra. Cho biết 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 đối với vị trí này hay không.

canModifyServiceList

boolean

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.

canHaveFoodMenus

boolean

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.

hasPendingEdits

boolean

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.

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 dựa 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 về Cơ sở lưu trú hay không.

Thuộc tính

Thuộc tính vị trí. Thuộc tính cung cấp thêm thông tin về một vị trí. Các thuộc tính có thể được đặt cho một vị trí có thể thay đổi dựa trên các thuộc tính 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)
    }
  ]
}
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 hàm 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 đó; hãy xem AttributeValueType. Đây là trường lặp lại mà có thể bạn phải 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, loại này 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 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 một thuộc tính có valueType 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ị.

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

string

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

unsetValues[]

string

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

UrlAttributeValue

Giá trị cho một thuộc tính có valueType URL.

Biểu diễn dưới dạng JSON
{
  "url": string
}
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
}
Trường
duplicate
(deprecated)

object (Duplicate)

Thông tin về vị trí mà vị trí này trùng lặp. Chỉ xuất hiện khi locationState.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.

mapsUrl

string

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

newReviewUrl

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.

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

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

placeId

string

Mã địa điểm của vị trí bị 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í 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.

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.

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

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

object (Label)

Bắt buộc. Nhãn được gắn thẻ theo 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 được tự động trích xuất để điền thông tin trình đơn.

sections[]

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

Biểu diễn dưới dạng JSON
{
  "displayName": string,
  "description": string,
  "languageCode": string
}
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. 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.

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

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

sectionType

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

object (Item)

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

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

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)
  }
}
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. 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

object (Money)

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

Tiền

Đại diện cho số tiền kèm theo loại đơn vị tiền tệ.

Biểu diễn dưới dạng JSON
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
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"USD", thì 1 đơn vị sẽ là 1 đô 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 thì nanos phải có giá trị dương hoặc 0. Nếu units bằng 0, nanos có thể là số dương, 0 hoặc số âm. Nếu units là số âm thì nanos phải có giá trị âm hoặc 0. Ví dụ: $-1,75 được biểu thị 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
}
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.

RelationshipData

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

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

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

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.

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

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

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

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ả các vị trí được chỉ định trong tài khoản đã cho.

batchGetReviews

Trả về danh sách bài đánh giá được phân trang cho tất cả vị trí được 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 thuộc sở hữu của tài khoản đã chỉ định và trả về thuộc tính này.

delete

Xoá một 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 tất cả các vị trí có thể trùng khớp với vị trí được chỉ định.

get

Xem vị trí được chỉ định.

getFoodMenus

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

getGoogleUpdated

Tải phiên bản do Google cập nhật cho vị trí được 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

Lấy 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 đã chỉ định.

patch

Cập nhật vị trí được 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 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 quy trình xác minh cho một vị trí.