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 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,
  "title": string,
  "phoneNumbers": {
    object (PhoneNumbers)
  },
  "categories": {
    object (Categories)
  },
  "storefrontAddress": {
    object (PostalAddress)
  },
  "websiteUri": string,
  "regularHours": {
    object (BusinessHours)
  },
  "specialHours": {
    object (SpecialHours)
  },
  "serviceArea": {
    object (ServiceAreaBusiness)
  },
  "labels": [
    string
  ],
  "adWordsLocationExtensions": {
    object (AdWordsLocationExtensions)
  },
  "latlng": {
    object (LatLng)
  },
  "openInfo": {
    object (OpenInfo)
  },
  "metadata": {
    object (Metadata)
  },
  "profile": {
    object (Profile)
  },
  "relationshipData": {
    object (RelationshipData)
  },
  "moreHours": [
    {
      object (MoreHours)
    }
  ],
  "serviceItems": [
    {
      object (ServiceItem)
    }
  ]
}
Trường
name

string

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

string

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

string

Không bắt buộc. Giá trị nhận dạng bên ngoài cho vị trí này, phải là duy nhất trong một tài khoản nhất định. Đây là một cách để 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 thực tế của doanh nghiệp, đượ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, đồng thời được khách hàng biết đến. Bạn có thể đưa mọi thông tin bổ sung (nếu có liên quan) 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ụ: nên dùng "Google" thay vì "Google Inc. – Trụ sở chính 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ờ mở cửa hoặc trạng thái đóng/mở cửa, số điện thoại, URL của trang web, thông tin sản phẩm, vị trí/địa chỉ hoặc đường đi, hay thông tin về vị trí của doanh nghiệp (ví dụ: "ATM của Chase trong Duane Reade").
phoneNumbers

object (PhoneNumbers)

Không bắt buộc. Các số điện thoại mà khách hàng có thể dùng để liên hệ với doanh nghiệp.
categories

object (Categories)

Không bắt buộc. Các danh mục khác nhau mô tả doanh nghiệp.
storefrontAddress

object (PostalAddress)

Không bắt buộc. Địa chỉ rõ ràng, chính xác để mô tả địa điểm của doanh nghiệp bạn. Chúng tôi 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. Hiện tại, bạn có thể chỉ định tối đa 5 giá trị addressLines trong địa chỉ. Bạn chỉ nên đặt trường này cho những 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ị được cung cấp sẽ bị loại bỏ.
websiteUri

string

Không bắt buộc. URL của 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 đại diện cho tất cả các địa điểm hoặc thương hiệu.
regularHours

object (BusinessHours)

Không bắt buộc. Giờ hoạt động của doanh nghiệp.
specialHours

object (SpecialHours)

Không bắt buộc. Giờ đặc biệt của doanh nghiệp. Giờ hoạt động đặc biệt 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ờ hoạt động thông thường. Những giờ này sẽ thay thế giờ hoạt động thông thường. Bạn không thể đặt trường này nếu không có giờ hoạt động thông thường.
serviceArea

object (ServiceAreaBusiness)

Không bắt buộc. Doanh nghiệp phục vụ tận nơi 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 phục vụ tận nơi, thì trường này sẽ mô tả(các) khu vực mà doanh nghiệp này phục vụ.
labels[]

string

Không bắt buộc. Một tập hợp các chuỗi dạng tuỳ ý cho phép bạn gắn thẻ doanh nghiệp của mình. Người dùng KHÔNG nhìn thấy các nhãn này; chỉ bạn mới có thể nhìn thấy chúng. Mỗi nhãn phải có từ 1 đến 255 ký tự.
adWordsLocationExtensions

object (AdWordsLocationExtensions)

Không bắt buộc. Thông tin bổ sung được hiển thị trong AdWords.
latlng

object (LatLng)

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

object (OpenInfo)

Không bắt buộc. Cờ cho biết liệu địa điểm hiện có đang hoạt động hay không.
metadata

object (Metadata)

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

object (Profile)

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

Trường này là bắt buộc đối với tất cả danh mục, ngoại trừ danh mục cơ sở lưu trú (ví dụ: khách sạn, nhà nghỉ ven đường, nhà trọ).
relationshipData

object (RelationshipData)

Không bắt buộc. Tất cả địa điểm và chuỗi liên quan đến địa điểm này.
moreHours[]

object (MoreHours)

Không bắt buộc. Giờ hoạt động khác cho các phòng ban hoặc khách hàng cụ thể của doanh nghiệp.
serviceItems[]

object (ServiceItem)

