Method: query.sources.list

Zwraca listę źródeł, których użytkownik może używać w interfejsach API query.search i suggest.

Uwaga: do uruchomienia tego interfejsu API wymagane jest standardowe konto użytkownika. Konto usługi nie może bezpośrednio wykonywać żądań interfejsu Query API. aby używać konta usługi do wykonywania zapytań, skonfiguruj przekazywanie uprawnień w całej domenie Google Workspace.

Żądanie HTTP

GET https://cloudsearch.googleapis.com/v1/query/sources

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
requestOptions

object (RequestOptions)

Opcje żądań, takie jak wyszukiwarka czy strefa czasowa użytkownika.
pageToken

string

Liczba źródeł do zwrócenia w odpowiedzi.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Wyświetl odpowiedź dotyczącą źródeł.

Zapis JSON 
{
  "sources": [
    {
      object (QuerySource)
    }
  ],
  "nextPageToken": string
}
Pola
sources[]

object (QuerySource)
nextPageToken

string

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu OAuth:

  • https://www.googleapis.com/auth/cloud_search.query
  • https://www.googleapis.com/auth/cloud_search

Więcej informacji znajdziesz w przewodniku na temat autoryzacji.

QuerySource

Lista źródeł, które użytkownik może przeszukiwać za pomocą interfejsu Query API.

Zapis JSON 
{
  "source": {
    object (Source)
  },
  "shortName": string,
  "displayName": string,
  "operators": [
    {
      object (QueryOperator)
    }
  ]
}
Pola
source

object (Source)

Nazwa źródła
shortName

string

Krótka nazwa lub alias źródła. Tej wartości można użyć z parametrem „source” .
displayName

string

Wyświetlana nazwa źródła danych.
operators[]

object (QueryOperator)

Lista wszystkich operatorów mających zastosowanie do tego źródła.

QueryOperator

Definicja operatora, którego można użyć w żądaniu query.search/query.suggest.

Zapis JSON 
{
  "operatorName": string,
  "lessThanOperatorName": string,
  "greaterThanOperatorName": string,
  "type": enum (QueryOperator.Type),
  "displayName": string,
  "isSortable": boolean,
  "isFacetable": boolean,
  "isReturnable": boolean,
  "isRepeatable": boolean,
  "isSuggestable": boolean,
  "enumValues": [
    string
  ],
  "objectType": string
}
Pola
operatorName

string

Nazwa operatora.
lessThanOperatorName

string

Wskazuje nazwę operatora, której można użyć do izolowania właściwości za pomocą operatora mniejszości.
greaterThanOperatorName

string

Wskazuje nazwę operatora, której można użyć do izolowania właściwości za pomocą operatora „większe niż”.
type

enum (QueryOperator.Type)

Typ operatora.
displayName

string

Wyświetlana nazwa operatora
isSortable

boolean

Czy można używać tego operatora do sortowania wyników?
isFacetable

boolean

Czy tego operatora można używać do pobierania aspektów.
isReturnable

boolean

Czy usługa powiązana z tym aspektem zostanie zwrócona w wynikach wyszukiwania.
isRepeatable

boolean

Wskazuje, czy dla tej usługi można ustawić wiele wartości.
isSuggestable

boolean

Może otrzymywać sugestie dotyczące tego pola.
enumValues[]

string

Możliwa lista wartości pola Opeatror. To pole jest wypełniane tylko wtedy, gdy możemy bezpiecznie wyliczyć wszystkie możliwe wartości tego operatora.
objectType

string

Nazwa obiektu odpowiadająca operatorowi. To pole jest wypełniane tylko w przypadku operatorów specyficznych dla schematu i nie jest skonfigurowane w przypadku popularnych operatorów.

QueryOperator.Type

Typ właściwości, do której odwołuje się operator.

Wartości w polu enum
UNKNOWN Nieprawidłowa wartość.
INTEGER
DOUBLE
TIMESTAMP
BOOLEAN
ENUM
DATE
TEXT
HTML