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

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.