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,
  "locationName": string,
  "primaryPhone": string,
  "additionalPhones": [
    string
  ],
  "address": {
    object (PostalAddress)
  },
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ],
  "websiteUrl": string,
  "regularHours": {
    object (BusinessHours)
  },
  "specialHours": {
    object (SpecialHours)
  },
  "serviceArea": {
    object (ServiceAreaBusiness)
  },
  "locationKey": {
    object (LocationKey)
  },
  "labels": [
    string
  ],
  "adWordsLocationExtensions": {
    object (AdWordsLocationExtensions)
  },
  "latlng": {
    object (LatLng)
  },
  "openInfo": {
    object (OpenInfo)
  },
  "locationState": {
    object (LocationState)
  },
  "attributes": [
    {
      object (Attribute)
    }
  ],
  "metadata": {
    object (Metadata)
  },
  "priceLists": [
    {
      object (PriceList)
    }
  ],
  "profile": {
    object (Profile)
  },
  "relationshipData": {
    object (RelationshipData)
  },
  "moreHours": [
    {
      object (MoreHours)
    }
  ]
}
Kolom
name

string

ID Google untuk lokasi ini dalam bentuk: accounts/{accountId}/locations/{locationId}

Dalam konteks kecocokan, kolom ini tidak akan diisi.

languageCode

string

Bahasa lokasi. Ditetapkan selama pembuatan dan tidak dapat diperbarui.

storeCode

string

ID eksternal untuk lokasi ini, yang harus unik di dalam akun tertentu. Ini adalah cara untuk mengaitkan lokasi dengan data Anda sendiri.

locationName

string

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

primaryPhone

string

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

Maksimal dua nomor telepon (seluler atau telepon rumah, bukan faks) yang dapat digunakan untuk menghubungi bisnis Anda, selain nomor telepon utama.

address

object (PostalAddress)

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.

primaryCategory

object (Category)

Kategori yang paling menggambarkan bisnis inti yang dijalankan lokasi ini.

additionalCategories[]

object (Category)

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.

websiteUrl

string

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)

Jam operasional bisnis.

specialHours

object (SpecialHours)

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.

serviceArea

object (ServiceAreaBusiness)

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.

locationKey

object (LocationKey)

Kumpulan kunci yang menautkan bisnis ini ke properti Google lainnya, seperti halaman Google+ dan Google Maps Places.

labels[]

string

Kumpulan string bentuk bebas untuk memungkinkan Anda memberi tag pada bisnis. Label ini TIDAK ditampilkan kepada pengguna; hanya Anda yang bisa melihatnya. Dibatasi hingga 255 karakter (per label).

adWordsLocationExtensions

object (AdWordsLocationExtensions)

Informasi tambahan yang muncul di AdWords.

latlng

object (LatLng)

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 Profil Bisnis. Kolom ini tidak dapat diperbarui.

openInfo

object (OpenInfo)

Tanda yang menunjukkan apakah lokasi tersebut saat ini buka.

locationState

object (LocationState)

Hanya output. Kumpulan boolean yang mencerminkan status lokasi.

attributes[]

object (Attribute)

Atribut untuk lokasi ini.

metadata

object (Metadata)

Hanya Output. Informasi tambahan yang tidak dapat diedit pengguna.

priceLists[]
(deprecated)

object (PriceList)

Tidak digunakan lagi: Informasi daftar harga untuk lokasi ini.

profile

object (Profile)

Mendeskripsikan bisnis Anda dengan gaya Anda sendiri dan membagikan kisah unik tentang bisnis dan penawaran Anda kepada pengguna.

relationshipData

object (RelationshipData)

Semua lokasi dan jaringan bisnis yang terkait dengan lokasi ini.

moreHours[]

object (MoreHours)

Jam buka lainnya untuk berbagai departemen atau pelanggan tertentu dalam bisnis.

BusinessHours

Menyatakan jangka waktu saat lokasi ini buka. Menyimpan kumpulan instance TimePeriod.

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

object (TimePeriod)

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": string,
  "closeDay": enum (DayOfWeek),
  "closeTime": string
}
Kolom
openDay

enum (DayOfWeek)

Menunjukkan day of the week periode ini dimulai.

openTime

string

Waktu dalam format diperluas ISO 8601 24 jam (hh:mm). Nilai yang valid adalah 00.00-24.00, dengan 24.00 merepresentasikan tengah malam di akhir kolom hari yang ditentukan.

closeDay

