REST Resource: accounts.locations

Resource: Lokasi

Lokasi. Lihat artikel pusat bantuan untuk mengetahui 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 data 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 referensi lainnya (misalnya, Address, Categories). Jangan menambahkan 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 pembatasan (misalnya, "ATM Chase di Tangerang").
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 maksimal lima nilai addressLines di alamat. Kolom ini hanya boleh ditetapkan untuk bisnis yang memiliki muka bangunan. Kolom ini tidak boleh ditetapkan untuk lokasi berjenis CUSTOMER_LOCATION_ONLY, tetapi jika ditetapkan, nilai apa pun yang diberikan akan dihapus.
websiteUri

string

Opsional. URL untuk bisnis ini. Jika memungkinkan, gunakan URL yang merepresentasikan setiap lokasi bisnis ini, bukan situs/URL generik yang mewakili semua lokasi atau brand.
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 buka 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 menjelaskan area yang dilayani oleh bisnis tersebut.
labels[]

string

Opsional. Kumpulan string bentuk bebas untuk memungkinkan Anda memberi tag pada bisnis. Label ini TIDAK ditampilkan kepada pengguna; hanya Anda yang bisa 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 saat permintaan GET jika nilai latlng yang diberikan pengguna diterima 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 tersebut saat ini buka.
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 ada 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 lainnya untuk berbagai departemen atau pelanggan tertentu dalam bisnis.
serviceItems[]

object (ServiceItem)

Opsional. Daftar layanan yang didukung oleh penjual. Layanan dapat potong rambut, memasang pemanas air, dll. Item servis duplikat akan otomatis dihapus.

PhoneNumbers

Kumpulan nomor telepon untuk bisnis. Selama update, kedua kolom harus ditetapkan. Klien tidak boleh hanya memperbarui nomor telepon utama atau tambahan menggunakan mask pembaruan. Lebih disarankan format telepon internasional, 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 (seluler 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 mengupdate kategori utama atau tambahan satu per satu menggunakan mask update.

Representasi JSON 
{
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ]
}
Kolom
primaryCategory

object (Category)

Wajib. Kategori yang paling menggambarkan bisnis inti yang dijalankan 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 Anda tetap akurat dan aktif, pastikan Anda menggunakan sesedikit mungkin kategori untuk menggambarkan bisnis inti Anda secara keseluruhan. Pilih kategori yang sespesifik mungkin, tetapi merepresentasikan bisnis utama Anda.

Kategori

Kategori yang mendeskripsikan jenis bisnis ini (bukan layanannya). 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 memodifikasi 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 oleh 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 oleh bisnis, selain jam buka reguler.

Representasi JSON 
{
  "hoursTypeId": string,
  "displayName": string,
  "localizedDisplayName": string
}
Kolom
hoursTypeId

string

Hanya output. ID stabil yang disediakan oleh Google untuk jenis jam buka 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

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

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

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

Opsional. Nama organisasi di alamat.

BusinessHours

Menyatakan 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 operasional lokasi ini. Setiap periode mewakili rentang jam buka lokasi tersebut selama seminggu.

TimePeriod

Menyatakan rentang waktu saat bisnis buka, dimulai pada hari/waktu buka yang ditentukan dan tutup pada hari/waktu tutup yang ditentukan. Waktu tutup harus terjadi setelah jam buka, misalnya di kemudian hari di hari yang sama, atau di 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.

Enum
DAY_OF_WEEK_UNSPECIFIED Hari 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 memungkinkan 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 waktu tutup bisnis.
minutes

integer

Menit dalam jam. Harus dari 0 hingga 59.
seconds

integer

Detik dalam waktu. Biasanya harus dari 0 hingga 59. API dapat mengizinkan nilai 60 jika memungkinkan lompatan-detik.
nanos

integer

Pecahan detik dalam nanodetik. Harus dari 0 hingga 999.999.999.

SpecialHours

Merepresentasikan kumpulan jangka waktu jika 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 kurang dari 24 jam. openTime dan startDate harus terjadi sebelum closeTime dan endDate. closeTime dan endDate dapat diperluas ke 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 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 dalam 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 dalam startDate diperlakukan 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 ini relatif terhadap Kalender Gregorian. ID ini dapat mewakili salah satu dari hal berikut:

  • Tanggal lengkap, dengan nilai tahun, bulan, dan hari bukan nol.
  • Bulan dan hari, dengan tahun nol (misalnya, hari jadi).
  • Tahun saja, dengan bulan nol dan hari nol.
  • Tahun dan bulan, dengan hari nol (misalnya, tanggal habis masa berlaku kartu kredit).

Jenis terkait:

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

integer

Tahun dalam 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 hingga 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 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 kumpulan 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 detailnya. Contoh: "CH" untuk Swiss.

Kolom ini wajib diisi untuk bisnis CUSTOMER_LOCATION_ONLY, dan akan diabaikan jika tidak digunakan.

