Schema

Definisi skema untuk sumber data.

Representasi JSON
{
  "objectDefinitions": [
    {
      object (ObjectDefinition)
    }
  ],
  "operationIds": [
    string
  ]
}
Kolom
objectDefinitions[]

object (ObjectDefinition)

Daftar objek tingkat atas untuk sumber data. Jumlah maksimum elemen adalah 10.

operationIds[]

string

ID Operasi Berjalan Lama (LRO) yang saat ini berjalan untuk skema ini. Setelah mengubah skema, tunggu hingga operasi selesai sebelum mengindeks konten tambahan.

ObjectDefinition

Definisi untuk objek dalam sumber data.

Representasi JSON
{
  "name": string,
  "options": {
    object (ObjectOptions)
  },
  "propertyDefinitions": [
    {
      object (PropertyDefinition)
    }
  ]
}
Kolom
name

string

Nama objek, yang kemudian menentukan jenisnya. Permintaan pengindeksan item harus menetapkan kolom objectType yang sama dengan nilai ini. Misalnya, jika name adalah Document, permintaan pengindeksan untuk item berjenis Dokumen harus menetapkan objectType sama dengan Dokumen. Setiap definisi objek harus diberi nama secara unik dalam skema. Nama harus diawali dengan huruf dan hanya boleh berisi huruf (A-Z, a-z) atau angka (0-9). Panjang maksimum adalah 256 karakter.

options

object (ObjectOptions)

Opsi opsional khusus objek.

propertyDefinitions[]

object (PropertyDefinition)

Definisi properti untuk objek. Jumlah maksimum elemen adalah 1.000.

ObjectOptions

Opsi untuk objek.

Representasi JSON
{
  "freshnessOptions": {
    object (ObjectOptions.FreshnessOptions)
  },
  "displayOptions": {
    object (ObjectDisplayOptions)
  },
  "suggestionFilteringOperators": [
    string
  ]
}
Kolom
freshnessOptions

object (ObjectOptions.FreshnessOptions)

Opsi keaktualan untuk objek.

displayOptions

object (ObjectDisplayOptions)

Opsi yang menentukan cara objek ditampilkan di halaman hasil Cloud Search.

suggestionFilteringOperators[]

string

Operator yang dapat digunakan untuk memfilter saran. Untuk query.suggest API, hanya operator yang disebutkan di sini yang akan diterima di FilterOptions. Hanya operator TEXT dan ENUM yang didukung.

CATATAN: "objecttype", "type", dan "mimetype" sudah didukung. Properti ini digunakan untuk mengonfigurasi operator khusus skema.

Meskipun ini adalah array, hanya satu operator yang dapat ditentukan. Ini adalah array untuk ekstensi di masa mendatang.

Operator yang melakukan pemetaan ke beberapa properti dalam objek yang sama tidak didukung. Jika operator mencakup berbagai jenis objek, opsi ini harus ditetapkan sekali untuk setiap definisi objek.

ObjectOptions.FreshnessOptions

Menunjukkan properti keaktualan mana yang akan digunakan saat menyesuaikan peringkat penelusuran untuk suatu item. Tanggal yang lebih baru dan lebih baru menunjukkan kualitas yang lebih tinggi. Gunakan properti opsi keaktualan yang paling sesuai dengan data Anda. Untuk dokumen fileshare, waktu terakhir diubah adalah waktu yang paling relevan. Untuk data acara kalender, waktu saat acara terjadi adalah indikator keaktualan yang lebih relevan. Dengan cara ini, acara kalender yang terjadi mendekati waktu kueri penelusuran dianggap berkualitas lebih tinggi dan diberi peringkat yang sesuai.

Representasi JSON
{
  "freshnessProperty": string,
  "freshnessDuration": string
}
Kolom
freshnessProperty

string

Properti ini menunjukkan tingkat keaktualan objek di indeks. Jika ditetapkan, properti ini harus berupa properti tingkat teratas dalam property definitions dan harus berupa timestamp type atau date type. Jika tidak, Indexing API akan menggunakan updateTime sebagai indikator keaktualan. Panjang maksimum adalah 256 karakter.

Jika properti digunakan untuk menghitung keaktualan, nilainya akan ditetapkan secara default ke 2 tahun dari waktu saat ini.

freshnessDuration

string (Duration format)

Durasi saat objek akan dianggap tidak berlaku. Nilai defaultnya adalah 180 hari (dalam detik).

Durasi dalam detik dengan paling banyak sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

ObjectDisplayOptions

Opsi tampilan untuk objek.

Representasi JSON
{
  "objectDisplayLabel": string,
  "metalines": [
    {
      object (ObjectDisplayOptions.Metaline)
    }
  ]
}
Kolom
objectDisplayLabel

