LiveCuepoints

Zasób liveCuepoint i metoda liveCuepoints.insert zostały wycofane i zastąpione metodą liveBroadcasts.cuepoint.

Zasób liveCuepoint wstawia punkt wstawienia reklamy w strumieniu transmisji wideo, co może spowodować przerwę na reklamę.

Uwaga: to polecenie interfejsu API jest częścią interfejsu YouTube Content ID API i ma inne wymagania autoryzacji niż żądania zarządzania zasobami liveBroadcast i liveStream.

Metody

Interfejs API obsługuje następujące metody w przypadku zasobów liveCuepoints:

wstaw
Wprowadza punkt wstawienia do transmisji na żywo. Obecnie prośby o dostęp do tej metody muszą być autoryzowane przez konto powiązane z właścicielem treści YouTube. Wypróbuj teraz

Reprezentowanie zasobów

Poniższa struktura JSON pokazuje format zasobu liveCuepoints:

{
  "id": string,
  "kind": "youtubePartner#liveCuepoint",
  "broadcastId": string,
  "settings": {
    "offsetTimeMs": long,
    "walltime": datetime,
    "cueType": string,
    "durationSecs": unsigned integer
  }
}

Usługi

Poniższa tabela określa właściwości, które pojawiają się w tym zasobie:

Usługi
id string
Wartość przypisywana w YouTube do jednoznacznego identyfikowania punktu wstawienia.
kind string
Typ zasobu interfejsu API. W przypadku liveCuepoint zasobu wartość to youtubePartner#liveCuepoint.
broadcastId string
Identyfikator przypisywany w YouTube do jednoznacznego identyfikowania transmisji, do której wstawiany jest punkt wstawienia.
settings object
Obiekt settings określa ustawienia punktu wstawienia.
settings.offsetTimeMs long
Ta wartość określa punkt w filmie, w którym widzowie powinni zobaczyć reklamę lub planszę In-Stream. Wartość właściwości określa przesunięcie czasu (w milisekundach) od początku strumienia monitorowania. Mimo że jest mierzona w milisekundach, wartość jest w przybliżeniu, a YouTube wstawia punkt wstawienia reklamy tak blisko jak to możliwe. Nie podawaj wartości tego parametru, jeśli w transmisji nie ma strumienia monitorowania.

Wartość domyślna tej właściwości to 0, co oznacza, że punkt wstawienia reklamy należy wstawić jak najszybciej. Jeśli Twoja transmisja nie jest opóźniona, jedyną prawidłową wartością jest 0. Jeśli jednak strumień transmisji jest opóźniony, wartość właściwości może określać czas, do którego należy wstawić punkt wstawienia. Więcej informacji znajdziesz w przewodniku Pierwsze kroki.

Uwaga: jeśli w transmisji wykorzystano fazę testowania, przesunięcie jest mierzone od momentu rozpoczęcia fazy testowania.
settings.walltime datetime
Ta wartość określa czas zegara ściennego, do którego należy wstawić punkt wstawienia. Wartość ma format ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ).

Interfejs API zwraca błąd, jeśli żądanie próbuje wstawić punkt wstawienia określający wartość tej właściwości i właściwości settings.offsetTimeMs.
settings.cueType string
Typ punktu wstawienia. Omówienie różnych typów punktów wstawienia reklamy znajdziesz w przewodniku dla początkujących. Sprawdzone metody wstawiania punktów wstawienia w trakcie transmisji znajdziesz też w dokumencie Dzień z transmisji.

Prawidłowe wartości tej właściwości to:
  • ad
settings.durationSecs unsigned integer
Czas trwania punktu wstawienia (w sekundach). Wartość musi być określona, jeśli cueType ma wartość ad, a w przeciwnym razie jest ignorowany.