Trang này được dịch bởi Cloud Translation API.

BusinessInfo

Biểu diễn dưới dạng JSON
PostalAddress
- Biểu diễn dưới dạng JSON
PhoneNumber
- Biểu diễn dưới dạng JSON
ShortCode (Mã ngắn)
- Biểu diễn dưới dạng JSON
PhoneVerificationState
CustomerService
- Biểu diễn dưới dạng JSON

Thu thập thông tin liên quan đến một doanh nghiệp.

Biểu diễn dưới dạng JSON

Biểu diễn dưới dạng JSON
{ "name": string, "address": { object (`PostalAddress`) }, "phone": { object (`PhoneNumber`) }, "phoneVerificationState": enum (`PhoneVerificationState`), "customerService": { object (`CustomerService`) } }

{
  "name": string,
  "address": {
    object (PostalAddress)
  },
  "phone": {
    object (PhoneNumber)
  },
  "phoneVerificationState": enum (PhoneVerificationState),
  "customerService": {
    object (CustomerService)
  }
}

Trường
`name`	`string` Giá trị nhận dạng. Tên tài nguyên của thông tin doanh nghiệp. Định dạng: `accounts/{account}/businessInfo`
`address`	`object (PostalAddress)` Không bắt buộc. Địa chỉ của doanh nghiệp.
`phone`	`object (PhoneNumber)` Không bắt buộc. Số điện thoại của doanh nghiệp.
`phoneVerificationState`	`enum (PhoneVerificationState)` Chỉ có đầu ra. Trạng thái xác minh số điện thoại của doanh nghiệp.
`customerService`	`object (CustomerService)` Không bắt buộc. Dịch vụ khách hàng của doanh nghiệp.

PostalAddress