enum (DayOfWeek)

Menunjukkan day of the week periode ini berakhir.

closeTime

string

Waktu dalam format diperluas ISO 8601 24 jam (hh:mm). 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

SpecialHours

Merepresentasikan kumpulan jangka waktu jika jam operasional lokasi berbeda dari jam buka normalnya.

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

object (SpecialHourPeriod)

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": string,
  "endDate": {
    object (Date)
  },
  "closeTime": string,
  "isClosed": boolean
}
Kolom
startDate

object (Date)

Tanggal kalender periode jam khusus ini dimulai.

openTime

string

Waktu proses di startDate saat lokasi dibuka, yang dinyatakan dalam format diperluas ISO 8601 24 jam. (hh:mm) Nilai yang valid adalah 00:00-24:00, dengan 24:00 merepresentasikan tengah malam di akhir kolom hari yang ditentukan. Harus ditentukan jika isClosed salah.

endDate

object (Date)

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

string

Waktu proses di endDate saat lokasi tutup, yang dinyatakan dalam format diperpanjang ISO 8601 24 jam. (hh:mm) Nilai yang valid adalah 00:00-24:00, dengan 24:00 merepresentasikan tengah malam di akhir kolom hari yang ditentukan. Harus ditentukan jika isClosed salah.

isClosed

boolean

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

ServiceAreaBusiness

Bisnis jasa sistem panggilan menyediakan layanan di lokasi pelanggan (misalnya, tukang kunci atau tukang leding).

Representasi JSON
{
  "businessType": enum (BusinessType),

  // Union field coverageArea can be only one of the following:
  "radius": {
    object (PointRadius)
  },
  "places": {
    object (Places)
  }
  // End of list of possible types for union field coverageArea.
}
Kolom
businessType

enum (BusinessType)

Menunjukkan type bisnis jasa sistem panggilan.

Kolom union coverageArea. Menunjukkan area cakupan tempat bisnis menawarkan layanan. coverageArea hanya dapat berupa salah satu dari berikut:
radius

object (PointRadius)

Hanya output. Area layanan bisnis ini yang berpusat pada satu titik.

places

object (Places)

Area yang dilayani bisnis ini yang ditentukan melalui kumpulan tempat.

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).
CUSTOMER_AND_BUSINESS_LOCATION Menawarkan layanan di alamat bisnis dan area sekitarnya.

PointRadius

Radius di sekitar titik tertentu (lintang/bujur).

Representasi JSON
{
  "latlng": {
    object (LatLng)
  },
  "radiusKm": number
}
Kolom
latlng

object (LatLng)

Lintang/bujur yang menentukan pusat area yang didefinisikan oleh radius.

radiusKm

number

Jarak dalam kilometer untuk area di sekitar titik.

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

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
{
  "name": string,
  "placeId": string
}
Kolom
name

string

Nama tempat yang dilokalkan. Misalnya, Scottsdale, AZ.

placeId

string

ID tempat. Harus sesuai dengan wilayah.

LocationKey

Referensi kunci alternatif/pengganti untuk lokasi.

Representasi JSON
{
  "plusPageId": string,
  "placeId": string,
  "explicitNoPlaceId": boolean,
  "requestId": string
}
Kolom
plusPageId

string

Hanya output. Jika lokasi ini memiliki halaman Google+ yang terkait dengannya, lokasi ini diisi dengan ID halaman Google+ untuk lokasi ini.

placeId

string

Jika lokasi ini telah diverifikasi dan terhubung ke/muncul di Google Maps, kolom ini diisi dengan ID tempat untuk lokasi. ID ini dapat digunakan di berbagai Places API.

Jika lokasi ini tidak diverifikasi, kolom ini mungkin diisi jika lokasi telah dikaitkan dengan tempat yang muncul di Google Maps.

Kolom ini dapat ditetapkan selama panggilan Create, tetapi tidak untuk Update.

Bool explicitNoPlaceId tambahan mengkualifikasi apakah ID tempat sengaja tidak ditetapkan atau tidak.

explicitNoPlaceId

boolean

Hanya output. Nilai true menunjukkan bahwa ID tempat yang tidak ditetapkan disengaja, yang berbeda karena belum ada pengaitan yang dibuat.

requestId

string

Hanya output. requestId yang digunakan untuk membuat lokasi ini. Mungkin kosong jika lokasi ini dibuat di luar Google My Business API atau Lokasi Profil Bisnis.

AdWordsLocationExtensions

