REST Resource: accounts.businessInfo

Resource: BusinessInfo

Pesan BusinessInfo berisi informasi penting tentang bisnis penjual.

Pesan ini berisi detail bisnis utama seperti alamat fisik, kontak layanan pelanggan, dan ID khusus wilayah.

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

string

ID. Nama resource info bisnis. Format: accounts/{account}/businessInfo
address

object (PostalAddress)

Opsional. Alamat bisnis. Hanya kolom regionCode, addressLines, postalCode, administrativeArea, dan locality yang didukung. Semua kolom lainnya diabaikan.
phone

object (PhoneNumber)

Hanya output. Nomor telepon bisnis.
phoneVerificationState

enum (PhoneVerificationState)

Hanya output. Status verifikasi telepon bisnis.
customerService

object (CustomerService)

Opsional. Layanan pelanggan bisnis.
koreanBusinessRegistrationNumber

string

Opsional. Nomor pendaftaran bisnis Korea 10 digit yang dipisahkan dengan tanda hubung dalam format: XXX-XX-XXXXX.

PostalAddress

Merepresentasikan alamat pos. Misalnya untuk alamat pembayaran atau pengiriman pos. Seperti alamat pos, layanan pos dapat mengirimkan item ke tempat, P.O Box, atau yang serupa. Ini tidak dimaksudkan untuk memodelkan lokasi geografis (jalan, kota, gunung).

Dalam penggunaan umum, alamat akan dibuat oleh input pengguna atau dengan mengimpor data yang ada, bergantung pada jenis prosesnya.

Saran tentang pengisian / pengeditan alamat: - Gunakan widget alamat yang siap untuk internasionalisasi seperti https://github.com/google/libaddressinput) - Pengguna tidak boleh diberi elemen UI untuk mengisi atau mengedit kolom selain negara tempat kolom tersebut digunakan.

Untuk panduan lebih lanjut tentang cara menggunakan skema ini, lihat: https://support.google.com/business/answer/6397478

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

integer

Revisi skema PostalAddress. Ini harus ditetapkan ke 0, yang merupakan revisi terbaru.

Semua revisi baru harus kompatibel dengan revisi lama.
regionCode

string

Wajib. Kode wilayah CLDR negara/wilayah alamat. Ini tidak pernah disimpulkan dan bergantung pada pengguna untuk memastikan nilainya benar. Lihat https://cldr.unicode.org/ dan https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html untuk mengetahui detailnya. Contoh: "CH" untuk Swiss.
languageCode

string

Opsional. Kode bahasa BCP-47 konten alamat ini (jika diketahui). Ini biasanya merupakan bahasa UI formulir input atau diharapkan cocok dengan salah satu bahasa yang digunakan di negara/wilayah alamat, atau padanan transliterasinya. Hal ini dapat memengaruhi pemformatan di negara tertentu, tetapi tidak berpengaruh penting terhadap kebenaran data dan tidak akan pernah memengaruhi validasi apa pun atau operasi terkait non-pemformatan.

Jika nilai tidak diketahui, maka harus dihilangkan (dibanding menentukan kemungkinan default yang salah).

Contoh: "zh-Hant", "ja", "ja-Latn", "en".
postalCode

string

Opsional. Kode pos alamat. Tidak semua negara menggunakan atau mewajibkan penyertaan kode pos, tetapi jika kode pos digunakan, kode pos dapat memicu validasi tambahan dengan bagian alamat lain (misalnya validasi negara bagian/kode pos di AS).
sortingCode

string

Opsional. Kode pengurutan tambahan khusus negara. Kode ini tidak digunakan di sebagian besar wilayah. Jika digunakan, nilainya adalah string seperti "CEDEX", yang secara opsional diikuti dengan angka (Misalnya "CEDEX 7"), atau hanya angka saja, yang mewakili "kode sektor" (Jamaika), "indikator area pengiriman" (Malawi), atau "indikator kantor pos" (Misalnya Côte d'Ivoire).
administrativeArea

string

Opsional. Subdivisi administratif tertinggi yang digunakan untuk alamat pos negara atau wilayah. Misalnya, ini dapat berupa negara bagian, provinsi, oblast, atau prefektur. Khususnya, untuk Spanyol ini adalah provinsi dan bukan komunitas otonom (Misalnya "Barcelona" dan bukan "Catalunya"). Banyak negara tidak menggunakan wilayah administratif dalam alamat pos. Misalnya di Swiss, kolom ini harus dibiarkan kosong.
locality

string

Opsional. Secara umum merujuk pada bagian kota dari alamat tersebut. Contoh: US city, IT comune, UK post town. Di wilayah dunia dengan lokalitas yang tidak didefinisikan dengan baik atau tidak cocok dengan struktur ini, biarkan lokalitas kosong dan gunakan addressLines.
sublocality

string

Opsional. Sublokalitas alamat. Misalnya, ini dapat berupa lingkungan, borough, distrik.
addressLines[]

string

Baris alamat tidak terstruktur yang menggambarkan level alamat yang lebih rendah.

Karena nilai dalam addressLines tidak memiliki informasi jenis dan terkadang dapat berisi beberapa nilai dalam satu kolom (misalnya "Austin, TX"), urutan baris haruslah jelas. Urutan baris alamat harus "urutan amplop" untuk negara/wilayah alamat. Di tempat baris alamat ini dapat bervariasi (misalnya Jepang), address_language digunakan untuk membuatnya eksplisit (misalnya "ja" untuk pengurutan besar ke kecil dan "ja-Latn" atau "en" untuk kecil ke besar). Dengan cara ini, baris alamat yang paling spesifik dapat dipilih berdasarkan bahasa.

Representasi struktural minimum yang diizinkan dari alamat terdiri dari regionCode dengan semua informasi yang tersisa yang ditempatkan di addressLines. Memformat alamat seperti itu dengan sangat akurat tanpa geocoding dapat dilakukan, tetapi tidak ada alasan semantik yang dapat dibuat mengenai salah satu komponen alamat hingga setidaknya sebagian diselesaikan.

Membuat alamat yang hanya berisi regionCode dan addressLines, lalu melakukan geocoding adalah cara yang direkomendasikan untuk menangani alamat yang sepenuhnya tidak terstruktur (sebagai kebalikan dari menebak bagian alamat yang harus berupa lokalitas atau wilayah administratif).
recipients[]

string

Opsional. Penerima di alamat. Kolom ini dapat, dalam keadaan tertentu, berisi informasi multibaris. Misalnya, ini bisa berisi informasi "alamat lainnya".
organization

string

Opsional. Nama organisasi di alamat.

NomorTelepon

Objek yang mewakili nomor telepon, cocok sebagai format wire API.

Representasi ini:

  • tidak boleh digunakan untuk pemformatan nomor telepon khusus lokalitas, seperti "+1 (650) 253-0000 ext. 123"

  • tidak dirancang untuk penyimpanan yang efisien

  • mungkin tidak cocok untuk melakukan panggilan - library khusus (lihat referensi) harus digunakan untuk mengurai nomor untuk tujuan tersebut

Untuk melakukan sesuatu yang bermakna dengan angka ini, seperti memformatnya untuk berbagai kasus penggunaan, konversikan terlebih dahulu ke objek i18n.phonenumbers.PhoneNumber.

Misalnya, dalam Java, ini akan menjadi:

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()); }

