REST Resource: settings.searchapplications

Resource: SearchApplication

SearchApplication

Representasi JSON
{
  "name": string,
  "displayName": string,
  "dataSourceRestrictions": [
    {
      object (DataSourceRestriction)
    }
  ],
  "sourceConfig": [
    {
      object (SourceConfig)
    }
  ],
  "scoringConfig": {
    object (ScoringConfig)
  },
  "defaultSortOptions": {
    object (SortOptions)
  },
  "defaultFacetOptions": [
    {
      object (FacetOptions)
    }
  ],
  "returnResultThumbnailUrls": boolean,
  "operationIds": [
    string
  ],
  "enableAuditLog": boolean,
  "queryInterpretationConfig": {
    object (QueryInterpretationConfig)
  }
}
Kolom
name

string

Nama Aplikasi Penelusuran.

Format: searchapplications/{applicationId}.

displayName

string

Nama tampilan Aplikasi Penelusuran. Panjang maksimumnya adalah 300 karakter.

dataSourceRestrictions[]

object (DataSourceRestriction)

Batasan diterapkan ke konfigurasi. Jumlah maksimum elemen adalah 10.

sourceConfig[]

object (SourceConfig)

Konfigurasi untuk sumber yang ditentukan dalam dataSourceRestrictions.

scoringConfig

object (ScoringConfig)

Konfigurasi untuk menentukan peringkat hasil.

defaultSortOptions

object (SortOptions)

Opsi default untuk mengurutkan hasil penelusuran

defaultFacetOptions[]

object (FacetOptions)

Kolom default untuk menampilkan hasil facet. Sumber yang ditentukan di sini juga telah disertakan dalam dataSourceRestrictions di atas.

returnResultThumbnailUrls

boolean

Dengan setiap hasil, kita harus menampilkan URI untuk thumbnail-nya (jika ada)

operationIds[]

string

Hanya output. ID Operasi yang Berjalan Lama (LRO) yang saat ini berjalan untuk skema ini. Kolom khusus output.

enableAuditLog

boolean

Menunjukkan apakah logging audit aktif/nonaktif untuk permintaan yang dibuat untuk aplikasi penelusuran di API kueri.

queryInterpretationConfig

object (QueryInterpretationConfig)

Opsi default untuk interpretasi kueri

DataSourceRestriction

Batasan pada Sumber Data.

Representasi JSON
{
  "source": {
    object (Source)
  },
  "filterOptions": [
    {
      object (FilterOptions)
    }
  ]
}
Kolom
source

object (Source)

Sumber pembatasan.

filterOptions[]

object (FilterOptions)

Opsi filter yang membatasi hasil. Jika ada beberapa filter, filter tersebut akan dikelompokkan menurut jenis objek sebelum bergabung. Filter dengan jenis objek yang sama digabungkan secara konjungtif, lalu ekspresi yang dihasilkan digabungkan secara disjungtif.

Jumlah maksimum elemen adalah 20.

CATATAN: Suggest API saat ini hanya mendukung beberapa filter: "objecttype", "type", dan "mimetype". Untuk saat ini, filter khusus skema tidak dapat digunakan untuk memfilter saran.

Sumber

Menentukan sumber untuk API saran/penelusuran.

Representasi JSON
{

  // Union field source can be only one of the following:
  "name": string,
  "predefinedSource": enum (Source.PredefinedSource)
  // End of list of possible types for union field source.
}
Kolom

Kolom union source.

source hanya dapat berupa salah satu dari hal berikut:

name

string

Nama sumber untuk konten yang diindeks oleh Indexing API.

predefinedSource

enum (Source.PredefinedSource)

Sumber konten standar untuk Google Apps.

Source.PredefinedSource

Sumber standar:

Enum
NONE
QUERY_HISTORY Menyarankan kueri yang dikeluarkan oleh pengguna sebelumnya. Hanya valid jika digunakan dengan suggest API. Diabaikan saat digunakan di API kueri.
PERSON Menyarankan orang dalam organisasi. Hanya valid jika digunakan dengan suggest API. Menghasilkan error saat digunakan di API kueri.
GOOGLE_DRIVE
GOOGLE_GMAIL
GOOGLE_SITES
GOOGLE_GROUPS
GOOGLE_CALENDAR
GOOGLE_KEEP

FilterOptions

Opsi filter yang akan diterapkan pada kueri.

Representasi JSON
{
  "objectType": string,
  "filter": {
    object (Filter)
  }
}
Kolom
objectType

string

Jika objectType ditetapkan, hanya objek dari jenis tersebut yang akan ditampilkan. Nama ini harus sesuai dengan nama objek yang terdaftar dalam definisi skema. Panjang maksimumnya adalah 256 karakter.

filter

object (Filter)

Filter generik untuk membatasi penelusuran, seperti lang:en, site:xyz.

Filter

Cara umum untuk mengekspresikan filter dalam kueri, yang mendukung dua pendekatan:

