REST Resource: 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á.

Phương thức

delete

 Xoá một vị trí.

get

 Trả về vị trí được chỉ định theo lần thiết lập gần đây nhất của người bán.

getAttributes

 Truy xuất các thuộc tính cho một vị trí theo lần đặt gần đây nhất của người bán.

getGoogleUpdated

 Trả về vị trí được chỉ định như vị trí đó xuất hiện trực tiếp trên Google Maps và Tìm kiếm.

patch

 Cập nhật vị trí được chỉ định.

updateAttributes

 Cập nhật các thuộc tính cho một vị trí nhất định.