string

Label yang mudah digunakan akan ditampilkan di hasil penelusuran untuk menunjukkan jenis item. Metode ini bersifat OPSIONAL; jika tidak diberikan, label objek tidak akan ditampilkan di baris konteks hasil penelusuran. Panjang maksimum adalah 64 karakter.

metalines[]

object (ObjectDisplayOptions.Metaline)

Menentukan properti yang ditampilkan di metaline hasil penelusuran. Nilai properti ditampilkan dalam urutan yang diberikan di sini. Jika properti memiliki beberapa nilai, semua nilai tersebut akan ditampilkan sebelum properti berikutnya. Oleh karena itu, sebaiknya tentukan properti tunggal sebelum properti berulang dalam daftar ini. Semua properti harus menetapkan isReturnable ke benar (true). Jumlah metaline maksimum adalah 3.

ObjectDisplayOptions.Metaline

Metaline adalah daftar properti yang ditampilkan bersama hasil penelusuran untuk memberikan konteks.

Representasi JSON
{
  "properties": [
    {
      object (ObjectDisplayOptions.DisplayedProperty)
    }
  ]
}
Kolom
properties[]

object (ObjectDisplayOptions.DisplayedProperty)

Daftar properti yang ditampilkan untuk metaline. Jumlah properti maksimum adalah 5.

ObjectDisplayOptions.DisplayedProperty

Referensi ke properti tingkat atas dalam objek yang harus ditampilkan di hasil penelusuran. Nilai properti yang dipilih akan ditampilkan di hasil penelusuran bersama dengan display label untuk properti tersebut jika ada yang ditentukan. Jika label tampilan tidak ditentukan, hanya nilai yang akan ditampilkan.

Representasi JSON
{
  "propertyName": string
}
Kolom
propertyName

string

Nama properti level teratas seperti yang didefinisikan dalam definisi properti untuk objek. Jika nama tersebut bukan properti yang ditentukan dalam skema, error akan terjadi saat mencoba memperbarui skema.

PropertyDefinition

Definisi properti dalam objek.

Representasi JSON
{
  "name": string,
  "isReturnable": boolean,
  "isRepeatable": boolean,
  "isSortable": boolean,
  "isFacetable": boolean,
  "isSuggestable": boolean,
  "isWildcardSearchable": boolean,
  "displayOptions": {
    object (PropertyDisplayOptions)
  },

  // Union field property_options can be only one of the following:
  "integerPropertyOptions": {
    object (IntegerPropertyOptions)
  },
  "doublePropertyOptions": {
    object (DoublePropertyOptions)
  },
  "timestampPropertyOptions": {
    object (TimestampPropertyOptions)
  },
  "booleanPropertyOptions": {
    object (BooleanPropertyOptions)
  },
  "objectPropertyOptions": {
    object (ObjectPropertyOptions)
  },
  "enumPropertyOptions": {
    object (EnumPropertyOptions)
  },
  "datePropertyOptions": {
    object (DatePropertyOptions)
  },
  "textPropertyOptions": {
    object (TextPropertyOptions)
  },
  "htmlPropertyOptions": {
    object (HtmlPropertyOptions)
  }
  // End of list of possible types for union field property_options.
}
Kolom
name

string

Nama properti. Permintaan pengindeksan item yang dikirim ke Indexing API harus menetapkan property name yang sama dengan nilai ini. Misalnya, jika nama adalah subject_line, permintaan pengindeksan untuk item dokumen yang memiliki kolom subjek harus menetapkan name untuk kolom tersebut sama dengan subject_line. Gunakan nama tersebut sebagai ID untuk properti objek. Setelah terdaftar sebagai properti suatu objek, Anda tidak dapat menggunakan kembali nama ini untuk properti lain dalam objek tersebut. Nama harus diawali dengan huruf dan hanya boleh berisi huruf (A-Z, a-z) atau angka (0-9). Panjang maksimum adalah 256 karakter.

isReturnable

boolean

Menunjukkan bahwa properti mengidentifikasi data yang harus ditampilkan dalam hasil penelusuran melalui Query API. Jika ditetapkan ke true, menunjukkan bahwa pengguna Query API dapat menggunakan kolom properti yang cocok dalam hasil. Namun, penyimpanan kolom memerlukan lebih banyak alokasi ruang dan menggunakan lebih banyak bandwidth untuk kueri penelusuran, sehingga memengaruhi performa pada set data yang besar. Tetapkan ke true di sini hanya jika kolom diperlukan untuk hasil penelusuran. Tidak boleh true untuk properti yang jenisnya adalah objek.

isRepeatable

boolean