Informasi tambahan yang muncul di AdWords.

Representasi JSON
{
  "adPhone": string
}
Kolom
adPhone

string

Nomor telepon alternatif yang akan ditampilkan di ekstensi lokasi AdWords, bukan nomor telepon utama lokasi.

OpenInfo

Informasi yang terkait dengan status buka bisnis.

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

enum (OpenForBusiness)

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)

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. Nilai ini hanya dapat diterapkan ke lokasi yang dipublikasikan (yaitu locationState.is_publication = true). Saat memperbarui kolom status ke nilai ini, klien wajib menetapkan updateMask secara eksplisit ke openInfo.status. Tidak ada mask update lain yang dapat disetel selama panggilan update ini. Ini adalah pembatasan sementara yang akan segera dilonggarkan.

LocationState

Berisi kumpulan boolean yang mencerminkan status Lokasi.

Representasi JSON
{
  "isGoogleUpdated": boolean,
  "isDuplicate": boolean,
  "isSuspended": boolean,
  "canUpdate": boolean,
  "canDelete": boolean,
  "isVerified": boolean,
  "needsReverification": boolean,
  "isPendingReview": boolean,
  "isDisabled": boolean,
  "isPublished": boolean,
  "isDisconnected": boolean,
  "isLocalPostApiDisabled": boolean,
  "canModifyServiceList": boolean,
  "canHaveFoodMenus": boolean,
  "hasPendingEdits": boolean,
  "hasPendingVerification": boolean,
  "canOperateHealthData": boolean,
  "canOperateLodgingData": boolean
}
Kolom
isGoogleUpdated

boolean

Hanya output. Menunjukkan apakah ID tempat yang terkait dengan lokasi ini memiliki pembaruan.

isDuplicate

boolean

Hanya output. Menunjukkan apakah lokasi merupakan duplikat dari lokasi lain.

isSuspended

boolean

Hanya output. Menunjukkan apakah lokasi ditangguhkan. Lokasi yang ditangguhkan tidak terlihat oleh pengguna akhir di produk Google. Jika Anda yakin ini adalah kesalahan, lihat artikel pusat bantuan.

canUpdate

boolean

Hanya output. Menunjukkan apakah lokasi dapat diperbarui.

canDelete

boolean

Hanya output. Menunjukkan apakah lokasi dapat dihapus menggunakan Google My Business API.

isVerified

boolean

Hanya output. Menunjukkan apakah lokasi telah diverifikasi.

needsReverification

boolean

Hanya output. Menunjukkan apakah lokasi memerlukan verifikasi ulang.

isPendingReview

boolean

Hanya output. Menunjukkan apakah peninjauan lokasi tertunda.

isDisabled

boolean

Hanya output. Menunjukkan apakah lokasi dinonaktifkan.

isPublished

boolean

Hanya output. Menunjukkan apakah lokasi dipublikasikan.

isDisconnected

boolean

Hanya output. Menunjukkan apakah lokasi terputus dari suatu tempat di Google Maps.

isLocalPostApiDisabled

boolean

Hanya output. Menunjukkan apakah accounts.locations.localPosts dinonaktifkan untuk lokasi ini.

canModifyServiceList

boolean

Hanya output. Menunjukkan apakah listingan dapat mengubah ServiceList.

canHaveFoodMenus

boolean

Hanya output. Menunjukkan apakah listingan memenuhi syarat untuk menu makanan.

hasPendingEdits

boolean

Hanya output. Menunjukkan apakah salah satu properti Lokasi ini dalam status hasil edit menunggu keputusan.

hasPendingVerification

boolean

Hanya output. Menunjukkan apakah lokasi memiliki permintaan verifikasi yang tertunda.

canOperateHealthData

boolean

Hanya output. Menunjukkan apakah lokasi dapat beroperasi pada data Kesehatan.

canOperateLodgingData

boolean

Hanya output. Menunjukkan apakah lokasi dapat beroperasi pada data Penginapan.

Atribut

Atribut lokasi. Atribut memberikan informasi tambahan tentang lokasi. Atribut yang dapat ditetapkan pada lokasi dapat bervariasi berdasarkan properti lokasi tersebut (misalnya, kategori). Atribut yang tersedia ditentukan oleh Google dan dapat ditambahkan serta dihapus tanpa perubahan API.

