REST Resource: accounts.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á.

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. Ứng dụng không thể 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. Định dạng số điện thoại quốc tế được ưu tiên, chẳng hạn như "+1 415 555 0132", 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
  ]
}
Các trường
primaryPhone

string

Bắt buộc. Số điện thoại kết nối với địa điểm kinh doanh riêng lẻ của bạn càng trực tiếp càng tốt. Nếu có thể, hãy sử dụng một số điện thoại địa phương thay vì số của đường dây hỗ trợ thuộc trung tâm tổng đài.
additionalPhones[]

string

Không bắt buộc. Tối đa hai số điện thoại (di động hoặc cố định, không có số fax) có thể được 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 từng danh mục chính hoặc danh mục bổ sung bằng cách sử dụng mặt nạ cập nhật.

Biểu diễn dưới dạng JSON 
{
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ]
}
Các 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 mà địa điểm này tham gia.
additionalCategories[]

object (Category)

Không bắt buộ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 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 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 là ngành nghề). Để biết danh sách mã danh mục hợp lệ và ánh xạ tớ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)
    }
  ]
}
Các 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 thông tin 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 doanh nghiệp 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
}
Các trường
serviceTypeId

string

Chỉ có đầu ra. Mã nhận dạng cố đị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 của loại dịch vụ.

MoreHoursType

Ngoài những 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
}
Các trường
hoursTypeId

string

Chỉ có đầu ra. Một mã nhận dạng cố đị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, ví dụ: địa chỉ giao hàng hoặc thanh toán qua bưu điện. Khi có địa chỉ bưu chính, dịch vụ bưu chính có thể giao hàng đến tận nhà, hộp thư bưu điện hoặc những thứ tương tự. Bố cục 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, địa chỉ sẽ được tạo qua hoạt động đầu vào của người dùng 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ề 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á 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 đó.

Để được hướng dẫn thêm 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
}
Các 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, vì đây là bản sửa đổi mới nhất.

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

string

Bắt buộc. Mã vùng CLDR của quốc gia/khu vực trên địa chỉ. Điều này không bao giờ được suy luận và người dùng có trách nhiệm đảm bảo giá trị chính xác. Hãy truy cập và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 dự kiến sẽ khớp với một trong các ngôn ngữ dùng tại quốc gia/khu vực của địa chỉ hoặc các ngôn ngữ tương đương được chuyển tự. Điều này có thể ảnh hưởng đến đị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ỳ thao tác xác thực hay hoạt động nào khác liên quan đến việc không định dạng.

Nếu không xác định được 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 bắt buộc phải có mã bưu chính. Tuy nhiên, ở những nơi sử dụng mã bưu chính, mã bưu chính 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 ở Hoa Kỳ).
sortingCode

string

Không bắt buộc. Mã phân loại bổ sung theo quốc gia. Chế độ này không được sử dụng ở hầu hết các khu vực. Trong trường hợp sử dụng, giá trị có thể là một chuỗi như "CEDEX", tuỳ ý theo sau là một số (ví dụ: "CEDEX 7") hoặc chỉ là một số, đại diện cho "mã ngành" (Jamaica), "chỉ báo khu vực giao hàng" (Malawi) hoặc "chỉ báo bưu điện" (ví dụ: Côte d'Ivoire).
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ụ: đó có thể là 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 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 điện. Ví dụ: ở Thuỵ Sĩ, bạn nên bỏ trống mã này.
locality

string

Không bắt buộc. Thường có nghĩa là phần thành phố/thị trấn trong địa chỉ. Ví dụ: Thành phố ở Hoa Kỳ, khu CNTT, thị trấn có bưu điện ở Vương quốc Anh. Ở những 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. Cụm dân cư 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ỉ 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"), điều quan trọng là thứ tự hàng phải rõ ràng. Thứ tự của các dòng địa chỉ phải là "phong bì đơn đặt hàng" cho quốc gia/khu vực của địa chỉ. Ở những nơi có thể khác nhau (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 từ nhỏ đến lớn). Bằng cách này, dòng địa chỉ cụ thể nhất có thể được chọn theo ngôn ngữ.

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ã khu vực với tất cả thông tin còn lại được đặt trong addressLines. Có thể định dạng địa chỉ như vậy rất gần mà không cần mã hoá địa lý, nhưng không thể đưa ra lý luận ngữ nghĩa nào về bất kỳ thành phần địa chỉ nào cho đến khi địa chỉ đó ít nhất được giải quyết một phần.

Tạo một địa chỉ chỉ chứa mã vùng và địa chỉ, sau đó mã hoá địa lý là cách được khuyên dùng để xử lý các địa chỉ hoàn toàn không có cấu trúc (thay vì đoán phần nào của địa chỉ nên 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ụ: tài liệu này có thể chứa thông tin "chăm sóc".
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 mà địa điểm này mở cửa kinh doanh. Lưu trữ một bộ sưu tập các phiên bản [TimePeriod][google.mybusiness.mybusinessinfo.v1.TimePeriod].

Biểu diễn dưới dạng JSON 
{
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
Các trường
periods[]

object (TimePeriod)

Bắt buộc. Tập hợp thời gian mà vị trí này mở cửa kinh doanh. Mỗi khoảng thời gian đại diện cho một phạm vi 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 từ 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ư sau này trong cùng ngày hoặc vào một 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)
  }
}
Các trường
openDay

