- Richiesta HTTP
- Parametri percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Prova!
Aggiorna un'origine dati.
Nota: per l'esecuzione di questa API è necessario un account amministratore.
Richiesta HTTP
PUT https://cloudsearch.googleapis.com/v1/settings/{source.name=datasources/*}
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
source.name |
Il nome della risorsa dell'origine dati. Formato: datasources/{sourceId}. Il nome viene ignorato durante la creazione di un'origine dati. |
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "source": { "name": string, "displayName": string, "shortName": string, "indexingServiceAccounts": [ string ], "disableServing": boolean, "disableModifications": boolean, "itemsVisibility": [ { // Union field |
Campi | |
---|---|
source.displayName |
Obbligatorio. Nome visualizzato dell'origine dati. La lunghezza massima è di 300 caratteri. |
source.shortName |
Un nome breve o un alias della fonte. Questo valore verrà utilizzato per corrispondere al valore "source" operatore. Ad esempio, se il nome breve è <value>, query come <value> restituiranno solo i risultati per questa sorgente. 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 sua lunghezza massima è di 32 caratteri. |
source.indexingServiceAccounts[] |
Elenco di account di servizio con accesso per l'indicizzazione. |
source.disableServing |
Disattiva la pubblicazione di risultati di ricerca o assistenza. |
source.disableModifications |
Se impostato su true, imposta l'origine dati in modalità di sola lettura. In modalità di sola lettura, l'API Index rifiuta qualsiasi richiesta 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. |
source.itemsVisibility[] |
Questo campo limita la visibilità agli elementi a livello di origine dati. Gli elementi all'interno dell'origine dati sono limitati all'unione di utenti e gruppi inclusi in questo campo. Tieni presente che ciò non garantisce l'accesso a un elemento specifico, poiché gli utenti devono disporre delle autorizzazioni ACL per gli elementi contenuti. Ciò garantisce un accesso generale all'intera origine dati e che i singoli elementi non vengono condivisi al di fuori di questa visibilità. |
source.returnThumbnailUrls |
Un utente può richiedere di ottenere l'URI della miniatura per gli elementi indicizzati in questa origine dati? |
source.operationIds[] |
ID delle operazioni a lunga esecuzione (LRO) attualmente in esecuzione per questo schema. |
debugOptions |
Opzioni di debug comuni. |
updateMask |
Si applica solo a Aggiorna la maschera per controllare quali campi aggiornare. Esempi di percorsi dei campi:
|
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation
.
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/cloud_search.settings.indexing
https://www.googleapis.com/auth/cloud_search.settings
https://www.googleapis.com/auth/cloud_search
Per ulteriori informazioni, consulta la Guida all'autorizzazione.