Method: media.upload

Lädt Medien für die Indexierung hoch.

Der Uploadendpunkt unterstützt direkte und fortsetzbare Uploadprotokolle und ist für große Elemente vorgesehen, die während Indexanfragen nicht eingefügt werden können. So indexieren Sie großen Inhalt:

  1. Rufen Sie indexing.datasources.items.upload mit dem Elementnamen auf, um eine Uploadsitzung zu starten und das UploadItemRef abzurufen.
  2. Rufen Sie media.upload auf, um den Inhalt als Streaminganfrage hochzuladen. Verwenden Sie dabei denselben Ressourcennamen aus der UploadItemRef aus Schritt 1.
  3. Rufen Sie indexing.datasources.items.index auf, um das Element zu indexieren. Füllen Sie ItemContent mit UploadItemRef aus Schritt 1.

Weitere Informationen zum Erstellen eines Inhaltsconnectors mit der REST API

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

HTTP-Anfrage

  • Upload-URI für Medien-Uploadanfragen:
    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 Medien, die heruntergeladen werden. ReadRequest.resource_name ansehen.

Anfragetext

Der Anfragetext enthält eine Instanz von Media.

Antworttext

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

Medienressource.

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.