Menunjukkan bahwa beberapa nilai diizinkan untuk properti. Misalnya, dokumen hanya memiliki satu deskripsi, tetapi dapat memiliki beberapa komentar. Tidak boleh benar untuk properti yang jenisnya adalah boolean. Jika disetel ke salah (false), properti yang berisi lebih dari satu nilai akan menyebabkan permintaan pengindeksan untuk item tersebut ditolak.

isSortable

boolean

Menunjukkan bahwa properti tersebut dapat digunakan untuk penyortiran. Tidak boleh benar untuk properti yang dapat diulang. Tidak boleh benar untuk properti yang jenisnya adalah objek. IsReturnable harus bernilai benar untuk menetapkan opsi ini. Hanya didukung untuk properti boolean, tanggal, ganda, bilangan bulat, dan stempel waktu.

isFacetable

boolean

Menunjukkan bahwa properti dapat digunakan untuk menghasilkan faset. Tidak boleh benar untuk properti yang jenisnya adalah objek. IsReturnable harus bernilai benar untuk menetapkan opsi ini. Hanya didukung untuk properti boolean, enum, bilangan bulat, dan teks.

isSuggestable

boolean

Menunjukkan bahwa properti dapat digunakan untuk menghasilkan saran kueri.

isWildcardSearchable

boolean

Menunjukkan bahwa pengguna dapat melakukan penelusuran karakter pengganti untuk properti ini. Hanya didukung untuk properti Teks. IsReturnable harus bernilai benar untuk menetapkan opsi ini. Dalam sumber data tertentu, maksimum 5 properti dapat ditandai sebagai isWildcardSearchable. Untuk mengetahui detail selengkapnya, lihat Menentukan properti objek

displayOptions

object (PropertyDisplayOptions)

Opsi yang menentukan cara properti ditampilkan di halaman hasil Cloud Search jika ditentukan untuk ditampilkan di display options objek.

Kolom union property_options. Opsi khusus jenis yang menentukan cara properti diindeks dan digunakan. Jika opsi harus menjadi opsi default untuk suatu jenis, kolom ini harus ditetapkan ke salah satu jenis. Jika kolom ini tidak ditetapkan, pembaruan skema akan ditolak. property_options hanya ada berupa salah satu diantara berikut:
integerPropertyOptions

object (IntegerPropertyOptions)

doublePropertyOptions

object (DoublePropertyOptions)

timestampPropertyOptions

object (TimestampPropertyOptions)

booleanPropertyOptions

object (BooleanPropertyOptions)

objectPropertyOptions

object (ObjectPropertyOptions)

enumPropertyOptions

object (EnumPropertyOptions)

datePropertyOptions

object (DatePropertyOptions)

textPropertyOptions

object (TextPropertyOptions)

htmlPropertyOptions

object (HtmlPropertyOptions)

IntegerPropertyOptions

Opsi untuk properti bilangan bulat.

Representasi JSON
{
  "orderedRanking": enum (IntegerPropertyOptions.OrderedRanking),
  "minimumValue": string,
  "maximumValue": string,
  "operatorOptions": {
    object (IntegerPropertyOptions.IntegerOperatorOptions)
  },
  "integerFacetingOptions": {
    object (IntegerFacetingOptions)
  }
}
Kolom
orderedRanking

enum (IntegerPropertyOptions.OrderedRanking)

Digunakan untuk menentukan peringkat yang diurutkan untuk bilangan bulat. Hanya dapat digunakan jika isRepeatable bernilai salah (false).

minimumValue

string (Int64Value format)

Nilai minimum properti. Nilai minimum dan maksimum untuk properti digunakan untuk menentukan peringkat hasil sesuai dengan ordered ranking. Permintaan pengindeksan dengan nilai kurang dari minimum akan diterima dan diberi peringkat dengan bobot yang sama seperti item yang diindeks dengan nilai minimum.

maximumValue

string (Int64Value format)

Nilai properti maksimum. Nilai minimum dan maksimum untuk properti digunakan untuk menentukan peringkat hasil sesuai dengan ordered ranking. Permintaan pengindeksan dengan nilai yang lebih besar dari nilai maksimum akan diterima dan diberi peringkat dengan bobot yang sama seperti item yang diindeks dengan nilai maksimum.

operatorOptions

object (IntegerPropertyOptions.IntegerOperatorOptions)

Jika ditetapkan, akan menjelaskan bagaimana bilangan bulat harus digunakan sebagai operator penelusuran.

integerFacetingOptions

object (IntegerFacetingOptions)

Jika ditetapkan, menjelaskan opsi faset bilangan bulat untuk properti bilangan bulat yang diberikan. Properti bilangan bulat yang sesuai harus ditandai sebagai isFacetable.

IntegerPropertyOptions.OrderedRanking