enum (DayOfWeek)

Bắt buộc. Cho biết day of the week bắt đầu từ ngày này.
openTime

object (TimeOfDay)

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

enum (DayOfWeek)

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

object (TimeOfDay)

Bắt buộc. Các giá trị hợp lệ là 00:00-24:00, trong đó 24:00 biểu thị nửa đêm vào 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 Chưa xác định ngày trong tuần.
MONDAY Thứ Hai
TUESDAY Thứ Ba
WEDNESDAY Thứ Tư
THURSDAY Thursday (thứ Năm)
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
}
Các trường
hours

integer

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

integer

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

integer

Số giây trong phút. Thông thường phải từ 0 đến 59. API có thể cho phép giá trị 60 nếu cho phép giây nhuận.
nanos

integer

Phân số giây tính bằng nano giây. Phải 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 bình thường của vị trí đó.

Biểu diễn dưới dạng JSON 
{
  "specialHourPeriods": [
    {
      object (SpecialHourPeriod)
    }
  ]
}
Các 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 khi giờ hoạt động của một vị trí khác với giờ làm việc bình thường của vị trí đó. Khoảng giờ đặc biệt phải đại diện cho một 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 dữ liệu đầ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

Các thông tin nhập sau 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
}
Các trường
startDate

object (Date)

Bắt buộc. Ngày dương lịch trong khoảng thời gian giờ đặc biệt này bắt đầu.
openTime

object (TimeOfDay)

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

object (Date)

Không bắt buộc. Ngày theo lịch trong khoảng thời gian giờ đặc biệt này sẽ 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 ngày startDate.
closeTime

object (TimeOfDay)

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

boolean

Không bắt buộc. Nếu đúng, endDate, openTime và closeTime sẽ bị bỏ qua và ngày chỉ định trong startDate được coi là vị trí đóng cửa trong 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. 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 Dương lịch. Điều này có thể đại diện cho một trong những điều 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, với năm 0 (ví dụ: ngày kỷ niệm).
  • Chỉ có một năm, có một tháng không có ngày nào.
  • 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
}
Các trường
year

integer

Năm của ngày tháng. 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 từ 0 để chỉ định một năm không có tháng và ngày.
day

integer

Ngày trong tháng. Giá trị phải từ 1 đến 31 và có giá trị trong năm và tháng, hoặc 0 để chỉ định một năm hoặc một năm và tháng không có ngày quan trọng.

ServiceAreaBusiness

Doanh nghiệp cung cấp dịch vụ tại cơ sở khách hàng 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
}
Các trường
businessType

enum (BusinessType)

Bắt buộc. Cho biết [type] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] của doanh nghiệp cung cấp dịch vụ tại cơ sở khách hàng.
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

