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

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 tại (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. Số điện thoại kết nối với địa điểm doanh nghiệp riêng của bạn trực tiếp nhất có thể. Nếu có thể, hãy dùng một số điện thoại ở địa phương thay vì số của đường dây trợ giúp thuộc tổng đài.
additionalPhones[]

string

Không bắt buộc. Tối đa 2 số điện thoại (di động hoặc cố định, không phải số fax) mà khách hàng có thể gọi đến doanh nghiệp của bạn, ngoài số điện thoại chính.

Danh mục

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

Danh mục

Danh mục mô tả về doanh nghiệp này (chứ không phải hoạt động của doanh nghiệp). Để xem danh sách mã danh mục hợp lệ và mối liên kết với 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ã nhận dạng ổn định (do Google cung cấp) cho danh mục này. Bạn phải chỉ định giá trị 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. Giá trị 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

Tin nhắn 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ã nhận dạng ổ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

Các loại giờ khác mà một doanh nghiệp có thể cung cấp, ngoài giờ hoạt động thông thường.

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

string

Chỉ có đầu ra. Mã nhận dạng ổ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

Đại diện cho địa chỉ bưu chính, chẳng hạn như địa chỉ giao hàng bưu chính hoặc địa chỉ thanh toán. Với địa chỉ bưu chính, dịch vụ bưu chính có thể giao hàng đến một cơ sở, hộp thư bưu điện hoặc địa điểm tương tự. Địa chỉ bưu chính không nhằm mục đích mô hình hoá các vị trí địa lý như đường, thị trấn hoặc núi.

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

Lời khuyên về cách nhập hoặc chỉnh sửa địa chỉ:

  • Sử dụng tiện ích địa chỉ sẵn sàng cho việc quốc tế hoá, chẳng hạn như https://github.com/google/libaddressinput.
  • Người dùng không được nhìn thấy 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 nơi trường đó được sử dụng.

Để biết thêm hướng dẫn về cách sử dụng giản đồ này, hãy 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. Bạn phải đặt giá trị này thành 0, tức 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 của địa chỉ. Giá trị này không bao giờ được suy luận và người dùng phải đảm bảo giá trị này là chính xác. Hãy xem 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 tại đị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 ngôn ngữ dự kiến khớp với một trong các ngôn ngữ được sử dụng ở quốc gia/khu vực của địa chỉ hoặc ngôn ngữ chuyển tự tương đương. Điều này có thể ảnh hưởng đến định dạng ở một số quốc gia, nhưng không ảnh hưởng đến tính 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 định dạng.

Nếu không biết giá trị này, bạn nên bỏ qua (thay vì chỉ định một 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, nhưng ở những quốc gia có sử dụng mã bưu chính, mã này 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 hoặc mã ZIP ở Hoa Kỳ).
sortingCode

string

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

string

Không bắt buộc. Phân khu hành chính cao nhất được dùng cho địa chỉ bưu chính của một quốc gia hoặc khu vực. Ví dụ: đây có thể là tiểu bang, tỉnh, tỉnh (oblast) hoặc tỉnh (prefecture). Đối với Tây Ban Nha, đây là tỉnh chứ không phải 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 chính. Ví dụ: ở Thuỵ Sĩ, bạn không nên điền thông tin này.
locality

string

Không bắt buộc. Thường là phần thành phố hoặc thị trấn của địa chỉ. Ví dụ: Thành phố ở Hoa Kỳ, xã ở Ý, thị trấn bưu chính ở Vương quốc Anh. Ở những khu vực trên thế giới mà đị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 locality và sử dụng addressLines.
sublocality

string

Không bắt buộc. Địa phương phụ của địa chỉ. Ví dụ: đây có thể là khu phố, quận hoặc huyện.
addressLines[]

string

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

Vì 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"), nên thứ tự dòng phải rõ ràng. Thứ tự của các dòng địa chỉ phải là "thứ tự trên phong bì" cho quốc gia hoặc khu vực của địa chỉ. Ở những nơi có thể thay đổi (ví dụ: Nhật Bản), address_language được 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 thứ tự từ nhỏ đến lớn). Bằng cách này, bạn có thể chọn dòng cụ thể nhất của địa chỉ dựa trên ngôn ngữ.

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

Bạn nên tạo một địa chỉ chỉ chứa regionCode và addressLines, sau đó mã hoá địa lý để xử lý các địa chỉ hoàn toàn không có cấu trúc (thay vì đoán xem phần nào của địa chỉ 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, trường này có thể chứa thông tin nhiều dòng. Ví dụ: địa chỉ này có thể chứa thông tin "nhờ chuyển".
organization

string

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

BusinessHours

Cho biết khoảng thời gian mà địa điểm này mở cửa hoạt động. Chứa một tập hợp các thực thể [TimePeriod][google.mybusiness.mybusinessinformation.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 các khoảng thời gian mà địa điểm này mở cửa hoạt động. Mỗi khoảng thời gian đại diện cho một khoảng giờ mà địa điểm mở cửa trong tuần.

TimePeriod

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

object (TimeOfDay)

Bắt buộc. Giá trị hợp lệ là từ 00:00 đến 24:00, trong đó 24:00 là nửa đêm vào cuối trường ngày được chỉ định. Lưu ý: Trong mối liên kết JSON Proto3, các giá trị 0 mặc định (00:00) sẽ bị bỏ qua, tạo ra {} cho openTime.
closeDay

enum (DayOfWeek)

Bắt buộc. Cho biết day of the week mà giai đoạn này kết thúc.
closeTime

object (TimeOfDay)

Bắt buộc. Giá trị hợp lệ là từ 00:00 đến 24:00, trong đó 24:00 là nửa đêm vào cuối trường ngày được chỉ định. Lưu ý: Trong mối liên kết JSON Proto3, các giá trị 0 mặc định (00:00) sẽ bị bỏ qua, tạo ra {} cho closeTime.

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 một thời điểm trong ngày. Ngày và múi giờ không quan trọng hoặc được chỉ định ở nơi khác. Một API có thể chọn cho phép giây nhuận. Các loại 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 theo định dạng 24 giờ. Phải lớn hơn hoặc bằng 0 và thường phải nhỏ hơn hoặc bằng 23. API có thể chọn cho phép giá trị "24:00:00" cho các trường hợp như giờ đóng cửa của doanh nghiệp.
minutes

integer

Số phút trong một giờ. Phải lớn hơn hoặc bằng 0 và nhỏ hơn hoặc bằng 59.
seconds

integer

Số giây trong một phút. Phải lớn hơn hoặc bằng 0 và thường phải nhỏ hơn hoặc bằng 59. API có thể cho phép giá trị 60 nếu cho phép giây nhuận.
nanos

integer

Phần giây, tính bằng nano giây. Phải lớn hơn hoặc bằng 0 và nhỏ hơn hoặc bằng 999.999.999.

SpecialHours

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

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ờ hoạt động thông thường của doanh nghiệp.

SpecialHourPeriod

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

Thông tin đầu vào 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 mà khoảng thời gian đặc biệt này bắt đầu.
openTime

object (TimeOfDay)

Không bắt buộc. Giá trị hợp lệ là 00:00-24:00, trong đó 24:00 là nửa đêm vào cuối ngày được chỉ định. Phải được chỉ định nếu closed là false.
endDate

object (Date)

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

object (TimeOfDay)

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

boolean

Không bắt buộc. Nếu đúng, endDate, openTime và closeTime sẽ bị bỏ qua và ngày được chỉ định trong startDate sẽ được coi là ngày địa điểm đóng cửa cả ngày.

Ngày

Biểu thị một ngày theo lịch (toàn bộ hoặc một phần), 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 quan trọng. Ngày này được tính theo Dương lịch. Điều này có thể đại diện cho một trong những trường hợp sau:

  • Ngày đầy đủ, có giá trị năm, tháng và ngày khác 0.
  • Tháng và ngày, với năm bằng 0 (ví dụ: ngày kỷ niệm).
  • Chỉ có năm, tháng và ngày đều là 0.
  • Năm và tháng, với ngày bằng 0 (ví dụ: ngày hết hạn của thẻ tín dụng).

Các loại 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. Phải từ 1 đến 9999 hoặc 0 để chỉ định ngày không có năm.
month

integer

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

integer

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

ServiceAreaBusiness

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 (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 [loại] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] của doanh nghiệp phục vụ tận nơi.
places

object (Places)

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

Không thể thay đổi. Mã vùng CLDR của quốc gia/khu vực nơi doanh nghiệp cung cấp dịch vụ tại cơ sở khách hàng này đặt trụ sở. Hãy xem 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à bị bỏ qua trong các trường hợp khác.

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

Nếu địa điểm này cần được 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ư bưu chính tại địa chỉ xác minh được cung cấp.

BusinessType

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

Địa điểm

Xác định tập hợp các khu vực được đại diện bởi một nhóm địa điểm.

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

object (PlaceInfo)

Không bắt buộ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ã đị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ã nhận dạng 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 được hiển thị 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 phần mở rộng về địa điểm của AdWords thay vì số điện thoại chính của địa điểm.

LatLng

Một đối tượng đại diện cho một cặp vĩ độ/kinh độ. Giá trị này được biểu thị dưới dạng một cặp số thực có độ chính xác gấp đôi để thể hiện độ 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 Địa điểm có đang hoạt động hay không. Theo mặc định, tất cả các địa điểm đều mở cửa, trừ phi được cập nhật là đã đóng cửa.
canReopen

boolean

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

Metadata

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

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,
  "isParticularlyPersonalPlace": boolean
}
Trường
hasGoogleUpdated

boolean

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

boolean

Chỉ có đầu ra. Cho biết liệu có thuộc tính nào của Địa điểm này đang ở trạng thái chờ chỉnh sửa hay không.
canDelete

boolean

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

boolean

Chỉ có đầu ra. Không dùng nữa: Trường này không còn được điền sẵn và sẽ bị xoá trong phiên bản sau này.
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 sử dụng thực đơn món ăn hay không.
canOperateHealthData

boolean

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

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

boolean

Chỉ có đầu ra. Cho biết liệu trang thông tin có đủ điều kiện sử dụng tính năng cuộc gọi đến doanh nghiệp hay không.
hasVoiceOfMerchant

boolean

Chỉ có đầu ra. Cho biết trang thông tin có Ý kiến 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ó Voice of Merchant.
isParticularlyPersonalPlace

boolean

Chỉ có đầu ra. Cho biết liệu vị trí đó có được phân loại là địa điểm đặc biệt riêng tư hay không. Điều này có nghĩa là các tính năng của Nhật ký vị trí sẽ bị hạn chế. Nếu bạn cho rằng đây là một sự nhầm lẫn, hãy xem bài viết này trên Trung tâm trợ giúp.

Hồ sơ

Tất cả thông tin liên quan đến hồ sơ của địa điểm.

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ề địa điểm bằng giọng nói của riêng bạn, không ai khác có thể chỉnh sửa.

RelationshipData

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

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

object (RelevantLocation)

Không bắt buộc. Vị trí gốc mà vị trí này có mối quan hệ.
childrenLocations[]

object (RelevantLocation)

Không bắt buộc. Danh sách các vị trí con mà vị trí này có mối quan hệ.
parentChain

string

Không bắt buộc. Tên tài nguyên của Chuỗi mà địa điểm 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à DEPARTMENT_OF hoặc INDEPENDENT_ESTABLISHMENT_OF và địa điểm được chỉ định ở đây có thể là địa điểm mẹ hoặc địa điểm con.

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ệ bằng mã địa điểm của vị trí đó.
relationType

enum (RelationType)

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

RelationType

Mối quan hệ về loại cần chỉ định.

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

MoreHours

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

object (TimePeriod)

Bắt buộc. Tập hợp các khoảng thời gian mà địa điểm này mở cửa. Mỗi khoảng thời gian đại diện cho một khoảng giờ mà địa điểm mở cửa trong tuần.

ServiceItem

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "structuredServiceItem": {
    object (StructuredServiceItem)
  },
  "freeFormServiceItem": {
    object (FreeFormServiceItem)
  }
  // End of mutually exclusive fields.
}
Trường
price

object (Money)

Không bắt buộc. Đại diện cho giá trị bằng tiền của mặt hàng dịch vụ. Bạn nên đặt currencyCode và units khi thêm giá. Giá này sẽ được coi là giá cố định cho mặt hàng dịch vụ.
Bạn phải luôn đặt một trong các trường sau. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
structuredServiceItem

object (StructuredServiceItem)

Không bắt buộc. Trường này sẽ được đặt trong trường hợp 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 trong trường hợp dữ liệu dịch vụ ở dạng tuỳ ý.
Kết thúc các trường loại trừ lẫn nhau.

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ụ: toilet_installation.

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ã nhận dạng duy nhất do Google cung cấp, có thể tìm thấy 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ả về mục dịch vụ có cấu trúc. Giới hạn ký tự là 300.

FreeFormServiceItem

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

Hãng nhạc

Nhãn dùng khi hiển thị bảng giá, mục 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 bảng giá, mục hoặc mặt hàng.
description

string

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

Tiền

Biểu thị 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ã tiền tệ gồm 3 chữ cái được xác định trong ISO 4217.
units

string (int64 format)

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

integer

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

Phương thức

create

 Tạo một Địa điểm mới thuộc quyền sở hữu của người dùng đã đăng nhập.

list

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