Đại diện cho địa chỉ bưu chính, ví dụ như địa chỉ giao hàng qua đường 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 một địa điểm, hộp thư bưu điện hoặc 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 }

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 dữ liệu hoặc được yêu cầu khớp với một trong các ngôn ngữ được sử dụng trong quốc gia/khu vực của địa chỉ hoặc các ngôn ngữ 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ị này phải là một chuỗi như "CEDEX", 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'Côte d' thận).
`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ụ: 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 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 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 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 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ỉ.

PhoneNumber

Đối tượng đại diện cho số điện thoại, phù hợp làm định dạng dây API.

Nội dung trình bày này:

không được sử dụng cho định dạng theo ngôn ngữ cụ thể của số điện thoại, chẳng hạn như "+1 (650) 253-0000 ext. 123"
không được thiết kế để lưu trữ hiệu quả
có thể không phù hợp để quay số - nên sử dụng các thư viện chuyên biệt (xem tài liệu tham khảo) để phân tích cú pháp số cho mục đích đó

Để làm những việc có ý nghĩa với số này, chẳng hạn như định dạng số cho các trường hợp sử dụng khác nhau, trước tiên, hãy chuyển đổi số đó thành đối tượng i18n.phonenumbers.PhoneNumber.

Ví dụ: trong Java, mã này sẽ là:

com.google.type.PhoneNumber wireProto = com.google.type.PhoneNumber.newBuilder().build(); com.google.i18n.phonenumbers.Phonenumber.PhoneNumber phoneNumber = PhoneNumberUtil.getInstance().parse(wireProto.getE164Number(), "ZZ"); if (!wireProto.getExtension().isEmpty()) { phoneNumber.setExtension(wireProto.getExtension()); }

(Các) tài liệu tham khảo: – https://github.com/google/libphonenumber

Biểu diễn dưới dạng JSON
{ "extension": string, // Union field `kind` can be only one of the following: "e164Number": string, "shortCode": { object (`ShortCode`) } // End of list of possible types for union field `kind`. }

Trường
`extension`	`string` Số mở rộng của số điện thoại. Phần mở rộng này không được chuẩn hoá theo khuyến nghị của ITU, ngoại trừ việc được định nghĩa là một chuỗi số có độ dài tối đa là 40 chữ số. Ngoại trừ chữ số, một số ký tự quay số khác như ',' (cho biết phải chờ) hoặc '#' có thể được lưu trữ tại đây. Xin lưu ý rằng hiện không có khu vực nào sử dụng tiện ích có mã ngắn. Vì vậy, trường này thường chỉ được đặt cùng với số E.164. Mã này được giữ riêng biệt với số E.164 để cho phép các phần mở rộng mã ngắn trong tương lai.
Trường kết hợp `kind`. Bắt buộc. Có thể là một số thông thường hoặc một mã ngắn. Trong tương lai, có thể thêm các trường mới vào một trong các trường bên dưới, vì vậy khách hàng nên bỏ qua những số điện thoại không đặt trường nào trong số các trường mà họ nhập vào đó. `kind` chỉ có thể là một trong những trạng thái sau đây:
`e164Number`	`string` Số điện thoại được biểu thị bằng dấu cộng (+) ở đầu, theo sau là số điện thoại theo định dạng ITU E.164 đơn giản bao gồm mã gọi điện quốc gia (từ 1 đến 3 chữ số) và số thuê bao, không có dấu cách hay định dạng bổ sung, ví dụ: - đúng: "+15552220123" - sai: "+1 (555) 222-01234 x123". Định dạng ITU E.164 giới hạn số mã thứ hai là 12 chữ số, nhưng trên thực tế không phải quốc gia nào cũng tôn trọng điều này, vì vậy chúng tôi nới lỏng quy định hạn chế đó ở đây. Không cho phép số điện thoại chỉ dành cho quốc gia. Tài liệu tham khảo: – https://www.itu.int/rec/T-REC-E.164-201011-I – https://en.wikipedia.org/wiki/E.164. – https://en.wikipedia.org/wiki/List_of_country_calling_codes
`shortCode`	`object (ShortCode)` Một mã ngắn. (Các) tài liệu tham khảo: – https://en.wikipedia.org/wiki/Short_code

ShortCode

Đối tượng đại diện cho một mã ngắn, là số điện thoại thường ngắn hơn nhiều so với số điện thoại thông thường và có thể được dùng để xử lý tin nhắn trong hệ thống MMS và SMS, cũng như để gọi tắt (ví dụ: "Nhắn tin 611 để biết gói thuê bao còn bao nhiêu phút).

Mã ngắn chỉ giới hạn ở một khu vực và không thể gọi điện quốc tế. Điều này có nghĩa là cùng một mã rút ngắn có thể tồn tại ở nhiều khu vực với cách sử dụng và giá cả khác nhau, ngay cả khi các khu vực đó có cùng mã gọi quốc gia (ví dụ: Hoa Kỳ và Canada).

Biểu diễn dưới dạng JSON
{ "regionCode": string, "number": string }

Trường

Trường
`regionCode`	`string` Bắt buộc. Mã vùng BCP-47 của vị trí có thể thực hiện lệnh gọi đến mã rút ngắn này, chẳng hạn như "US" và "BB". (Các) tài liệu tham khảo: – http://www.unicode.org/reports/tr35/#unicode_region_subtag
`number`	`string` Bắt buộc. Các chữ số mã ngắn, không có dấu cộng ở đầu ("+") hoặc mã gọi điện quốc gia, ví dụ: "611".

regionCode

string

Bắt buộc. Mã vùng BCP-47 của vị trí có thể thực hiện lệnh gọi đến mã rút ngắn này, chẳng hạn như "US" và "BB".

(Các) tài liệu tham khảo: – http://www.unicode.org/reports/tr35/#unicode_region_subtag

number

string

Bắt buộc. Các chữ số mã ngắn, không có dấu cộng ở đầu ("+") hoặc mã gọi điện quốc gia, ví dụ: "611".

PhoneVerificationState

Trạng thái xác minh số điện thoại.

Enum
`PHONE_VERIFICATION_STATE_UNSPECIFIED`	Giá trị mặc định. Giá trị này chưa được sử dụng.
`PHONE_VERIFICATION_STATE_VERIFIED`	Điện thoại này đã được xác minh.
`PHONE_VERIFICATION_STATE_UNVERIFIED`	Điện thoại này chưa được xác minh

CustomerService

Thông tin về dịch vụ khách hàng.

Biểu diễn dưới dạng JSON
{ "uri": string, "email": string, "phone": { object (`PhoneNumber`) } }

Trường

Trường
`uri`	`string` Không bắt buộc. URI nơi dịch vụ khách hàng có thể tìm thấy.
`email`	`string` Không bắt buộc. Địa chỉ email để liên hệ với bộ phận dịch vụ khách hàng.
`phone`	`object (PhoneNumber)` Không bắt buộc. Số điện thoại để gọi cho dịch vụ khách hàng.

uri

string

Không bắt buộc. URI nơi dịch vụ khách hàng có thể tìm thấy.

email

string

Không bắt buộc. Địa chỉ email để liên hệ với bộ phận dịch vụ khách hàng.

phone

object (PhoneNumber)

Không bắt buộc. Số điện thoại để gọi cho dịch vụ khách hàng.