Digunakan untuk menentukan bagaimana nilai bilangan bulat harus diberi peringkat relatif terhadap nilai lain. Bilangan bulat dengan peringkat yang lebih tinggi menunjukkan tingkat kepentingan yang lebih besar. Misalnya, di beberapa sumber data memiliki prioritas lebih rendah menunjukkan kepentingan yang lebih tinggi sementara di sumber data lainnya, prioritas yang lebih tinggi menunjukkan kepentingan yang lebih tinggi.

Enum
NO_ORDER Tidak ada urutan peringkat untuk properti. Hasil tidak disesuaikan oleh nilai properti ini.
ASCENDING Properti ini diberi peringkat dalam urutan menaik. Nilai yang lebih rendah menunjukkan peringkat yang lebih rendah.
DESCENDING Properti ini diberi peringkat dalam urutan menurun. Nilai yang lebih rendah menunjukkan peringkat yang lebih tinggi.

IntegerPropertyOptions.IntegerOperatorOptions

Digunakan untuk menyediakan operator penelusuran untuk properti bilangan bulat. Ini bersifat opsional. Operator query.search memungkinkan pengguna membatasi kueri ke kolom tertentu yang relevan dengan jenis item yang ditelusuri.

Representasi JSON
{
  "operatorName": string,
  "lessThanOperatorName": string,
  "greaterThanOperatorName": string
}
Kolom
operatorName

string

Menunjukkan nama operator yang diperlukan dalam kueri untuk mengisolasi properti bilangan bulat. Misalnya, jika operatorName adalah priority dan nama properti adalah priorityVal, kueri seperti priority:<value> hanya menampilkan hasil ketika nilai properti bernama priorityVal cocok dengan <value>. Sebaliknya, penelusuran yang menggunakan <value> yang sama tanpa operator akan menampilkan semua item yang <value> cocok dengan nilai properti String atau teks dalam kolom konten untuk item tersebut. Nama operator hanya boleh berisi huruf kecil (a-z). Panjang maksimum adalah 32 karakter.

lessThanOperatorName

string

Menunjukkan nama operator yang diperlukan dalam kueri untuk mengisolasi properti bilangan bulat menggunakan operator kurang-dari. Misalnya, jika lessThanOperatorName adalah prioritas di bawah dan nama propertinya adalah priorityVal, kueri seperti priorityunder:<value> hanya menampilkan hasil jika nilai properti bernama priorityVal lebih kecil dari <value>. Nama operator hanya boleh berisi huruf kecil (a-z). Panjang maksimum adalah 32 karakter.

greaterThanOperatorName

string

Menunjukkan nama operator yang diperlukan dalam kueri untuk mengisolasi properti bilangan bulat menggunakan operator lebih besar dari. Misalnya, jika largerThanOperatorName adalah priorityabove dan nama properti adalah priorityVal, kueri seperti priorityabove:<value> hanya menampilkan hasil ketika nilai properti bernama priorityVal lebih besar dari <value>. Nama operator hanya boleh berisi huruf kecil (a-z). Panjang maksimum adalah 32 karakter.

DoublePropertyOptions

Opsi untuk properti ganda.

Representasi JSON
{
  "operatorOptions": {
    object (DoublePropertyOptions.DoubleOperatorOptions)
  }
}
Kolom
operatorOptions

object (DoublePropertyOptions.DoubleOperatorOptions)

Jika ditetapkan, menjelaskan cara double harus digunakan sebagai operator penelusuran.

DoublePropertyOptions.DoubleOperatorOptions

Digunakan untuk memberikan operator penelusuran untuk properti ganda. Ini bersifat opsional. Operator query.search memungkinkan pengguna membatasi kueri ke kolom tertentu yang relevan dengan jenis item yang ditelusuri.

Representasi JSON
{
  "operatorName": string
}
Kolom
operatorName

string

Menunjukkan nama operator yang diperlukan dalam kueri untuk menggunakan properti ganda dalam pengurutan atau sebagai faset. Nama operator hanya boleh berisi huruf kecil (a-z). Panjang maksimum adalah 32 karakter.

TimestampPropertyOptions

Opsi untuk properti stempel waktu.

Representasi JSON
{
  "operatorOptions": {
    object (TimestampPropertyOptions.TimestampOperatorOptions)
  }
}
Kolom
operatorOptions

object (TimestampPropertyOptions.TimestampOperatorOptions)

Jika ditetapkan, akan menjelaskan cara stempel waktu harus digunakan sebagai operator penelusuran.

TimestampPropertyOptions.TimestampOperatorOptions

