REST Resource: settings.datasources
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Risorsa: DataSource
Origine dati è uno spazio dei nomi logico per gli elementi da indicizzare. Tutti gli elementi devono appartenere a un'origine dati. Questo è il prerequisito necessario prima che gli elementi possano essere indicizzati in Cloud Search.
| Rappresentazione JSON |
{
"name": string,
"displayName": string,
"shortName": string,
"indexingServiceAccounts": [
string
],
"disableServing": boolean,
"disableModifications": boolean,
"itemsVisibility": [
{
object (GSuitePrincipal)
}
],
"returnThumbnailUrls": boolean,
"operationIds": [
string
]
} |
| Campi |
name |
string
Il nome della risorsa dell'origine dati. Formato: datasources/{sourceId}. Il nome viene ignorato durante la creazione di un'origine dati.
|
displayName |
string
Obbligatorio. Nome visualizzato dell'origine dati. La lunghezza massima è 300 caratteri.
|
shortName |
string
Un nome breve o un alias per l'origine. Questo valore verrà utilizzato per trovare una corrispondenza con l'operatore "source". Ad esempio, se il nome breve è <value>, query come source:<value> restituiranno solo risultati per questa origine. Il valore deve essere univoco in tutte le origini dati. Il valore deve contenere solo caratteri alfanumerici (a-zA-Z0-9). Il valore non può iniziare con "google" e non può essere uno dei seguenti: mail, gmail, docs, drive, groups, sites, calendar, hangouts, gplus, keep, people, teams. La lunghezza massima è di 32 caratteri.
|
indexingServiceAccounts[] |
string
Elenco degli account di servizio che dispongono dell'accesso all'indicizzazione.
|
disableServing |
boolean
Disattivare la pubblicazione di risultati di ricerca o di assistenza.
|
disableModifications |
boolean
Se true, imposta la modalità di sola lettura per la sorgente dati. In modalità di sola lettura, l'API Indexing rifiuta tutte le richieste di indicizzazione o eliminazione di elementi in questa origine. L'attivazione della modalità di sola lettura non interrompe l'elaborazione dei dati accettati in precedenza.
|
itemsVisibility[] |
object (GSuitePrincipal)
Questo campo limita la visibilità agli elementi a livello di origine dati. Gli elementi all'interno della sorgente dati sono limitati all'unione di utenti e gruppi inclusi in questo campo. Tieni presente che questo non garantisce l'accesso a un elemento specifico, poiché gli utenti devono disporre delle autorizzazioni ACL per gli elementi contenuti. In questo modo, viene garantito un accesso di alto livello all'intera origine dati e i singoli elementi non vengono condivisi al di fuori di questa visibilità.
|
returnThumbnailUrls |
boolean
Un utente può richiedere l'URI delle miniature per gli elementi indicizzati in questa origine dati.
|
operationIds[] |
string
ID delle operazioni a lunga esecuzione (LRO) attualmente in esecuzione per questo schema.
|
Metodi |
|
|
Crea un'origine dati. |
|
|
Consente di eliminare un'origine dati. |
|
|
Recupera un'origine dati. |
|
|
Elenca le origini dati. |
|
|
Aggiorna un'origine dati. |
|
|
Aggiorna un'origine dati. |
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 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. |"]]
