- Richiesta HTTP
- Parametri percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- IndexItemOptions
- Prova!
Aggiorna ACL, metadati e contenuti di Item
. L'elemento Item
verrà inserito se non esiste. Questo metodo non supporta gli aggiornamenti parziali. I campi senza valori forniti vengono cancellati nell'indice di Cloud Search.
L'esecuzione di questa API richiede un account amministratore o di servizio. L'account di servizio utilizzato è quello consentito nell'origine dati corrispondente.
Richiesta HTTP
POST https://cloudsearch.googleapis.com/v1/indexing/{item.name=datasources/*/items/*}:index
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
item.name |
Il nome dell'articolo. Formato: datasources/{sourceId}/items/{itemId} Questo campo è obbligatorio. La lunghezza massima è di 1536 caratteri. |
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "item": { "name": string, "acl": { "inheritAclFrom": string, "aclInheritanceType": enum ( |
Campi | |
---|---|
item.acl |
Elenco di controllo dell'accesso per questo elemento. |
item.metadata |
Le informazioni sui metadati. |
item.structuredData |
I dati strutturati per l'elemento che devono essere conformi a una definizione di oggetto registrato nello schema dell'origine dati. |
item.content |
Contenuti degli elementi da indicizzare e rendere il testo disponibile per la ricerca. |
item.version |
Obbligatorio. Il sistema di indicizzazione archivia la versione dell'origine dati come stringa di byte e confronta la versione dell'elemento nell'indice con la versione dell'elemento in coda utilizzando l'ordine grammaticale. L'indicizzazione di Cloud Search non indicizza né elimina alcun elemento in coda con un valore di versione inferiore o uguale a quello dell'elemento attualmente indicizzato. La lunghezza massima per questo campo è 1024 byte. Per informazioni su come la versione dell'elemento influisce sul processo di eliminazione, consulta Gestire le revisioni dopo le eliminazioni manuali. Una stringa con codifica base64. |
item.status |
Stato dell'articolo. Campo di solo output. |
item.queue |
Coda a cui appartiene questo elemento. La lunghezza massima è di 100 caratteri. |
item.payload |
Un connettore di stato aggiuntivo può archiviare per questo elemento. La lunghezza massima è 10.000 byte. Una stringa con codifica base64. |
item.itemType |
Il tipo di questo elemento. |
connectorName |
Il nome del connettore che effettua la chiamata. Formato: datasources/{sourceId}/connectors/{ID} |
mode |
Obbligatorio. Il campo RequestMode per questa richiesta. |
debugOptions |
Opzioni di debug comuni. |
indexItemOptions |
|
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.indexing
https://www.googleapis.com/auth/cloud_search
Per ulteriori informazioni, consulta la Guida all'autorizzazione.
IndexItemOptions
Rappresentazione JSON |
---|
{ "allowUnknownGsuitePrincipals": boolean } |
Campi | |
---|---|
allowUnknownGsuitePrincipals |
Specifica se la richiesta di indice deve consentire le entità Google Workspace che non esistono o che sono state eliminate. |