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 ( |
Các trường | |
---|---|
name |
Giá trị nhận dạng của Google cho vị trí này ở dạng: |
languageCode |
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 |
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 |
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ụ: |
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 |
Không bắt buộc. Các danh mục khác nhau mô tả doanh nghiệp. |
storefrontAddress |
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ị |
websiteUri |
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 |
Không bắt buộc. Giờ làm việc của doanh nghiệp. |
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 |
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[] |
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 |
Không bắt buộc. Thông tin bổ sung xuất hiện trong AdWords. |
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ị |
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 |
Chỉ có đầu ra. Thông tin bổ sung mà người dùng không thể chỉnh sửa. |
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 |
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[] |
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[] |
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 |
|
---|---|
|
Xoá vị trí. |
|
Trả về vị trí đã chỉ định. |
|
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ể. |
|
Nhận phiên bản do Google cập nhật của vị trí đã chỉ định. |
|
Cập nhật vị trí đã chỉ định. |
|
Cập nhật các thuộc tính cho một vị trí cụ thể. |