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 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,
  "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 của Google cho vị trí này trong biểu mẫu: locations/{locationId}.

languageCode

string

Bất biến. 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

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

title

string

Bắt buộc. 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").

phoneNumbers

object (PhoneNumbers)

Không bắt buộc. Các 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 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ư đặ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ỉ. Bạn chỉ nên đặt trường này cho những doanh nghiệp có mặt tiền cửa hàng. Không được đặt trường này cho các vị trí thuộc loại CUSTOMER_LOCATION_ONLY nhưng nếu bạn đặt trường này, mọi giá trị được 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 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)

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 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. Bạn 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. 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.

labels[]

string

Không bắt buộc. 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. Phải có từ 1-255 ký tự cho 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 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 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 vị trí hiện có đang 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 chỉnh sửa được.

profile

object (Profile)

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

Trường này là bắt buộc đối với tất cả cá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ờ khác cho các phòng ban hoặc khách hàng cụ thể của một 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 mục dịch vụ trùng lặp sẽ tự động được xoá.

Phương thức

delete

Xoá một vị trí.

get

Trả về vị trí được chỉ định.

getAttributes

Tra cứu tất cả thuộc tính được thiết lập cho 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.

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í cụ thể.