Digunakan untuk menyediakan operator penelusuran untuk properti stempel waktu. Ini bersifat opsional. Operator query.search memungkinkan pengguna membatasi kueri ke kolom tertentu yang relevan dengan jenis item yang ditelusuri.

Representasi JSON
{
  "operatorName": string,
  "lessThanOperatorName": string,
  "greaterThanOperatorName": string
}
Kolom
operatorName

string

Menunjukkan nama operator yang diperlukan dalam kueri untuk mengisolasi properti stempel waktu. Misalnya, jika operatorName closedon dan nama properti adalah closeDate, kueri seperti closedon:<value> hanya menampilkan hasil jika nilai properti bernama closeDate cocok dengan <value>. Sebaliknya, penelusuran yang menggunakan <value> yang sama tanpa operator akan menampilkan semua item yang <value> cocok dengan nilai properti String atau teks dalam kolom konten untuk item tersebut. Nama operator hanya boleh berisi huruf kecil (a-z). Panjang maksimum adalah 32 karakter.

lessThanOperatorName

string

Menunjukkan nama operator yang diperlukan dalam kueri untuk mengisolasi properti stempel waktu menggunakan operator kurang-dari. Misalnya, jika lessThanOperatorName closedbefore dan nama properti adalah closeDate, kueri seperti closedbefore:<value> hanya menampilkan hasil ketika nilai properti bernama closeDate lebih awal dari <value>. Nama operator hanya boleh berisi huruf kecil (a-z). Panjang maksimum adalah 32 karakter.

greaterThanOperatorName

string

Menunjukkan nama operator yang diperlukan dalam kueri untuk mengisolasi properti stempel waktu menggunakan operator lebih besar dari. Misalnya, jika largerThanOperatorName closedafter dan nama properti adalah closeDate, maka kueri seperti closedafter:<value> hanya akan menampilkan hasil ketika nilai properti bernama closeDate lebih lambat dari <value>. Nama operator hanya boleh berisi huruf kecil (a-z). Panjang maksimum adalah 32 karakter.

BooleanPropertyOptions

Opsi untuk properti boolean.

Representasi JSON
{
  "operatorOptions": {
    object (BooleanPropertyOptions.BooleanOperatorOptions)
  }
}
Kolom
operatorOptions

object (BooleanPropertyOptions.BooleanOperatorOptions)

Jika ditetapkan, menjelaskan bagaimana boolean harus digunakan sebagai operator penelusuran.

BooleanPropertyOptions.BooleanOperatorOptions

Digunakan untuk menyediakan operator penelusuran untuk properti boolean. Ini bersifat opsional. Operator query.search memungkinkan pengguna membatasi kueri ke kolom tertentu yang relevan dengan jenis item yang ditelusuri.

Representasi JSON
{
  "operatorName": string
}
Kolom
operatorName

string

Menunjukkan nama operator yang diperlukan dalam kueri untuk mengisolasi properti boolean. Misalnya, jika operatorName closed dan nama properti adalah isClosed, kueri seperti closed:<value> hanya menampilkan hasil jika nilai properti bernama isClosed cocok dengan <value>. Sebaliknya, penelusuran yang menggunakan <value> yang sama tanpa operator akan menampilkan semua item yang <value> cocok dengan nilai properti String atau teks apa pun dalam kolom konten untuk item tersebut. Nama operator hanya boleh berisi huruf kecil (a-z). Panjang maksimum adalah 32 karakter.

ObjectPropertyOptions

Opsi untuk properti objek.

Representasi JSON
{
  "subobjectProperties": [
    {
      object (PropertyDefinition)
    }
  ]
}
Kolom
subobjectProperties[]

object (PropertyDefinition)

Properti sub-objek. Properti ini mewakili objek bertingkat. Misalnya, jika properti ini merepresentasikan alamat pos, subobjectProperties mungkin bernama street, city, dan state. Jumlah maksimum elemen adalah 1.000.

EnumPropertyOptions

Opsi untuk properti enum, yang memungkinkan Anda menentukan kumpulan string terbatas untuk mencocokkan kueri pengguna, menetapkan peringkat untuk nilai string tersebut, dan menentukan nama operator yang akan dipasangkan dengan string tersebut sehingga pengguna dapat mempersempit hasil ke item dengan nilai tertentu saja. Misalnya, untuk item dalam sistem pelacakan permintaan dengan informasi prioritas, Anda dapat menentukan p0 sebagai nilai enum yang diizinkan dan mengaitkan enum ini dengan nama operator priority, sehingga pengguna penelusuran dapat menambahkan priority:p0 ke kueri mereka untuk membatasi kumpulan hasil, hanya untuk item yang diindeks dengan nilai p0.

