LiveBroadcasts

Interfejs API obsługuje teraz możliwość oznaczania transmisji na żywo jako „przeznaczonych dla dzieci”, a zasób liveBroadcast zawiera teraz właściwość, która określa stan „przeznaczone dla dzieci” danej transmisji na żywo. 10 stycznia 2020 r. zaktualizowaliśmy też Warunki korzystania z usług YouTube API oraz zasady dla deweloperów. Więcej informacji znajdziesz w historiach zmian usługi YouTube Live Streaming API i Warunków korzystania z usług interfejsu API YouTube.

liveBroadcast zasób reprezentuje wydarzenie, które będzie transmitowane na żywo w YouTube.

Metody

Interfejs API obsługuje te metody dla zasobów liveBroadcasts:

list

Zwraca listę transmisji w YouTube, które pasują do parametrów żądania do interfejsu API. Wypróbuj teraz

wstaw

Tworzy transmisję. Wypróbuj teraz

aktualizować

Aktualizuje transmisję. Możesz na przykład zmodyfikować ustawienia transmisji zdefiniowane w obiekcie contentDetails zasobu liveBroadcast. Wypróbuj teraz

usuń

Usuwa transmisję. Wypróbuj teraz

bind

Łączy transmisję w YouTube ze strumieniem lub usuwa istniejące połączenie między transmisją a strumieniem. Transmisję można powiązać tylko z 1 strumieniem wideo, ale strumień wideo można powiązać z więcej niż 1 transmisją. Wypróbuj teraz

transition

Zmienia stan transmisji na żywo w YouTube i inicjuje procesy powiązane z nowym stanem. Na przykład, gdy zmienisz stan transmisji na testing, YouTube zacznie przesyłać wideo do strumienia monitora tej transmisji. Przed wywołaniem tej metody sprawdź, czy wartość właściwości status.streamStatus w przypadku strumienia powiązanego z transmisją wynosi active. Wypróbuj teraz

cuepoint

Wstawia punkt sygnałowy do transmisji na żywo. Punkt sygnałowy może wywołać przerwę na reklamę.

Prezentacja zasobów

Poniższa struktura JSON przedstawia format zasobu liveBroadcasts:

{
  "kind": "youtube#liveBroadcast",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "scheduledStartTime": datetime,
    "scheduledEndTime": datetime,
    "actualStartTime": datetime,
    "actualEndTime": datetime,
    "isDefaultBroadcast": boolean,
    "liveChatId": string
  },
  "status": {
    "lifeCycleStatus": string,
    "privacyStatus": string,
    "recordingStatus": string,
    "madeForKids": string,
    "selfDeclaredMadeForKids": string,
  },
  "contentDetails": {
    "boundStreamId": string,
    "boundStreamLastUpdateTimeMs": datetime,
    "monitorStream": {
      "enableMonitorStream": boolean,
      "broadcastStreamDelayMs": unsigned integer,
      "embedHtml": string
    },
    "enableEmbed": boolean,
    "enableDvr": boolean,
    "recordFromStart": boolean,
    "enableClosedCaptions": boolean,
    "closedCaptionsType": string,
    "projection": string,
    "enableLowLatency": boolean,
    "latencyPreference": boolean,
    "enableAutoStart": boolean,
    "enableAutoStop": boolean,
    "availabilityConfig": {
      "globalConfig": {
        "excludedRegionCodes": [
          string
        ],
        "interval": {
          "startTime": datetime,
          "endTime": datetime
        }
      },
      "regionsConfig": {
        "regionIntervals": [
          {
            "regionCode": string,
            "interval": {
              "startTime": datetime,
              "endTime": datetime
            }
          }
        ]
      }
    }
  },
  "statistics": {
    "totalChatCount": unsigned long
  },
  "monetizationDetails": {
    "adsMonetizationStatus": string,
    "eligibleForAdsMonetization": boolean,
    "cuepointSchedule": {
      "enabled": boolean,
      "pauseAdsUntil": datetime,
      "ytOptimizedCuepointConfig": string,
      "creatorCuepointConfig": {
        "scheduleStrategy": string,
        "repeatIntervalSecs": unsigned integer
      }
    }
  }
}

