- Referensi: Akun
- AccountType
- AccountRole
- VerificationState
- VettedState
- PermissionLevel
- OrganizationInfo
- PostalAddress
- Metode
Resource: Akun
Akun adalah penampung untuk lokasi Anda. Jika Anda adalah satu-satunya pengguna yang mengelola lokasi untuk bisnis, Anda dapat menggunakan Akun Google pribadi. Untuk membagikan pengelolaan lokasi kepada beberapa pengguna, buat akun bisnis.
Representasi JSON |
---|
{ "name": string, "accountName": string, "primaryOwner": string, "type": enum ( |
Kolom | |
---|---|
name |
Tidak dapat diubah. Nama resource, dalam format |
accountName |
Wajib diisi. Nama akun. Untuk akun jenis |
primaryOwner |
Wajib diisi. Input saja. Nama resource akun yang akan menjadi pemilik utama akun yang dibuat. Formatnya harus |
type |
Wajib diisi. Berisi jenis akun. Akun dengan jenis PERSONAL dan PERSONAL tidak dapat dibuat menggunakan API ini. |
role |
Hanya output. Menentukan AccountRole untuk akun ini. |
verificationState |
Hanya output. Jika diverifikasi, lokasi mendatang yang dibuat akan otomatis terhubung ke Google Maps, dan dibuatkan halaman Google+, tanpa memerlukan moderasi. |
vettedState |
Hanya output. Menunjukkan apakah akun diperiksa oleh Google. Akun terverifikasi dapat memverifikasi lokasi melalui metode VETTED_PARTNER. |
accountNumber |
Hanya output. Nomor referensi akun jika disediakan. |
permissionLevel |
Hanya output. Menentukan tingkat izin yang dimiliki pengguna untuk akun ini. |
organizationInfo |
Hanya output. Info tambahan untuk organisasi. Kolom ini hanya diisi untuk akun organisasi. |
AccountType
Menunjukkan jenis akun ini: akun pribadi/pengguna atau akun bisnis.
Enum | |
---|---|
ACCOUNT_TYPE_UNSPECIFIED |
Tidak ditentukan. |
PERSONAL |
Akun pengguna akhir. |
LOCATION_GROUP |
Grup Lokasi. Untuk mengetahui informasi selengkapnya, lihat artikel pusat bantuan |
USER_GROUP |
Grup Pengguna untuk memisahkan staf organisasi dalam beberapa grup. Untuk mengetahui informasi selengkapnya, lihat artikel pusat bantuan |
ORGANIZATION |
Organisasi yang mewakili perusahaan. Untuk mengetahui informasi selengkapnya, lihat artikel pusat bantuan |
AccountRole
Menunjukkan tingkat akses yang dimiliki pengguna terautentikasi untuk akun ini. Untuk mengetahui informasi selengkapnya, lihat artikel pusat bantuan
Enum | |
---|---|
ACCOUNT_ROLE_UNSPECIFIED |
Tidak ditentukan. |
PRIMARY_OWNER |
Pengguna adalah pemilik utama akun ini. |
OWNER |
Pemilik pengguna akun. |
MANAGER |
Pengguna dapat mengelola akun ini. |
SITE_MANAGER |
Pengguna dapat mengelola serangkaian fitur terbatas untuk akun. |
VerificationState
Menunjukkan status verifikasi akun.
Enum | |
---|---|
VERIFICATION_STATE_UNSPECIFIED |
Tidak ditentukan. |
VERIFIED |
Akun terverifikasi. |
UNVERIFIED |
Akun yang tidak diverifikasi, dan verifikasi belum diminta. |
VERIFICATION_REQUESTED |
Akun yang tidak diverifikasi, tetapi verifikasi telah diminta. |
VettedState
Menunjukkan status akun yang terverifikasi.
Enum | |
---|---|
VETTED_STATE_UNSPECIFIED |
Tidak Ditentukan |
NOT_VETTED |
Akun tidak diperiksa oleh Google. |
VETTED |
Akun ini diverifikasi oleh Google dan dalam status valid. Akun akan otomatis diperiksa jika memiliki akses langsung ke akun grup terverifikasi. |
INVALID |
Akun diperiksa, tetapi dalam status tidak valid. Akun akan berperilaku seperti akun yang tidak diverifikasi. |
PermissionLevel
Menunjukkan tingkat akses yang dimiliki pengguna terautentikasi untuk akun ini.
Enum | |
---|---|
PERMISSION_LEVEL_UNSPECIFIED |
Tidak ditentukan. |
OWNER_LEVEL |
Pengguna memiliki izin tingkat pemilik. |
MEMBER_LEVEL |
Pengguna memiliki izin tingkat anggota. |
OrganizationInfo
Informasi tambahan yang disimpan untuk organisasi.
Representasi JSON |
---|
{
"registeredDomain": string,
"address": {
object ( |
Kolom | |
---|---|
registeredDomain |
Hanya output. Domain yang terdaftar untuk akun. |
address |
Hanya output. Alamat pos untuk akun. |
phoneNumber |
Hanya output. Nomor kontak untuk organisasi. |
PostalAddress
Merepresentasikan alamat pos, mis. untuk pengiriman pos atau alamat pembayaran. Dengan mempertimbangkan alamat pos, layanan pos dapat mengirimkan item ke suatu tempat, P.O. Box atau yang serupa. Hal ini tidak dimaksudkan untuk membuat model lokasi geografis (jalan, kota, gunung).
Dalam penggunaan umum, alamat akan dibuat melalui input pengguna atau dari mengimpor data yang ada, tergantung pada jenis prosesnya.
Saran tentang input / pengeditan alamat: - Gunakan widget alamat yang mendukung internasionalisasi seperti https://github.com/google/libaddressinput) - Pengguna tidak boleh diberi elemen UI untuk memasukkan atau mengedit kolom di luar negara tempat kolom tersebut digunakan.
Untuk panduan selengkapnya 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 |
Revisi skema Semua revisi baru harus kompatibel dengan revisi lama. |
regionCode |
Wajib diisi. Kode wilayah CLDR negara/wilayah alamat. Hal 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 detailnya. Contoh: "CH" untuk Swiss. |
languageCode |
Opsional. Kode bahasa BCP-47 konten alamat ini (jika diketahui). Ini sering kali merupakan bahasa UI formulir input atau diharapkan cocok dengan salah satu bahasa yang digunakan di alamat negara/wilayah, atau padanannya dalam transliterasi. Hal ini dapat memengaruhi pemformatan di negara tertentu, tetapi tidak penting bagi keakuratan data dan tidak akan memengaruhi validasi atau operasi terkait non-pemformatan lainnya. Jika nilai ini tidak diketahui, sebaiknya dihilangkan (bukan menentukan default yang mungkin salah). Contoh: "zh-Hant", "ja", "ja-Latn", "en". |
postalCode |
Opsional. Kode pos alamat. Tidak semua negara menggunakan atau mewajibkan keberadaan kode pos, tetapi jika kode pos digunakan, kode pos tersebut dapat memicu validasi tambahan dengan bagian alamat lainnya (misalnya, validasi negara bagian/kode pos di Amerika Serikat). |
sortingCode |
Opsional. Kode pengurutan tambahan khusus negara. Ini tidak digunakan di sebagian besar wilayah. Jika digunakan, nilainya dapat berupa string seperti "CEDEX", secara opsional diikuti dengan angka (mis. "CEDEX 7"), atau hanya angka saja, yang mewakili "kode sektor" (Jamaika), "indikator area pengiriman" (Malawi) atau "indikator kantor pos" (mis. Côte d'Ivoire). |
administrativeArea |
Opsional. Subdivisi administratif tertinggi yang digunakan untuk alamat pos suatu 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 "Catalonia"). Banyak negara tidak menggunakan wilayah administratif dalam alamat pos. Mis. di Swiss kolom ini harus dibiarkan tidak terisi. |
locality |
Opsional. Secara umum mengacu pada bagian kota dari alamat tersebut. Contoh: US city, IT comune, UK post city. Di wilayah dunia dengan lokalitas yang tidak didefinisikan dengan baik atau tidak cocok dengan struktur ini, biarkan lokalitas kosong dan gunakan addressLines. |
sublocality |
Opsional. Sublokalitas alamat. Misalnya, ini dapat berupa kawasan, kota besar, distrik. |
addressLines[] |
Baris alamat tidak terstruktur yang menggambarkan tingkat 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 barisnya harus jelas. Urutan baris alamat harus berupa "urutan amplop" untuk negara/wilayah alamat. Di tempat yang 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 sebuah alamat terdiri dari regionCode dengan semua informasi yang tersisa yang ditempatkan di addressLines. Anda dapat memformat alamat seperti itu secara kira-kira tanpa geocoding, tetapi tidak ada alasan semantik yang dapat dibuat untuk setiap komponen alamat hingga setidaknya sebagian di-resolve. Membuat alamat yang hanya berisi regionCode dan addressLines, dan kemudian geocoding adalah cara yang direkomendasikan untuk menangani alamat yang benar-benar tidak terstruktur (daripada menebak bagian alamat mana yang harus berupa lokalitas atau wilayah administratif). |
recipients[] |
Opsional. Penerima di alamat. Dalam keadaan tertentu, kolom ini dapat berisi informasi multibaris. Misalnya, mungkin ada kata "care of" tidak akurat atau tidak sesuai. |
organization |
Opsional. Nama organisasi di alamat. |
Metode |
|
---|---|
|
Membuat akun dengan nama dan jenis yang ditentukan di bawah induk tertentu. |
|
Mendapatkan akun yang ditentukan. |
|
Mencantumkan semua akun untuk pengguna terautentikasi. |
|
Memperbarui akun bisnis yang ditentukan. |