Không bắt buộc. Danh sách các 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. Các dịch vụ trùng lặp sẽ tự động bị xoá.

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. Khách hàng không được 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. Bạn nên dùng định dạng số điện thoại quốc tế, chẳng hạn như "+1 415 555 0132". Hãy xem thêm tại (https://developers.google.com/style/phone-numbers#international-phone-numbers).

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

string

Bắt buộc. Số điện thoại kết nối với địa điểm doanh nghiệp riêng của bạn trực tiếp nhất có thể. Nếu có thể, hãy dùng một số điện thoại ở địa phương thay vì số của đường dây trợ giúp thuộc tổng đài.
additionalPhones[]

string

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

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 riêng lẻ danh mục chính hoặc danh mục bổ sung bằng mặt nạ cập nhật.

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

object (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 của địa điểm này.
additionalCategories[]

object (Category)

Không bắt buộc. 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 và cụ thể cho những dịch vụ mà họ quan tâm. Để đảm bảo thông tin doanh nghiệp của bạn luôn chính xác và xuất hiện trên Google, 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 các danh mục càng cụ thể càng tốt, nhưng phải đại diện cho ngành nghề kinh doanh chính của bạn.

Danh mục

Danh mục mô tả về doanh nghiệp này (chứ không phải hoạt động của doanh nghiệp). Để xem danh sách mã danh mục hợp lệ và mối liên kết với tên mà con người có thể đọc được, hãy xem categories.list.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "displayName": string,
  "serviceTypes": [
    {
      object (ServiceType)
    }
  ],
  "moreHoursTypes": [
    {
      object (MoreHoursType)
    }
  ]
}
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í).
displayName

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 vị trí. Khi sửa đổi vị trí, bạn phải đặt category_id.
serviceTypes[]

object (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 kinh doanh này.
moreHoursTypes[]

object (MoreHoursType)

Chỉ có đầu ra. Các loại giờ khác có sẵn cho danh mục kinh doanh này.

ServiceType

Tin nhắn mô tả loại dịch vụ mà doanh nghiệp cung cấp.

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

string

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

string

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

MoreHoursType

Các loại giờ khác mà một doanh nghiệp có thể cung cấp, ngoài giờ hoạt động thông thường.

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

string

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

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

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

BusinessHours

Cho biết khoảng thời gian mà địa điểm này mở cửa hoạt động. Chứa một tập hợp các thực thể [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod].

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

object (TimePeriod)

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

TimePeriod

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

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

enum (DayOfWeek)

Bắt buộc. Cho biết day of the week mà khoảng thời gian này bắt đầu.
openTime

object (TimeOfDay)

Bắt buộc. Giá trị hợp lệ là từ 00:00 đến 24:00, trong đó 24:00 là nửa đêm vào cuối trường ngày được chỉ định. Lưu ý: Trong mối liên kết JSON Proto3, các giá trị 0 mặc định (00:00) sẽ bị bỏ qua, tạo ra {} cho openTime.
closeDay

enum (DayOfWeek)

Bắt buộc. Cho biết day of the week mà giai đoạn này kết thúc.
closeTime

object (TimeOfDay)

Bắt buộc. Giá trị hợp lệ là từ 00:00 đến 24:00, trong đó 24:00 là nửa đêm vào cuối trường ngày được chỉ định. Lưu ý: Trong mối liên kết JSON Proto3, các giá trị 0 mặc định (00:00) sẽ bị bỏ qua, tạo ra {} cho closeTime.

SpecialHours

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

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

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

SpecialHourPeriod

Đại diện cho một khoảng thời gian duy nhất khi giờ hoạt động của một địa điểm khác với giờ hoạt động thông thường. Một khoảng giờ đặc biệt phải đại diện cho một phạm vi dưới 24 giờ. openTime và startDate phải có trước closeTime và endDate. closeTime và endDate có thể kéo dài đến 11:59 sáng ngày sau startDate được chỉ định. Ví dụ: các giá trị đầ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

Thông tin đầu vào 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": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "closeTime": {
    object (TimeOfDay)
  },
  "closed": boolean
}
Trường
startDate

object (Date)

Bắt buộc. Ngày theo lịch mà khoảng thời gian đặc biệt này bắt đầu.
openTime

object (TimeOfDay)

Không bắt buộc. Giá trị hợp lệ là 00:00-24:00, trong đó 24:00 là nửa đêm vào cuối ngày được chỉ định. Phải được chỉ định nếu closed là false.
endDate

object (Date)

Không bắt buộc. Ngày theo lịch mà khoảng thời gian đặc biệt này kết thúc. Nếu bạn không đặt trường endDate, thì ngày 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 muộn hơn startDate tối đa 1 ngày.
closeTime

object (TimeOfDay)

Không bắt buộc. Giá trị hợp lệ là 00:00-24:00, trong đó 24:00 là nửa đêm vào cuối trường ngày được chỉ định. Phải được chỉ định nếu closed là false.
closed

boolean

Không bắt buộc. Nếu đúng, endDate, openTime và closeTime sẽ bị bỏ qua và ngày được chỉ định trong startDate sẽ được coi là ngày địa điểm đóng cửa cả ngày.