Wilayah yang ditentukan di sini dapat berbeda dengan wilayah untuk area yang dilayani bisnis ini (mis. bisnis jasa sistem panggilan yang menyediakan layanan di wilayah selain wilayah tempat bisnis tersebut 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 tempat (misalnya, toko pizza dengan ruang makan, yang juga melakukan pengiriman ke pelanggan).

Enum
BUSINESS_TYPE_UNSPECIFIED Hanya output. Tidak ditentukan.
CUSTOMER_LOCATION_ONLY Menawarkan layanan hanya di area sekitar (bukan di alamat bisnis). Jika bisnis diperbarui dari CUSTOMER_AND_BUSINESS_LOCATION menjadi CUSTOMER_LOCATION_ONLY, pembaruan lokasi harus menyertakan mask kolom storefrontAddress dan mengosongkan kolom tersebut.
CUSTOMER_AND_BUSINESS_LOCATION Menawarkan layanan di alamat bisnis dan area sekitarnya.

Tempat

Menentukan gabungan area yang diwakili oleh kumpulan tempat.

Representasi JSON 
{
  "placeInfos": [
    {
      object (PlaceInfo)
    }
  ]
}
Kolom
placeInfos[]

object (PlaceInfo)

Area yang diwakili oleh ID tempat. Dibatasi maksimal 20 tempat.

PlaceInfo

Menentukan area yang diwakili 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 jika 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 menjadi tutup.
canReopen

boolean

Hanya output. Menunjukkan apakah bisnis ini memenuhi syarat untuk buka 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 waktu lampau 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 tentang lokasi yang tidak dapat diedit pengguna.

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 terkait dengan lokasi ini memiliki update yang perlu diupdate atau ditolak oleh klien. Jika boolean ini disetel, Anda harus memanggil metode getGoogleUpdated untuk mencari informasi yang perlu diverifikasi.
hasPendingEdits

boolean

Hanya output. Menunjukkan apakah salah satu properti Lokasi ini 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 oleh lokasi ini.
mapsUri

string

Hanya output. Link ke lokasi di Maps.
newReviewUri

string

Hanya output. Link ke halaman di Google Penelusuran tempat pelanggan dapat memberikan ulasan untuk 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 API locations.getVoiceOfMerchantState untuk mendapatkan detail terkait alasan mengapa lokasi 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 gaya Anda sendiri yang 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 memiliki hubungan 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. Relasi 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. Tentukan lokasi yang ada di sisi lain relasi berdasarkan placeID-nya.
relationType

enum (RelationType)

Wajib. Jenis hubungan.

RelationType

Jenis hubungan yang akan ditentukan.

Enum
RELATION_TYPE_UNSPECIFIED Jenis belum ditetapkan.
DEPARTMENT_OF Ini mewakili hubungan antara 2 lokasi yang memiliki satu area fisik yang sama, merek/pengelolaan tingkat atas/organisasi yang sama, tetapi dengan atribut utama yang berbeda seperti jam buka toko atau nomor telepon. Misalnya, Apotek Costco adalah departemen di Costco Glesale.
INDEPENDENT_ESTABLISHMENT_IN Ini mewakili kasus saat 2 lokasi ditempatkan di lokasi fisik yang sama, tetapi dari perusahaan yang berbeda (mis. Starbucks di Safeway, pertokoan di mal).

MoreHours

Jangka waktu lokasi buka untuk jenis bisnis tertentu.

Representasi JSON 
{
  "hoursTypeId": string,
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
Kolom
hoursTypeId

string

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

object (TimePeriod)

Wajib. Kumpulan waktu buka lokasi ini. Setiap periode mewakili rentang jam buka lokasi tersebut selama seminggu.

ServiceItem

Pesan yang menjelaskan satu item layanan. Atribut ini digunakan untuk menjelaskan jenis layanan yang disediakan penjual. Misalnya, potong rambut bisa berupa layanan.

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. Menampilkan harga uang dari item layanan. Sebaiknya mata uang dan satuan ditetapkan saat menyertakan harga. Harga ini akan dianggap sebagai harga tetap untuk item layanan.
Kolom union service_item_info. Salah satu kolom berikut harus selalu ditetapkan. service_item_info hanya dapat berupa salah satu dari berikut:
structuredServiceItem

object (StructuredServiceItem)

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

object (FreeFormServiceItem)

Opsional. Kolom ini akan ditetapkan sebagai kasus 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 karakter 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 memasukkan nama layanan tersebut secara manual melalui platform geopenjual.

Representasi JSON 
{
  "category": string,
  "label": {
    object (Label)
  }
}
Kolom
category

string

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

object (Label)

Wajib. Label dengan tag bahasa untuk item. Sebaiknya nama item terdiri dari 140 karakter atau kurang, dan deskripsi terdiri dari 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 diterapkan dengan 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

Kode mata uang tiga huruf yang ditentukan dalam ISO 4217.
units

string (int64 format)

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

integer

Jumlah unit nano (10^-9) dari jumlah tersebut. Nilainya 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.