Representasi JSON
{
  "possibleValues": [
    {
      object (EnumPropertyOptions.EnumValuePair)
    }
  ],
  "orderedRanking": enum (EnumPropertyOptions.OrderedRanking),
  "operatorOptions": {
    object (EnumPropertyOptions.EnumOperatorOptions)
  }
}
Kolom
possibleValues[]

object (EnumPropertyOptions.EnumValuePair)

Daftar kemungkinan nilai untuk properti enumerasi. Semua EnumValuePairs harus memberikan nilai string. Jika Anda menentukan nilai bilangan bulat untuk satu EnumValuePair, semua EnumValuePairs yang memungkinkan harus memberikan nilai bilangan bulat. Nilai string dan nilai bilangan bulat harus unik atas semua nilai yang memungkinkan. Setelah ditetapkan, nilai yang mungkin tidak dapat dihapus atau diubah. Jika Anda memberikan peringkat yang diurutkan dan merasa mungkin memasukkan nilai enum tambahan di masa mendatang, sisakan celah di nilai bilangan bulat awal untuk memungkinkan penambahan nilai di antara nilai yang telah didaftarkan sebelumnya. Jumlah maksimum elemen adalah 100.

orderedRanking

enum (EnumPropertyOptions.OrderedRanking)

Digunakan untuk menentukan peringkat yang diurutkan untuk enumerasi yang menentukan bagaimana nilai bilangan bulat yang diberikan dalam kemungkinan EnumValuePairs digunakan untuk menentukan peringkat hasil. Jika ditentukan, nilai bilangan bulat harus diberikan untuk semua kemungkinan nilai EnumValuePair yang diberikan untuk properti ini. Hanya dapat digunakan jika isRepeatable bernilai salah (false).

operatorOptions

object (EnumPropertyOptions.EnumOperatorOptions)

Jika ditetapkan, menjelaskan cara enum harus digunakan sebagai operator penelusuran.

EnumPropertyOptions.EnumValuePair

Pasangan nilai enumerasi menentukan dua hal: nilai string yang diperlukan dan nilai bilangan bulat opsional. Nilai string menentukan istilah kueri diperlukan yang diperlukan untuk mengambil item tersebut, seperti p0 untuk item prioritas. Nilai bilangan bulat menentukan peringkat nilai string tersebut secara relatif terhadap nilai terenumerasi lainnya untuk properti yang sama. Misalnya, Anda dapat mengaitkan p0 dengan 0 dan menentukan pasangan enum lainnya seperti p1 dan 1. Anda harus menggunakan nilai bilangan bulat yang dikombinasikan dengan ordered ranking untuk menetapkan peringkat nilai tertentu relatif terhadap nilai terenumerasi lainnya untuk nama properti yang sama. Di sini, urutan peringkat PENJELASAN untuk properti prioritas menghasilkan peningkatan peringkat untuk item yang diindeks dengan nilai p0 dibandingkan dengan item yang diindeks dengan nilai p1. Tanpa urutan peringkat yang ditentukan, nilai bilangan bulat tidak memengaruhi peringkat item.

Representasi JSON
{
  "stringValue": string,
  "integerValue": integer
}
Kolom
stringValue

string

Nilai string EnumValuePair. Panjang maksimum adalah 32 karakter.

integerValue

integer

Nilai bilangan bulat EnumValuePair yang harus positif. Opsional.

EnumPropertyOptions.OrderedRanking

Digunakan untuk menentukan arah peringkat untuk bilangan bulat EnumValuePair relatif terhadap nilai bilangan bulat EnumValuePair lainnya. Untuk beberapa properti, nilai bilangan bulat yang lebih rendah menunjukkan tingkat kepentingan yang lebih tinggi, sedangkan di properti lain, bilangan bulat yang lebih tinggi menunjukkan tingkat kepentingan yang lebih tinggi.

Enum
NO_ORDER Tidak ada urutan peringkat untuk properti. Hasil tidak disesuaikan oleh nilai properti ini.
ASCENDING Properti ini diberi peringkat dalam urutan menaik. Nilai yang lebih rendah menunjukkan peringkat yang lebih rendah.
DESCENDING Properti ini diberi peringkat dalam urutan menurun. Nilai yang lebih rendah menunjukkan peringkat yang lebih tinggi.

EnumPropertyOptions.EnumOperatorOptions

Digunakan untuk menyediakan operator penelusuran untuk properti enum. Ini bersifat opsional. Operator query.search memungkinkan pengguna membatasi kueri ke kolom tertentu yang relevan dengan jenis item yang ditelusuri. Misalnya, jika Anda tidak memberikan operator untuk properti enum prioritas dengan kemungkinan nilai p0 dan p1, kueri yang berisi istilah p0 akan menampilkan item yang memiliki p0 sebagai nilai properti priority, serta item apa pun yang berisi string p0 di kolom lain. Jika Anda memberikan nama operator untuk enum, seperti priority, pengguna penelusuran dapat menggunakan operator tersebut untuk menyaring hasil hanya untuk item yang memiliki p0 sebagai nilai properti ini, dengan kueri priority:p0.

