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

Metode

delete

Menghapus lokasi.

get

Menampilkan lokasi yang ditentukan seperti yang terakhir ditetapkan oleh penjual.

getAttributes

Mengambil atribut untuk lokasi seperti yang terakhir ditetapkan oleh penjual.

getGoogleUpdated

Menampilkan lokasi yang ditentukan seperti yang muncul di Google Maps dan Penelusuran.

patch

Memperbarui lokasi yang ditentukan.

updateAttributes

Memperbarui atribut untuk lokasi tertentu.