Representasi JSON
{
  "attributeId": string,
  "valueType": enum (AttributeValueType),
  "values": [
    value
  ],
  "repeatedEnumValue": {
    object (RepeatedEnumAttributeValue)
  },
  "urlValues": [
    {
      object (UrlAttributeValue)
    }
  ]
}
Kolom
attributeId

string

ID atribut. ID atribut disediakan oleh Google.

valueType

enum (AttributeValueType)

Hanya output. Jenis nilai yang terdapat dalam atribut ini. Ini harus digunakan untuk menentukan cara menafsirkan nilai.

values[]

value (Value format)

Nilai untuk atribut ini. Jenis nilai yang diberikan harus cocok dengan yang diharapkan untuk atribut tersebut; lihat AttributeValueType. Ini adalah kolom berulang tempat beberapa nilai atribut dapat diberikan. Jenis atribut hanya mendukung satu nilai.

repeatedEnumValue

object (RepeatedEnumAttributeValue)

Jika jenis nilai atribut adalah REPEATED_ENUM, kolom ini berisi nilai atribut, dan kolom nilai lainnya harus kosong.

urlValues[]

object (UrlAttributeValue)

Jika jenis nilai atribut adalah URL, kolom ini berisi nilai untuk atribut ini, dan kolom nilai lainnya harus kosong.

RepeatedEnumAttributeValue

Nilai untuk atribut dengan valueType dari REPEATED_ENUM. Daftar ini terdiri dari dua daftar ID nilai: yang ditetapkan (benar) dan yang tidak ditetapkan (salah). Nilai yang tidak ada dianggap tidak diketahui. Minimal satu nilai harus ditentukan.

Representasi JSON
{
  "setValues": [
    string
  ],
  "unsetValues": [
    string
  ]
}
Kolom
setValues[]

string

Nilai enum yang ditetapkan.

unsetValues[]

string

Nilai enum yang tidak ditetapkan.

UrlAttributeValue

Nilai untuk atribut dengan valueType URL.

Representasi JSON
{
  "url": string
}
Kolom
url

string

URL.

Metadata

Informasi tambahan tentang lokasi yang tidak dapat diedit pengguna.

Representasi JSON
{
  "duplicate": {
    object (Duplicate)
  },
  "mapsUrl": string,
  "newReviewUrl": string
}
Kolom
duplicate
(deprecated)

object (Duplicate)

Informasi tentang lokasi yang diduplikasi oleh lokasi ini. Hanya ada jika locationState.is_duplicate benar. Tidak digunakan lagi: Kami tidak lagi mendukung informasi mendetail untuk duplikat.

mapsUrl

string

Link ke lokasi di Maps.

newReviewUrl

string

Link ke halaman di Google Penelusuran tempat pelanggan dapat memberikan ulasan untuk lokasi.

Duplikasikan

Informasi tentang lokasi yang diduplikasi oleh lokasi ini.

Representasi JSON
{
  "locationName": string,
  "placeId": string,
  "access": enum (Access)
}
Kolom
locationName

string

Nama resource lokasi yang diduplikasi lokasi ini. Hanya diisi jika pengguna terautentikasi memiliki hak akses ke lokasi tersebut dan lokasi tersebut tidak dihapus.

placeId

string

ID tempat lokasi yang diduplikasi oleh lokasi ini.

access

enum (Access)

Menunjukkan apakah pengguna memiliki akses ke lokasi yang diduplikasi.

Akses

Tingkat akses pengguna ke lokasi yang diduplikasi. Tindakan ini akan menggantikan Kepemilikan dan harus digunakan sebagai gantinya.

Enum
ACCESS_UNSPECIFIED Tidak ditentukan.
ACCESS_UNKNOWN Tidak dapat menentukan apakah pengguna memiliki akses ke lokasi yang diduplikasi.
ALLOWED Pengguna memiliki akses ke lokasi yang diduplikasi oleh lokasi tersebut.
INSUFFICIENT Pengguna tidak memiliki akses ke lokasi yang diduplikasi oleh lokasi tersebut.

PriceList

Tidak digunakan lagi: Daftar informasi harga item. Daftar harga disusun sebagai satu atau beberapa daftar harga, yang masing-masing berisi satu atau beberapa bagian dengan satu atau beberapa item. Misalnya, daftar harga makanan dapat merepresentasikan menu sarapan/makan siang/makan malam, dengan bagian untuk burger/steak/makanan laut.

Representasi JSON
{
  "priceListId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "sourceUrl": string,
  "sections": [
    {
      object (Section)
    }
  ]
}
Kolom
priceListId