Representasi JSON
{
  "operatorName": string
}
Kolom
operatorName

string

Menunjukkan nama operator yang diperlukan dalam kueri untuk mengisolasi properti enum. Misalnya, jika operatorName adalah priority dan nama properti adalah priorityVal, kueri seperti priority:<value> hanya menampilkan hasil ketika nilai properti bernama priorityVal cocok dengan <value>. Sebaliknya, penelusuran yang menggunakan <value> yang sama tanpa operator akan menampilkan semua item yang <value> cocok dengan nilai properti String atau teks dalam kolom konten untuk item tersebut. Nama operator hanya boleh berisi huruf kecil (a-z). Panjang maksimum adalah 32 karakter.

DatePropertyOptions

Opsi untuk properti tanggal.

Representasi JSON
{
  "operatorOptions": {
    object (DatePropertyOptions.DateOperatorOptions)
  }
}
Kolom
operatorOptions

object (DatePropertyOptions.DateOperatorOptions)

Jika ditetapkan, deskripsi ini menjelaskan bagaimana tanggal harus digunakan sebagai operator penelusuran.

DatePropertyOptions.DateOperatorOptions

Opsional. Menyediakan operator penelusuran untuk properti tanggal. Operator query.search memungkinkan pengguna membatasi kueri ke kolom tertentu yang relevan dengan jenis item yang ditelusuri.

Representasi JSON
{
  "operatorName": string,
  "lessThanOperatorName": string,
  "greaterThanOperatorName": string
}
Kolom
operatorName

string

Menunjukkan string sebenarnya yang diperlukan dalam kueri untuk memisahkan properti tanggal. Misalnya, objek skema pelacakan masalah memiliki properti bernama closeDate yang menentukan operator dengan operatorName closedon. Untuk penelusuran terkait data tersebut, kueri seperti closedon:<value> hanya menampilkan hasil jika nilai properti closeDate cocok dengan <value>. Sebaliknya, penelusuran yang menggunakan <value> yang sama tanpa operator akan menampilkan semua item yang <value> cocok dengan nilai properti String atau teks apa pun dalam kolom konten untuk sumber data yang diindeks. Nama operator hanya boleh berisi huruf kecil (a-z). Panjang maksimum adalah 32 karakter.

lessThanOperatorName

string

Menunjukkan nama operator yang diperlukan dalam kueri untuk memisahkan properti tanggal menggunakan operator kurang-dari. Misalnya, jika lessThanOperatorName closedbefore dan nama properti adalah closeDate, kueri seperti closedbefore:<value> hanya menampilkan hasil ketika nilai properti bernama closeDate lebih awal dari <value>. Nama operator hanya boleh berisi huruf kecil (a-z). Panjang maksimum adalah 32 karakter.

greaterThanOperatorName

string

Menunjukkan nama operator yang diperlukan dalam kueri untuk memisahkan properti tanggal menggunakan operator lebih besar dari. Misalnya, jika largerThanOperatorName closedafter dan nama properti adalah closeDate, maka kueri seperti closedafter:<value> hanya akan menampilkan hasil ketika nilai properti bernama closeDate lebih lambat dari <value>. Nama operator hanya boleh berisi huruf kecil (a-z). Panjang maksimum adalah 32 karakter.

TextPropertyOptions

Opsi untuk properti teks.

Representasi JSON
{
  "retrievalImportance": {
    object (RetrievalImportance)
  },
  "operatorOptions": {
    object (TextPropertyOptions.TextOperatorOptions)
  }
}
Kolom
retrievalImportance

object (RetrievalImportance)

Menunjukkan tingkat kepentingan kualitas penelusuran token dalam kolom saat digunakan untuk pengambilan.

operatorOptions

object (TextPropertyOptions.TextOperatorOptions)

Jika ditetapkan, menjelaskan cara properti digunakan sebagai operator penelusuran.

RetrievalImportance

Representasi JSON
{
  "importance": enum (RetrievalImportance.Importance)
}
Kolom
importance

enum (RetrievalImportance.Importance)

Menunjukkan tingkat kepentingan peringkat yang diberikan pada properti saat dicocokkan selama pengambilan. Setelah ditetapkan, nilai penting token properti tidak dapat diubah.

RetrievalImportance.Importance

