REST Resource: accounts.locations

Resource: Location

Lokasi. Lihat artikel pusat bantuan untuk mengetahui deskripsi mendetail tentang kolom ini, atau endpoint kategori untuk mengetahui 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. 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 di dunia nyata, seperti yang digunakan secara konsisten di etalase, situs, dan 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" bukan "Google Inc. - Kantor Pusat Mountain View"). 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 penampungan (misalnya, "ATM BCA di Indomaret").
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 akurat dan tepat 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 etalase. Kolom ini tidak boleh ditetapkan untuk lokasi jenis 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 lokasi bisnis individual ini, bukan situs/URL umum yang merepresentasikan semua lokasi atau merek.
regularHours

object (BusinessHours)

Opsional. Jam buka bisnis.
specialHours

object (SpecialHours)

Opsional. Jam khusus untuk bisnis. Hal ini biasanya mencakup jam buka hari libur, dan waktu lain di luar jam buka reguler. Jam buka ini menggantikan jam buka reguler. Kolom ini tidak dapat ditetapkan tanpa jam buka reguler.
serviceArea

object (ServiceAreaBusiness)

Opsional. Bisnis jasa sistem panggilan menyediakan layanannya 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 Anda. Label ini TIDAK ditampilkan kepada pengguna; hanya Anda yang dapat melihatnya. Harus terdiri dari 1-255 karakter per label.
adWordsLocationExtensions

object (AdWordsLocationExtensions)

Opsional. Informasi tambahan yang ditampilkan di AdWords.
latlng

object (LatLng)

Opsional. Lintang dan bujur yang diberikan pengguna. Saat membuat lokasi, kolom ini akan diabaikan jika alamat yang diberikan berhasil di-geocoding. Kolom ini hanya ditampilkan pada 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 saat ini buka untuk bisnis.
metadata

object (Metadata)

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

object (Profile)

Opsional. Mendeskripsikan bisnis Anda dengan gaya Anda sendiri serta menyampaikan kisah unik tentang bisnis dan penawaran Anda kepada pengguna.

