Method: media.upload

Lädt Medien zur Indexierung hoch.

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

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

Weitere Informationen finden Sie im Hilfeartikel Inhaltsconnectors mit der REST API erstellen.

Hinweis:Zum Ausführen 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 des Mediums, das heruntergeladen wird. 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.