Method: indexing.datasources.items.upload
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Crea una sessione di caricamento per il caricamento dei contenuti degli articoli. Per gli elementi di dimensioni inferiori a 100 KB, è più facile incorporare i contenuti inline in una richiesta index.
Per l'esecuzione di questa API è necessario un account amministratore o un account di servizio. L'account di servizio utilizzato è quello inserito nella lista consentita nell'origine dati corrispondente.
Richiesta HTTP
POST https://cloudsearch.googleapis.com/v1/indexing/{name=datasources/*/items/*}:upload
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
| Parametri |
name |
string
Il nome dell'elemento per avviare un caricamento riavviabile. Formato: datasources/{sourceId}/items/{itemId}. La lunghezza massima è di 1536 byte.
|
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
| Rappresentazione JSON |
{
"connectorName": string,
"debugOptions": {
object (DebugOptions)
}
} |
| Campi |
connectorName |
string
Il nome del connettore che effettua questa chiamata. Formato: datasources/{sourceId}/connectors/{id}
|
debugOptions |
object (DebugOptions)
Opzioni di debug comuni.
|
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di UploadItemRef.
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/cloud_search.indexinghttps://www.googleapis.com/auth/cloud_search
Per ulteriori informazioni, consulta la Guida all'autorizzazione.
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,["# Method: indexing.datasources.items.upload\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates an upload session for uploading item content. For items smaller than 100 KB, it's easier to embed the content [inline](/workspace/cloud-search/docs/reference/rest/v1/indexing.datasources.items#ItemContent.FIELDS.inline_content) within an [index](/workspace/cloud-search/docs/reference/rest/v1/indexing.datasources.items/index_#google.apps.search.v1.ItemsService.IndexItem) request.\n\nThis API requires an admin or service account to execute. The service account used is the one whitelisted in the corresponding data source.\n\n### HTTP request\n\n`POST https://cloudsearch.googleapis.com/v1/indexing/{name=datasources/*/items/*}:upload`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|---------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` The name of the Item to start a resumable upload. Format: datasources/{sourceId}/items/{itemId}. The maximum length is 1536 bytes. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"connectorName\": string, \"debugOptions\": { object (/workspace/cloud-search/docs/reference/rest/v1/DebugOptions) } } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------------------------------|\n| `connectorName` | `string` The name of connector making this call. Format: datasources/{sourceId}/connectors/{id} |\n| `debugOptions` | `object (`[DebugOptions](/workspace/cloud-search/docs/reference/rest/v1/DebugOptions)`)` Common debug options. |\n\n### Response body\n\nIf successful, the response body contains an instance of [UploadItemRef](/workspace/cloud-search/docs/reference/rest/v1/indexing.datasources.items#UploadItemRef).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud_search.indexing`\n- `https://www.googleapis.com/auth/cloud_search`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