Kolom ini wajib diisi untuk semua kategori kecuali kategori penginapan (misalnya, 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 dari suatu bisnis.
serviceItems[]

object (ServiceItem)

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

PhoneNumbers

Kumpulan nomor telepon untuk bisnis. Selama update, kedua kolom harus ditetapkan. Klien tidak boleh memperbarui hanya nomor telepon utama atau tambahan menggunakan update mask. 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 terhubung ke setiap lokasi bisnis Anda secara langsung. Gunakan nomor telepon lokal, bukan nomor saluran bantuan pusat panggilan sentral, jika memungkinkan.
additionalPhones[]

string

Opsional. Hingga dua nomor telepon (ponsel atau telepon rumah, bukan faks) yang dapat dihubungi 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 update mask.

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. Agar informasi bisnis Anda tetap akurat dan dipublikasikan, 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 menggambarkan bisnis ini (bukan apa yang dilakukannya). Untuk mengetahui 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 mengubah 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 buka regulernya.

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

string

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

string

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

string

Hanya output. Nama tampilan yang dilokalkan dan dapat dibaca manusia untuk jenis jam buka.

PostalAddress

Merupakan alamat pos, seperti untuk pengiriman pos atau alamat pembayaran. Dengan alamat pos, layanan pos dapat mengirimkan item ke tempat, kotak pos, atau yang serupa. Alamat pos tidak dimaksudkan untuk memodelkan lokasi geografis seperti jalan, kota, atau gunung.

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

Saran terkait input atau pengeditan alamat:

  • Gunakan widget alamat yang mendukung internasionalisasi seperti https://github.com/google/libaddressinput.
  • Pengguna tidak boleh diberi elemen UI untuk mengisi atau mengedit kolom selain negara tempat kolom tersebut digunakan.

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

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

integer

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

Semua revisi baru harus kompatibel dengan revisi lama.
regionCode

string

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

string

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

Jika nilai ini tidak diketahui, nilai ini harus dihilangkan (daripada menentukan kemungkinan default yang salah).

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

string

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

string

Opsional. Kode pengurutan tambahan khusus negara. Kode ini tidak digunakan di sebagian besar wilayah. Jika digunakan, nilainya berupa string seperti "CEDEX", yang dapat diikuti dengan angka (misalnya, "CEDEX 7"), atau hanya angka saja, yang mewakili "kode sektor" (Jamaika), "indikator area pengiriman" (Malawi), atau "indikator kantor pos" (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. Untuk Spanyol, ini adalah provinsi dan bukan komunitas otonom (misalnya, "Barcelona" dan bukan "Catalunya"). Banyak negara tidak menggunakan wilayah administratif dalam alamat pos. Misalnya, di Swiss, kolom ini harus dibiarkan kosong.
locality

string

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

string

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

string

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

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

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

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

string

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

string

Opsional. Nama organisasi di alamat.

BusinessHours

Menunjukkan jangka waktu lokasi ini buka untuk bisnis. Menyimpan kumpulan instance [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod].

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

object (TimePeriod)

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

TimePeriod

Menunjukkan rentang waktu buka bisnis, mulai dari hari/waktu buka yang ditentukan dan tutup pada hari/waktu tutup yang ditentukan. Waktu tutup harus setelah waktu buka, misalnya pada 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 dimulainya periode ini.
openTime

object (TimeOfDay)

Wajib. Nilai yang valid adalah 00.00-24.00, dengan 24.00 mewakili tengah malam di akhir kolom hari yang ditentukan. Catatan: Dalam pemetaan JSON Proto3, nilai nol default (00:00) dihilangkan, sehingga menghasilkan {} untuk openTime.
closeDay

enum (DayOfWeek)

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

object (TimeOfDay)

Wajib. Nilai yang valid adalah 00.00-24.00, dengan 24.00 mewakili tengah malam di akhir kolom hari yang ditentukan. Catatan: Dalam pemetaan JSON Proto3, nilai nol default (00:00) dihilangkan, sehingga menghasilkan {} untuk closeTime.

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

Merepresentasikan waktu dalam sehari. 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 sehari dalam format 24 jam. Harus lebih besar dari atau sama dengan 0 dan biasanya harus kurang dari atau sama dengan 23. API dapat memilih untuk mengizinkan nilai "24:00:00" untuk skenario seperti waktu tutup bisnis.
minutes

integer

Menit dalam satu jam. Harus lebih besar dari atau sama dengan 0 dan kurang dari atau sama dengan 59.
seconds

integer

Detik dalam menit. Harus lebih besar dari atau sama dengan 0 dan biasanya harus kurang dari atau sama dengan 59. API dapat mengizinkan nilai 60 jika mengizinkan detik kabisat.
nanos

integer

Pecahan detik, dalam nanodetik. Harus lebih besar dari atau sama dengan 0 dan kurang dari atau sama dengan 999.999.999.

SpecialHours

Menunjukkan kumpulan jangka waktu saat jam operasional lokasi berbeda dengan jam buka normalnya.

Representasi JSON 
{
  "specialHourPeriods": [
    {
      object (SpecialHourPeriod)
    }
  ]
}
Kolom
specialHourPeriods[]

object (SpecialHourPeriod)

Wajib. Daftar pengecualian untuk jam buka reguler bisnis.

SpecialHourPeriod

Merepresentasikan satu jangka waktu saat jam operasional lokasi berbeda dari jam buka normalnya. Periode jam khusus harus mewakili rentang kurang dari 24 jam. openTime dan startDate harus mendahului closeTime dan endDate. closeTime dan endDate dapat diperpanjang 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 mewakili 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 defaultnya adalah tanggal yang ditentukan di startDate. Jika ditetapkan, kolom ini harus sama dengan atau maksimal 1 hari setelah startDate.
closeTime

object (TimeOfDay)

Opsional. Nilai yang valid adalah 00.00-24.00, dengan 24.00 mewakili tengah malam di akhir kolom hari yang ditentukan. Harus ditentukan jika closed salah.
closed

boolean

Opsional. Jika benar, endDate, openTime, dan closeTime akan diabaikan, dan tanggal yang ditentukan dalam startDate akan diperlakukan sebagai lokasi yang tutup sepanjang hari.

Tanggal

Merepresentasikan tanggal kalender lengkap atau sebagian, seperti ulang tahun. Waktu dan zona waktu ditentukan di tempat lain atau tidak signifikan. Tanggalnya relatif terhadap Kalender Gregorian. Hal ini dapat mewakili salah satu dari hal berikut:

  • Tanggal lengkap, dengan nilai tahun, bulan, dan hari selain 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 dari tanggal. Harus dari 1 hingga 9999, atau 0 untuk menentukan tanggal tanpa tahun.
month

integer

Bulan dalam satu tahun. 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 layanannya 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 [jenis] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] bisnis jasa sistem panggilan.
places

object (Places)

Opsional. Area yang dilayani bisnis ini ditentukan melalui serangkaian 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 diabaikan jika tidak.

Wilayah yang ditentukan di sini dapat berbeda dengan wilayah untuk area yang dilayani bisnis ini (misalnya, 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 bisnis dan di lokasi pelanggan (misalnya, restoran pizza dengan area makan, yang juga melayani 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 field mask storefrontAddress dan menetapkan kolom ke kosong.
CUSTOMER_AND_BUSINESS_LOCATION Menawarkan layanan di alamat bisnis dan area sekitarnya.

Tempat

Menentukan gabungan area yang diwakili oleh sekumpulan tempat.

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

object (PlaceInfo)

Opsional. Area yang diwakili oleh ID tempat. Dibatasi hingga maksimum 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 region. (https://developers.google.com/places/web-service/supported_types#table3)

AdWordsLocationExtensions

Informasi tambahan yang ditampilkan di AdWords.

Representasi JSON 
{
  "adPhone": string
}
Kolom
adPhone

string

Wajib. Nomor telepon alternatif untuk 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 terkait status buka bisnis.

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

enum (OpenForBusiness)

Wajib. Menunjukkan apakah Lokasi saat ini buka untuk bisnis atau tidak. Semua lokasi buka secara default, kecuali jika diperbarui menjadi 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 yang tepat tidak diketahui, hanya bulan dan tahun yang dapat diberikan. Tanggal harus berada di masa lalu atau tidak lebih dari satu tahun di masa mendatang.

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 ditutup 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,
  "isParticularlyPersonalPlace": boolean
}
Kolom
hasGoogleUpdated

boolean

Hanya output. Menunjukkan apakah ID tempat yang terkait 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
(deprecated)

boolean

Hanya output. Tidak digunakan lagi: Kolom ini tidak lagi diisi dan akan dihapus di versi mendatang.
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 Agen Penjual. Jika boolean ini salah, Anda harus memanggil API locations.getVoiceOfMerchantState untuk mendapatkan detail alasan mereka tidak memiliki Voice of Merchant.
isParticularlyPersonalPlace

boolean

Hanya output. Menunjukkan apakah lokasi diklasifikasikan sebagai tempat yang sangat pribadi. Artinya, ada batasan pada fitur Histori Lokasi. Jika Anda yakin bahwa hal ini merupakan kekeliruan, lihat artikel pusat bantuan.

Profil

Semua informasi yang berkaitan dengan profil lokasi.

Representasi JSON 
{
  "description": string
}
Kolom
description

string

Wajib. Deskripsi lokasi dengan kata-kata 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)

Opsional. Lokasi induk yang memiliki hubungan dengan lokasi ini.
childrenLocations[]

object (RelevantLocation)

Opsional. Daftar lokasi turunan yang memiliki hubungan dengan lokasi ini.
parentChain

string

Opsional. Nama resource Jaringan Bisnis yang mencakup lokasi ini. [Cara menemukan ID Jaringan Bisnis] [Locations.SearchChains]

RelevantLocation

Informasi tentang lokasi lain yang terkait dengan lokasi saat ini. Hubungannya dapat berupa 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 berada di sisi lain relasi berdasarkan placeID-nya.
relationType

enum (RelationType)

Wajib. Jenis hubungan.

RelationType

Jenis hubungan yang akan ditentukan.

Enum
RELATION_TYPE_UNSPECIFIED Jenis tidak ditentukan.
DEPARTMENT_OF Hal ini menunjukkan hubungan antara 2 lokasi yang berbagi satu area fisik, merek/manajemen/organisasi yang sama, tetapi dengan atribut utama yang berbeda seperti jam buka toko atau nomor telepon. Misalnya, Costco Pharmacy adalah departemen di Costco Wholesale.
INDEPENDENT_ESTABLISHMENT_IN Hal ini menunjukkan kasus saat 2 lokasi berada di lokasi fisik yang sama, tetapi dari perusahaan yang berbeda (misalnya, Starbucks di Safeway, toko di 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 businessCategories:BatchGet} untuk mendapatkan jenis jam yang didukung untuk kategori lokasi mereka.
periods[]

object (TimePeriod)

Wajib. Kumpulan waktu buka lokasi ini. 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, potong rambut dapat menjadi layanan.

Representasi JSON 
{
  "price": {
    object (Money)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "structuredServiceItem": {
    object (StructuredServiceItem)
  },
  "freeFormServiceItem": {
    object (FreeFormServiceItem)
  }
  // End of mutually exclusive fields.
}
Kolom
price

object (Money)

Opsional. Menunjukkan harga uang item layanan. Sebaiknya currencyCode dan unit ditetapkan saat menyertakan harga. Harga ini akan diperlakukan sebagai harga tetap untuk item layanan.
Salah satu kolom berikut harus selalu ditetapkan. Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
structuredServiceItem

object (StructuredServiceItem)

Opsional. Kolom ini akan ditetapkan jika data layanan terstruktur.
freeFormServiceItem

object (FreeFormServiceItem)

Opsional. Kolom ini akan ditetapkan jika data layanan berbentuk bebas.
Akhir kolom yang saling eksklusif.

StructuredServiceItem

Merepresentasikan 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 disediakan 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. Layanan ini tidak ditampilkan sebagai bagian dari data layanan terstruktur kami. Penjual memasukkan nama untuk layanan tersebut secara manual menggunakan platform geomerchant.

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 yang diberi tag bahasa untuk item. Sebaiknya nama item berisi maksimal 140 karakter, dan deskripsi berisi maksimal 250 karakter. Kolom ini hanya boleh ditetapkan jika inputnya adalah item layanan kustom. Jenis layanan standar harus diperbarui menggunakan 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 set label yang dapat ditetapkan per bahasa.

Uang

Mewakili 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. Nilainya harus antara -999.999.999 dan +999.999.999 inklusif. Jika units positif, nanos harus positif atau nol. Jika units nol, nanos dapat positif, nol, atau negatif. Jika units negatif, nanos harus negatif atau nol. Misalnya,$-1,75 ditampilkan sebagai units=-1 dan nanos=-750.000.000.

Metode

create

 Membuat Lokasi baru yang akan dimiliki oleh pengguna yang login.

list

 Mencantumkan lokasi untuk akun yang ditentukan.