REST Resource: 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.

Metode

delete

Menghapus lokasi.

get

Menampilkan lokasi yang ditentukan.

getAttributes

Mencari semua atribut yang ditetapkan untuk lokasi tertentu.

getGoogleUpdated

Mendapatkan versi yang diperbarui Google untuk lokasi yang ditentukan.

patch

Memperbarui lokasi yang ditentukan.

updateAttributes

Memperbarui atribut untuk lokasi tertentu.