Referensi: - https://github.com/google/libphonenumber

Representasi 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.
}
Kolom
extension

string

Ekstensi nomor telepon. Ekstensi ini tidak distandarisasi dalam rekomendasi ITU, kecuali jika didefinisikan sebagai serangkaian angka dengan panjang maksimum 40 digit. Selain angka, beberapa karakter pemilihan nomor lainnya seperti ',' (menunjukkan tunggu) atau '#' dapat disimpan di sini.

Perhatikan bahwa saat ini tidak ada wilayah yang menggunakan ekstensi dengan kode singkat, sehingga kolom ini biasanya hanya ditetapkan bersama dengan nomor E.164. Kode ini disimpan secara terpisah dari nomor E.164 untuk memungkinkan ekstensi kode singkat di masa mendatang.
Kolom union kind. Wajib. Nomor biasa atau kode singkat. Kolom baru dapat ditambahkan ke oneof di bawah pada masa mendatang, sehingga klien harus mengabaikan nomor telepon yang tidak memiliki kolom yang dienkode. kind hanya dapat berupa salah satu dari berikut:
e164Number

string

Nomor telepon, yang diwakili sebagai tanda plus di awal ('+'), diikuti dengan nomor telepon yang menggunakan format ITU E.164 yang longgar yang terdiri dari kode telepon negara (1 hingga 3 digit) dan nomor pelanggan, tanpa spasi atau pemformatan tambahan. Misalnya: - benar: "+15552220123" - salah: "+1 (555) 222-01234 x123".

Format ITU E.164 membatasi nomor telepon ke 12 digit, tetapi dalam praktiknya tidak semua negara mematuhinya, jadi kami melonggarkan pembatasan tersebut di sini. Nomor khusus nasional tidak diizinkan.

Referensi: - 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)

Kode singkat.

Referensi: - https://en.wikipedia.org/wiki/Short_code

ShortCode

Objek yang mewakili kode singkat, yang merupakan nomor telepon yang biasanya jauh lebih pendek daripada nomor telepon biasa dan dapat digunakan untuk mengirim pesan di sistem MMS dan SMS, serta untuk melakukan panggilan singkat (Misalnya "Kirim SMS ke 611 untuk melihat sisa menit yang Anda miliki dalam paket Anda").

Kode singkat dibatasi untuk suatu wilayah dan tidak dapat diakses secara internasional, yang berarti kode singkat yang sama dapat ada di wilayah yang berbeda, dengan penggunaan dan harga yang berbeda, meskipun wilayah tersebut memiliki kode telepon negara yang sama (Misalnya: AS dan Kanada).

Representasi JSON 
{
  "regionCode": string,
  "number": string
}
Kolom
regionCode

string

Wajib. Kode wilayah BCP-47 dari lokasi tempat panggilan ke kode singkat ini dapat dilakukan, seperti "US" dan "BB".

Referensi: - http://www.unicode.org/reports/tr35/#unicode_region_subtag
number

string

Wajib. Digit kode singkat, tanpa tanda plus di awal ('+') atau kode telepon negara. Misalnya "611".

PhoneVerificationState

Status verifikasi melalui ponsel.

Enum
PHONE_VERIFICATION_STATE_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
PHONE_VERIFICATION_STATE_VERIFIED Telepon telah diverifikasi.
PHONE_VERIFICATION_STATE_UNVERIFIED Ponsel belum diverifikasi

CustomerService

Informasi layanan pelanggan.

Representasi JSON 
{
  "uri": string,
  "email": string,
  "phone": {
    object (PhoneNumber)
  }
}
Kolom
uri

string

Opsional. URI tempat layanan pelanggan dapat ditemukan.
email

string

Opsional. Alamat email yang dapat digunakan untuk menghubungi layanan pelanggan.
phone

object (PhoneNumber)

Opsional. Nomor telepon yang dapat dihubungi layanan pelanggan.

Metode

getBusinessInfo

 Mengambil info bisnis akun.

updateBusinessInfo

 Memperbarui info bisnis akun.