Enum
DEFAULT Perlakukan pencocokan seperti pencocokan teks isi.
HIGHEST Perlakukan kecocokan seperti kecocokan dengan judul item.
HIGH Memperlakukan pencocokan dengan tingkat kepentingan yang lebih tinggi daripada teks isi.
LOW Memperlakukan kecocokan dengan tingkat kepentingan yang lebih rendah daripada teks isi.
NONE Jangan cocokkan dengan kolom ini selama pengambilan. Properti ini masih dapat digunakan untuk pencocokan operator, facet, dan saran jika diinginkan.

TextPropertyOptions.TextOperatorOptions

Digunakan untuk menyediakan operator penelusuran untuk properti teks. Ini bersifat opsional. Operator query.search memungkinkan pengguna membatasi kueri ke kolom tertentu yang relevan dengan jenis item yang ditelusuri.

Representasi JSON
{
  "operatorName": string,
  "exactMatchWithOperator": boolean
}
Kolom
operatorName

string

Menunjukkan nama operator yang diperlukan dalam kueri untuk mengisolasi properti teks. Misalnya, jika operatorName adalah subject dan nama properti adalah subjectLine, kueri seperti subject:<value> hanya menampilkan hasil ketika nilai properti bernama subjectLine cocok dengan <value>. Sebaliknya, penelusuran yang menggunakan <value> yang sama tanpa operator akan menampilkan semua item yang <value> cocok dengan nilai properti teks atau teks apa pun dalam kolom konten untuk item tersebut. Nama operator hanya boleh berisi huruf kecil (a-z). Panjang maksimum adalah 32 karakter.

exactMatchWithOperator

boolean

Jika true (benar), nilai teks akan ditokenkan sebagai satu nilai atom pada penelusuran operator dan pencocokan faset. Misalnya, jika nama operator adalah "genre" dan nilainya adalah "science-Fiksi", pembatasan kueri "genre:science" dan "genre:genre" tidak cocok dengan itemnya; "genre:science-Fiksi" cocok. Pencocokan nilai teks peka huruf besar/kecil dan tidak menghapus karakter khusus. Jika false, teks akan dibuat token. Misalnya, jika nilainya adalah "science-Fiksi", kueri "genre:science" dan "genre:genre" akan cocok dengan item tersebut.

HtmlPropertyOptions

Opsi untuk properti HTML.

Representasi JSON
{
  "retrievalImportance": {
    object (RetrievalImportance)
  },
  "operatorOptions": {
    object (HtmlPropertyOptions.HtmlOperatorOptions)
  }
}
Kolom
retrievalImportance

object (RetrievalImportance)

Menunjukkan tingkat kepentingan kualitas penelusuran token dalam kolom saat digunakan untuk pengambilan. Hanya dapat disetel ke DEFAULT atau NONE.

operatorOptions

object (HtmlPropertyOptions.HtmlOperatorOptions)

Jika ditetapkan, menjelaskan cara properti digunakan sebagai operator penelusuran.

HtmlPropertyOptions.HtmlOperatorOptions

Digunakan untuk menyediakan operator penelusuran untuk properti html. Ini bersifat opsional. Operator query.search memungkinkan pengguna membatasi kueri ke kolom tertentu yang relevan dengan jenis item yang ditelusuri.

Representasi JSON
{
  "operatorName": string
}
Kolom
operatorName

string

Menunjukkan nama operator yang diperlukan dalam kueri untuk mengisolasi properti html. Misalnya, jika operatorName adalah subject dan nama properti adalah subjectLine, kueri seperti subject:<value> hanya menampilkan hasil ketika nilai properti bernama subjectLine cocok dengan <value>. Sebaliknya, penelusuran yang menggunakan <value> yang sama tanpa operator akan menampilkan semua item yang <value> cocok dengan nilai properti html atau teks apa pun dalam kolom konten untuk item tersebut. Nama operator hanya boleh berisi huruf kecil (a-z). Panjang maksimum adalah 32 karakter.

PropertyDisplayOptions

Opsi tampilan untuk properti.

Representasi JSON
{
  "displayLabel": string
}
Kolom
displayLabel

string

Label yang mudah digunakan untuk properti yang digunakan jika properti ditentukan untuk ditampilkan di ObjectDisplayOptions. Jika disediakan, label tampilan akan ditampilkan di depan nilai properti saat properti merupakan bagian dari opsi tampilan objek. Misalnya, jika nilai properti adalah '1', nilai itu sendiri mungkin bukan konteks yang berguna bagi pengguna. Jika nama tampilan yang diberikan adalah 'priority', pengguna akan melihat 'priority : 1' di hasil penelusuran yang memberikan konteks yang jelas untuk pengguna yang menelusuri. Ini adalah OPSIONAL; jika tidak diberikan, hanya nilai properti yang ditampilkan. Panjang maksimum adalah 64 karakter.