REST Resource: 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,
  "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)
    }
  ]
}
Các trường
name

string

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 vị trí. Đượ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 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").
phoneNumbers

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

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. 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ỉ. 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ỏ.
websiteUri

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

object (BusinessHours)

Không bắt buộc. Giờ làm việc của doanh nghiệp.
specialHours

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

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

object (AdWordsLocationExtensions)

Không bắt buộc. Thông tin bổ sung xuất hiện 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 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.
openInfo

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

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

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

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

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

Phương thức

delete

 Xoá vị trí.

get

 Trả về vị trí đã chỉ định.

getAttributes

 Tìm kiếm tất cả các thuộc tính được thiết lập cho 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.

patch

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

updateAttributes

 Cập nhật các thuộc tính cho một vị trí cụ thể.