Không thể thay đổi. Mã vùng CLDR của quốc gia/khu vực nơi doanh nghiệp khu vực kinh doanh này đặt trụ sở. Hãy truy cập và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à bị bỏ qua nếu không có.

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

Nếu vị trí 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 ủy quyền của họ phải nhận được thư qua đường bưu điện theo địa chỉ xác minh đã cung cấp.

BusinessType

Cho biết liệu 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ả một địa chỉ và tại chỗ (ví dụ: cửa hàng pizza có khu vực ăn uống và cũng có dịch vụ giao hàng cho khách hàng).

Enum
BUSINESS_TYPE_UNSPECIFIED Chỉ có đầu ra. Chưa xác đị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 đ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 phần hợp nhất các khu vực được biểu thị bằng một tập hợp các địa điểm.

Biểu diễn dưới dạng JSON 
{
  "placeInfos": [
    {
      object (PlaceInfo)
    }
  ]
}
Các 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 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
}
Các trường
placeName

string

Bắt buộc. Tên được 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
}
Các trường
adPhone

string

Bắt buộc. Số điện thoại thay thế để hiển thị trên tiện ích địa điểm 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 cặp vĩ độ/kinh độ. Đây là một cặp số kép để biểu thị độ 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
}
Các trường
latitude

number

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

number

Kinh độ theo độ. 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 khai trương của doanh nghiệp.

Biểu diễn dưới dạng JSON 
{
  "status": enum (OpenForBusiness),
  "canReopen": boolean,
  "openingDate": {
    object (Date)
  }
}
Các trường
status

enum (OpenForBusiness)

Bắt buộc. Cho biết liệu Vị trí đó hiện có đang mở cửa kinh doanh hay không. Tất 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 liệu doanh nghiệp này có đủ điều kiện để mở lại hay không.
openingDate

object (Date)

Không bắt buộc. Ngày mà vị trí mở cửa lần đầu tiên. Nếu không xác định được ngày chính xác thì bạn chỉ có thể 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 xác định.
OPEN Cho biết vị trí đó đang mở cửa.
CLOSED_PERMANENTLY Cho biết vị trí đã bị đóng vĩnh viễn.
CLOSED_TEMPORARILY Cho biết vị trí 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
}
Các 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ó nội dung cập nhật cần khách hàng cập nhật hoặc từ chối hay không. Nếu đặt giá trị 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ó cơ sở lưu trú nào của Vị trí này ở 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 danh sách có thể quản lý các bài đăng cục bộ hay không.
canModifyServiceList

boolean

Chỉ có đầu ra. Cho biết 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 này có đủ điều kiện để hiển thị 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 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 của Phòng cho thuê 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 cho vị trí đó. Mã nhận dạng này có thể được dùng trong nhiều API Địa điểm.

Bạn có thể đặt trường này trong lệnh gọi Create nhưng không thể đặt cho trường này.
duplicateLocation

string

Chỉ có đầu ra. Tài nguyên vị trí mà vị trí này trùng lặp.
mapsUri

string

Chỉ có đầu ra. Đường liên kết đến thông tin 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á về địa điểm đó.
canHaveBusinessCalls

boolean

Chỉ có đầu ra. Cho biết liệu danh sách có đủ điều kiện để gọi điện cho doanh nghiệp hay không.
hasVoiceOfMerchant

boolean

Chỉ có đầu ra. Cho biết liệu danh sách có sử dụng Voice của người bán hay không. Nếu boolean này sai, bạn nên gọi API locations.getVoiceOfMerchantState để biết chi tiết về lý do tại sao chúng không có 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
}
Các trường
description

string

Bắt buộc. Mô tả vị trí bằng giọng của chính bạn, không ai khác có thể chỉnh sửa được.

RelationshipData

Thông tin về tất cả vị trí của nhà xuất bản mẹ và nhà xuất bản 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
}
Các trường
parentLocation

object (RelevantLocation)

Vị trí chính mà vị trí này có quan hệ.
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 có vị trí này. [Cách tìm Mã chuỗi] [Locations.SearchChains]

RelevantLocation