string

Wajib. ID untuk daftar harga. ID daftar harga, bagian, dan item tidak dapat diduplikasi dalam Lokasi ini.

labels[]

object (Label)

Wajib. Label dengan tag bahasa untuk daftar harga.

sourceUrl

string

URL sumber opsional tempat daftar harga diambil. Misalnya, URL ini dapat berupa URL halaman yang disalin secara otomatis untuk mengisi informasi menu.

sections[]

object (Section)

Wajib. Bagian untuk daftar harga ini. Setiap daftar harga harus berisi setidaknya satu bagian.

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.

Bagian

Bagian dari daftar harga yang berisi satu atau beberapa item.

Representasi JSON
{
  "sectionId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "sectionType": enum (SectionType),
  "items": [
    {
      object (Item)
    }
  ]
}
Kolom
sectionId

string

Wajib. ID untuk bagian tersebut. ID daftar harga, bagian, dan item tidak dapat diduplikasi dalam Lokasi ini.

labels[]

object (Label)

Wajib. Label dengan tag bahasa untuk bagian tersebut. Sebaiknya nama dan deskripsi bagian terdiri dari 140 karakter atau kurang. Setidaknya satu kumpulan label wajib diisi.

sectionType

enum (SectionType)

Opsional. Jenis bagian daftar harga saat ini. Nilai defaultnya adalah FOOD.

items[]

object (Item)

Item yang terdapat dalam bagian daftar harga ini.

SectionType

Jenis bagian.

Enum
SECTION_TYPE_UNSPECIFIED Tidak ditentukan.
FOOD Bagian berisi item yang mewakili makanan.
SERVICES Bagian berisi item yang merepresentasikan layanan.

Item

Item daftar tunggal. Setiap variasi item dalam daftar harga harus memiliki Item sendiri dengan data harganya sendiri.

Representasi JSON
{
  "itemId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "price": {
    object (Money)
  }
}
Kolom
itemId

string

Wajib. ID untuk item. ID daftar harga, bagian, dan item tidak dapat diduplikasi dalam Lokasi ini.

labels[]

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. Setidaknya satu kumpulan label wajib diisi.

price

object (Money)

Opsional. Harga item.

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.

Profil

Semua informasi yang berkaitan dengan profil lokasi.

Representasi JSON
{
  "description": string
}
Kolom
description

string

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
{
  "parentChain": string
}
Kolom
parentChain

string

Nama resource Jaringan tempat lokasi ini menjadi anggota. How to find Chain ID

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.

Metode

associate

Mengaitkan lokasi ke ID tempat.

batchGet

Mendapatkan semua lokasi yang ditentukan di akun tertentu.

batchGetReviews

Menampilkan daftar ulasan bernomor halaman untuk semua lokasi yang ditentukan.

clearAssociation

Menghapus pengaitan antara lokasi dan ID tempatnya.

create

Membuat location baru yang dimiliki oleh akun yang ditentukan, dan menampilkannya.

delete

Menghapus lokasi.

fetchVerificationOptions

Melaporkan semua opsi verifikasi yang memenuhi syarat untuk lokasi dalam bahasa spesifik.

findMatches

Menemukan semua kemungkinan lokasi yang cocok dengan lokasi yang ditentukan.

get

Mendapatkan lokasi yang ditentukan.

getFoodMenus

Menampilkan menu makanan di lokasi tertentu.

getGoogleUpdated

Mendapatkan versi yang diperbarui Google untuk lokasi yang ditentukan.

getHealthProviderAttributes

Menampilkan atribut Penyedia layanan kesehatan untuk lokasi tertentu.

getServiceList

Mendapatkan daftar layanan lokasi yang ditentukan.

list

Menampilkan daftar lokasi untuk akun yang ditentukan.

patch

Memperbarui lokasi yang ditentukan.

reportInsights

Menampilkan laporan yang berisi insight tentang satu atau beberapa metrik berdasarkan lokasi.

transfer
(deprecated)

Memindahkan lokasi dari akun yang dimiliki pengguna ke akun lain yang dikelola oleh pengguna yang sama.

updateFoodMenus

Memperbarui menu makanan di lokasi tertentu.

updateHealthProviderAttributes

Memperbarui atribut Penyedia layanan kesehatan di lokasi tertentu.

updateServiceList

Memperbarui daftar layanan lokasi yang ditentukan.

verify

Memulai proses verifikasi untuk lokasi.