REST Resource: accounts.locations

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 (PhoneNumbers)
  },
  "categories": {
    object (Categories)
  },
  "storefrontAddress": {
    object (PostalAddress)
  },
  "websiteUri": string,
  "regularHours": {
    object (BusinessHours)
  },
  "specialHours": {
    object (SpecialHours)
  },
  "serviceArea": {
    object (ServiceAreaBusiness)
  },
  "labels": [
    string
  ],
  "adWordsLocationExtensions": {
    object (AdWordsLocationExtensions)
  },
  "latlng": {
    object (LatLng)
  },
  "openInfo": {
    object (OpenInfo)
  },
  "metadata": {
    object (Metadata)
  },
  "profile": {
    object (Profile)
  },
  "relationshipData": {
    object (RelationshipData)
  },
  "moreHours": [
    {
      object (MoreHours)
    }
  ],
  "serviceItems": [
    {
      object (ServiceItem)
    }
  ]
}
Kolom
name

string

ID Google untuk lokasi ini dalam bentuk: locations/{locationId}.
languageCode

string

Tidak dapat diubah. Bahasa lokasi. Ditetapkan selama pembuatan dan tidak dapat diperbarui.
storeCode

string

Opsional. ID eksternal untuk lokasi ini, yang harus unik dalam akun tertentu. Ini adalah cara untuk mengaitkan lokasi dengan catatan Anda sendiri.
title

string

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, Address, Categories). Jangan tambahkan informasi yang tidak perlu ke nama Anda (misalnya, pilih "Google" daripada "Google Inc. - Mountain View Corporate Headquarters"). Jangan sertakan tagline pemasaran, kode toko, karakter khusus, jam buka atau status tutup/buka, nomor telepon, URL situs, informasi layanan/produk, lokasi/alamat atau rute, atau informasi tempat bisnis Anda berada (misalnya, "ATM Bank Mandiri di Jakarta Pusat").
phoneNumbers

object (PhoneNumbers)

Opsional. Berbagai nomor telepon yang dapat digunakan pelanggan untuk menghubungi bisnis.
categories

object (Categories)

Opsional. Berbagai kategori yang mendeskripsikan bisnis.
storefrontAddress

object (PostalAddress)

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 addressLines di alamat. Kolom ini hanya boleh ditetapkan untuk bisnis yang memiliki etalase. Kolom ini tidak boleh disetel untuk lokasi jenis CUSTOMER_LOCATION_ONLY, tetapi jika disetel, nilai apa pun yang disediakan akan dihapus.
websiteUri

string

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

object (BusinessHours)

Opsional. Jam operasional bisnis.
specialHours

object (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

object (ServiceAreaBusiness)

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[]

string

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

object (AdWordsLocationExtensions)

Opsional. Informasi tambahan yang muncul di AdWords.
latlng

object (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 latlng yang diberikan pengguna disetujui selama pembuatan, atau nilai latlng diperbarui melalui situs Google Profil Bisnis. Kolom ini hanya dapat diperbarui oleh klien yang disetujui.
openInfo

object (OpenInfo)

Opsional. Tanda yang menunjukkan apakah lokasi saat ini buka atau tidak.
metadata

object (Metadata)

Hanya output. Informasi tambahan yang tidak dapat diedit pengguna.
profile

object (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

object (RelationshipData)

Opsional. Semua lokasi dan jaringan bisnis yang terkait dengan lokasi ini.
moreHours[]

object (MoreHours)

Opsional. Jam buka lebih banyak untuk departemen yang berbeda atau pelanggan tertentu dalam sebuah bisnis.
serviceItems[]

object (ServiceItem)

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

string

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[]

string

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 (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ]
}
Kolom
primaryCategory

object (Category)

Wajib. Kategori yang paling menggambarkan bisnis inti yang dilakukan lokasi ini.
additionalCategories[]

object (Category)

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 (ServiceType)
    }
  ],
  "moreHoursTypes": [
    {
      object (MoreHoursType)
    }
  ]
}
Kolom
name

string

Wajib. ID stabil (disediakan oleh Google) untuk kategori ini. Nilai harus ditentukan saat memodifikasi kategori (saat membuat atau memperbarui lokasi).
displayName

string

Hanya output. Nama kategori yang dapat dibaca manusia. Ini ditetapkan saat membaca lokasi. Saat mengubah lokasi, category_id harus ditetapkan.
serviceTypes[]

