REST Resource: accounts.locations

{
  "primaryPhone": string,
  "additionalPhones": [
    string
  ]
}

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.

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.

{
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ]
}

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.

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.

{
  "name": string,
  "displayName": string,
  "serviceTypes": [
    {
      object (ServiceType)
    }
  ],
  "moreHoursTypes": [
    {
      object (MoreHoursType)
    }
  ]
}

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í).

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.

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.

object (MoreHoursType)

Chỉ có đầu ra. Các loại giờ khác có sẵn cho danh mục kinh doanh này.

{
  "serviceTypeId": string,
  "displayName": string
}

string

Chỉ có đầu ra. Mã ổn định (do Google cung cấp) cho loại dịch vụ này.

string

Chỉ có đầu ra. Tên hiển thị mà con người có thể đọc được cho loại dịch vụ.

{
  "hoursTypeId": string,
  "displayName": string,
  "localizedDisplayName": string
}

string

Chỉ có đầu ra. Mã ổn định do Google cung cấp cho loại giờ này.

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

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

{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}

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

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

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

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ỳ).

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à).

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.

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.

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.

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

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.

string

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

{
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}

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.

{
  "openDay": enum (DayOfWeek),
  "openTime": {
    object (TimeOfDay)
  },
  "closeDay": enum (DayOfWeek),
  "closeTime": {
    object (TimeOfDay)
  }
}

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.

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.

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.

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.

{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}

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.

integer

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

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.

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.

{
  "specialHourPeriods": [
    {
      object (SpecialHourPeriod)
    }
  ]
}

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.

{
  "startDate": {
    object (Date)
  },
  "openTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "closeTime": {
    object (TimeOfDay)
  },
  "closed": boolean
}

object (Date)

Bắt buộc. Ngày theo lịch cho khoảng thời gian đặc biệt này.

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.

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.

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.

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.

{
  "year": integer,
  "month": integer,
  "day": integer
}

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.

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.

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.

{
  "businessType": enum (BusinessType),
  "places": {
    object (Places)
  },
  "regionCode": string
}

enum (BusinessType)

Bắt buộc. Cho biết [type] [google.hl=vi

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.

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.

{
  "placeInfos": [
    {
      object (PlaceInfo)
    }
  ]
}

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.

{
  "placeName": string,
  "placeId": string
}

string

Bắt buộc. Tên đã bản địa hoá của địa điểm. Ví dụ: Scottsdale, AZ.

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)

{
  "adPhone": string
}

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

{
  "latitude": number,
  "longitude": number
}

number

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

number

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

{
  "status": enum (OpenForBusiness),
  "canReopen": boolean,
  "openingDate": {
    object (Date)
  }
}

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.

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.

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.

{
  "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
}

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.

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.

boolean

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

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.

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.

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.

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.

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.

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.

string

Chỉ có đầu ra. Tài nguyên vị trí mà vị trí này sao chép.

string

Chỉ có đầu ra. Đường liên kết đến vị trí trên Maps.

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í đó.

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.

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.

{
  "description": string
}

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.

{
  "parentLocation": {
    object (RelevantLocation)
  },
  "childrenLocations": [
    {
      object (RelevantLocation)
    }
  ],
  "parentChain": string
}

object (RelevantLocation)

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

object (RelevantLocation)

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

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]

{
  "placeId": string,
  "relationType": enum (RelationType)
}

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í).

enum (RelationType)

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

{
  "hoursTypeId": string,
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}

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

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.

{
  "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.
}

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

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.

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.

{
  "serviceTypeId": string,
  "description": string
}

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.

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

{
  "category": string,
  "label": {
    object (Label)
  }
}

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.

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.

{
  "displayName": string,
  "description": string,
  "languageCode": string
}

string

Bắt buộc. Tên hiển thị của danh sách giá, mục hoặc mặt hàng.

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.

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

{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}

string

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

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

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.