ServiceAreaBusiness

Doanh nghiệp phục vụ tận nơi 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),
  "places": {
    object (Places)
  },
  "regionCode": string
}
Trường
businessType

enum (BusinessType)

Bắt buộc. Cho biết [loại] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] của doanh nghiệp phục vụ tận nơi.
places

object (Places)

Không bắt buộc. 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.
regionCode

string

Không thể thay đổi. Mã vùng CLDR của quốc gia/khu vực nơi doanh nghiệp cung cấp dịch vụ tại cơ sở khách hàng này đặt trụ sở. Hãy xem 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 trong các trường hợp khác.

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

Nếu địa điểm này cần được 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 uỷ quyền của họ phải có thể nhận thư bưu chính tại địa chỉ xác minh được cung cấp.

BusinessType

Cho biết 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ả địa chỉ của doanh nghiệp và địa điểm của khách hàng (ví dụ: cửa hàng pizza có khu vực ăn uống và cũng 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ụ ở khu vực lân cận (không cung cấp 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 storefrontAddress 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.

Địa điểm

Xác định tập hợp các khu vực được đại diện bởi một nhóm địa điểm.

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

object (PlaceInfo)

Không bắt buộ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ã địa điểm.

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

string

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

string

Bắt buộc. Mã nhận dạng 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)

AdWordsLocationExtensions

Thông tin bổ sung được hiển thị trong AdWords.

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

string

Bắt buộc. Số điện thoại thay thế để hiển thị trên phần mở rộng về địa điểm của 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 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)

Bắt buộc. Cho biết Địa điểm có đang hoạt động hay không. Theo mặc định, tất cả các địa điểm đều mở cửa, trừ phi được cập nhật là đã đó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ở cửa lại hay không.
openingDate

object (Date)

Không bắt buộc. Ngày địa điểm này khai trương lần đầu. Nếu không biết chính xác ngày, bạn chỉ cần 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 chỉ định.
OPEN Cho biết địa điểm đang mở cửa.
CLOSED_PERMANENTLY Cho biết vị trí đã đóng cửa vĩnh viễn.
CLOSED_TEMPORARILY Cho biết địa điểm đã tạm thời đóng cửa.

Metadata

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

Biểu diễn dưới dạng JSON 
{
  "hasGoogleUpdated": boolean,
  "hasPendingEdits": boolean,
  "canDelete": boolean,
  "canOperateLocalPost": boolean,
  "canModifyServiceList": boolean,
  "canHaveFoodMenus": boolean,
  "canOperateHealthData": boolean,
  "canOperateLodgingData": boolean,
  "placeId": string,
  "duplicateLocation": string,
  "mapsUri": string,
  "newReviewUri": string,
  "canHaveBusinessCalls": boolean,
  "hasVoiceOfMerchant": boolean,
  "isParticularlyPersonalPlace": boolean
}
Trường
hasGoogleUpdated

boolean

Chỉ có đầu ra. Cho biết mã địa điểm liên kết với vị trí này có nội dung cập nhật cần được khách hàng cập nhật hoặc từ chối hay không. Nếu boolean này được đặt, bạn nên gọi phương thức getGoogleUpdated để tra cứu thông tin cần xác minh.
hasPendingEdits

boolean

Chỉ có đầu ra. Cho biết liệu có thuộc tính nào của Địa điểm này đang ở trạng thái chờ chỉnh sửa hay không.
canDelete

boolean

Chỉ có đầu ra. Cho biết liệu có thể xoá vị trí bằng API hay không.
canOperateLocalPost
(deprecated)

boolean

Chỉ có đầu ra. Không dùng nữa: Trường này không còn được điền sẵn và sẽ bị xoá trong phiên bản sau này.
canModifyServiceList

boolean

Chỉ có đầu ra. Cho biết liệu trang thông tin có thể sửa đổi 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 sử dụng thực đơn món ăn 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 Chỗ lưu trú hay không.
placeId

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 của vị trí đó. Bạn có thể dùng mã nhận dạng này trong nhiều Places API.

Bạn có thể đặt trường này trong lệnh gọi Tạo, nhưng không thể đặt trong lệnh gọi Cập nhật.
duplicateLocation

string

Chỉ có đầu ra. Tài nguyên vị trí mà vị trí này sao chép.
mapsUri

string

Chỉ có đầu ra. Đường liên kết đến vị trí trên Maps.
newReviewUri

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á cho địa điểm.
canHaveBusinessCalls

boolean

Chỉ có đầu ra. Cho biết liệu trang thông tin có đủ điều kiện sử dụng tính năng cuộc gọi đến doanh nghiệp hay không.
hasVoiceOfMerchant

boolean