object (ServiceType)

Hanya output. Daftar semua jenis layanan yang tersedia untuk kategori bisnis ini.
moreHoursTypes[]

object (MoreHoursType)

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

string

Hanya output. ID stabil (disediakan oleh Google) untuk jenis layanan ini.
displayName

string

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

string

Hanya output. ID stabil yang diberikan oleh Google untuk jenis jam ini.
displayName

string

Hanya output. Nama tampilan bahasa Inggris yang dapat dibaca manusia untuk jenis jam.
localizedDisplayName

string

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

integer

Revisi skema PostalAddress. Nilai ini harus disetel 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 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

string

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

string

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

string

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

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 (mis. "Barcelona" dan bukan "Catalunya"). Banyak negara yang 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. 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

string

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

string

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[]

string

Opsional. Penerima di alamat. Dalam keadaan tertentu, kolom ini dapat berisi informasi multibaris. Misalnya, halaman ini mungkin berisi informasi "perawatan".
organization

string

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 (TimePeriod)
    }
  ]
}
Kolom
periods[]

object (TimePeriod)

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 (DayOfWeek),
  "openTime": {
    object (TimeOfDay)
  },
  "closeDay": enum (DayOfWeek),
  "closeTime": {
    object (TimeOfDay)
  }
}
Kolom
openDay

enum (DayOfWeek)

Wajib. Menunjukkan day of the week periode ini dimulai.
openTime

object (TimeOfDay)

Wajib. Nilai yang valid adalah 00:00-24:00, dengan 24:00 merepresentasikan tengah malam di akhir kolom hari yang ditentukan.
closeDay

enum (DayOfWeek)

Wajib. Menunjukkan day of the week periode ini berakhir.
closeTime

object (TimeOfDay)

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

integer

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

integer

Menit dalam jam. Harus dari 0 hingga 59.
seconds

integer

Detik menit dari waktu. Biasanya harus antara 0 hingga 59. API dapat mengizinkan nilai 60 jika memungkinkan kabisat-detik.
nanos

integer

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 (SpecialHourPeriod)
    }
  ]
}
Kolom
specialHourPeriods[]

object (SpecialHourPeriod)

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 (Date)
  },
  "openTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "closeTime": {
    object (TimeOfDay)
  },
  "closed": boolean
}
Kolom
startDate

object (Date)

Wajib. Tanggal kalender saat periode jam khusus ini dimulai.
openTime

object (TimeOfDay)

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 salah.
endDate

object (Date)

Opsional. Tanggal kalender saat periode jam khusus ini berakhir. Jika kolom endDate tidak ditetapkan, setelan default adalah tanggal yang ditentukan di startDate. Jika ditetapkan, kolom ini harus sama dengan atau maksimum 1 hari setelah startDate.
closeTime

object (TimeOfDay)

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 salah.
closed

boolean

Opsional. Jika benar, endDate, openTime, dan closeTime diabaikan, dan tanggal yang ditentukan di startDate dianggap sebagai lokasi yang tutup sepanjang hari.

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:

Representasi JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Kolom
year

integer

Tahun dari tanggal. Harus dari 1 hingga 9999, atau 0 untuk menentukan tanggal tanpa tahun.
month

integer

Bulan dalam setahun. Harus dari 1 hingga 12, atau 0 untuk menentukan tahun tanpa bulan dan hari.
day

integer

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 (BusinessType),
  "places": {
    object (Places)
  },
  "regionCode": string
}
Kolom
businessType

enum (BusinessType)

Wajib. Menunjukkan [type] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] dari bisnis jasa sistem panggilan.
places

object (Places)

Area yang dilayani bisnis ini yang ditentukan melalui sekumpulan tempat.
regionCode

string

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 (PlaceInfo)
    }
  ]
}
Kolom
placeInfos[]

object (PlaceInfo)

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

string

Wajib. Nama tempat yang dilokalkan. Misalnya, Scottsdale, AZ.
placeId

string

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

string

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

number

Lintang dalam derajat. Harus dalam rentang [-90.0, +90.0].
longitude

number

Bujur dalam derajat. Harus dalam rentang [-180.0, +180.0].

OpenInfo

Informasi yang terkait dengan status buka bisnis.

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

enum (OpenForBusiness)