1. Menetapkan ValueFilter. Nama harus cocok dengan operatorName yang ditentukan dalam skema untuk sumber data Anda.

2. Menetapkan CompositeFilter. Filter dievaluasi menggunakan operator logika. Operator tingkat atas hanya dapat berupa AND atau NOT. DAN hanya dapat muncul di tingkat teratas. ATAU hanya dapat muncul di bawah DAN tingkat atas.

Representasi JSON
{

  // Union field filter can be only one of the following:
  "valueFilter": {
    object (Filter.ValueFilter)
  },
  "compositeFilter": {
    object (Filter.CompositeFilter)
  }
  // End of list of possible types for union field filter.
}
Kolom

Kolom union filter.

filter hanya dapat berupa salah satu dari hal berikut:

valueFilter

object (Filter.ValueFilter)

compositeFilter

object (Filter.CompositeFilter)

Filter.ValueFilter

Representasi JSON
{
  "operatorName": string,
  "value": {
    object (Value)
  }
}
Kolom
operatorName

string

operatorName yang diterapkan ke kueri, seperti price_greater_than. Filter dapat berfungsi untuk kedua jenis filter yang ditentukan dalam skema untuk sumber data Anda:

  1. operatorName, dengan kueri memfilter hasil berdasarkan properti yang cocok dengan nilai.

  2. greaterThanOperatorName atau lessThanOperatorName dalam skema Anda. Kueri memfilter hasil untuk nilai properti yang lebih besar atau lebih kecil dari nilai yang diberikan dalam kueri.

value

object (Value)

Nilai yang akan dibandingkan.

Nilai

Definisi satu nilai dengan jenis generik.

Representasi JSON
{

  // Union field value can be only one of the following:
  "stringValue": string,
  "integerValue": string,
  "doubleValue": number,
  "timestampValue": string,
  "booleanValue": boolean,
  "dateValue": {
    object (Date)
  }
  // End of list of possible types for union field value.
}
Kolom
Kolom union value. Nilai properti yang dinamai. value hanya dapat berupa salah satu dari berikut:
stringValue

string

integerValue

string (int64 format)

doubleValue

number

timestampValue

string (Timestamp format)

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

booleanValue

boolean

dateValue

object (Date)

Filter.CompositeFilter

Representasi JSON
{
  "logicOperator": enum (Filter.CompositeFilter.LogicOperator),
  "subFilters": [
    {
      object (Filter)
    }
  ]
}
Kolom
logicOperator

enum (Filter.CompositeFilter.LogicOperator)

Operator logika subfilter.

subFilters[]

object (Filter)

Sub-filter.

Filter.CompositeFilter.LogicOperator

Enum
AND Operator logika, yang hanya dapat diterapkan ke subfilter.
OR
NOT NOT hanya dapat diterapkan pada satu subfilter.

SourceConfig

Konfigurasi untuk sumber saat memproses permintaan query.search atau query.suggest.

Representasi JSON
{
  "source": {
    object (Source)
  },
  "scoringConfig": {
    object (SourceScoringConfig)
  },
  "crowdingConfig": {
    object (SourceCrowdingConfig)
  }
}
Kolom
source

object (Source)

Sumber yang akan menggunakan konfigurasi ini.

scoringConfig

object (SourceScoringConfig)

Konfigurasi penskoran untuk sumber.

crowdingConfig

object (SourceCrowdingConfig)

Konfigurasi kepadatan untuk sumber.

SourceScoringConfig

Tetapkan konfigurasi pemberian skor. Hal ini memungkinkan Anda mengubah peringkat hasil untuk suatu sumber.

Representasi JSON
{
  "sourceImportance": enum (SourceScoringConfig.SourceImportance)
}
Kolom
sourceImportance

enum (SourceScoringConfig.SourceImportance)

Pentingnya sumber.

SourceScoringConfig.SourceImportance

Pentingnya sumber yang dapat digunakan untuk menunjukkan apakah sumber harus diberi prioritas lebih tinggi dalam peringkat dibandingkan sumber lain.

Enum
DEFAULT
LOW
HIGH

SourceCrowdingConfig

Menetapkan batas kepadatan hasil penelusuran. Kepadatan adalah situasi saat beberapa hasil dari sumber atau host yang sama "mengalahkan" hasil lainnya, sehingga mengurangi kualitas penelusuran bagi pengguna. Untuk meningkatkan kualitas penelusuran dan keragaman sumber dalam hasil penelusuran, Anda dapat menetapkan kondisi untuk mengurangi hasil berulang menurut sumber.

Representasi JSON
{
  "numResults": integer,
  "numSuggestions": integer
}
Kolom
numResults

integer

Jumlah maksimum hasil yang diizinkan dari sumber data di halaman hasil selama hasil dari sumber lain tidak habis. nilai yang ditentukan tidak boleh negatif. Nilai default akan digunakan jika nilai ini sama dengan 0. Untuk menonaktifkan batas kepadatan, tetapkan nilai lebih besar dari 100.

numSuggestions

