Method: media.upload

Przesyła multimedia do indeksowania.

Punkt końcowy przesyłania obsługuje protokoły bezpośredniego przesyłania i przesyłania z możliwością wznowienia. Jest przeznaczony do przesyłania dużych elementów, których nie można wstawić w ramach żądań indeksu. Aby zindeksować duże treści:

  1. Aby rozpocząć sesję przesyłania i pobrać UploadItemRef, wywołaj funkcję indexing.datasources.items.upload z nazwą elementu.
  2. Wywołaj funkcję media.upload, aby przesłać treści jako żądanie przesyłania strumieniowego, używając tej samej nazwy zasobu z identyfikatora UploadItemRef z etapu 1.
  3. Zadzwoń pod numer indexing.datasources.items.index, aby zindeksować element. Wypełnij element ItemContent wartością UploadItemRef z kroku 1.

Więcej informacji znajdziesz w artykule Tworzenie oprogramowania sprzęgającego treści za pomocą interfejsu API REST.

Uwaga: do wykonania tej operacji wymagane jest konto usługi.

Żądanie HTTP

  • Identyfikator URI przesyłania – dotyczy żądań przesyłania multimediów:
    POST https://cloudsearch.googleapis.com/upload/v1/media/{resourceName=**}
  • Identyfikator URI metadanych, w przypadku żądań tylko z metadanymi:
    POST https://cloudsearch.googleapis.com/v1/media/{resourceName=**}

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
resourceName

string

Nazwa multimediów, które są pobierane. Zobacz ReadRequest.resource_name.

Treść żądania

Treść żądania zawiera wystąpienie elementu Media.

Treść odpowiedzi

Zasób multimedialny.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "resourceName": string
}
Pola
resourceName

string

Nazwa zasobu multimedialnego.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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

Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.