Wajib. Menunjukkan apakah Lokasi saat ini buka atau tidak. Semua lokasi buka secara default, kecuali jika diperbarui ke tutup.
canReopen

boolean

Hanya output. Menunjukkan apakah bisnis ini memenuhi syarat untuk dibuka kembali.
openingDate

object (Date)

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

boolean

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 getGoogleUpdated untuk mencari informasi yang perlu diverifikasi.
hasPendingEdits

boolean

Hanya output. Menunjukkan apakah salah satu properti Lokasi ini berada dalam status hasil edit menunggu keputusan.
canDelete

boolean

Hanya output. Menunjukkan apakah lokasi dapat dihapus menggunakan API.
canOperateLocalPost

boolean

Hanya output. Menunjukkan apakah listingan dapat mengelola postingan lokal.
canModifyServiceList

boolean

Hanya output. Menunjukkan apakah listingan dapat mengubah daftar layanan.
canHaveFoodMenus

boolean

Hanya output. Menunjukkan apakah listingan memenuhi syarat untuk menu makanan.
canOperateHealthData

boolean

Hanya output. Menunjukkan apakah lokasi dapat beroperasi pada data Kesehatan.
canOperateLodgingData

boolean

Hanya output. Menunjukkan apakah lokasi dapat beroperasi pada data Penginapan.
placeId

string

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

string

Hanya output. Resource lokasi yang diduplikasi lokasi ini.
mapsUri

string

Hanya output. Link ke lokasi di Maps.
newReviewUri

string

Hanya output. Link ke halaman di Google Penelusuran yang dapat digunakan pelanggan untuk memberikan ulasan lokasi.
canHaveBusinessCalls

boolean

Hanya output. Menunjukkan apakah listingan memenuhi syarat untuk panggilan bisnis.
hasVoiceOfMerchant

boolean

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

string

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 (RelevantLocation)
  },
  "childrenLocations": [
    {
      object (RelevantLocation)
    }
  ],
  "parentChain": string
}
Kolom
parentLocation

object (RelevantLocation)

Lokasi induk yang terkait dengan lokasi ini.
childrenLocations[]

object (RelevantLocation)

Daftar lokasi turunan yang memiliki hubungan dengan lokasi ini.
parentChain

string

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 (RelationType)
}
Kolom
placeId

string

Wajib. Menentukan lokasi yang ada di sisi lain hubungan menurut placeID-nya.
relationType

enum (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 (TimePeriod)
    }
  ]
}
Kolom
hoursTypeId

string

Wajib. Jenis jam buka. Klien harus memanggil {#link businessCategory:BatchGet} untuk mendapatkan jenis jam yang didukung untuk kategori lokasi mereka.
periods[]

object (TimePeriod)

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 (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.
}
Kolom
price

object (Money)

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

object (StructuredServiceItem)

Opsional. Kolom ini akan ditetapkan sebagai kasus data layanan terstruktur.
freeFormServiceItem

object (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

string

Wajib. Kolom serviceTypeId adalah ID unik yang diberikan Google yang dapat ditemukan di ServiceType. Informasi ini disediakan oleh layanan rpc categories.batchGet.
description

string

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 (Label)
  }
}
Kolom
category

string

Wajib. Kolom ini menunjukkan nama kategori (yaitu ID stabil kategori). category dan serviceTypeId harus cocok dengan kemungkinan kombinasi yang diberikan di pesan Category.
label

object (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

string

Wajib. Nama tampilan untuk daftar harga, bagian, atau item.
description

string

Opsional. Deskripsi daftar harga, bagian, atau item.
languageCode

string

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

string

Tiga huruf kode mata uang yang ditentukan dalam ISO 4217.
units

string (int64 format)

Seluruh unit jumlah. Misalnya jika currencyCode adalah "USD", maka 1 unit adalah satu dolar AS.
nanos

integer

Jumlah satuan nano (10^-9) dari jumlah tersebut. Nilai harus antara -999.999.999 dan +999.999.999 inklusif. Jika units positif, nanos harus positif atau nol. Jika units nol, nanos bisa positif, nol, atau negatif. Jika units negatif, nanos harus negatif, atau nol. Misalnya,$-1,75 direpresentasikan sebagai units=-1 dan nanos=-750.000.000.

Metode

create

 Membuat Lokasi baru yang akan dimiliki oleh pengguna yang login.

list

 Menampilkan daftar lokasi untuk akun yang ditentukan.