Właściwości

W tej tabeli znajdziesz definicje właściwości, które pojawiają się w tym zasobie:

Właściwości
kind	string Określa typ zasobu interfejsu API. Wartość będzie wynosić youtube#liveBroadcast.
etag	etag Etag tego zasobu.
id	string Identyfikator przypisany przez YouTube w celu jednoznacznego określenia transmisji.
snippet	object Obiekt snippet zawiera podstawowe informacje o wydarzeniu, w tym tytuł, opis, godzinę rozpoczęcia i zakończenia.
snippet.publishedAt	datetime Data i godzina dodania transmisji do harmonogramu transmisji na żywo w YouTube. Wartość jest podana w formacie ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
snippet.channelId	string Identyfikator, którego YouTube używa do jednoznacznej identyfikacji kanału publikującego transmisję.
snippet.title	string Tytuł transmisji. Pamiętaj, że transmisja reprezentuje dokładnie 1 film w YouTube. Możesz ustawić to pole, modyfikując zasób transmisji lub ustawiając pole title odpowiedniego zasobu wideo.
snippet.description	string Opis transmisji. Podobnie jak w przypadku pola title, możesz ustawić to pole, modyfikując zasób transmisji lub ustawiając pole description odpowiedniego zasobu wideo.
snippet.thumbnails	object Mapa miniatur powiązanych z transmisją. W przypadku każdego zagnieżdżonego obiektu w tym obiekcie kluczem jest nazwa miniatury, a wartością jest obiekt zawierający inne informacje o miniaturze.
snippet.thumbnails.(key)	object Prawidłowe wartości klucza to: default – domyślna miniatura. Domyślna miniatura filmu lub zasobu, który odnosi się do filmu, np. elementu playlisty lub wyniku wyszukiwania, ma szerokość 120 pikseli i wysokość 90 pikseli. Domyślna miniatura kanału ma 88 pikseli szerokości i 88 pikseli wysokości. medium – wersja miniatury w wyższej rozdzielczości. W przypadku filmu (lub zasobu, który odwołuje się do filmu) obraz ma szerokość 320 pikseli i wysokość 180 pikseli. W przypadku kanału obraz ten ma szerokość 240 pikseli i wysokość 240 pikseli. high – wersja miniatury w wysokiej rozdzielczości. W przypadku filmu (lub zasobu, który odwołuje się do filmu) ten obraz ma szerokość 480 pikseli i wysokość 360 pikseli. W przypadku kanału obraz ten ma szerokość i wysokość 800 pikseli.
snippet.thumbnails.(key).url	string Adres URL obrazu.
snippet.thumbnails.(key).width	unsigned integer Szerokość obrazu.
snippet.thumbnails.(key).height	unsigned integer Wysokość obrazu.
snippet.scheduledStartTime	datetime Data i godzina rozpoczęcia transmisji. Wartość jest podana w formacie ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ). Creator Studio umożliwia tworzenie transmisji bez planowania godziny rozpoczęcia. W takim przypadku transmisja rozpoczyna się, gdy właściciel kanału rozpocznie przesyłanie strumieniowe. W przypadku tych transmisji wartość datetime odpowiada zeru czasu epoki systemu Unix i nie można jej zmienić za pomocą interfejsu API ani w Studio Twórców.
snippet.scheduledEndTime	datetime Data i godzina zakończenia transmisji. Wartość jest podana w formacie ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ). Jeśli zasób liveBroadcast nie określa wartości tej właściwości, transmisja jest zaplanowana na czas nieokreślony. Podobnie, jeśli nie podasz wartości tej właściwości, YouTube uzna, że transmisja będzie trwać w nieskończoność.
snippet.actualStartTime	datetime Data i godzina rozpoczęcia transmisji. Te informacje są dostępne dopiero wtedy, gdy stan transmisji to live. Wartość jest podana w formacie ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
snippet.actualEndTime	datetime Data i godzina rzeczywistego zakończenia transmisji. Te informacje są dostępne dopiero wtedy, gdy stan transmisji to complete. Wartość jest podana w formacie ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
snippet.isDefaultBroadcast	boolean Ta właściwość zostanie wycofana 1 września 2020 r. lub później. W tym czasie YouTube przestanie tworzyć domyślny strumień i domyślną transmisję, gdy kanał zostanie włączony do transmitowania na żywo. Więcej informacji znajdziesz w ogłoszeniu o wycofaniu. Ta właściwość wskazuje, czy ta transmisja jest domyślną transmisją. Jak działają domyślne transmisje Gdy kanał w YouTube jest włączony do transmisji na żywo, YouTube tworzy dla niego domyślny strumień i domyślną transmisję. Strumień określa, w jaki sposób właściciel kanału przesyła transmisję na żywo do YouTube, a transmisja to sposób, w jaki widzowie mogą oglądać domyślny strumień. Właściciel kanału może użyć metod liveStreams.list i liveBroadcasts.list, aby zidentyfikować te zasoby. Gdy kanał rozpocznie przesyłanie strumieniowe wideo do domyślnego strumienia, film będzie widoczny w domyślnej transmisji kanału. Po zakończeniu transmisji na żywo YouTube przekształca ukończoną transmisję w film na YouTube i przypisuje mu identyfikator filmu w YouTube. Po zakończeniu konwersji film jest dodawany do listy przesłanych filmów na kanale. Film nie jest dostępny od razu po zakończeniu transmisji, a długość opóźnienia zależy od rzeczywistej długości transmisji.
snippet.liveChatId	string Identyfikator czatu na żywo w YouTube. Za pomocą tego identyfikatora możesz używać metod zasobu liveChatMessage do pobierania, wstawiania i usuwania wiadomości na czacie. Możesz też dodawać i usuwać moderatorów czatu, blokować użytkownikom możliwość uczestniczenia w czatach na żywo lub usuwać istniejące blokady.
status	object Obiekt status zawiera informacje o stanie zdarzenia.
status.lifeCycleStatus	string Stan transmisji. Stan można zaktualizować za pomocą metody liveBroadcasts.transition interfejsu API. Prawidłowe wartości tej właściwości to: complete – transmisja została zakończona. created – transmisja ma niekompletne ustawienia, więc nie jest gotowa do przejścia do stanu live lub testing, ale została utworzona i jest w inny sposób prawidłowa. live – transmisja jest aktywna. liveStarting – transmisja jest w trakcie przechodzenia do stanu live. ready – ustawienia transmisji są kompletne i może ona przejść do stanu live lub testing. revoked – ta transmisja została usunięta przez administratora. testStarting – transmisja jest w trakcie przechodzenia do stanu testing. testing – transmisja jest widoczna tylko dla partnera.
status.privacyStatus	string Stan prywatności transmisji. Pamiętaj, że transmisja reprezentuje dokładnie 1 film w YouTube, więc ustawienia prywatności są identyczne z tymi, które są obsługiwane w przypadku filmów. Możesz też ustawić to pole, modyfikując zasób transmisji lub ustawiając pole privacyStatus odpowiedniego zasobu wideo. Prawidłowe wartości tej właściwości to: private public unlisted
status.recordingStatus	string Stan rejestrowania (danych) transmisji. Prawidłowe wartości tego atrybutu to: notRecording recorded recording
status.madeForKids	boolean Ta wartość wskazuje, czy transmisja jest oznaczona jako skierowana do dzieci. Wartość tej właściwości jest tylko do odczytu.
status.selfDeclaredMadeForKids	boolean W liveBroadcasts.insertżądaniu ta właściwość umożliwia właścicielowi kanału oznaczenie transmisji jako skierowanej do dzieci. W przypadku żądania liveBroadcasts.list wartość właściwości jest zwracana tylko wtedy, gdy właściciel kanału autoryzował żądanie interfejsu API.
contentDetails	object Obiekt contentDetails zawiera informacje o treściach wideo powiązanych ze zdarzeniem, np. czy można je wyświetlać w odtwarzaczu umieszczonym na stronie, czy będą archiwizowane, a tym samym dostępne do obejrzenia po zakończeniu zdarzenia.
contentDetails.boundStreamId	string Ta wartość jednoznacznie identyfikuje live stream powiązany z transmisją.
contentDetails.boundStreamLastUpdateTimeMs	datetime Data i godzina ostatniej aktualizacji transmisji na żywo, do której odwołuje się parametr boundStreamId.
contentDetails.monitorStream	object Obiekt monitorStream zawiera informacje o strumieniu monitora, którego nadawca może użyć do sprawdzenia treści zdarzenia przed publicznym wyświetleniem strumienia transmisji.
contentDetails.monitorStream.enableMonitorStream	boolean Ta wartość określa, czy strumień monitora jest włączony w przypadku transmisji. Jeśli strumień monitorowania jest włączony, YouTube będzie transmitować treści wydarzenia w specjalnym strumieniu przeznaczonym tylko dla nadawcy. Nadawca może używać strumienia do sprawdzania treści wydarzenia, a także do określania optymalnych momentów na wstawianie punktów sygnałowych.  Jeśli chcesz, aby transmisja miała testing etap lub opóźnienie transmisji dla wydarzenia, musisz ustawić tę wartość na true. Jeśli wartość tej właściwości to true, musisz też przejść do stanu testing, zanim przejdziesz do stanu live. (Jeśli wartość właściwości to false, transmisja nie może mieć etapu testing, więc możesz bezpośrednio przejść do stanu live).  Gdy update a broadcast, ta właściwość musi być ustawiona, jeśli żądanie do interfejsu API zawiera część contentDetails w wartości parametru part. Jeśli jednak insert a broadcast, właściwość jest opcjonalna i ma domyślną wartość true. Ważne: tego atrybutu nie można zaktualizować, gdy transmisja jest w stanie testing lub live.
contentDetails.monitorStream.broadcastStreamDelayMs	unsigned integer Jeśli właściwość enableMonitorStream ma wartość true, ta właściwość określa długość opóźnienia transmisji na żywo.  Gdy update a broadcast, ta właściwość musi być ustawiona, jeśli żądanie do interfejsu API zawiera część contentDetails w wartości parametru part. Jeśli jednak insert a broadcast, właściwość jest opcjonalna i ma domyślną wartość 0. Ta wartość oznacza, że transmisja nie ma opóźnienia transmisji. Uwaga: tej właściwości nie można zaktualizować, gdy transmisja jest w stanie testing lub live.
contentDetails.monitorStream.embedHtml	string Kod HTML, który umieszcza odtwarzacz odtwarzający strumień monitora.
contentDetails.enableEmbed	boolean To ustawienie określa, czy film z transmisji może być odtwarzany w odtwarzaczu umieszczonym na stronie. Jeśli zdecydujesz się zarchiwizować film (za pomocą właściwości enableArchive), to ustawienie będzie też obowiązywać w przypadku zarchiwizowanego filmu.  Gdy update a broadcast, ta właściwość musi być ustawiona, jeśli żądanie do interfejsu API zawiera część contentDetails w wartości parametru part. Jeśli jednak insert a broadcast, właściwość jest opcjonalna i ma domyślną wartość true. Uwaga: tego atrybutu nie można zaktualizować, gdy transmisja jest w stanie testing lub live.
contentDetails.enableDvr	boolean To ustawienie określa, czy widzowie mogą korzystać z elementów sterujących DVR podczas oglądania filmu. Elementy sterujące nagrywarką cyfrową umożliwiają widzowi sterowanie odtwarzaniem filmu poprzez wstrzymywanie, przewijanie do tyłu i do przodu. Domyślna wartość tej właściwości to true.  Gdy update a broadcast, ta właściwość musi być ustawiona, jeśli żądanie do interfejsu API zawiera część contentDetails w wartości parametru part. Jeśli jednak insert a broadcast, właściwość jest opcjonalna i ma domyślną wartość true. Ważne: jeśli chcesz, aby odtwarzanie było dostępne natychmiast po zakończeniu transmisji, musisz ustawić wartość true, a także ustawić wartość właściwości enableArchive na true. Poza tym nie można zaktualizować tej właściwości, gdy transmisja jest w stanie testing lub live.
contentDetails.recordFromStart	boolean To ustawienie określa, czy YouTube ma automatycznie rozpocząć nagrywanie transmisji po zmianie stanu wydarzenia na „na żywo”. Domyślna wartość tej właściwości to true. Można ją ustawić na false tylko wtedy, gdy kanał nadawczy może wyłączyć nagrywanie transmisji na żywo. Jeśli Twój kanał nie ma uprawnień do wyłączania nagrań, a spróbujesz wstawić transmisję z właściwością recordFromStart ustawioną na false, interfejs API zwróci błąd Forbidden. Jeśli Twój kanał nie ma tego uprawnienia i spróbujesz zaktualizować transmisję, aby ustawić właściwość recordFromStart na false, interfejs API zwróci błąd modificationNotAllowed.  Gdy update a broadcast, ta właściwość musi być ustawiona, jeśli żądanie do interfejsu API zawiera część contentDetails w wartości parametru part. Jeśli jednak insert a broadcast, właściwość jest opcjonalna i ma domyślną wartość true. Ważne: jeśli chcesz, aby odtwarzanie było dostępne natychmiast po zakończeniu transmisji, musisz też ustawić wartość właściwości enableDvr na true. Jeśli ustawisz wartość tej właściwości na true, ale nie ustawisz też wartości właściwości enableDvr na true, zarchiwizowany film może być dostępny do odtwarzania z około jednodniowym opóźnieniem. Uwaga: tego atrybutu nie można zaktualizować, gdy transmisja jest w stanie testing lub live.
contentDetails.enableClosedCaptions	boolean Ta właściwość została wycofana 17 grudnia 2015 r. Zamiast tego użyj właściwości contentDetails.closedCaptionsType. To ustawienie wskazuje, czy w przypadku tej transmisji włączone są napisy kodowane HTTP POST. W przypadku klientów interfejsu API, którzy już korzystają z tej usługi: Ustawienie wartości właściwości na true jest równoznaczne z ustawieniem właściwości contentDetails.closedCaptionsType na closedCaptionsHttpPost. Ustawienie wartości właściwości na false jest równoznaczne z ustawieniem właściwości contentDetails.closedCaptionsType na closedCaptionsDisabled.
contentDetails.closedCaptionsType	string Uwaga: ta właściwość zastępuje właściwość contentDetails.enableClosedCaptions. Ta właściwość wskazuje, czy napisy są włączone w przypadku transmisji, a jeśli tak, to jakiego rodzaju napisy są udostępniane: closedCaptionsDisabled: napisy są wyłączone w transmisji na żywo. closedCaptionsHttpPost: napisy będą przesyłane za pomocą żądania HTTP POST na adres URL przesyłania powiązany z transmisją na żywo. closedCaptionsEmbedded: napisy zostaną zakodowane w strumieniu wideo w formatach EIA-608 lub CEA-708.
contentDetails.projection	string Format projekcji tej transmisji. Domyślna wartość usługi to rectangular. Prawidłowe wartości tego atrybutu to: 360 rectangular
contentDetails.enableLowLatency	boolean Wskazuje, czy transmisja powinna być kodowana na potrzeby strumieniowania z małym opóźnieniem. Strumień o niskim opóźnieniu może skrócić czas, po którym film będzie widoczny dla użytkowników oglądających transmisję, ale może też wpłynąć na rozdzielczość dla widzów strumienia.
contentDetails.latencyPreference	string Wskazuje ustawienie opóźnienia, które ma być używane w przypadku tej transmisji. Tej właściwości można używać zamiast enableLowLatency, która nie obsługuje ultraLow. Strumień o niskim opóźnieniu może skrócić czas, po którym film będzie widoczny dla użytkowników oglądających transmisję, ale może też wpłynąć na płynność odtwarzania. Strumień o bardzo małym opóźnieniu jeszcze bardziej skraca czas, po którym film będzie widoczny dla widzów, co ułatwia interakcję z nimi, ale bardzo małe opóźnienie nie obsługuje napisów ani rozdzielczości wyższych niż 1080p. Prawidłowe wartości tej właściwości to: normal low ultraLow
contentDetails.enableAutoStart	boolean Określa, czy ta transmisja ma się rozpocząć automatycznie po rozpoczęciu przesyłania strumieniowego wideo na połączonym live stream.
contentDetails.enableAutoStop	boolean Określa, czy ta transmisja powinna się automatycznie zakończyć około minuty po tym, jak właściciel kanału przestanie przesyłać strumieniowo wideo w powiązanym strumieniu wideo.
contentDetails.availabilityConfig	object Konfiguracja dostępności transmisji. Służy do ustawiania dostępności w określonych regionach lub blokowania określonych regionów. Jest to opcjonalne – jeśli nie zostanie skonfigurowane, nie będzie wymuszane.
contentDetails.availabilityConfig.globalConfig	object Konfiguracja globalnej dostępności transmisji. Film jest dostępny we wszystkich regionach z wyjątkiem tych, które są wymienione na liście excludedRegionCodes.
contentDetails.availabilityConfig.globalConfig.excludedRegionCodes	list (string) Lista regionów, w których film jest zablokowany.
contentDetails.availabilityConfig.globalConfig.interval	object Domyślny okres, w którym film jest dostępny we wszystkich regionach, w których nie jest zablokowany. Uwaga: ta właściwość nie jest obsługiwana w przypadku nadchodzących ani aktywnych transmisji na żywo.
contentDetails.availabilityConfig.globalConfig.interval.startTime	datetime Data i godzina udostępnienia filmu. Jeśli nie zostanie określony, film jest już dostępny. Wartość jest podana w formacie ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
contentDetails.availabilityConfig.globalConfig.interval.endTime	datetime Data i godzina, po których film przestanie być dostępny. Jeśli nie zostanie określony, film będzie dostępny na zawsze. Określone daty rozpoczęcia i zakończenia nie mogą przypadać później niż za 5 lat. Wartość jest podana w formacie ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
contentDetails.availabilityConfig.regionsConfig	object Konfiguracja regionalnej dostępności transmisji. Film jest dostępny tylko w określonych regionach.
contentDetails.availabilityConfig.regionsConfig.regionIntervals	list (object) Lista regionów i okien czasowych, w których film jest dostępny. Jeśli region zostanie określony kilka razy, używana jest suma wszystkich przedziałów.
contentDetails.availabilityConfig.regionsConfig.regionIntervals.regionCode	string Region, w którym film jest dostępny.
contentDetails.availabilityConfig.regionsConfig.regionIntervals.interval	object Okno czasowe, w którym film jest dostępny w określonym regionie. Uwaga: ta właściwość nie jest obsługiwana w przypadku nadchodzących ani aktywnych transmisji na żywo.
contentDetails.availabilityConfig.regionsConfig.regionIntervals.interval.startTime	datetime Data i godzina, kiedy film stanie się dostępny w określonym regionie. Jeśli nie zostanie określony, film jest już dostępny. Wartość jest podana w formacie ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
contentDetails.availabilityConfig.regionsConfig.regionIntervals.interval.endTime	datetime Data i godzina, kiedy film przestanie być dostępny w określonym regionie. Jeśli nie zostanie określony, film będzie dostępny na zawsze. Określone daty rozpoczęcia i zakończenia nie mogą przypadać później niż za 5 lat. Wartość jest podana w formacie ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
statistics	object Obiekt statistics zawiera statystyki dotyczące transmisji na żywo. Wartości tych statystyk mogą się zmieniać w trakcie transmisji i można je pobrać tylko wtedy, gdy jest ona aktywna.
statistics.totalChatCount	unsigned long Łączna liczba wiadomości na czacie na żywo powiązanych z transmisją. Właściwość i jej wartość są obecne, jeśli transmisja jest widoczna dla użytkownika, ma włączoną funkcję czatu na żywo i zawiera co najmniej 1 wiadomość. Pamiętaj, że po zakończeniu transmisji ta właściwość nie będzie miała wartości. Dlatego ta usługa nie będzie identyfikować liczby wiadomości na czacie w przypadku zarchiwizowanego filmu z zakończonej transmisji na żywo.
monetizationDetails	object Obiekt monetizationDetails zawiera informacje o szczegółach zarabiania na strumieniu, np. czy automatyzacja reklam jest włączona lub czy wstawianie reklam w trakcie filmu jest opóźnione. Ważne: aby włączyć automatyczne reklamy w filmie, kanał musi kwalifikować się do zarabiania na filmach. Ustawienia zarabiania transmisji, takie jak włączenie zarabiania lub automatyzacji reklam (np. „Zezwól YouTube na wstawianie reklam w trakcie filmu” lub „Zaplanuj reklamy w trakcie filmu z określoną częstotliwością”), można skonfigurować za pomocą interfejsu API lub w YouTube Studio podczas tworzenia transmisji lub edytowania jej w trakcie transmisji na żywo.
monetizationDetails.adsMonetizationStatus	string Ta właściwość wskazuje, czy w transmisji wideo są włączone reklamy w trakcie filmu. Prawidłowe wartości to on i off.
monetizationDetails.eligibleForAdsMonetization	string Ta właściwość wskazuje, czy transmisja wideo kwalifikuje się do wyświetlania reklam w trakcie filmu. Transmisja może nie kwalifikować się do zarabiania z różnych powodów, np. z powodu istniejącego roszczenia lub braku konfiguracji kanału pod kątem zarabiania.
monetizationDetails.cuepointSchedule	object Obiekt cuepointSchedule określa ustawienia automatyzacji reklam w transmisji.
monetizationDetails.cuepointSchedule.enabled	boolean Ta wartość określa, czy reklamy są automatycznie wstawiane do transmisji. Jeśli wartość to true, YouTube automatycznie wstawi reklamy w trakcie transmisji. Harmonogram wyświetlania reklam zostanie określony przez wartości innych pól w obiekcie monetizationDetails.cuepointSchedule.
monetizationDetails.cuepointSchedule.pauseAdsUntil	datetime Ta wartość określa, że YouTube nie powinien wstawiać reklam w trakcie transmisji do określonej daty i godziny. Wartość jest podana w formacie ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ). Aby wstrzymać reklamy, musisz ustawić wartość na datę i godzinę w przyszłości. Aby cofnąć wstrzymanie reklam, możesz też ustawić wartość pola na datę i godzinę w przeszłości lub na pustą wartość.
monetizationDetails.cuepointSchedule.ytOptimizedCuepointConfig	string To pole określa wybraną opcję automatycznie wstawianych punktów wstawienia reklam. Pole może określać jeden z 3 trybów: LOW: niższe potencjalne zarobki, mniej przerw podczas oglądania. MEDIUM: średnie potencjalne zarobki, bardziej zrównoważone wrażenia z oglądania HIGH: wyższe potencjalne zarobki, częstsze przerwy podczas oglądania;
monetizationDetails.cuepointSchedule.creatorCuepointConfig	object Obiekt creatorCuepointConfig określa opcję automatyzacji reklam, która umożliwia twórcom wybór sposobu wyświetlania reklam w trakcie filmu.
monetizationDetails.cuepointSchedule.creatorCuepointConfig.scheduleStrategy	string Ta wartość określa strategię, której YouTube powinien używać do planowania punktów sygnałowych. Prawidłowe wartości: CONCURRENT: punkty sygnałowe są zaplanowane na tę samą godzinę dla wszystkich widzów. NON_CONCURRENT: Punkty sygnałowe są zaplanowane w różnych momentach dla różnych widzów. Dzięki temu reklamy mogą być wyświetlane z większą częstotliwością, co umożliwia widzom otrzymywanie punktów sygnałowych, gdy są do tego uprawnieni.
monetizationDetails.cuepointSchedule.creatorCuepointConfig.repeatIntervalSecs	unsigned integer Ta wartość określa odstęp w sekundach między automatycznym wstawianiem reklam podczas transmisji. Jeśli na przykład wartość to 360, YouTube może wstawiać punkty wstawienia reklam w trakcie filmu co 6 minut. Uwaga: Wartość określa czas między początkiem kolejnych punktów wskazujących. Oznacza to, że przedział nie jest mierzony od końca jednego punktu sygnałowego do początku następnego. Aby zachować spójność z ustawieniami YouTube Studio, ta wartość jest wielokrotnością 6 minut i mieści się w przedziale od 6 do 30 minut. Każda liczba całkowita w żądaniu aktualizacji w tym zakresie, choć prawidłowa, zostanie zaokrąglona w dół do najbliższej wielokrotności 6 minut.