- Referensi: Lokasi
- Representasi JSON
- PhoneNumbers
- Kategori
- Kategori
- ServiceType
- MoreHoursType
- PostalAddress
- BusinessHours
- TimePeriod
- DayOfWeek
- TimeOfDay
- SpecialHours
- SpecialHourPeriod
- Tanggal
- ServiceAreaBusiness
- BusinessType
- Tempat
- PlaceInfo
- AdWordsLocationExtensions
- LatLng
- OpenInfo
- OpenForBusiness
- Metadata
- Profil
- RelationshipData
- RelevantLocation
- RelationType
- MoreHours
- ServiceItem
- StructuredServiceItem
- FreeFormServiceItem
- Label
- Uang
- Metode
Resource: Lokasi
Lokasi. Lihat artikel pusat bantuan untuk deskripsi mendetail tentang kolom tersebut atau endpoint kategori untuk daftar kategori bisnis yang valid.
Representasi JSON |
---|
{ "name": string, "languageCode": string, "storeCode": string, "title": string, "phoneNumbers": { object ( |
Kolom | |
---|---|
name |
ID Google untuk lokasi ini dalam bentuk: |
languageCode |
Tidak dapat diubah. Bahasa lokasi. Ditetapkan selama pembuatan dan tidak dapat diperbarui. |
storeCode |
Opsional. ID eksternal untuk lokasi ini, yang harus unik dalam akun tertentu. Ini adalah cara untuk mengaitkan lokasi dengan catatan Anda sendiri. |
title |
Wajib. Nama lokasi harus mencerminkan nama bisnis Anda yang sebenarnya, seperti yang digunakan secara konsisten di etalase, situs, alat tulis, dan sebagaimana diketahui pelanggan. Setiap informasi tambahan, jika relevan, dapat disertakan di kolom resource lainnya (misalnya, |
phoneNumbers |
Opsional. Berbagai nomor telepon yang dapat digunakan pelanggan untuk menghubungi bisnis. |
categories |
Opsional. Berbagai kategori yang mendeskripsikan bisnis. |
storefrontAddress |
Opsional. Alamat yang tepat dan akurat untuk mendeskripsikan lokasi bisnis Anda. PO box atau kotak surat yang terletak di lokasi terpencil tidak dapat diterima. Saat ini, Anda dapat menentukan maksimum lima nilai |
websiteUri |
Opsional. URL untuk bisnis ini. Jika memungkinkan, gunakan URL yang mewakili lokasi bisnis individual ini, bukan situs/URL umum yang mewakili semua lokasi, atau merek. |
regularHours |
Opsional. Jam operasional bisnis. |
specialHours |
Opsional. Jam khusus untuk bisnis. Jam ini biasanya mencakup jam buka di hari libur, dan waktu lain di luar jam operasional reguler. Jam ini akan menggantikan jam buka reguler. Kolom ini tidak dapat ditetapkan tanpa jam buka reguler. |
serviceArea |
Opsional. Bisnis jasa sistem panggilan menyediakan layanan di lokasi pelanggan. Jika bisnis ini adalah bisnis jasa sistem panggilan, kolom ini mendeskripsikan area yang dilayani oleh bisnis tersebut. |
labels[] |
Opsional. Kumpulan string bentuk bebas yang memungkinkan Anda memberi tag pada bisnis Anda. Label ini TIDAK ditampilkan kepada pengguna; hanya Anda yang dapat melihatnya. Harus berisi antara 1-255 karakter per label. |
adWordsLocationExtensions |
Opsional. Informasi tambahan yang muncul di AdWords. |
latlng |
Opsional. Lintang dan bujur yang diberikan pengguna. Saat membuat lokasi, kolom ini diabaikan jika alamat yang diberikan berhasil di-geocode. Kolom ini hanya ditampilkan menggunakan permintaan GET jika nilai |
openInfo |
Opsional. Tanda yang menunjukkan apakah lokasi saat ini buka atau tidak. |
metadata |
Hanya output. Informasi tambahan yang tidak dapat diedit pengguna. |
profile |
Opsional. Mendeskripsikan bisnis Anda dengan gaya Anda sendiri dan membagikan kisah unik tentang bisnis dan penawaran Anda kepada pengguna. Kolom ini wajib diisi untuk semua kategori kecuali kategori penginapan (mis. hotel, motel, losmen). |
relationshipData |
Opsional. Semua lokasi dan jaringan bisnis yang terkait dengan lokasi ini. |
moreHours[] |
Opsional. Jam buka lebih banyak untuk departemen yang berbeda atau pelanggan tertentu dalam sebuah bisnis. |
serviceItems[] |
Opsional. Daftar layanan yang didukung oleh penjual. Layanan dapat memotong rambut, memasang pemanas air, dll. Item layanan duplikat akan dihapus secara otomatis. |
PhoneNumbers
Kumpulan nomor telepon untuk bisnis. Selama update, kedua kolom harus ditetapkan. Klien tidak boleh memperbarui hanya nomor telepon utama atau tambahan menggunakan mask pembaruan. Format telepon internasional lebih disarankan, seperti "+1 415 555 0132", lihat selengkapnya di (https://developers.google.com/style/phone-numbers#international-phone-numbers).
Representasi JSON |
---|
{ "primaryPhone": string, "additionalPhones": [ string ] } |
Kolom | |
---|---|
primaryPhone |
Wajib. Nomor telepon yang dapat langsung terhubung ke lokasi bisnis individual Anda. Gunakan nomor telepon lokal, bukan nomor bantuan pusat layanan sentral, jika memungkinkan. |
additionalPhones[] |
Opsional. Maksimal dua nomor telepon (ponsel atau telepon rumah, bukan faks) yang dapat digunakan untuk menghubungi bisnis Anda, selain nomor telepon utama. |
Kategori
Kumpulan kategori yang mendeskripsikan bisnis. Selama update, kedua kolom harus ditetapkan. Klien dilarang memperbarui kategori utama atau tambahan satu per satu menggunakan mask pembaruan.
Representasi JSON |
---|
{ "primaryCategory": { object ( |
Kolom | |
---|---|
primaryCategory |
Wajib. Kategori yang paling menggambarkan bisnis inti yang dilakukan lokasi ini. |
additionalCategories[] |
Opsional. Kategori tambahan untuk mendeskripsikan bisnis Anda. Kategori membantu pelanggan menemukan hasil yang spesifik dan akurat untuk layanan yang mereka minati. Untuk menjaga informasi bisnis tetap akurat dan aktif, pastikan Anda menggunakan sesedikit mungkin kategori untuk mendeskripsikan bisnis inti Anda secara keseluruhan. Pilih kategori yang sespesifik mungkin, tetapi merepresentasikan bisnis utama Anda. |
Kategori
Kategori yang mendeskripsikan jenis bisnis ini (bukan apa yang dilakukannya). Untuk daftar ID kategori yang valid, dan pemetaan ke nama yang dapat dibaca manusia, lihat categories.list
.
Representasi JSON |
---|
{ "name": string, "displayName": string, "serviceTypes": [ { object ( |
Kolom | |
---|---|
name |
Wajib. ID stabil (disediakan oleh Google) untuk kategori ini. Nilai harus ditentukan saat memodifikasi kategori (saat membuat atau memperbarui lokasi). |
displayName |
Hanya output. Nama kategori yang dapat dibaca manusia. Ini ditetapkan saat membaca lokasi. Saat mengubah lokasi, |
serviceTypes[] |
Hanya output. Daftar semua jenis layanan yang tersedia untuk kategori bisnis ini. |
moreHoursTypes[] |
Hanya output. Jenis jam buka lainnya yang tersedia untuk kategori bisnis ini. |
ServiceType
Pesan yang menjelaskan jenis layanan yang ditawarkan bisnis.
Representasi JSON |
---|
{ "serviceTypeId": string, "displayName": string } |
Kolom | |
---|---|
serviceTypeId |
Hanya output. ID stabil (disediakan oleh Google) untuk jenis layanan ini. |
displayName |
Hanya output. Nama tampilan yang dapat dibaca manusia untuk jenis layanan. |
MoreHoursType
Jenis jam buka lainnya yang dapat ditawarkan bisnis, selain jam regulernya.
Representasi JSON |
---|
{ "hoursTypeId": string, "displayName": string, "localizedDisplayName": string } |
Kolom | |
---|---|
hoursTypeId |
Hanya output. ID stabil yang diberikan oleh Google untuk jenis jam ini. |
displayName |
Hanya output. Nama tampilan bahasa Inggris yang dapat dibaca manusia untuk jenis jam. |
localizedDisplayName |
Hanya output. Nama tampilan yang dilokalkan dan dapat dibaca manusia untuk jenis jam. |
PostalAddress
Mewakili alamat pos, mis. untuk pengiriman pos atau alamat pembayaran. Misalnya, layanan pos dapat mengirimkan item ke lokasi, P.O. Box, atau yang serupa. 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, bergantung pada jenis prosesnya.
Saran terkait input / pengeditan alamat: - Gunakan widget alamat yang siap internasionalisasi seperti https://github.com/google/libaddressinput) - Pengguna tidak boleh diberi elemen UI untuk memasukkan 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 |
Revisi skema Semua revisi baru harus kompatibel dengan revisi lama. |
regionCode |
Wajib. Kode wilayah CLDR negara/wilayah alamat. Ini tidak pernah disimpulkan dan terserah 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 |
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 negara/wilayah alamat, atau padanannya yang telah ditransliterasi. Hal ini dapat memengaruhi pemformatan di negara tertentu, tetapi tidak penting bagi kebenaran data dan tidak akan memengaruhi validasi apa pun atau operasi terkait non-pemformatan lainnya. Jika nilai ini tidak diketahui, nilai ini harus dihilangkan (daripada 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. Namun, jika kode pos digunakan, kode pos tersebut dapat memicu validasi tambahan dengan bagian alamat lainnya (misalnya, validasi negara bagian/kode pos di AS). |
sortingCode |
Opsional. Kode pengurutan tambahan khusus negara. Opsi ini tidak digunakan di sebagian besar wilayah. Jika digunakan, nilainya bisa 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 negara atau wilayah. Misalnya, ini dapat berupa negara bagian, provinsi, oblast, atau prefektur. Khususnya, untuk Spanyol ini adalah provinsi dan bukan komunitas otonom (mis. "Barcelona" dan bukan "Catalunya"). Banyak negara yang tidak menggunakan wilayah administratif dalam alamat pos. Misalnya, di Swiss, kolom ini harus dibiarkan kosong. |
locality |
Opsional. Secara umum merujuk pada bagian kota dari alamat. 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, borough, distrik. |
addressLines[] |
Baris alamat tidak terstruktur yang menjelaskan 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 baris harus jelas. Urutan baris alamat harus "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 alamat terdiri dari regionCode dengan semua informasi lainnya yang ditempatkan di addressLines. Memformat alamat seperti itu bisa dilakukan dengan sangat akurat tanpa geocoding, tetapi tidak ada alasan semantik yang bisa dibuat mengenai salah satu komponen alamat hingga setidaknya sebagian diselesaikan. Membuat alamat yang hanya berisi regionCode dan addressLines, dan kemudian geocoding adalah cara yang disarankan untuk menangani alamat yang benar-benar tidak terstruktur (sebagai kebalikan dari 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, halaman ini mungkin berisi informasi "perawatan". |
organization |
Opsional. Nama organisasi di alamat. |
BusinessHours
Merepresentasikan jangka waktu saat lokasi ini buka. Menyimpan kumpulan instance [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod].
Representasi JSON |
---|
{
"periods": [
{
object ( |
Kolom | |
---|---|
periods[] |
Wajib. Kumpulan waktu saat lokasi ini buka. Setiap periode mewakili rentang jam saat lokasi buka selama seminggu. |
TimePeriod
Merepresentasikan rentang waktu bisnis buka, mulai dari hari/waktu buka yang ditentukan dan tutup pada hari/waktu tutup yang ditentukan. Waktu tutup harus terjadi setelah jam buka, misalnya nanti di hari yang sama, atau pada hari berikutnya.
Representasi JSON |
---|
{ "openDay": enum ( |
Kolom | |
---|---|
openDay |
Wajib. Menunjukkan |
openTime |
Wajib. Nilai yang valid adalah 00:00-24:00, dengan 24:00 merepresentasikan tengah malam di akhir kolom hari yang ditentukan. |
closeDay |
Wajib. Menunjukkan |
closeTime |
Wajib. Nilai yang valid adalah 00:00-24:00, dengan 24:00 merepresentasikan tengah malam di akhir kolom hari yang ditentukan. |
DayOfWeek
Merepresentasikan hari dalam seminggu.
Enum | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
Hari dalam seminggu tidak ditentukan. |
MONDAY |
Senin |
TUESDAY |
Selasa |
WEDNESDAY |
Rabu |
THURSDAY |
Kamis |
FRIDAY |
Jumat |
SATURDAY |
Sabtu |
SUNDAY |
Minggu |
TimeOfDay
Mewakili waktu. Tanggal dan zona waktu tidak signifikan atau ditentukan di tempat lain. API dapat memilih untuk mengizinkan detik kabisat. Jenis terkait adalah google.type.Date
dan google.protobuf.Timestamp
.
Representasi JSON |
---|
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer } |
Kolom | |
---|---|
hours |
Jam dalam format 24 jam. Harus dari 0 hingga 23. API dapat memilih untuk mengizinkan nilai "24:00:00" untuk skenario seperti jam tutup bisnis. |
minutes |
Menit dalam jam. Harus dari 0 hingga 59. |
seconds |
Detik menit dari waktu. Biasanya harus antara 0 hingga 59. API dapat mengizinkan nilai 60 jika memungkinkan kabisat-detik. |
nanos |
Pecahan detik dalam nanodetik. Harus dari 0 hingga 999.999.999. |
SpecialHours
Merepresentasikan kumpulan jangka waktu saat jam operasional lokasi berbeda dari jam buka normalnya.
Representasi JSON |
---|
{
"specialHourPeriods": [
{
object ( |
Kolom | |
---|---|
specialHourPeriods[] |
Wajib. Daftar pengecualian untuk jam reguler bisnis. |
SpecialHourPeriod
Merepresentasikan jangka waktu tunggal jika jam operasional lokasi berbeda dari jam buka normalnya. Periode jam khusus harus mewakili rentang yang kurang dari 24 jam. openTime
dan startDate
harus terjadi sebelum closeTime
dan endDate
. closeTime
dan endDate
dapat diperluas hingga pukul 11.59 pada hari setelah startDate
yang ditentukan. Misalnya, input berikut valid:
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
Input berikut tidak valid:
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
Representasi JSON |
---|
{ "startDate": { object ( |
Kolom | |
---|---|
startDate |
Wajib. Tanggal kalender saat periode jam khusus ini dimulai. |
openTime |
Opsional. Nilai yang valid adalah 00:00-24:00 dengan 24:00 merepresentasikan tengah malam di akhir kolom hari yang ditentukan. Harus ditentukan jika |
endDate |
Opsional. Tanggal kalender saat periode jam khusus ini berakhir. Jika kolom |
closeTime |
Opsional. Nilai yang valid adalah 00:00-24:00, dengan 24:00 merepresentasikan tengah malam di akhir kolom hari yang ditentukan. Harus ditentukan jika |
closed |
Opsional. Jika benar, |
Tanggal
Mewakili seluruh atau sebagian tanggal kalender, seperti ulang tahun. Waktu dan zona waktu ditentukan di tempat lain atau tidak signifikan. Tanggal tersebut relatif terhadap Kalender Gregorian. Ini dapat mewakili salah satu hal berikut:
- Tanggal lengkap, dengan nilai tahun, bulan, dan hari bukan nol.
- Bulan dan hari, dengan nol tahun (misalnya, hari jadi).
- Satu tahun saja, dengan bulan nol dan hari nol.
- Tahun dan bulan, dengan nol hari (misalnya, tanggal habis masa berlaku kartu kredit).
Jenis terkait:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
Representasi JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
Kolom | |
---|---|
year |
Tahun dari tanggal. Harus dari 1 hingga 9999, atau 0 untuk menentukan tanggal tanpa tahun. |
month |
Bulan dalam setahun. Harus dari 1 hingga 12, atau 0 untuk menentukan tahun tanpa bulan dan hari. |
day |
Hari dalam sebulan. Harus dari 1 sampai 31 dan berlaku untuk tahun dan bulan, atau 0 untuk menentukan tahun saja atau tahun dan bulan jika hari dianggap tidak signifikan. |
ServiceAreaBusiness
Bisnis jasa sistem panggilan menyediakan layanan mereka di lokasi pelanggan (misalnya, tukang kunci atau tukang leding).
Representasi JSON |
---|
{ "businessType": enum ( |
Kolom | |
---|---|
businessType |
Wajib. Menunjukkan [type] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] dari bisnis jasa sistem panggilan. |
places |
Area yang dilayani bisnis ini yang ditentukan melalui sekumpulan tempat. |
regionCode |
Tidak dapat diubah. Kode wilayah CLDR negara/wilayah tempat bisnis jasa sistem panggilan ini berada. Lihat http://cldr.unicode.org/ dan http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html untuk mengetahui detailnya. Contoh: "CH" untuk Swiss. Kolom ini wajib diisi untuk bisnis CUSTOMER_LOCATION_ONLY, dan akan diabaikan jika tidak. Wilayah yang ditetapkan di sini bisa berbeda dari wilayah untuk area yang dilayani bisnis ini (mis., bisnis jasa sistem panggilan yang menyediakan layanan di wilayah selain tempat mereka berada). Jika lokasi ini memerlukan verifikasi setelah dibuat, alamat yang diberikan untuk tujuan verifikasi harus berada di wilayah ini, dan pemilik bisnis atau perwakilan resminya harus dapat menerima surat pos di alamat verifikasi yang diberikan. |
BusinessType
Menunjukkan apakah bisnis ini hanya menawarkan layanan di lokasi pelanggan (misalnya, truk derek), atau di alamat dan di lokasi (misalnya, toko pizza dengan ruang makan, yang juga melakukan pengiriman ke pelanggan).
Enum | |
---|---|
BUSINESS_TYPE_UNSPECIFIED |
Hanya output. Tidak ditentukan. |
CUSTOMER_LOCATION_ONLY |
Hanya menawarkan layanan di area sekitar (bukan di alamat bisnis). Jika bisnis diperbarui dari CUSTOMER_AND_BUSINESS_LOCATION ke CUSTOMER_LOCATION_ONLY, pembaruan lokasi harus menyertakan mask kolom storefrontAddress dan menetapkan kolom ke kosong. |
CUSTOMER_AND_BUSINESS_LOCATION |
Menawarkan layanan di alamat bisnis dan area sekitar. |
Tempat
Mendefinisikan gabungan area yang direpresentasikan oleh sekumpulan tempat.
Representasi JSON |
---|
{
"placeInfos": [
{
object ( |
Kolom | |
---|---|
placeInfos[] |
Area yang direpresentasikan oleh ID tempat. Dibatasi maksimum 20 tempat. |
PlaceInfo
Menentukan area yang direpresentasikan oleh ID tempat.
Representasi JSON |
---|
{ "placeName": string, "placeId": string } |
Kolom | |
---|---|
placeName |
Wajib. Nama tempat yang dilokalkan. Misalnya, |
placeId |
Wajib. ID tempat. Harus sesuai dengan wilayah. (https://developers.google.com/places/web-service/supported_types#table3) |
AdWordsLocationExtensions
Informasi tambahan yang muncul di AdWords.
Representasi JSON |
---|
{ "adPhone": string } |
Kolom | |
---|---|
adPhone |
Wajib. Nomor telepon alternatif yang akan ditampilkan di ekstensi lokasi AdWords, bukan nomor telepon utama lokasi. |
LatLng
Objek yang merepresentasikan pasangan garis lintang/bujur. Objek ini dinyatakan sebagai pasangan double untuk mewakili derajat lintang dan derajat bujur. Kecuali ditentukan lain, objek ini harus sesuai dengan standar WGS84. Nilai harus berada dalam rentang yang dinormalisasi.
Representasi JSON |
---|
{ "latitude": number, "longitude": number } |
Kolom | |
---|---|
latitude |
Lintang dalam derajat. Harus dalam rentang [-90.0, +90.0]. |
longitude |
Bujur dalam derajat. Harus dalam rentang [-180.0, +180.0]. |
OpenInfo
Informasi yang terkait dengan status buka bisnis.
Representasi JSON |
---|
{ "status": enum ( |
Kolom | |
---|---|
status |
Wajib. Menunjukkan apakah Lokasi saat ini buka atau tidak. Semua lokasi buka secara default, kecuali jika diperbarui ke tutup. |
canReopen |
Hanya output. Menunjukkan apakah bisnis ini memenuhi syarat untuk dibuka kembali. |
openingDate |
Opsional. Tanggal saat lokasi pertama kali dibuka. Jika hari persisnya tidak diketahui, hanya bulan dan tahun yang dapat diberikan. Tanggal harus berada di masa lalu atau tidak lebih dari satu tahun ke depan. |
OpenForBusiness
Menunjukkan status lokasi.
Enum | |
---|---|
OPEN_FOR_BUSINESS_UNSPECIFIED |
Tidak ditentukan. |
OPEN |
Menunjukkan bahwa lokasi buka. |
CLOSED_PERMANENTLY |
Menunjukkan bahwa lokasi telah tutup permanen. |
CLOSED_TEMPORARILY |
Menunjukkan bahwa lokasi telah tutup sementara. |
Metadata
Informasi tambahan yang tidak dapat diedit pengguna tentang lokasi.
Representasi 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 } |
Kolom | |
---|---|
hasGoogleUpdated |
Hanya output. Menunjukkan apakah ID tempat yang dikaitkan dengan lokasi ini memiliki pembaruan yang perlu diperbarui atau ditolak oleh klien. Jika boolean ini ditetapkan, Anda harus memanggil metode |
hasPendingEdits |
Hanya output. Menunjukkan apakah salah satu properti Lokasi ini berada dalam status hasil edit menunggu keputusan. |
canDelete |
Hanya output. Menunjukkan apakah lokasi dapat dihapus menggunakan API. |
canOperateLocalPost |
Hanya output. Menunjukkan apakah listingan dapat mengelola postingan lokal. |
canModifyServiceList |
Hanya output. Menunjukkan apakah listingan dapat mengubah daftar layanan. |
canHaveFoodMenus |
Hanya output. Menunjukkan apakah listingan memenuhi syarat untuk menu makanan. |
canOperateHealthData |
Hanya output. Menunjukkan apakah lokasi dapat beroperasi pada data Kesehatan. |
canOperateLodgingData |
Hanya output. Menunjukkan apakah lokasi dapat beroperasi pada data Penginapan. |
placeId |
Hanya output. Jika lokasi ini muncul di Google Maps, kolom ini akan diisi dengan ID tempat untuk lokasi tersebut. ID ini dapat digunakan di berbagai Places API. Kolom ini dapat ditetapkan selama panggilan Create, tetapi tidak untuk Update. |
duplicateLocation |
Hanya output. Resource lokasi yang diduplikasi lokasi ini. |
mapsUri |
Hanya output. Link ke lokasi di Maps. |
newReviewUri |
Hanya output. Link ke halaman di Google Penelusuran yang dapat digunakan pelanggan untuk memberikan ulasan lokasi. |
canHaveBusinessCalls |
Hanya output. Menunjukkan apakah listingan memenuhi syarat untuk panggilan bisnis. |
hasVoiceOfMerchant |
Hanya output. Menunjukkan apakah listingan memiliki Voice of Merchant. Jika boolean ini salah, Anda harus memanggil locations.getVoiceOfMerchantState API untuk mendapatkan detail mengapa API tersebut tidak memiliki Voice of Merchant. |
Profil
Semua informasi yang berkaitan dengan profil lokasi.
Representasi JSON |
---|
{ "description": string } |
Kolom | |
---|---|
description |
Wajib. Deskripsi lokasi dengan suara Anda sendiri, tidak dapat diedit oleh orang lain. |
RelationshipData
Informasi semua lokasi induk dan turunan yang terkait dengan lokasi ini.
Representasi JSON |
---|
{ "parentLocation": { object ( |
Kolom | |
---|---|
parentLocation |
Lokasi induk yang terkait dengan lokasi ini. |
childrenLocations[] |
Daftar lokasi turunan yang memiliki hubungan dengan lokasi ini. |
parentChain |
Nama resource Jaringan tempat lokasi ini menjadi anggota. [Cara menemukan ID Jaringan Bisnis] [Locations.SearchChains] |
RelevantLocation
Informasi tentang lokasi lain yang terkait dengan lokasi saat ini. Relasinya dapat berupa salah satu dari DEPARTMENT_OF atau INDEPENDENT_ESTABLISHMENT_OF, dan lokasi yang ditentukan di sini dapat berada di salah satu sisi (induk/turunan) lokasi.
Representasi JSON |
---|
{
"placeId": string,
"relationType": enum ( |
Kolom | |
---|---|
placeId |
Wajib. Menentukan lokasi yang ada di sisi lain hubungan menurut placeID-nya. |
relationType |
Wajib. Jenis hubungan. |
RelationType
Relasi jenis yang akan ditentukan.
Enum | |
---|---|
RELATION_TYPE_UNSPECIFIED |
Jenis tidak ditentukan. |
DEPARTMENT_OF |
Hal ini merepresentasikan hubungan antara 2 lokasi yang memiliki satu area fisik yang sama, merek/manajemen tingkat atas/organisasi yang sama, tetapi dengan atribut utama yang berbeda seperti jam buka toko atau nomor telepon. Misalnya, Apotek Hypermart adalah departemen di Pusat Grosir Alfamart. |
INDEPENDENT_ESTABLISHMENT_IN |
Ini mewakili kasus saat 2 lokasi berada dalam lokasi fisik yang sama, tetapi dari perusahaan yang berbeda (mis. Starbucks di Safeway, toko di suatu mal). |
MoreHours
Jangka waktu saat lokasi buka untuk jenis bisnis tertentu.
Representasi JSON |
---|
{
"hoursTypeId": string,
"periods": [
{
object ( |
Kolom | |
---|---|
hoursTypeId |
Wajib. Jenis jam buka. Klien harus memanggil {#link businessCategory:BatchGet} untuk mendapatkan jenis jam yang didukung untuk kategori lokasi mereka. |
periods[] |
Wajib. Kumpulan waktu saat lokasi ini buka. Setiap periode mewakili rentang jam saat lokasi buka selama seminggu. |
ServiceItem
Pesan yang menjelaskan satu item layanan. Atribut ini digunakan untuk mendeskripsikan jenis layanan yang disediakan penjual. Misalnya, layanan potong rambut.
Representasi JSON |
---|
{ "price": { object ( |
Kolom | |
---|---|
price |
Opsional. Mewakili harga uang dari item layanan. Sebaiknya currencyCode dan unit harus ditetapkan saat menyertakan harga. Ini akan diperlakukan sebagai harga tetap untuk item layanan. |
Kolom union service_item_info . Salah satu kolom berikut harus selalu ditetapkan. service_item_info hanya ada berupa salah satu diantara berikut: |
|
structuredServiceItem |
Opsional. Kolom ini akan ditetapkan sebagai kasus data layanan terstruktur. |
freeFormServiceItem |
Opsional. Kolom ini akan ditetapkan sebagai kasus untuk data layanan bentuk bebas. |
StructuredServiceItem
Mewakili layanan terstruktur yang ditawarkan oleh penjual. Misalnya: toilet_installation.
Representasi JSON |
---|
{ "serviceTypeId": string, "description": string } |
Kolom | |
---|---|
serviceTypeId |
Wajib. Kolom |
description |
Opsional. Deskripsi item layanan terstruktur. Batas karakternya adalah 300. |
FreeFormServiceItem
Mewakili layanan bentuk bebas yang ditawarkan oleh penjual. Ini adalah layanan yang tidak diekspos sebagai bagian dari data layanan struktur kami. Penjual secara manual memasukkan nama untuk layanan tersebut melalui platform geolokasi.
Representasi JSON |
---|
{
"category": string,
"label": {
object ( |
Kolom | |
---|---|
category |
Wajib. Kolom ini menunjukkan nama kategori (yaitu ID stabil kategori). |
label |
Wajib. Label dengan tag bahasa untuk item. Sebaiknya nama item terdiri dari 140 karakter atau kurang dan deskripsi 250 karakter atau kurang. Kolom ini hanya boleh ditetapkan jika inputnya adalah item layanan kustom. Jenis layanan standar harus diperbarui melalui serviceTypeId. |
Label
Label yang akan digunakan saat menampilkan daftar harga, bagian, atau item.
Representasi JSON |
---|
{ "displayName": string, "description": string, "languageCode": string } |
Kolom | |
---|---|
displayName |
Wajib. Nama tampilan untuk daftar harga, bagian, atau item. |
description |
Opsional. Deskripsi daftar harga, bagian, atau item. |
languageCode |
Opsional. Kode bahasa BCP-47 yang berlaku untuk string ini. Hanya satu kumpulan label yang dapat ditetapkan per bahasa. |
Uang
Menyatakan jumlah uang dengan jenis mata uangnya.
Representasi JSON |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
Kolom | |
---|---|
currencyCode |
Tiga huruf kode mata uang yang ditentukan dalam ISO 4217. |
units |
Seluruh unit jumlah. Misalnya jika |
nanos |
Jumlah satuan nano (10^-9) dari jumlah tersebut. Nilai harus antara -999.999.999 dan +999.999.999 inklusif. Jika |
Metode |
|
---|---|
|
Membuat Lokasi baru yang akan dimiliki oleh pengguna yang login. |
|
Menampilkan daftar lokasi untuk akun yang ditentukan. |