Method: media.upload

Przesyła multimedia do zindeksowania.

Punkt końcowy przesyłania obsługuje protokoły przesyłania bezpośredniego i wznawiania oraz jest przeznaczony dla dużych elementów, których nie można wbudować w żądaniach indeksu. Aby zindeksować dużą treść:

  1. Wywołaj indexing.datasources.items.upload, podając nazwę elementu, aby rozpocząć sesję przesyłania i pobrać UploadItemRef.
  2. Wywołaj media.upload, aby przesłać treści w ramach żądania strumieniowego przesyłania treści, korzystając z tej samej nazwy zasobu, która widnieje w polu UploadItemRef od kroku 1.
  3. Wywołaj funkcję indexing.datasources.items.index, aby zindeksować element. Wypełnij pole ItemContent wartością UploadItemRef z kroku 1.

Więcej informacji znajdziesz w artykule Tworzenie oprogramowania sprzęgającego treści przy użyciu interfejsu API REST.

Uwaga: do wykonania tego interfejsu API wymagane jest konto usługi.

Żądanie HTTP

  • Identyfikator URI przesyłania dla żądań przesłania multimediów:
    POST https://cloudsearch.googleapis.com/upload/v1/media/{resourceName=**}
  • Identyfikator URI metadanych dla żądań tylko metadanych:
    POST https://cloudsearch.googleapis.com/v1/media/{resourceName=**}

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
resourceName

string

Nazwa pobieranych multimediów. Zobacz ReadRequest.resource_name.

Treść żądania

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

Treść odpowiedzi

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

Zasób multimedialny.

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 po autoryzacji.