REST Resource: settings.datasources
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Zasób: DataSource
Źródło danych to logiczna przestrzeń nazw dla elementów do zindeksowania. Wszystkie elementy muszą należeć do źródła danych. Jest to warunek wstępny, który musi zostać spełniony, aby elementy mogły zostać zindeksowane w Cloud Search.
| Zapis JSON |
{
"name": string,
"displayName": string,
"shortName": string,
"indexingServiceAccounts": [
string
],
"disableServing": boolean,
"disableModifications": boolean,
"itemsVisibility": [
{
object (GSuitePrincipal)
}
],
"returnThumbnailUrls": boolean,
"operationIds": [
string
]
} |
| Pola |
name |
string
Nazwa zasobu źródła danych. Format: datasources/{sourceId}. Nazwa jest ignorowana podczas tworzenia źródła danych.
|
displayName |
string
Wymagane. Wyświetlana nazwa źródła danych. Maksymalna długość to 300 znaków.
|
shortName |
string
Krótka nazwa lub alias źródła. Ta wartość będzie używana do dopasowania operatora „source”. Jeśli np. krótka nazwa to <value>, zapytania takie jak source:<value> zwracają tylko wyniki dla tego źródła. Wartość musi być niepowtarzalna we wszystkich źródłach danych. Wartość może zawierać tylko znaki alfanumeryczne (a–z, A–Z, 0–9). Wartość nie może zaczynać się od „google” i nie może być jedną z tych nazw: mail, gmail, docs, drive, groups, sites, calendar, hangouts, gplus, keep, people, teams. Maksymalna długość to 32 znaki.
|
indexingServiceAccounts[] |
string
Lista kont usługi, które mają dostęp do indeksowania.
|
disableServing |
boolean
Wyłącz wyświetlanie wyników wyszukiwania lub asystenta.
|
disableModifications |
boolean
Jeśli ma wartość Prawda, powoduje, że dane źródłowe są w trybie tylko do odczytu. W trybie tylko do odczytu interfejs Indexing API odrzuca wszystkie żądania indeksowania lub usuwania elementów z tego źródła. Włączenie trybu tylko do odczytu nie powoduje przerwania przetwarzania wcześniej zaakceptowanych danych.
|
itemsVisibility[] |
object (GSuitePrincipal)
To pole ogranicza widoczność do elementów na poziomie źródła danych. Elementy w źródle danych są ograniczone do zbioru użytkowników i grup uwzględnionych w tym polu. Pamiętaj, że nie zapewnia to dostępu do konkretnego elementu, ponieważ użytkownicy muszą mieć uprawnienia ACL do zawartych w nim elementów. Dzięki temu masz dostęp do całego źródła danych na wysokim poziomie i możesz mieć pewność, że poszczególne elementy nie są udostępniane poza widocznością.
|
returnThumbnailUrls |
boolean
Użytkownik może poprosić o uzyskanie identyfikatora URI miniatury dla elementów zindeksowanych w tym źródle danych.
|
operationIds[] |
string
Identyfikatory długotrwałych operacji (LROs) obecnie wykonywanych w ramach tego schematu.
|
Metody |
|
|
Tworzy źródło danych. |
|
|
Usuwa źródło danych. |
|
|
Pobiera źródło danych. |
|
|
Wyświetla listę źródeł danych. |
|
|
Aktualizuje źródło danych. |
|
|
Aktualizuje źródło danych. |
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-25 UTC.
[null,null,["Ostatnia aktualizacja: 2025-07-25 UTC."],[],[],null,["# REST Resource: settings.datasources\n\n- [Resource: DataSource](#DataSource)\n - [JSON representation](#DataSource.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: DataSource\n--------------------\n\nDatasource is a logical namespace for items to be indexed. All items must belong to a datasource. This is the prerequisite before items can be indexed into Cloud Search.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"displayName\": string, \"shortName\": string, \"indexingServiceAccounts\": [ string ], \"disableServing\": boolean, \"disableModifications\": boolean, \"itemsVisibility\": [ { object (/workspace/cloud-search/docs/reference/rest/v1/GSuitePrincipal) } ], \"returnThumbnailUrls\": boolean, \"operationIds\": [ string ] } ``` |\n\n| Fields ||\n|-----------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` The name of the datasource resource. Format: datasources/{sourceId}. The name is ignored when creating a datasource. |\n| `displayName` | `string` Required. Display name of the datasource The maximum length is 300 characters. |\n| `shortName` | `string` A short name or alias for the source. This value will be used to match the 'source' operator. For example, if the short name is *\\\u003cvalue\\\u003e* then queries like *source:\\\u003cvalue\\\u003e* will only return results for this source. The value must be unique across all datasources. The value must only contain alphanumeric characters (a-zA-Z0-9). The value cannot start with 'google' and cannot be one of the following: mail, gmail, docs, drive, groups, sites, calendar, hangouts, gplus, keep, people, teams. Its maximum length is 32 characters. |\n| `indexingServiceAccounts[]` | `string` List of service accounts that have indexing access. |\n| `disableServing` | `boolean` Disable serving any search or assist results. |\n| `disableModifications` | `boolean` If true, sets the datasource to read-only mode. In read-only mode, the Indexing API rejects any requests to index or delete items in this source. Enabling read-only mode does not stop the processing of previously accepted data. |\n| `itemsVisibility[]` | `object (`[GSuitePrincipal](/workspace/cloud-search/docs/reference/rest/v1/GSuitePrincipal)`)` This field restricts visibility to items at the datasource level. Items within the datasource are restricted to the union of users and groups included in this field. Note that, this does not ensure access to a specific item, as users need to have ACL permissions on the contained items. This ensures a high level access on the entire datasource, and that the individual items are not shared outside this visibility. |\n| `returnThumbnailUrls` | `boolean` Can a user request to get thumbnail URI for Items indexed in this data source. |\n| `operationIds[]` | `string` IDs of the Long Running Operations (LROs) currently running for this schema. |\n\n| Methods ------- ||\n|------------------------------------------------------------------------------------------|-----------------------|\n| ### [create](/workspace/cloud-search/docs/reference/rest/v1/settings.datasources/create) | Creates a datasource. |\n| ### [delete](/workspace/cloud-search/docs/reference/rest/v1/settings.datasources/delete) | Deletes a datasource. |\n| ### [get](/workspace/cloud-search/docs/reference/rest/v1/settings.datasources/get) | Gets a datasource. |\n| ### [list](/workspace/cloud-search/docs/reference/rest/v1/settings.datasources/list) | Lists datasources. |\n| ### [patch](/workspace/cloud-search/docs/reference/rest/v1/settings.datasources/patch) | Updates a datasource. |\n| ### [update](/workspace/cloud-search/docs/reference/rest/v1/settings.datasources/update) | Updates a datasource. |"]]
