Przesyłanie multimediów

Funkcja przesyłania plików multimedialnych umożliwia przechowywanie danych, których możesz używać w Display & Video 360. Rodzaje danych, które można przesłać, to m.in. zdjęcia, filmy, pliki ZIP itp.

Opcje przesyłania

Interfejs Display & Video 360 API umożliwia przesyłanie określonych typów danych binarnych lub multimediów. Charakterystyka danych, które możesz przesłać, jest szczegółowo opisana w przewodniku dla deweloperów w przypadku każdego zadania wymagającego przesłania multimediów:

  • Maksymalny rozmiar przesyłanego pliku: maksymalna ilość danych, jaką możesz przechowywać za pomocą tej metody.
  • Akceptowane typy MIME multimediów: typy danych binarnych, które możesz przechowywać za pomocą tej metody.

Żądania przesyłania możesz wysyłać na jeden z tych sposobów. Określ metodę, której używasz, za pomocą parametru uploadType.

  • Proste przesyłanie: uploadType=media. Szybkie przesyłanie plików o rozmiarze około 5 MB lub mniejszym.
  • Przesyłanie wieloczęściowe: uploadType=multipart. Szybkie przenoszenie plików i odpowiednich metadanych. Przenosi plik i metadane w ramach jednego żądania.

Podczas przesyłania multimediów używasz /uploadidentyfikatora URI. Użyj tego URI podczas przesyłania samych danych multimedialnych.

Przykład:

  POST /upload/media/resource-name

Proste przesyłanie

Proste żądanie przesłania to najprostsza metoda przesyłania pliku. To dobry wybór, gdy:

  • W razie potrzeby możesz ponownie przesłać plik.
  • Nie ma metadanych do wysłania. Może to być prawdą, jeśli metadane nie są konieczne lub są uwzględnione w innym miejscu w żądaniu.

Aby użyć prostego przesyłania, wyślij żądanie POST lub PUT do adresu URI /upload metody i dodaj parametr zapytania uploadType=media. Na przykład:

  POST https://displayvideo.googleapis.com/upload/media/resource-name?uploadType=media

Nagłówki HTTP, które należy użyć podczas prostego przesyłania, to:

  • Content-Type. Ustaw na jeden z akceptowanych typów danych multimedialnych metody.
  • Content-Length. Ustaw na liczbę przesyłanych bajtów. Nie jest wymagane, jeśli używasz kodowania przesyłania fragmentami.

Przesyłanie wieloczęściowe

Jeśli chcesz przesłać metadane wraz z danymi, możesz wysłać multipart/related. To dobre rozwiązanie, jeśli wysyłane dane są wystarczająco małe, aby w razie potrzeby można było je ponownie przesłać.

Aby użyć przesyłania wieloczęściowego, wyślij żądanie POST lub PUT do identyfikatora URI metody /upload i dodaj parametr zapytania uploadType=multipart. Na przykład:

  POST https://displayvideo.googleapis.com/upload/v4/advertisers/advertiser-id/assets?uploadType=multipart

Nagłówki HTTP najwyższego poziomu, które należy użyć podczas wysyłania żądania przesyłania wieloczęściowego, to:

  • Content-Type. Ustaw wartość multipart/related i dołącz ciąg graniczny, którego używasz do identyfikowania części żądania.
  • Content-Length. Ustaw na łączną liczbę bajtów w treści żądania. Część żądania dotycząca multimediów musi być mniejsza niż maksymalny rozmiar pliku określony dla tej metody.

Treść żądania jest sformatowana jako typ treści multipart/related [RFC2387] i zawiera dokładnie 2 części. Poszczególne części są identyfikowane za pomocą ciągu granicznego, a po ostatnim ciągu granicznym występują dwa łączniki.

Każda część żądania wieloczęściowego wymaga dodatkowego nagłówka Content-Type:

  1. Część metadanych: musi być pierwsza, a Content-Type musi być zgodna z jednym z akceptowanych formatów metadanych.
  2. Część multimedialna: musi występować jako druga, a Content-Type musi pasować do jednego z akceptowanych typów MIME multimediów w metodzie.

Przykłady

Za pomocą interfejsu Display & Video 360 API możesz przesyłać multimedia, aby wykonywać różne zadania. Ta sekcja zawiera przykłady w postaci żądań curl.

Przesyłanie komponentu kreacji

Aby przesłać komponent kreacji:

curl --request POST \
  'https://displayvideo.googleapis.com/upload/v4/advertisers/advertiser-id/assets?uploadType=multipart' \
  --header 'Authorization: Bearer access-token' \
   -F "data={\"filename\": \"asset-filename\"};type=application/json;charset=UTF-8" \
   -F "file=@asset-path;type=asset-mime-type"

Więcej informacji i przykłady kodu znajdziesz w przewodniku Przesyłanie komponentów kreacji.

Prześlij plik skryptu ustalania stawek niestandardowych

Aby przesłać plik skryptu:

curl --request POST \
  'https://displayvideo.googleapis.com/upload/media/resource-name?uploadType=media' \
  -H 'authorization: Bearer access-token' \
  -H 'Content-Type: text/plain' \
  --data-binary @script-path

Więcej informacji i przykłady kodu znajdziesz w przewodniku Przesyłanie skryptu.