integer

Jumlah maksimum saran yang diizinkan dari sumber. Tidak ada batas yang akan ditetapkan pada hasil jika nilai ini kurang dari atau sama dengan 0.

ScoringConfig

Menghitung skor konfigurasi untuk sumber saat memproses permintaan query.search atau query.suggest.

Representasi JSON
{
  "disableFreshness": boolean,
  "disablePersonalization": boolean
}
Kolom
disableFreshness

boolean

Apakah akan menggunakan keaktualan sebagai sinyal penentu peringkat. Secara default, keaktualan digunakan sebagai sinyal peringkat. Perhatikan bahwa setelan ini tidak tersedia di UI Admin.

disablePersonalization

boolean

Apakah akan mempersonalisasi hasil. Secara default, sinyal pribadi akan digunakan untuk meningkatkan hasil.

SortOptions

Representasi JSON
{
  "operatorName": string,
  "sortOrder": enum (SortOptions.SortOrder)
}
Kolom
operatorName

string

Nama operator yang sesuai dengan kolom yang akan diurutkan. Properti yang sesuai harus ditandai sebagai sortable.

sortOrder

enum (SortOptions.SortOrder)

Urutan menaik adalah urutan pengurutan default

SortOptions.SortOrder

Enum
ASCENDING
DESCENDING

FacetOptions

Menentukan operator untuk menampilkan hasil faset. Akan ada satu FacetResult untuk setiap kombinasi sourceName/objectType/operatorName.

Representasi JSON
{
  "sourceName": string,
  "objectType": string,
  "operatorName": string,
  "numFacetBuckets": integer,
  "integerFacetingOptions": {
    object (IntegerFacetingOptions)
  }
}
Kolom
sourceName

string

Nama sumber untuk membuat faset. Format: datasources/{sourceId} Jika kosong, semua sumber data akan digunakan.

objectType

string

Jika objectType ditetapkan, hanya objek dari jenis tersebut yang akan digunakan untuk menghitung facet. Jika kosong, semua objek akan digunakan untuk menghitung facet.

operatorName

string

Nama operator yang dipilih untuk pembuatan facet. @see cloudsearch.SchemaPropertyOptions

numFacetBuckets

integer

Jumlah maksimum bucket faset yang harus ditampilkan untuk faset ini. Setelan defaultnya adalah 10. Nilai maksimumnya adalah 100.

integerFacetingOptions

object (IntegerFacetingOptions)

Jika ditetapkan, menjelaskan opsi pengelompokan bilangan bulat untuk properti bilangan bulat yang diberikan. Properti bilangan bulat yang sesuai dalam skema harus ditandai isFacetable. Jumlah bucket yang ditampilkan akan menjadi minimum dari ini dan numFacetBuckets.

IntegerFacetingOptions

Digunakan untuk menentukan opsi pengelompokan berdasarkan atribut bilangan bulat.

Representasi JSON
{
  "integerBuckets": [
    string
  ]
}
Kolom
integerBuckets[]

string (Int64Value format)

Bucket untuk nilai bilangan bulat yang diberikan harus dalam urutan menaik. Misalnya, jika nilai yang diberikan adalah (1,5,10,100), bucket aspek berikut akan terbentuk {<1, [1,5), [5-10), [10-100), >=100}.

QueryInterpretationConfig

Opsi default untuk menafsirkan kueri pengguna.

Representasi JSON
{
  "forceVerbatimMode": boolean,
  "forceDisableSupplementalResults": boolean
}
Kolom
forceVerbatimMode

boolean

Aktifkan tanda ini untuk menonaktifkan semua pengoptimalan internal seperti interpretasi kueri dalam bahasa alami (NL), pengambilan hasil tambahan, dan penggunaan sinonim, termasuk sinonim kustom. Jika tanda ini ditetapkan ke Benar (True), tanda ini akan diprioritaskan daripada opsi yang ditetapkan di tingkat Kueri. Untuk nilai default False, tanda tingkat kueri akan menetapkan interpretasi yang benar untuk mode verbatim.

forceDisableSupplementalResults

boolean

Tetapkan tanda ini untuk menonaktifkan pengambilan hasil tambahan. Menetapkan tanda di sini tidak akan mengambil hasil tambahan untuk kueri yang terkait dengan aplikasi penelusuran tertentu. Jika tanda ini ditetapkan ke Benar (True), tanda ini akan diprioritaskan daripada opsi yang ditetapkan di tingkat Kueri. Untuk nilai default False, tanda tingkat kueri akan menetapkan interpretasi yang benar untuk hasil tambahan.

Metode

create

Membuat aplikasi penelusuran.

delete

Menghapus aplikasi penelusuran.

get

Mendapatkan aplikasi penelusuran yang ditentukan.

list

Mencantumkan semua aplikasi penelusuran.

patch

Memperbarui aplikasi penelusuran.

reset

Mereset aplikasi penelusuran ke setelan default.

update

Memperbarui aplikasi penelusuran.