Thông tin về một vị trí khác liên quan đến vị trí hiện tại. Mối quan hệ có thể là bất kỳ một trong hai giá trị DEpartMENT_OF hoặc INDEPENDENT_ESTABLISHMENT_OF và vị trí được chỉ định ở đây có thể nằm ở một trong hai bên (gốc/con) của vị trí.

Biểu diễn dưới dạng JSON 
{
  "placeId": string,
  "relationType": enum (RelationType)
}
Các trường
placeId

string

Bắt buộc. Chỉ định vị trí ở phía bên kia của mối quan hệ theo placeID.
relationType

enum (RelationType)

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

RelationType

Mối quan hệ của kiểu sẽ được chỉ định.

Enum
RELATION_TYPE_UNSPECIFIED Chưa xác định loại.
DEPARTMENT_OF Điề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 cấp trên nhưng có các thuộc tính chính khác nhau như giờ mở cửa hoặc số điện thoại. Ví dụ: Hiệu thuốc Costco là một bộ phận trong Costco Merchandise.
INDEPENDENT_ESTABLISHMENT_IN Điều này thể hiện trường hợp 2 địa điểm có cùng vị trí thực tế nhưng lại thuộc các công ty khác nhau (ví dụ: quán Starbucks ở Safeway, cửa hàng trong trung tâm mua sắm).

MoreHours

Khoảng thời gian mà 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)
    }
  ]
}
Các trường
hoursTypeId

string

Bắt buộc. Loại giờ. Khách hàng nên gọi {#link businessCategory:BatchGet} để biết các loại giờ được hỗ trợ cho các danh mục vị trí của họ.
periods[]

object (TimePeriod)

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

ServiceItem

Thông báo mô tả một mục dịch vụ. Trường hợp này được 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.
}
Các 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 đặt currencyCode và các đơn vị khi đưa vào giá cả. Đây sẽ được coi là giá cố định cho mặt hàng dịch vụ.
Trường nhóm service_item_info. Bạn phải luôn đặt một trong các trường sau. 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ẽ được đặt làm trường hợp sử dụng 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 làm trường 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ụ: Vệ sinh_cài đặt.

Biểu diễn dưới dạng JSON 
{
  "serviceTypeId": string,
  "description": string
}
Các 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 và bạn 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 là 300 ký tự.

FreeFormServiceItem

Đại diện cho dịch vụ biểu mẫu tùy ý do người bán cung cấp. Đây là các dịch vụ không thuộc dữ liệu về dịch vụ kết cấu của chúng tôi. Người bán nhập tên của các dịch vụ đó theo cách thủ công thông qua nền tảng dành cho người bán.

Biểu diễn dưới dạng JSON 
{
  "category": string,
  "label": {
    object (Label)
  }
}
Các trường
category

string

Bắt buộc. Trường này đại diện cho tên danh mục (tức là ID ổn định của danh mục). category và serviceTypeId phải khớp với các tổ hợp có thể được cung cấp trong thông báo Category.
label

object (Label)

Bắt buộc. Các nhãn được gắn thẻ ngôn ngữ cho mặt hàng. Tên mục nên dài từ 140 ký tự trở xuống và nội dung mô tả không 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. Bạn phải cập nhật các loại dịch vụ được chuẩn hoá thông qua serviceTypeId.

Nhãn

Nhãn được dùng khi hiển thị danh sách giá, mục hoặc mặt hàng.

Biểu diễn dưới dạng JSON 
{
  "displayName": string,
  "description": string,
  "languageCode": string
}
Các 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. Chỉ có thể đặt một bộ nhãn cho mỗi ngôn ngữ.

Tiền

Biểu thị số tiền cùng với loại đơn vị tiền tệ.

Biểu diễn dưới dạng JSON 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Các 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ị là một đô 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, nanos phải là số dương hoặc 0. Nếu units bằng 0, thì nanos có thể là số dương, 0 hoặc âm. Nếu units là số âm, nanos phải là số âm hoặc 0. Ví dụ: $-1,75 được biểu diễn dưới dạng units=-1 và nanos=-750.000.000.

Phương thức

create

 Tạo một Vị trí mới sẽ thuộc 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.