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

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 trong phần (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. Là số điện thoại kết nối trực tiếp nhất có thể với địa điểm kinh doanh riêng của bạn. Nếu có thể, hãy sử dụng số điện thoại tại địa phương thay vì số đường dây hỗ trợ của trung tâm chăm sóc khách hàng.
additionalPhones[]

string

Không bắt buộc. Ngoài số điện thoại chính, bạn có thể sử dụng tối đa 2 số điện thoại (di động hoặc cố định, không được là số fax) để gọi cho doanh nghiệp của mình.

Loại

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. Ứng dụng không được phép cập nhật riêng 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ả đúng nhất về 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, cụ thể cho dịch vụ mà họ quan tâm. Để thông tin doanh nghiệp của bạn luôn chính xác và cập nhật, hãy đảm bảo rằng bạn 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 mình. Chọn danh mục càng cụ thể càng tốt, nhưng đại diện cho công việc kinh doanh chính của bạn.

Danh mục

Danh mục mô tả doanh nghiệp này là gì (không phải doanh nghiệp hoạt động ở đâu). Để biết danh sách mã danh mục hợp lệ và dữ liệu ánh xạ đến 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ã ổn định (do Google cung cấp) cho danh mục này. Giá trị phải được chỉ định 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. Tuỳ chọn 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

Thông báo 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ã ổ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

Ngoài giờ làm việc thông thường, doanh nghiệp có thể cung cấp các loại giờ khác.

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

string

Chỉ có đầu ra. Mã ổ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ờ.

PostalAddress (Địa chỉ bưu điện)

Đại diện cho địa chỉ bưu chính, ví dụ: cho địa chỉ giao hàng qua bưu điện hoặc địa chỉ thanh toán. Khi có địa chỉ bưu chính, dịch vụ bưu chính có thể giao hàng đến trụ sở là P.O. Hộp hoặc thứ tự tương tự. Tính năng này không nhằm lập mô hình vị trí địa lý (đường, thị trấn, núi).

Trong cách sử dụng thông thường, một địa chỉ sẽ được tạo thông qua hoạt động đầu vào của người dùng hoặc từ việc nhập dữ liệu hiện có, tuỳ thuộc vào loại quy trình.

Lời khuyên về việc nhập / chỉnh sửa địa chỉ: – Sử dụng tiện ích địa chỉ sẵn sàng quốc tế hoá, chẳng hạn như https://github.com/google/libaddressinput) – Không nên cung cấp cho người dùng các phần tử trên giao diện người dùng để nhập hoặc chỉnh sửa các trường ở bên ngoài quốc gia sử dụng trường đó.

Để biết thêm hướng dẫn về cách sử dụng giản đồ này, vui lòng xem: https://support.google.com/business/answer/6397478

Biểu diễn dưới dạng JSON 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
Trường
revision

integer

Bản sửa đổi giản đồ của PostalAddress. Giá trị này phải được đặt thành 0, đây là bản sửa đổi mới nhất.

Tất cả các bản sửa đổi mới phải tương thích ngược với các bản sửa đổi cũ.
regionCode

string

Bắt buộc. Mã vùng CLDR của quốc gia/khu vực trong địa chỉ. Điều này không bao giờ được dự đoán và việc đảm bảo giá trị chính xác là tuỳ thuộc vào người dùng. Hãy tham khảo https://cldr.unicode.org/ và https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html để biết thông tin chi tiết. Ví dụ: "CH" cho Thuỵ Sĩ.
languageCode

string

Không bắt buộc. Mã ngôn ngữ BCP-47 của nội dung địa chỉ này (nếu biết). Đây thường là ngôn ngữ giao diện người dùng của biểu mẫu nhập hoặc được yêu cầu khớp với một trong các ngôn ngữ được sử dụng trong địa chỉ quốc gia/khu vực hoặc từ tương đương được chuyển tự của chúng. Điều này có thể ảnh hưởng đến việc định dạng ở một số quốc gia nhất định, nhưng không quan trọng đối với độ chính xác của dữ liệu và sẽ không bao giờ ảnh hưởng đến bất kỳ hoạt động xác thực hoặc hoạt động nào khác không liên quan đến việc định dạng.

Nếu không biết giá trị này, bạn nên bỏ qua giá trị này (thay vì chỉ định giá trị mặc định có thể không chính xác).

Ví dụ: "zh-Hant", "ja", "ja-Latn", "en".
postalCode

string

Không bắt buộc. Mã bưu chính của địa chỉ. Không phải quốc gia nào cũng sử dụng hoặc yêu cầu mã bưu chính phải xuất hiện, nhưng ở Hoa Kỳ, các quốc gia đó có thể kích hoạt quy trình xác thực bổ sung với các phần khác của địa chỉ (ví dụ: xác thực tiểu bang/mã bưu chính tại Hoa Kỳ).
sortingCode

string

Không bắt buộc. Mã phân loại bổ sung, theo quốc gia cụ thể. Thông tin này không được sử dụng ở hầu hết các khu vực. Khi giá trị được sử dụng, giá trị phải là một chuỗi như "CEDEX", có thể theo sau là một số (ví dụ: "CEDEX 7") hoặc chỉ một số, đại diện cho "mã lĩnh vực" (Jamaica), "chỉ báo khu vực giao hàng" (Malawi) hoặc "chỉ báo tại bưu điện" (ví dụ: Bờ Biển Ngà).
administrativeArea

string

Không bắt buộc. Phân khu hành chính cao nhất dùng cho địa chỉ bưu chính của một quốc gia hoặc khu vực. Ví dụ: bạn có thể nhập một tiểu bang, một tỉnh, một vùng hoặc một tỉnh. Cụ thể, đối với Tây Ban Nha, đây là tỉnh và không phải là cộng đồng tự trị (ví dụ: "Barcelona" chứ không phải "Catalonia"). Nhiều quốc gia không sử dụng khu vực hành chính trong địa chỉ bưu điện. Ví dụ: ở Thuỵ Sĩ thì không nên điền giá trị này.
locality

string

Không bắt buộc. Nói chung là phần thành phố/thị trấn của địa chỉ. Ví dụ: Thành phố ở Hoa Kỳ, xã CNTT, thị trấn có bưu điện của Vương quốc Anh. Trong các khu vực trên thế giới nơi các địa phương không được xác định rõ hoặc không phù hợp với cấu trúc này, hãy để trống địa phương và sử dụng addressLines.
sublocality

string

Không bắt buộc. Quận/phường của địa chỉ. Ví dụ: đây có thể là vùng lân cận, thị xã, quận.
addressLines[]

string

Dòng địa chỉ phi cấu trúc mô tả các cấp thấp hơn của một địa chỉ.

Do các giá trị trong addressLines không có thông tin về loại và đôi khi có thể chứa nhiều giá trị trong một trường (ví dụ: "Austin, TX"), điều quan trọng là thứ tự dòng phải rõ ràng. Thứ tự của các dòng địa chỉ phải là "thứ tự phong bì" cho quốc gia/khu vực trong địa chỉ. Ở những nơi giá trị này có thể thay đổi (ví dụ: Nhật Bản), address_language được sử dụng để thể hiện rõ ràng (ví dụ: "ja" cho thứ tự từ lớn đến nhỏ và "ja-Latn" hoặc "en" cho từ nhỏ đến lớn). Bằng cách này, dòng địa chỉ cụ thể nhất có thể được chọn dựa trên ngôn ngữ.

Cách biểu diễn cấu trúc tối thiểu được phép của một địa chỉ bao gồm một Mã vùng với tất cả thông tin còn lại được đặt trong Dòng địa chỉ. Có thể định dạng một địa chỉ như vậy gần như mà không cần mã hoá địa lý, nhưng không thể lập luận ngữ nghĩa về bất kỳ thành phần địa chỉ nào cho đến khi địa chỉ đó được giải quyết ít nhất một phần.

Tạo một địa chỉ chỉ chứa mã vùng và addressLines, sau đó mã hóa địa lý là cách được khuyến nghị để xử lý các địa chỉ hoàn toàn không có cấu trúc (trái ngược với việc đoán phần nào của địa chỉ sẽ là địa phương hoặc khu vực hành chính).
recipients[]

string

Không bắt buộc. Người nhận tại địa chỉ. Trong một số trường hợp nhất định, trường này có thể chứa thông tin nhiều dòng. Ví dụ: thẻ có thể chứa từ "chăm sóc" của bạn.
organization

string

Không bắt buộc. Tên của tổ chức tại địa chỉ.

BusinessHours

Thể hiện khoảng thời gian vị trí này mở cửa hoạt động. Lưu trữ một tập hợp các phiên bản [TimePeriod][google.lưới.đảm bảo thông tin.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 thời gian vị trí này mở cửa hoạt động. Mỗi khoảng thời gian biểu thị một khoảng giờ khi vị trí mở cửa trong tuần.

TimePeriod

Thể hiện khoảng thời gian mà doanh nghiệp mở cửa, bắt đầu vào ngày/giờ mở cửa được chỉ định và đóng cửa vào ngày/giờ đóng cửa được chỉ định. Thời gian đóng cửa phải sau thời gian mở cửa, ví dụ như muộn hơn trong cùng một 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 thời gian day of the week bắt đầu của khoảng thời gian này.
openTime

object (TimeOfDay)

Bắt buộc. Giá trị hợp lệ là 00:00-24:00, trong đó 24:00 thể hiện nửa đêm ở cuối trường ngày được chỉ định.
closeDay

enum (DayOfWeek)

Bắt buộc. Cho biết thời gian này sẽ kết thúc vào day of the week.
closeTime

object (TimeOfDay)

Bắt buộc. Giá trị hợp lệ là 00:00-24:00, trong đó 24:00 thể hiện nửa đêm ở cuối trường ngày được chỉ định.

DayOfWeek

Đại diện cho một ngày trong tuần.

Enum
DAY_OF_WEEK_UNSPECIFIED Ngày trong tuần không được chỉ định.
MONDAY Thứ Hai
TUESDAY Tuesday (thứ Ba)
WEDNESDAY Wednesday (thứ Tư)
THURSDAY Thursday (thứ Năm)
FRIDAY Friday (thứ Sáu)
SATURDAY Saturday (thứ Bảy)
SUNDAY Chủ Nhật

TimeOfDay

Đại diện cho thời gian trong ngày. Ngày và múi giờ không quan trọng hoặc được chỉ định ở nơi khác. API có thể chọn cho phép giây nhuận. Các loại có liên quan là google.type.Date và google.protobuf.Timestamp.

Biểu diễn dưới dạng JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Trường
hours

integer

Giờ trong ngày ở định dạng 24 giờ. Nên ở từ 0 đến 23. Một API có thể chọn cho phép giá trị "24:00:00" cho các tình huống như thời gian đóng cửa doanh nghiệp.
minutes

integer

Số phút trong ngày. Phải từ 0 đến 59.
seconds

integer

Số giây của thời gian. Giá trị thường phải từ 0 đến 59. Một API có thể cho phép giá trị 60 nếu cho phép bật-giây.
nanos

integer

Các phân số của giây tính bằng nano giây. Giá trị phải nằm trong khoảng từ 0 đến 999.999.999.

SpecialHours

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

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ờ làm việc thông thường của doanh nghiệp.

SpecialHourPeriod

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

Các giá trị nhập 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 cho khoảng thời gian đặc biệt này.
openTime

object (TimeOfDay)

Không bắt buộc. Giá trị hợp lệ là 00:00-24:00 trong đó 24:00 thể hiện nửa đêm ở cuối trường ngày được chỉ định. Bạn phải chỉ định giá trị này nếu closed là false.
endDate

object (Date)

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

object (TimeOfDay)

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

boolean

Không bắt buộc. Nếu giá trị là true, thì endDate, openTime và closeTime sẽ bị bỏ qua và ngày được chỉ định trong startDate được coi là vị trí đóng cửa cả ngày.

Ngày

Đại diện cho toàn bộ hoặc một phần ngày theo lịch, chẳng hạn như ngày sinh nhật. Thời gian trong ngày và múi giờ được chỉ định ở nơi khác hoặc không đáng kể. Ngày này có liên quan đến Lịch Gregory. Thông tin này có thể là một trong những trường hợp sau:

  • Ngày đầy đủ, với các giá trị năm, tháng và ngày khác 0.
  • Tháng và ngày, thể hiện giá trị năm 0 (ví dụ: ngày kỷ niệm).
  • Một năm riêng biệt, tháng không tháng và ngày không tháng.
  • Năm và tháng, không có ngày (ví dụ: ngày hết hạn thẻ tín dụng).

Các loại có liên quan:

Biểu diễn dưới dạng JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Trường
year

integer

Năm của ngày. Giá trị phải từ 1 đến 9999 hoặc bằng 0 để chỉ định ngày không có năm.
month

integer

Tháng trong năm. Giá trị phải từ 1 đến 12 hoặc bằng 0 để chỉ định một năm không có tháng và ngày.
day

integer

Ngày trong tháng. Phải có giá trị từ 1 đến 31 và có giá trị hợp lệ trong năm và tháng, hoặc bằng 0 để chỉ định một năm độc lập hoặc là một năm và tháng mà ngày không quan trọng.

ServiceAreaBusiness

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 (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 [type] [google.hl=vi
places

object (Places)

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

Bất biến. Mã vùng CLDR của quốc gia/khu vực nơi doanh nghiệp hoạt động trong khu vực kinh doanh này đặt trụ sở. Hãy tham khảo 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à sẽ bị bỏ qua nếu không.

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

Nếu địa điểm này yêu cầu 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ư qua đường bưu điện theo địa chỉ xác minh đã cung cấp.

BusinessType

Cho biết doanh nghiệp này chỉ cung cấp dịch vụ tại chỗ tại vị trí của khách hàng (ví dụ: xe kéo) hay tại cả địa chỉ và tại chỗ (ví dụ: cửa hàng pizza có khu vực ăn uống và đồng thời 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ụ trong khu vực xung quanh (không phải tại địa chỉ doanh nghiệp). Nếu một doanh nghiệp đượ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à để trường trống.
CUSTOMER_AND_BUSINESS_LOCATION Cung cấp dịch vụ tại địa chỉ doanh nghiệp và khu vực xung quanh.

Địa điểm

Xác định sự kết hợp của các khu vực được biểu thị bằng một tập hợp địa điểm.

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

object (PlaceInfo)

Cá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ột 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ã 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 xuất hiện 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 tiện ích vị trí AdWords thay vì số điện thoại chính của vị trí.

LatLng

Đối tượng đại diện cho cặp vĩ độ/kinh độ. Giá trị này được biểu thị bằng cặp số đại diện cho vĩ độ và độ kinh độ. Trừ phi có quy định khác, đối tượng này phải tuân thủ tiêu chuẩn WGS84. Giá trị phải nằm trong phạm vi chuẩn hoá.

Biểu diễn dưới dạng JSON 
{
  "latitude": number,
  "longitude": number
}
Trường
latitude

number

Vĩ độ tính bằng độ. Giá trị này phải nằm trong khoảng [-90.0, +90.0].
longitude

number

Kinh độ tính bằng độ. Giá trị này phải nằm trong khoảng [-180.0, +180.0].

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 Vị trí hiện có đang mở cửa kinh doanh hay không. Tất cả các vị trí đều mở cửa theo mặc định, trừ phi bạn cập nhật thành đóng cửa.
canReopen

boolean

Chỉ có đầu ra. Cho biết 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 vị trí mở cửa lần đầu tiên. Nếu không xác định được ngày chính xác, bạn chỉ có thể cung cấp tháng và năm. Ngày này phải trong quá khứ hoặc không quá 1 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 vị trí đang mở cửa.
CLOSED_PERMANENTLY Cho biết vị trí đã bị đóng cửa vĩnh viễn.
CLOSED_TEMPORARILY Cho biết địa điểm này đã tạm thời đóng cửa.

Metadata

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

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
}
Trường
hasGoogleUpdated

boolean

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

boolean

Chỉ có đầu ra. Cho biết liệu có bất kỳ cơ sở lưu trú nào của Vị trí này đang ở trạng thái đang chờ chỉnh sửa hay không.
canDelete

boolean

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

boolean

Chỉ có đầu ra. Cho biết liệu trang thông tin có thể quản lý bài đăng tại địa phương hay không.
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 dùng thực đơn đồ ăn hay không.
canOperateHealthData

boolean

Chỉ có đầu ra. Cho biết liệu vị trí có thể hoạt động dựa 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 về Cơ sở 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, trường này sẽ được điền mã địa điểm cho vị trí. Mã này có thể dùng trong nhiều Places API.

Bạn có thể đặt trường này trong khi thực hiện lệnh gọi Tạo, nhưng không thể đặt trường này khi 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 để khách hàng có thể viết bài đánh giá về vị trí đó.
canHaveBusinessCalls

boolean

Chỉ có đầu ra. Cho biết liệu trang thông tin có đủ điều kiện gọi điện đến doanh nghiệp hay không.
hasVoiceOfMerchant

boolean

Chỉ có đầu ra. Cho biết liệu trang thông tin có tính năng Voice 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ó tính năng Voice of Merchant.

Hồ sơ

Tất cả thông tin liên quan đến hồ sơ của vị trí.

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ị trí bằng giọng của bạn, không ai khác có thể chỉnh sửa được.

RelationshipData

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

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

object (RelevantLocation)

Vị trí gốc mà vị trí này có liên quan.
childrenLocations[]

object (RelevantLocation)

Danh sách các vị trí con mà vị trí này có liên quan.
parentChain

string

Tên tài nguyên của Chuỗi mà vị trí 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à bất kỳ một trong số DEPARTMENT_OF hoặc INDEPENDENT_ESTABLISHMENT_OF và vị trí được chỉ định ở đây có thể ở một trong hai phía (gốc/con) của vị trí đó.

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ệ theo locationID (mã vị trí).
relationType

enum (RelationType)

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

RelationType

Các quan hệ kiểu dữ liệu sẽ được chỉ định.

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

MoreHours

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

object (TimePeriod)

Bắt buộc. Tập hợp thời gian vị trí này mở cửa. Mỗi khoảng thời gian biểu thị một khoảng giờ khi vị trí mở cửa trong tuần.

ServiceItem

Thông báo mô tả một hạng 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)
  },

  // Union field service_item_info can be only one of the following:
  "structuredServiceItem": {
    object (StructuredServiceItem)
  },
  "freeFormServiceItem": {
    object (FreeFormServiceItem)
  }
  // End of list of possible types for union field service_item_info.
}
Trường
price

object (Money)

Không bắt buộc. Đại diện cho giá tiền của mục dịch vụ. Bạn nên thiết lập CurrencyCode và đơn vị khi thêm giá. Đây sẽ được coi là giá cố định cho mặt hàng dịch vụ.
Trường kết hợp service_item_info. Bạn phải luôn đặt một trong các trường sau đây. service_item_info chỉ có thể là một trong những trạng thái sau đây:
structuredServiceItem

object (StructuredServiceItem)

Không bắt buộc. Trường này sẽ là trường hợp của 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 thành trường hợp dữ liệu dịch vụ dạng tự do.

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ụ: chế độ cài đặt nhà vệ sinh.

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ột mã nhận dạng duy nhất do Google cung cấp có trong ServiceType. Thông tin này do dịch vụ rpc categories.batchGet cung cấp.
description

string

Không bắt buộc. Nội dung mô tả mục dịch vụ có cấu trúc. Giới hạn là 300 ký tự.

FreeFormServiceItem

Đại diện cho 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 cung cấp trong dữ liệu dịch vụ về cấu trúc của chúng tôi. Người bán tự nhập tên cho các dịch vụ đó thông qua nền tảng của người bán theo đị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ã ổn định của danh mục). category và serviceTypeId phải khớp với các 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ục này. Tên mặt hàng không nên dài quá 140 ký tự và nội dung mô tả không được dài quá 250 ký tự. Bạn chỉ nên đặt trường này nếu dữ liệu đầu vào là một mục dịch vụ tuỳ chỉnh. Các loại dịch vụ được chuẩn hoá phải được cập nhật thông qua serviceTypeId.

Hãng nhạc

Nhãn được dùng khi đăng bảng giá, mục giá 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 danh sách giá, mục hoặc mặt hàng.
description

string

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

Tiền

Đại diện cho số tiền kèm theo loại đơn vị tiền tệ.

Biểu diễn dưới dạng JSON 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Trường
currencyCode

string

Mã đơn vị tiền tệ gồm ba chữ cái được xác định trong ISO 4217.
units

string (int64 format)

Toàn bộ đơn vị của số tiền. Ví dụ: nếu currencyCode là "USD", thì 1 đơn vị sẽ là 1 đô la Mỹ.
nanos

integer

Số lượng nano (10^-9) đơn vị của lượng. Giá trị phải nằm trong khoảng từ -999.999.999 đến +999.999.999. Nếu units là số dương thì nanos phải có giá trị dương hoặc 0. Nếu units bằng 0, nanos có thể là số dương, 0 hoặc số âm. Nếu units là số âm thì nanos phải có giá trị âm hoặc 0. Ví dụ: $-1,75 được biểu thị dưới dạng units=-1 và nanos=-750.000.000.

Phương thức

create

 Tạo một Vị trí mới do người dùng đã đăng nhập sở hữu.

list

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