Chỉ có đầu ra. Cho biết trang thông tin có Ý kiến của người bán hay không. Nếu giá trị boolean này là false, bạn nên gọi API locations.getVoiceOfMerchantState để biết thông tin chi tiết về lý do họ không có Voice of Merchant.
isParticularlyPersonalPlace

boolean

Chỉ có đầu ra. Cho biết liệu vị trí đó có được phân loại là địa điểm đặc biệt riêng tư hay không. Điều này có nghĩa là các tính năng của Nhật ký vị trí sẽ bị hạn chế. Nếu bạn cho rằng đây là một sự nhầm lẫn, hãy xem bài viết này trên Trung tâm trợ giúp.

Hồ sơ

Tất cả thông tin liên quan đến hồ sơ của địa điểm.

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

string

Bắt buộc. Nội dung mô tả về địa điểm bằng giọng nói của riêng bạn, không ai khác có thể chỉnh sửa.

RelationshipData

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

Biểu diễn dưới dạng JSON 
{
  "parentLocation": {
    object (RelevantLocation)
  },
  "childrenLocations": [
    {
      object (RelevantLocation)
    }
  ],
  "parentChain": string
}
Trường
parentLocation

object (RelevantLocation)

Không bắt buộc. Vị trí gốc mà vị trí này có mối quan hệ.
childrenLocations[]

object (RelevantLocation)

Không bắt buộc. Danh sách các vị trí con mà vị trí này có mối quan hệ.
parentChain

string

Không bắt buộc. Tên tài nguyên của Chuỗi mà địa điểm này là thành viên. [Cách tìm mã chuỗi] [Locations.SearchChains]

RelevantLocation

Thông tin về một vị trí khác có liên quan đến vị trí hiện tại. Mối quan hệ có thể là DEPARTMENT_OF hoặc INDEPENDENT_ESTABLISHMENT_OF và địa điểm được chỉ định ở đây có thể là địa điểm mẹ hoặc địa điểm con.

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

string

Bắt buộc. Chỉ định vị trí ở phía bên kia của mối quan hệ bằng mã địa điểm của vị trí đó.
relationType

enum (RelationType)

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

RelationType

Mối quan hệ về loại cần chỉ định.

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

MoreHours

Khoảng thời gian mà một địa điểm mở cửa cho một số loại hình doanh nghiệp 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 danh mục của địa điểm.
periods[]

object (TimePeriod)

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

ServiceItem

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

Biểu diễn dưới dạng JSON 
{
  "price": {
    object (Money)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "structuredServiceItem": {
    object (StructuredServiceItem)
  },
  "freeFormServiceItem": {
    object (FreeFormServiceItem)
  }
  // End of mutually exclusive fields.
}
Trường
price

object (Money)

Không bắt buộc. Đại diện cho giá trị bằng tiền của mặt hàng dịch vụ. Bạn nên đặt currencyCode và units khi thêm giá. Giá này sẽ được coi là giá cố định cho mặt hàng dịch vụ.
Bạn phải luôn đặt một trong các trường sau. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
structuredServiceItem

object (StructuredServiceItem)

Không bắt buộc. Trường này sẽ được đặt trong trường hợp dữ liệu dịch vụ có cấu trúc.
freeFormServiceItem

object (FreeFormServiceItem)

Không bắt buộc. Trường này sẽ được đặt trong trường hợp dữ liệu dịch vụ ở dạng tuỳ ý.
Kết thúc các trường loại trừ lẫn nhau.

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

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

string

Bắt buộc. Trường serviceTypeId là mã nhận dạng duy nhất do Google cung cấp, 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 ký tự là 300.

FreeFormServiceItem

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

Biểu diễn dưới dạng JSON 
{
  "category": string,
  "label": {
    object (Label)
  }
}
Trường
category

string

Bắt buộc. Trường này thể hiện tên danh mục (tức là mã nhận dạng ổn định của danh mục). category và serviceTypeId phải khớp với các kiểu kết hợp có thể có được cung cấp trong thông báo Category.
label

object (Label)

Bắt buộc. Nhãn được gắn thẻ ngôn ngữ cho mặt hàng. Bạn nên đặt tên mặt hàng có tối đa 140 ký tự và nội dung mô tả có tối đa 250 ký tự. Bạn chỉ nên đặt trường này nếu thông tin đầu vào là một mục dịch vụ tuỳ chỉnh. Bạn nên cập nhật các loại dịch vụ được chuẩn hoá bằng serviceTypeId.

Hãng nhạc

Nhãn dùng khi hiển thị bảng giá, mục 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 bảng giá, mục hoặc mặt hàng.
description

string

Không bắt buộc. Nội dung mô tả về 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 nhóm nhãn cho mỗi ngôn ngữ.

Phương thức

create

 Tạo một Địa điểm mới thuộc quyền sở hữu của người dùng đã đăng nhập.

list

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