Method: media.upload

Lädt Medien zur Indexierung hoch.

Der Uploadendpunkt unterstützt direkte und fortsetzbare Uploadprotokolle und ist für große Elemente gedacht, die nicht bei Indexanfragen eingefügt werden können. So indexieren Sie große Inhalte:

  1. Rufe indexing.datasources.items.upload mit dem Artikelnamen auf, um eine Uploadsitzung zu starten und die UploadItemRef abzurufen.
  2. Rufe media.upload auf, um die Inhalte als Streaminganfrage hochzuladen. Verwende dabei denselben Ressourcennamen wie in der UploadItemRef aus Schritt 1.
  3. Rufen Sie indexing.datasources.items.index auf, um das Element zu indexieren. Fülle ItemContent mit der UploadItemRef aus Schritt 1 aus.

Weitere Informationen finden Sie unter Mithilfe der REST API Inhaltsconnectors erstellen.

Hinweis:Für die Ausführung dieser API ist ein Dienstkonto erforderlich.

HTTP-Anfrage

  • Upload-URI für Anfragen zum Hochladen von Medien:
    POST https://cloudsearch.googleapis.com/upload/v1/media/{resourceName=**}
  • Metadaten-URI für Anfragen, die nur Metadaten enthalten:
    POST https://cloudsearch.googleapis.com/v1/media/{resourceName=**}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
resourceName

string

Name der heruntergeladenen Medien. ReadRequest.resource_name ansehen.

Anfragetext

Der Anfragetext enthält eine Instanz von Media.

Antworttext

Medienressource

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "resourceName": string
}
Felder
resourceName

string

Name der Medienressource.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/cloud_search.indexing
  • https://www.googleapis.com/auth/cloud_search

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.