Videos

Wszystkie filmy przesłane za pomocą punktu końcowego videos.insert z niezweryfikowanych projektów API utworzonych po 28 lipca 2020 roku będą miały ograniczony dostęp do trybu prywatnego wyświetlania. Aby znieść to ograniczenie, każdy projekt API musi przejść audyt, który potwierdzi zgodność z Warunkami usługi. Więcej informacji znajdziesz w historii zmian interfejsu API.

video zasób reprezentuje film na YouTube.

Metody

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

getRating
Pobiera oceny, które autoryzowany użytkownik przyznał określonej liście filmów. Wypróbuj teraz
list
Zwraca listę filmów, które pasują do parametrów żądania do interfejsu API. Wypróbuj teraz
batchGetStats
Pobiera listę statystyk filmów, które pasują do parametrów żądania do interfejsu API. Wypróbuj teraz
wstaw
Przesyła film do YouTube i opcjonalnie ustawia metadane filmu.
aktualizować
Aktualizuje metadane filmu. Wypróbuj teraz
usuń
Usuwa film na YouTube. Wypróbuj teraz
rate [stawka]
Dodawanie oceny „Lubię” lub „Nie lubię” do filmu albo usuwanie oceny z filmu. Wypróbuj teraz
reportAbuse
Zgłoś film, który zawiera nieodpowiednie treści. Wypróbuj teraz

Prezentacja zasobów

Poniższa struktura JSON przedstawia format zasobu videos:

{
  "kind": "youtube#video",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "tags": [
      string
    ],
    "categoryId": string,
    "liveBroadcastContent": string,
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    },
    "defaultAudioLanguage": string
  },
  "contentDetails": {
    "duration": string,
    "dimension": string,
    "definition": string,
    "caption": string,
    "licensedContent": boolean,
    "regionRestriction": {
      "allowed": [
        string
      ],
      "blocked": [
        string
      ]
    },
    "contentRating": {
      "acbRating": string,
      "agcomRating": string,
      "anatelRating": string,
      "bbfcRating": string,
      "bfvcRating": string,
      "bmukkRating": string,
      "catvRating": string,
      "catvfrRating": string,
      "cbfcRating": string,
      "cccRating": string,
      "cceRating": string,
      "chfilmRating": string,
      "chvrsRating": string,
      "cicfRating": string,
      "cnaRating": string,
      "cncRating": string,
      "csaRating": string,
      "cscfRating": string,
      "czfilmRating": string,
      "djctqRating": string,
      "djctqRatingReasons": [,
        string
      ],
      "ecbmctRating": string,
      "eefilmRating": string,
      "egfilmRating": string,
      "eirinRating": string,
      "fcbmRating": string,
      "fcoRating": string,
      "fmocRating": string,
      "fpbRating": string,
      "fpbRatingReasons": [,
        string
      ],
      "fskRating": string,
      "grfilmRating": string,
      "icaaRating": string,
      "ifcoRating": string,
      "ilfilmRating": string,
      "incaaRating": string,
      "kfcbRating": string,
      "kijkwijzerRating": string,
      "kmrbRating": string,
      "lsfRating": string,
      "mccaaRating": string,
      "mccypRating": string,
      "mcstRating": string,
      "mdaRating": string,
      "medietilsynetRating": string,
      "mekuRating": string,
      "mibacRating": string,
      "mocRating": string,
      "moctwRating": string,
      "mpaaRating": string,
      "mpaatRating": string,
      "mtrcbRating": string,
      "nbcRating": string,
      "nbcplRating": string,
      "nfrcRating": string,
      "nfvcbRating": string,
      "nkclvRating": string,
      "oflcRating": string,
      "pefilmRating": string,
      "rcnofRating": string,
      "resorteviolenciaRating": string,
      "rtcRating": string,
      "rteRating": string,
      "russiaRating": string,
      "skfilmRating": string,
      "smaisRating": string,
      "smsaRating": string,
      "tvpgRating": string,
      "ytRating": string
    },
    "projection": string,
    "hasCustomThumbnail": boolean
  },
  "status": {
    "uploadStatus": string,
    "failureReason": string,
    "rejectionReason": string,
    "privacyStatus": string,
    "publishAt": datetime,
    "license": string,
    "embeddable": boolean,
    "publicStatsViewable": boolean,
    "madeForKids": boolean,
    "selfDeclaredMadeForKids": boolean,
    "containsSyntheticMedia": boolean
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "paidProductPlacementDetails": {
    "hasPaidProductPlacement": boolean
  },
  "player": {
    "embedHtml": string,
    "embedHeight": long,
    "embedWidth": long
  },
  "topicDetails": {
    "topicIds": [
      string
    ],
    "relevantTopicIds": [
      string
    ],
    "topicCategories": [
      string
    ]
  },
  "recordingDetails": {
    "recordingDate": datetime
  },
  "fileDetails": {
    "fileName": string,
    "fileSize": unsigned long,
    "fileType": string,
    "container": string,
    "videoStreams": [
      {
        "widthPixels": unsigned integer,
        "heightPixels": unsigned integer,
        "frameRateFps": double,
        "aspectRatio": double,
        "codec": string,
        "bitrateBps": unsigned long,
        "rotation": string,
        "vendor": string
      }
    ],
    "audioStreams": [
      {
        "channelCount": unsigned integer,
        "codec": string,
        "bitrateBps": unsigned long,
        "vendor": string
      }
    ],
    "durationMs": unsigned long,
    "bitrateBps": unsigned long,
    "creationTime": string
  },
  "processingDetails": {
    "processingStatus": string,
    "processingProgress": {
      "partsTotal": unsigned long,
      "partsProcessed": unsigned long,
      "timeLeftMs": unsigned long
    },
    "processingFailureReason": string,
    "fileDetailsAvailability": string,
    "processingIssuesAvailability": string,
    "tagSuggestionsAvailability": string,
    "editorSuggestionsAvailability": string,
    "thumbnailsAvailability": string
  },
  "suggestions": {
    "processingErrors": [
      string
    ],
    "processingWarnings": [
      string
    ],
    "processingHints": [
      string
    ],
    "tagSuggestions": [
      {
        "tag": string,
        "categoryRestricts": [
          string
        ]
      }
    ],
    "editorSuggestions": [
      string
    ]
  },
  "liveStreamingDetails": {
    "actualStartTime": datetime,
    "actualEndTime": datetime,
    "scheduledStartTime": datetime,
    "scheduledEndTime": datetime,
    "concurrentViewers": unsigned long,
    "activeLiveChatId": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

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ść to youtube#video.
etag etag
Etag tego zasobu.
id string
Identyfikator, którego YouTube używa do jednoznacznej identyfikacji filmu.
snippet object
Obiekt snippet zawiera podstawowe informacje o filmie, takie jak tytuł, opis i kategoria.
snippet.publishedAt datetime
Data i godzina opublikowania filmu. Pamiętaj, że może się on różnić od czasu przesłania filmu. Jeśli na przykład film zostanie przesłany jako film prywatny, a później udostępniony publicznie, ta właściwość określi czas, w którym film został udostępniony publicznie.

Istnieje kilka przypadków specjalnych:
  • Jeśli film zostanie przesłany jako film prywatny, a właściciel kanału pobierze jego metadane, wartość właściwości określa datę i godzinę przesłania filmu.
  • Jeśli film zostanie przesłany jako niepubliczny, wartość właściwości określa też datę i godzinę przesłania filmu. W tym przypadku każdy, kto zna unikalny identyfikator filmu, może pobrać jego metadane.
Wartość jest podana w formacie ISO 8601.
snippet.channelId string
Identyfikator, którego YouTube używa do jednoznacznej identyfikacji kanału, na który został przesłany film.
snippet.title string
Tytuł filmu. Wartość właściwości może mieć maksymalnie 100 znaków i zawierać wszystkie prawidłowe znaki UTF-8 z wyjątkiem <>. Musisz ustawić wartość tej właściwości, jeśli wywołujesz metodę videos.update i aktualizujesz część snippet zasobu video.
snippet.description string
Opis filmu. Wartość właściwości może mieć maksymalnie 5000 bajtów i zawierać wszystkie prawidłowe znaki UTF-8 z wyjątkiem <>.
snippet.thumbnails object
Mapa miniatur powiązanych z filmem. W przypadku każdego obiektu na mapie 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) ten 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) obraz ma szerokość 480 pikseli i wysokość 360 pikseli. W przypadku kanału obraz ten ma szerokość i wysokość 800 pikseli.
  • standard – wersja miniatury w jeszcze wyższej rozdzielczości niż obraz w rozdzielczości high. Ten obraz jest dostępny w przypadku niektórych filmów i innych zasobów, które odwołują się do filmów, np. elementów playlisty lub wyników wyszukiwania. Ten obraz ma szerokość 640 pikseli i wysokość 480 pikseli.
  • maxres – wersja miniatury w najwyższej rozdzielczości. Ten rozmiar obrazu jest dostępny w przypadku niektórych filmów i innych zasobów, które odwołują się do filmów, takich jak elementy playlisty czy wyniki wyszukiwania. Ten obraz ma szerokość 1280 pikseli i wysokość 720 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.channelTitle string
Tytuł kanału, do którego należy film.
snippet.tags[] list
Lista tagów słów kluczowych powiązanych z filmem. Tagi mogą zawierać spacje. Maksymalna długość wartości właściwości to 500 znaków. Pamiętaj o tych zasadach dotyczących sposobu obliczania limitu znaków:
  • Wartość właściwości jest listą, a przecinki między elementami listy wliczają się do limitu.
  • Jeśli tag zawiera spację, serwer API traktuje wartość tagu tak, jakby była ujęta w cudzysłów, a cudzysłów wlicza się do limitu znaków. Dlatego w przypadku limitów znaków tag Foo-Baz zawiera 7 znaków, a tag Foo Baz – 9 znaków.
snippet.categoryId string
Kategoria filmu w YouTube powiązana z filmem. Musisz ustawić wartość tej właściwości, jeśli wywołujesz metodę videos.update i aktualizujesz część snippet zasobu video.
snippet.liveBroadcastContent string

Wskazuje, czy film jest nadchodzącą lub aktywną transmisją na żywo. Jeśli film nie jest nadchodzącą lub aktywną transmisją na żywo, wartość to none.



Prawidłowe wartości tej właściwości to:
  • live
  • none
  • upcoming
snippet.defaultLanguage string
Język tekstu we właściwościach snippet.titlesnippet.description zasobu video.
snippet.localized object
Obiekt snippet.localized zawiera zlokalizowany tytuł i opis filmu lub tytuł w języku domyślnym dla metadanych filmu.
  • Zlokalizowany tekst jest zwracany we fragmencie zasobu, jeśli w żądaniu videos.list użyto parametru hl do określenia języka, w którym ma być zwracany zlokalizowany tekst i zlokalizowany tekst jest dostępny w tym języku.
  • Metadane dla języka domyślnego są zwracane, jeśli nie określono wartości parametru hl lub określono wartość, ale zlokalizowane metadane nie są dostępne dla wybranego języka.
 Właściwość zawiera wartość tylko do odczytu. Użyj obiektu localizations, aby dodawać, aktualizować lub usuwać zlokalizowane tytuły.
snippet.localized.title string
Zlokalizowany tytuł filmu.
snippet.localized.description string
Zlokalizowany opis filmu.
snippet.defaultAudioLanguage string
Właściwość default_audio_language określa język używany w domyślnej ścieżce dźwiękowej filmu.
contentDetails object
Obiekt contentDetails zawiera informacje o treści wideo, w tym długość filmu i informację o tym, czy są dostępne napisy.
contentDetails.duration string
Długość filmu. Wartość właściwości to czas trwania w formacie ISO 8601. Na przykład w przypadku filmu, który trwa co najmniej minutę, ale nie dłużej niż godzinę, czas trwania jest podawany w formacie PT#M#S, w którym litery PT oznaczają, że wartość określa okres, a litery M i S odnoszą się odpowiednio do długości w minutach i sekundach. # znaki przed literami MS to liczby całkowite określające liczbę minut (lub sekund) filmu. Na przykład wartość PT15M33S oznacza, że film trwa 15 minut i 33 sekundy.

Jeśli film trwa co najmniej godzinę, czas trwania jest podany w formacie PT#H#M#S, w którym # przed literą H określa długość filmu w godzinach, a wszystkie inne szczegóły są takie same jak opisane powyżej. Jeśli film trwa co najmniej 1 dzień, litery PT są rozdzielone, a format wartości to P#DT#H#M#S. Szczegółowe informacje znajdziesz w specyfikacji ISO 8601.
contentDetails.dimension string
Wskazuje, czy film jest dostępny w 3D czy w 2D.
contentDetails.definition string
Określa, czy film jest dostępny w wysokiej rozdzielczości (HD), czy tylko w standardowej.

Prawidłowe wartości tej właściwości to:
  • hd
  • sd
contentDetails.caption string
Wskazuje, czy napisy są dostępne w przypadku filmu.

Prawidłowe wartości tej właściwości to:
  • false
  • true
contentDetails.licensedContent boolean
Wskazuje, czy film zawiera licencjonowane treści, co oznacza, że zostały one przesłane na kanał powiązany z partnerem YouTube ds. treści, a następnie objęte roszczeniem przez tego partnera.
contentDetails.regionRestriction object
Obiekt regionRestriction zawiera informacje o krajach, w których film jest (lub nie jest) dostępny. Obiekt będzie zawierać właściwość contentDetails.regionRestriction.allowed lub właściwość contentDetails.regionRestriction.blocked.
contentDetails.regionRestriction.allowed[] list
Lista kodów regionów, które identyfikują kraje, w których film jest widoczny. Jeśli ta właściwość jest obecna, a kraj nie jest wymieniony w jej wartości, film jest blokowany w tym kraju. Jeśli ta właściwość jest obecna i zawiera pustą listę, film jest blokowany we wszystkich krajach.
contentDetails.regionRestriction.blocked[] list
Lista kodów regionów, które identyfikują kraje, w których film jest zablokowany. Jeśli ta właściwość jest obecna, a kraj nie jest wymieniony w jej wartości, film jest dostępny w tym kraju. Jeśli ta właściwość jest obecna i zawiera pustą listę, film jest widoczny we wszystkich krajach.
contentDetails.contentRating object
Określa oceny, jakie otrzymał film w ramach różnych systemów oceniania.
contentDetails.contentRating.acbRating string
Ocena filmu przyznana przez Australian Classification Board (ACB) lub Australian Communications and Media Authority (ACMA). Oceny ACMA służą do klasyfikowania programów telewizyjnych dla dzieci.

Prawidłowe wartości tej właściwości to:
  • acbC – programy, którym australijski urząd ds. komunikacji i mediów przyznał klasyfikację C. Są one przeznaczone dla dzieci (powyżej wieku przedszkolnego), które nie ukończyły 14 lat.
  • acbE – E
  • acbG – G
  • acbM – M
  • acbMa15plus – MA15+
  • acbP – programy, którym Australian Communications and Media Authority przyznała klasyfikację P. Te programy są przeznaczone dla dzieci w wieku przedszkolnym.
  • acbPg – PG
  • acbR18plus – R18+
  • acbUnrated
contentDetails.contentRating.agcomRating string
Ocena filmu przyznana przez włoski organ Autorità per le Garanzie nelle Comunicazioni (AGCOM).

Prawidłowe wartości tej właściwości to:
  • agcomT – T
  • agcomUnrated
  • agcomVm14 – VM14
  • agcomVm18 – VM18
contentDetails.contentRating.anatelRating string
Ocena filmu przyznana przez Anatel (Asociación Nacional de Televisión) w przypadku telewizji w Chile.

Prawidłowe wartości tego atrybutu to:
  • anatelA – A
  • anatelF – F
  • anatelI – I
  • anatelI10 – I-10
  • anatelI12 – I-12
  • anatelI7 – I-7
  • anatelR – R
  • anatelUnrated
contentDetails.contentRating.bbfcRating string
Ocena filmu przyznana przez British Board of Film Classification (BBFC).

Prawidłowe wartości tej właściwości to:
  • bbfc12 – 12
  • bbfc12a – 12A
  • bbfc15 – 15
  • bbfc18 – 18
  • bbfcPg – PG
  • bbfcR18 – R18
  • bbfcU – U
  • bbfcUnrated
contentDetails.contentRating.bfvcRating string
Ocena filmu przyznana przez tajlandzką Radę Cenzorów Filmów i Materiałów Wideo.

Prawidłowe wartości tej właściwości to:
  • bfvc13 – 13
  • bfvc15 – 15
  • bfvc18 – 18
  • bfvc20 – 20
  • bfvcB – B
  • bfvcE – E
  • bfvcG – G
  • bfvcUnrated
contentDetails.contentRating.bmukkRating string
Ocena filmu przyznana przez austriacką Radę ds. Klasyfikacji Mediów (Bundesministerium für Unterricht, Kunst und Kultur).

Prawidłowe wartości tej właściwości to:
  • bmukk10 – 10+
  • bmukk12 – 12+
  • bmukk14 – 14+
  • bmukk16 – 16+
  • bmukk6 – 6+
  • bmukk8 – 8+
  • bmukkAa – bez ograniczeń
  • bmukkUnrated
contentDetails.contentRating.catvRating string
System oceniania kanadyjskich programów telewizyjnych – kanadyjski system klasyfikacji programów telewizyjnych. Ocena filmu przyznana przez Kanadyjską Komisję ds. Radia i Telewizji (CRTC) w przypadku kanadyjskich programów nadawanych w języku angielskim. Więcej informacji znajdziesz na stronie Canadian Broadcast Standards Council.

Prawidłowe wartości tej właściwości to:
  • catv14plus – 14+
  • catv18plus – 18+
  • catvC – C
  • catvC8 – C8
  • catvG – G
  • catvPg – PG
  • catvUnrated
contentDetails.contentRating.catvfrRating string
Ocena filmu przyznana przez Kanadyjską Komisję ds. Radia i Telewizji (CRTC) w przypadku francuskojęzycznych transmisji w Kanadzie. Więcej informacji znajdziesz na stronie Canadian Broadcast Standards Council.

Prawidłowe wartości tej właściwości to:
  • catvfr13plus – 13+
  • catvfr16plus – 16+
  • catvfr18plus – 18+
  • catvfr8plus – 8+
  • catvfrG – G
  • catvfrUnrated
contentDetails.contentRating.cbfcRating string
Ocena filmu przyznana przez Centralną Radę Cenzury Filmowej (CBFC) w Indiach.

Prawidłowe wartości tej właściwości to:
  • cbfcA – A
  • cbfcS – S
  • cbfcU – U
  • cbfcUnrated
  • cbfcUA – U/A
  • cbfcUA7plus – U/A
  • cbfcUA13plus – U/A
  • cbfcUA16plus – U/A
contentDetails.contentRating.cccRating string
Ocena filmu przyznana przez Consejo de Calificación Cinematográfica (Chile).

Prawidłowe wartości tej właściwości to:
  • ccc14 – 14+
  • ccc18 – 18+
  • ccc18s – 18+ - contenido pornográfico
  • ccc18v – 18+ - contenido excesivamente violento
  • ccc6 – 6+ - Inconveniente para menores de 7 años
  • cccTe – Todo espectador
  • cccUnrated
contentDetails.contentRating.cceRating string
Ocena filmu przyznana przez portugalską organizację Comissão de Classificação de Espect´culos.

Prawidłowe wartości tej właściwości to:
  • cceM12 – 12
  • cceM14 – 14
  • cceM16 – 16
  • cceM18 – 18
  • cceM4 – 4
  • cceM6 – 6
  • cceUnrated
contentDetails.contentRating.chfilmRating string
Ocena filmu w Szwajcarii.

Prawidłowe wartości tego atrybutu to:
  • chfilm0 – 0
  • chfilm12 – 12
  • chfilm16 – 16
  • chfilm18 – 18
  • chfilm6 – 6
  • chfilmUnrated
contentDetails.contentRating.chvrsRating string
Ocena filmu w kanadyjskim systemie klasyfikacji filmów na nośnikach domowych (CHVRS).

Prawidłowe wartości tej właściwości to:
  • chvrs14a – 14A
  • chvrs18a – 18A
  • chvrsE – E
  • chvrsG – G
  • chvrsPg – PG
  • chvrsR – R
  • chvrsUnrated
contentDetails.contentRating.cicfRating string
Ocena filmu przyznana przez Commission de Contrôle des Films (Belgia).

Prawidłowe wartości tej właściwości to:
  • cicfE – E
  • cicfKntEna – KNT/ENA
  • cicfKtEa – KT/EA
  • cicfUnrated
contentDetails.contentRating.cnaRating string
Ocena filmu przyznana przez rumuńską organizację CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA).

Prawidłowe wartości tego atrybutu to:
  • cna12 – 12
  • cna15 – 15
  • cna18 – 18
  • cna18plus – 18+
  • cnaAp – AP
  • cnaUnrated
contentDetails.contentRating.cncRating string
System ocen we Francji – Commission de classification cinematographique

Prawidłowe wartości tej właściwości to:
  • cnc10 – 10
  • cnc12 – 12
  • cnc16 – 16
  • cnc18 – 18
  • cncE – E
  • cncT – T
  • cncUnrated
contentDetails.contentRating.csaRating string
Ocena filmu przyznana przez francuską instytucję Conseil supérieur de l'audiovisuel, która ocenia treści nadawane w telewizji.

Prawidłowe wartości tej właściwości to:
  • csa10 – 10
  • csa12 – 12
  • csa16 – 16
  • csa18 – 18
  • csaInterdiction – Interdiction
  • csaT – T
  • csaUnrated
contentDetails.contentRating.cscfRating string
Ocena filmu w Luksemburgu przyznana przez Commission de surveillance de la classification des films (CSCF).

Prawidłowe wartości tej właściwości to:
  • cscf12 – 12
  • cscf16 – 16
  • cscf18 – 18
  • cscf6 – 6
  • cscf9 – 9
  • cscfA – A
  • cscfAl – AL
  • cscfUnrated
contentDetails.contentRating.czfilmRating string
Ocena filmu w Czechach.

Prawidłowe wartości tego pola to:
  • czfilm12 – 12
  • czfilm14 – 14
  • czfilm18 – 18
  • czfilmU – U
  • czfilmUnrated
contentDetails.contentRating.djctqRating string
Ocena filmu przyznana przez Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT) w Brazylii.

Prawidłowe wartości tej właściwości to:
  • djctq10 – 10
  • djctq12 – 12
  • djctq14 – 14
  • djctq16 – 16
  • djctq18 – 18
  • djctqL – L
  • djctqUnrated
contentDetails.contentRating.djctqRatingReasons[] list
Przyczyny, dla których film otrzymał klasyfikację DJCQT (Brazylia).
contentDetails.contentRating.ecbmctRating string
System ocen w Turcji – Rada ds. Oceny i Klasyfikacji przy Ministerstwie Kultury i Turystyki

Prawidłowe wartości tej właściwości to:
  • ecbmct13a – 13A
  • ecbmct13plus – 13+
  • ecbmct15a – 15A
  • ecbmct15plus – 15+
  • ecbmct18plus – 18+
  • ecbmct7a – 7A
  • ecbmct7plus – 7+
  • ecbmctG – G
  • ecbmctUnrated
  • ecbmct6a – 6A
  • ecbmct6plus – 6+
  • ecbmct10a – 10A
  • ecbmct10plus – 10+
  • ecbmct16plus – 16+
contentDetails.contentRating.eefilmRating string
Ocena filmu w Estonii.

Prawidłowe wartości tego atrybutu to:
  • eefilmK12 – K-12
  • eefilmK14 – K-14
  • eefilmK16 – K-16
  • eefilmK6 – K-6
  • eefilmL – L
  • eefilmMs12 – MS-12
  • eefilmMs6 – MS-6
  • eefilmPere – Pere
  • eefilmUnrated
contentDetails.contentRating.egfilmRating string
Ocena filmu w Egipcie.

Prawidłowe wartości tego atrybutu to:
  • egfilm18 – 18
  • egfilmBn – BN
  • egfilmGn – GN
  • egfilmUnrated
contentDetails.contentRating.eirinRating string
Ocena filmu w systemie EIRIN (映倫). EIRIN to japoński system ocen.

Prawidłowe wartości tego atrybutu to:
  • eirinG – G
  • eirinPg12 – PG-12
  • eirinR15plus – R15+
  • eirinR18plus – R18+
  • eirinUnrated
contentDetails.contentRating.fcbmRating string
Ocena filmu przyznana przez malezyjską Radę Cenzury Filmowej.

Prawidłowe wartości tej właściwości to:
  • fcbm13 – 13
  • fcbm16 – 16
  • fcbm18 – 18
  • fcbm18pa – 18PA
  • fcbm18pl – 18PL
  • fcbm18sg – 18SG
  • fcbm18sx – 18SX
  • fcbmP12 – P12
  • fcbmP13 – P13
  • fcbmPg13 – PG13
  • fcbmU – U
  • fcbmUnrated
contentDetails.contentRating.fcoRating string
Ocena filmu przyznana przez Office for Film, Newspaper and Article Administration w Hongkongu.

Prawidłowe wartości tej właściwości to:
  • fcoI – I
  • fcoIi – II
  • fcoIia – IIA
  • fcoIib – IIB
  • fcoIii – III
  • fcoUnrated
contentDetails.contentRating.fmocRating string
Ten atrybut został wycofany 2 listopada 2015 r. Zamiast niego używaj atrybutu contentDetails.contentRating.cncRating.

Ocena filmu przyznana przez Centre national du cinéma et de l'image animé (francuskie Ministerstwo Kultury).

Prawidłowe wartości tego atrybutu to:
  • fmoc10 – 10
  • fmoc12 – 12
  • fmoc16 – 16
  • fmoc18 – 18
  • fmocE – E
  • fmocU – U
  • fmocUnrated
contentDetails.contentRating.fpbRating string
Ocena filmu przyznana przez Film and Publication Board w Republice Południowej Afryki.

Prawidłowe wartości tej właściwości to:
  • fpb10 – 10
  • fpb1012Pg – 10-12PG
  • fpb13 – 13
  • fpb16 – 16
  • fpb18 – 18
  • fpb79Pg – 7-9PG
  • fpbA – A
  • fpbPg – PG
  • fpbUnrated
  • fpbX18 – X18
  • fpbXx – XX
contentDetails.contentRating.fpbRatingReasons[] list
Przyczyny, dla których film otrzymał ocenę FPB (RPA).
contentDetails.contentRating.fskRating string
Klasyfikacja filmu według Freiwillige Selbstkontrolle der Filmwirtschaft (FSK – Niemcy).

Prawidłowe wartości tej właściwości to:
  • fsk0 – FSK 0
  • fsk12 – FSK 12
  • fsk16 – FSK 16
  • fsk18 – FSK 18
  • fsk6 – FSK 6
  • fskUnrated
contentDetails.contentRating.grfilmRating string
Ocena filmu w Grecji.

Prawidłowe wartości tego atrybutu to:
  • grfilmE – E
  • grfilmK – K
  • grfilmK12 – K-12
  • grfilmK13 – K-13
  • grfilmK15 – K-15
  • grfilmK17 – K-17
  • grfilmK18 – K-18
  • grfilmUnrated
contentDetails.contentRating.icaaRating string
Ocena filmu przyznana przez Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA – Hiszpania).

Prawidłowe wartości tej właściwości to:
  • icaa12 – 12
  • icaa13 – 13
  • icaa16 – 16
  • icaa18 – 18
  • icaa7 – 7
  • icaaApta – APTA
  • icaaUnrated
  • icaaX – X
contentDetails.contentRating.ifcoRating string
Ocena filmu przyznana przez Irish Film Classification Office (IFCO – Irlandia). Więcej informacji znajdziesz na stronie IFCO.

Prawidłowe wartości tej właściwości to:
  • ifco12 – 12
  • ifco12a – 12A
  • ifco15 – 15
  • ifco15a – 15A
  • ifco16 – 16
  • ifco18 – 18
  • ifcoG – G
  • ifcoPg – PG
  • ifcoUnrated
contentDetails.contentRating.ilfilmRating string
Ocena filmu w Izraelu.

Prawidłowe wartości tej właściwości to:
  • ilfilm12 – 12
  • ilfilm16 – 16
  • ilfilm18 – 18
  • ilfilmAa – AA
  • ilfilmUnrated
contentDetails.contentRating.incaaRating string
Ocena filmu przyznana przez INCAA (Instituto Nacional de Cine y Artes Audiovisuales – Argentyna).

Prawidłowe wartości tej właściwości to:
  • incaaAtp – ATP (Apta para todo publico)
  • incaaC – X (Solo apta para mayores de 18 años, de exhibición condicionada)
  • incaaSam13 – 13 (Solo apta para mayores de 13 años)
  • incaaSam16 – 16 (Solo apta para mayores de 16 años)
  • incaaSam18 – 18 (Solo apta para mayores de 18 años)
  • incaaUnrated
contentDetails.contentRating.kfcbRating string
Ocena filmu przyznana przez Kenya Film Classification Board.

Prawidłowe wartości tego atrybutu to:
  • kfcb16plus – 16
  • kfcbG – GE
  • kfcbPg – PG
  • kfcbR – 18
  • kfcbUnrated
contentDetails.contentRating.kijkwijzerRating string
voor de Classificatie van Audiovisuele Media (Holandia).

Prawidłowe wartości tej właściwości to:
  • kijkwijzer12 – 12
  • kijkwijzer14 – 14
  • kijkwijzer16 – 16
  • kijkwijzer18 – 18
  • kijkwijzer6 – 6
  • kijkwijzer9 – 9
  • kijkwijzerAl – AL
  • kijkwijzerUnrated
contentDetails.contentRating.kmrbRating string
Ocena filmu przyznana przez Korea Media Rating Board (영상물등급위원회). KMRB ocenia filmy w Korei Południowej.

Prawidłowe wartości tego atrybutu to:
  • kmrb12plus – 12세 이상 관람가
  • kmrb15plus – 15세 이상 관람가
  • kmrbAll – 전체관람가
  • kmrbR – 청소년 관람불가
  • kmrbTeenr
  • kmrbUnrated
contentDetails.contentRating.lsfRating string
Ocena filmu przyznana przez indonezyjską organizację Lembaga Sensor Film.

Prawidłowe wartości tego atrybutu to:
  • lsf13 – 13
  • lsf17 – 17
  • lsf21 – 21
  • lsfA – A
  • lsfBo – BO
  • lsfD – D
  • lsfR – R
  • lsfSu – SU
  • lsfUnrated
contentDetails.contentRating.mccaaRating string
Ocena filmu przyznana przez maltańską Radę ds. Klasyfikacji Wiekowej Filmów.

Prawidłowe wartości tej właściwości to:
  • mccaa12 – 12
  • mccaa12a – 12A
  • mccaa14 – 14 – ta ocena została usunięta z nowej struktury klasyfikacji wprowadzonej w 2013 roku.
  • mccaa15 – 15
  • mccaa16 – 16 – ta ocena została usunięta z nowej struktury klasyfikacji wprowadzonej w 2013 roku.
  • mccaa18 – 18
  • mccaaPg – PG
  • mccaaU – U
  • mccaaUnrated
contentDetails.contentRating.mccypRating string
Ocena filmu przyznana przez Radę ds. Mediów dla Dzieci i Młodzieży (Media Council for Children and Young People) Duńskiego Instytutu Filmowego (Det Danske Filminstitut).

Prawidłowe wartości tej właściwości to:
  • mccyp11 – 11
  • mccyp15 – 15
  • mccyp7 – 7
  • mccypA – A
  • mccypUnrated
contentDetails.contentRating.mcstRating string
System oceniania filmów w Wietnamie – MCST

Prawidłowe wartości tej właściwości:
  • mcst0 – 0
  • mcst16plus – 16+
  • mcstC13 – C13
  • mcstC16 – C16
  • mcstC18 – C18
  • mcstP – P
  • mcstUnrated
  • mcstT13 – T13
  • mcstT16 – T16
  • mcstT18 – T18
  • mcstK – K
contentDetails.contentRating.mdaRating string
Ocena filmu przyznana przez Media Development Authority (MDA) w Singapurze, a konkretnie przez Board of Film Censors (BFC).

Prawidłowe wartości tej właściwości to:
  • mdaG – G
  • mdaM18 – M18
  • mdaNc16 – NC16
  • mdaPg – PG
  • mdaPg13 – PG13
  • mdaR21 – R21
  • mdaUnrated
contentDetails.contentRating.medietilsynetRating string
Ocena filmu przyznana przez norweski organ ds. mediów Medietilsynet.

Prawidłowe wartości tego atrybutu to:
  • medietilsynet11 – 11
  • medietilsynet12 – 12
  • medietilsynet15 – 15
  • medietilsynet18 – 18
  • medietilsynet6 – 6
  • medietilsynet7 – 7
  • medietilsynet9 – 9
  • medietilsynetA – A
  • medietilsynetUnrated
contentDetails.contentRating.mekuRating string
Ocena filmu przyznana przez fiński Kansallinen Audiovisuaalinen Instituutti (Narodowy Instytut Audiowizualny).

Prawidłowe wartości tej właściwości to:
  • meku12 – 12
  • meku16 – 16
  • meku18 – 18
  • meku7 – 7
  • mekuS – S
  • mekuUnrated
contentDetails.contentRating.mibacRating string
Ocena filmu przyznana przez Ministero dei Beni e delle Attività Culturali e del Turismo (Włochy).

Prawidłowe wartości tej właściwości to:
  • mibacT
  • mibacUnrated
  • mibacVap
  • mibacVm6
  • mibacVm12
  • mibacVm14
  • mibacVm18
contentDetails.contentRating.mocRating string
Ocena filmu przyznana przez Ministerio de Cultura (Kolumbia).

Prawidłowe wartości tej właściwości to:
  • moc12 – 12
  • moc15 – 15
  • moc18 – 18
  • moc7 – 7
  • mocBanned – zablokowany,
  • mocE – E
  • mocT – T
  • mocUnrated
  • mocX – X
contentDetails.contentRating.moctwRating string
Ocena filmu przyznana przez Ministerstwo Kultury Tajwanu (文化部).

Prawidłowe wartości tej właściwości to:
  • moctwG – G
  • moctwP – P
  • moctwPg – PG
  • moctwR – R
  • moctwR12 – R-12
  • moctwR15 – R-15
  • moctwUnrated
contentDetails.contentRating.mpaaRating string
Ocena filmu przyznana przez Motion Picture Association of America (MPAA).

Prawidłowe wartości tego atrybutu to:
  • mpaaG – G
  • mpaaNc17 – NC-17
  • mpaaPg – PG
  • mpaaPg13 – PG-13
  • mpaaR – R
  • mpaaUnrated
contentDetails.contentRating.mpaatRating string
Ocena zwiastunów i zapowiedzi filmów przyznana przez Motion Picture Association of America.

Prawidłowe wartości tej właściwości to:
  • mpaatGb – GB (Green Band - Approved for all audiences)
  • mpaatRb – RB (Red Band – zalecane dla osób powyżej 17 roku życia)
contentDetails.contentRating.mtrcbRating string
Ocena filmu z Filipińskiej Rady ds. Oceny i Klasyfikacji Filmów i Programów Telewizyjnych.

Prawidłowe wartości tej właściwości to:
  • mtrcbG – G
  • mtrcbPg – PG
  • mtrcbR13 – R-13
  • mtrcbR16 – R-16
  • mtrcbR18 – R-18
  • mtrcbUnrated
  • mtrcbX – X
contentDetails.contentRating.nbcRating string
Ocena filmu przyznana przez malediwskie Krajowe Biuro Klasyfikacji.

Prawidłowe wartości tego atrybutu to:
  • nbc12plus – 12+
  • nbc15plus – 15+
  • nbc18plus – 18+
  • nbc18plusr – 18+R
  • nbcG – G
  • nbcPg – PG
  • nbcPu – PU
  • nbcUnrated
contentDetails.contentRating.nfrcRating string
Ocena filmu przyznana przez Bułgarskie Narodowe Centrum Filmowe.

Prawidłowe wartości tej właściwości to:
  • nfrcA – A
  • nfrcB – B
  • nfrcC – C
  • nfrcD – D
  • nfrcUnrated
  • nfrcX – X
contentDetails.contentRating.nfvcbRating string
Ocena filmu przyznana przez nigeryjską National Film and Video Censors Board.

Prawidłowe wartości tej właściwości to:
  • nfvcb12 – 12
  • nfvcb12a – 12A
  • nfvcb15 – 15
  • nfvcb18 – 18
  • nfvcbG – G
  • nfvcbPg – PG
  • nfvcbRe – RE
  • nfvcbUnrated
contentDetails.contentRating.nkclvRating string
Ocena filmu przyznana przez Nacionãlais Kino centrs (Narodowe Centrum Filmowe Łotwy).

Prawidłowe wartości tej właściwości to:
  • nkclv12plus – 12+
  • nkclv18plus – 18+
  • nkclv7plus – 7+
  • nkclvU – U
  • nkclvUnrated
contentDetails.contentRating.oflcRating string
Ocena filmu przyznana przez nowozelandzki urząd ds. klasyfikacji filmów i literatury (OFLC).

Prawidłowe wartości tej właściwości:
  • oflcG – G
  • oflcM – M
  • oflcPg – PG
  • oflcR13 – R13
  • oflcR15 – R15
  • oflcR16 – R16
  • oflcR18 – R18
  • oflcRp13 – RP13
  • oflcRp16 – RP16
  • oflcUnrated
contentDetails.contentRating.pefilmRating string
Ocena filmu w Peru.

Prawidłowe wartości tego atrybutu to:
  • pefilm14 – 14
  • pefilm18 – 18
  • pefilmPg – PG
  • pefilmPt – PT
  • pefilmUnrated
contentDetails.contentRating.resorteviolenciaRating string
Ocena filmu w Wenezueli.

Prawidłowe wartości tego pola to:
  • resorteviolenciaA – A
  • resorteviolenciaB – B
  • resorteviolenciaC – C
  • resorteviolenciaD – D
  • resorteviolenciaE – E
  • resorteviolenciaUnrated
contentDetails.contentRating.rtcRating string
Ocena filmu przyznana przez Generalną Dyrekcję ds. Radia, Telewizji i Kinematografii (Meksyk).

Prawidłowe wartości tej właściwości to:
  • rtcA – A
  • rtcAa – AA
  • rtcB – B
  • rtcB15 – B15
  • rtcC – C
  • rtcD – D
  • rtcUnrated
contentDetails.contentRating.rteRating string
Ocena filmu przyznana przez irlandzką stację Raidió Teilifís Éireann.

Prawidłowe wartości tego atrybutu to:
  • rteCh – CH
  • rteGa – GA
  • rteMa – MA
  • rtePs – PS
  • rteUnrated
contentDetails.contentRating.russiaRating string
Ocena filmu w rejestrze filmów Narodowego Rejestru Filmów Federacji Rosyjskiej (MKRF – Rosja).

Prawidłowe wartości tego atrybutu to:
  • russia0 – 0+
  • russia12 – 12+
  • russia16 – 16+
  • russia18 – 18+
  • russia6 – 6+
  • russiaUnrated
contentDetails.contentRating.skfilmRating string
Ocena filmu w Słowacji.

Prawidłowe wartości tego atrybutu to:
  • skfilmG – G
  • skfilmP2 – P2
  • skfilmP5 – P5
  • skfilmP8 – P8
  • skfilmUnrated
contentDetails.contentRating.smaisRating string
Ocena filmu w Islandii.

Prawidłowe wartości tego atrybutu to:
  • smais12 – 12
  • smais14 – 14
  • smais16 – 16
  • smais18 – 18
  • smais7 – 7
  • smaisL – L
  • smaisUnrated
contentDetails.contentRating.smsaRating string
Ocena filmu przyznana przez Statens medieråd (szwedzką Radę ds. Mediów).

Prawidłowe wartości tej właściwości to:
  • smsa11 – 11
  • smsa15 – 15
  • smsa7 – 7
  • smsaA – wszystkie grupy wiekowe
  • smsaUnrated
contentDetails.contentRating.tvpgRating string
Ocena filmu zgodnie z wytycznymi TV Parental Guidelines (TVPG).

Prawidłowe wartości tego atrybutu to:
  • tvpgG – TV-G
  • tvpgMa – TV-MA
  • tvpgPg – TV-PG
  • tvpgUnrated
  • tvpgY – TV-Y
  • tvpgY7 – TV-Y7
  • tvpgY7Fv – TV-Y7-FV
  • pg14 – TV-14
contentDetails.contentRating.ytRating string
Ocena, której YouTube używa do identyfikowania treści z ograniczeniem wiekowym.

Prawidłowe wartości tej właściwości to:
  • ytAgeRestricted
contentDetails.projection string
Określa format projekcji filmu.

Prawidłowe wartości tej właściwości to:
  • 360
  • rectangular
contentDetails.hasCustomThumbnail boolean
Określa, czy osoba, która przesłała film, dodała do niego niestandardową miniaturę. Ta właściwość jest widoczna tylko dla osoby, która przesłała film.
status object
Obiekt status zawiera informacje o stanie przesyłania, przetwarzania i prywatności filmu.
status.uploadStatus string
Stan przesłanego filmu.

Prawidłowe wartości tej właściwości to:
  • deleted
  • failed
  • processed
  • rejected
  • uploaded
status.failureReason string
Ta wartość wyjaśnia, dlaczego nie udało się przesłać filmu. Ta właściwość występuje tylko wtedy, gdy właściwość uploadStatus wskazuje, że przesyłanie nie powiodło się.

Prawidłowe wartości tej właściwości to:
  • codec
  • conversion
  • emptyFile
  • invalidFile
  • tooSmall
  • uploadAborted
status.rejectionReason string
Ta wartość wyjaśnia, dlaczego YouTube odrzucił przesłany film. Ta właściwość występuje tylko wtedy, gdy właściwość uploadStatus wskazuje, że przesłanie zostało odrzucone.

Prawidłowe wartości tej właściwości to:
  • claim
  • copyright
  • duplicate
  • inappropriate
  • legal
  • length
  • termsOfUse
  • trademark
  • uploaderAccountClosed
  • uploaderAccountSuspended
status.privacyStatus string
Stan prywatności filmu.

Prawidłowe wartości tej właściwości to:
  • private
  • public
  • unlisted
status.publishAt datetime
Data i godzina, o której film ma zostać opublikowany. Można ją ustawić tylko wtedy, gdy stan prywatności filmu to „prywatny”. Wartość jest podana w formacie ISO 8601. Zwróć uwagę na te 2 dodatkowe kwestie dotyczące działania tej właściwości:
  • Jeśli ustawisz wartość tej właściwości podczas wywoływania metody videos.update, musisz też ustawić wartość właściwości status.privacyStatus na private, nawet jeśli film jest już prywatny.
  • Tę właściwość można ustawić tylko wtedy, gdy stan prywatności filmu to private i film nigdy nie został opublikowany.
  • Jeśli w żądaniu zaplanujesz publikację filmu na jakiś czas w przeszłości, zostanie on opublikowany od razu. Dlatego ustawienie właściwości status.publishAt na datę i godzinę w przeszłości ma taki sam efekt jak zmiana privacyStatus filmu z private na public.
status.license string
Licencja filmu.

Prawidłowe wartości tego pola to:
  • creativeCommon
  • youtube
status.embeddable boolean
Ta wartość wskazuje, czy film można umieścić w innej witrynie.
status.publicStatsViewable boolean
Ta wartość określa, czy rozszerzone statystyki filmu na stronie odtwarzania filmu są widoczne publicznie. Domyślnie te statystyki są widoczne, a statystyki takie jak liczba wyświetleń i oceny filmu będą nadal widoczne publicznie, nawet jeśli wartość tej właściwości jest ustawiona na false.
status.madeForKids boolean
Ta wartość wskazuje, czy film jest skierowany do dzieci, i zawiera aktualny stan „przeznaczone dla dzieci”. Stan może być określany na podstawie wartości właściwości selfDeclaredMadeForKids. Więcej informacji o ustawianiu odbiorców kanału, filmów lub transmisji znajdziesz w Centrum pomocy YouTube.
status.selfDeclaredMadeForKids boolean
W żądaniu videos.insert lub videos.update ta właściwość umożliwia właścicielowi kanału oznaczenie filmu jako skierowanego do dzieci. W przypadku żądania videos.list wartość właściwości jest zwracana tylko wtedy, gdy właściciel kanału autoryzował żądanie do interfejsu API.
status.containsSyntheticMedia boolean
W przypadku żądania videos.insert lubvideos.update ta właściwość umożliwia właścicielowi kanału poinformowanie, że film zawiera realistyczne treści zmodyfikowane lub wygenerowane syntetycznie (A/S). Dowiedz się więcej o zasadach YouTube dotyczących treści związanych z alkoholem, tytoniem i innymi substancjami.

Przykłady treści związanych z alkoholem, tytoniem i innymi substancjami obejmują filmy, które:
  • przedstawiają prawdziwą osobę, która mówi lub robi coś, czego wcale nie powiedziała ani nie zrobiła;
  • zmieniać materiał przedstawiający prawdziwe wydarzenie lub miejsce;
  • treści przedstawiają realistycznie wyglądającą scenę, która faktycznie nie miała miejsca.
statistics object
Obiekt statistics zawiera statystyki dotyczące filmu.
statistics.viewCount unsigned long

Liczba wyświetleń filmu.

Od 31 marca 2025 r. w przypadku filmów Short pole viewCount będzie zwracać liczbę rozpoczęć lub ponowień odtwarzania filmu Short, bez minimalnego czasu oglądania.

statistics.likeCount unsigned long
Liczba użytkowników, którzy polubili film.
statistics.dislikeCount unsigned long
Uwaga: od 13 grudnia 2021 r. usługa statistics.dislikeCount jest prywatna. Oznacza to, że usługa jest uwzględniana w odpowiedzi interfejsu API tylko wtedy, gdy żądanie do interfejsu API zostało uwierzytelnione przez właściciela filmu. Więcej informacji znajdziesz w historii zmian.

Liczba użytkowników, którzy wyrazili swoją dezaprobatę dla filmu.
statistics.favoriteCount unsigned long
Uwaga: ta właściwość została wycofana. Wycofanie nastąpiło 28 sierpnia 2015 r. Wartość właściwości jest teraz zawsze ustawiona na 0.
statistics.commentCount unsigned long
Liczba komentarzy do filmu.
paidProductPlacementDetails object
Obiekt paidProductPlacementDetails zawiera informacje o płatnym lokowaniu produktu w filmie.
paidProductPlacementDetails.hasPaidProductPlacement boolean
Ustaw wartość true, jeśli w treściach występuje płatne lokowanie produktu. Domyślna wartość to false.
player object
Obiekt player zawiera informacje, które umożliwiają odtworzenie filmu w odtwarzaczu umieszczonym na stronie.
player.embedHtml string
Tag <iframe>, który osadza odtwarzacz odtwarzający film.
  • Jeśli żądanie do interfejsu API dotyczące pobrania zasobu określa wartość parametrów maxHeight lub maxWidth, rozmiar osadzonego odtwarzacza jest skalowany tak, aby spełniać wymagania maxHeight lub maxWidth.
  • Jeśli współczynnik proporcji filmu jest nieznany, odtwarzacz osadzony domyślnie przyjmuje format 4:3.
player.embedHeight long
Wysokość odtwarzacza umieszczonego na stronie zwrócona we właściwości player.embedHtml. Ta właściwość jest zwracana tylko wtedy, gdy w żądaniu określono wartość parametrów maxHeight lub maxWidth i znany jest współczynnik proporcji filmu.
player.embedWidth long
Szerokość odtwarzacza umieszczonego na stronie zwrócona we właściwości player.embedHtml. Ta właściwość jest zwracana tylko wtedy, gdy w żądaniu określono wartość parametrów maxHeight lub maxWidth i znany jest współczynnik proporcji filmu.
topicDetails object
Obiekt topicDetails zawiera informacje o tematach powiązanych z filmem.

Ważne: więcej informacji o nadchodzących zmianach związanych z identyfikatorami tematów znajdziesz w definicjach właściwości topicDetails.relevantTopicIds[] i topicDetails.topicIds[] oraz w historii zmian.
topicDetails.topicIds[] list
Ważne: to pole zostało wycofane 10 listopada 2016 r. Interfejs API nie zwraca już wartości tej właściwości, a wszystkie tematy powiązane z filmem są teraz zwracane przez wartość właściwości topicDetails.relevantTopicIds[].
topicDetails.relevantTopicIds[] list
Lista identyfikatorów tematów związanych z filmem.

Ta właściwość została wycofana 10 listopada 2016 r. Będzie on obsługiwany do 10 listopada 2017 r.

Ważne: ze względu na wycofanie Freebase i interfejsu Freebase API identyfikatory tematów zaczęły działać inaczej od 27 lutego 2017 r. W tym czasie YouTube zaczął zwracać niewielki zestaw wyselekcjonowanych identyfikatorów tematów.

topicDetails.topicCategories[] list
Lista adresów URL Wikipedii, które zawierają ogólny opis treści filmu.
recordingDetails object
Obiekt recordingDetails zawiera informacje o lokalizacji, dacie i adresie, pod którym nagrano film.
recordingDetails.locationDescription string
Ta właściwość została wycofana 1 czerwca 2017 r. Więcej informacji znajdziesz w ogłoszeniu o wycofaniu funkcji.

Tekstowy opis miejsca, w którym nagrano film.
recordingDetails.location object
Informacje o geolokalizacji powiązane z filmem. Pamiętaj, że wartości właściwości podrzędnej określają lokalizację, którą właściciel filmu chce powiązać z filmem. Wartość można edytować, wyszukiwać w publicznych filmach i może być wyświetlana użytkownikom w przypadku publicznych filmów.
recordingDetails.location.latitude double
Ta właściwość została wycofana 1 czerwca 2017 r. Więcej informacji znajdziesz w ogłoszeniu o wycofaniu funkcji.

Szerokość geograficzna w stopniach.
recordingDetails.location.longitude double
Ta właściwość została wycofana 1 czerwca 2017 r. Więcej informacji znajdziesz w ogłoszeniu o wycofaniu funkcji.

Długość geograficzna w stopniach.
recordingDetails.location.altitude double
Ta właściwość została wycofana 9 lipca 2018 r. Więcej informacji znajdziesz w ogłoszeniu o wycofaniu.

Wysokość nad elipsoidą odniesienia w metrach.
recordingDetails.recordingDate datetime
Data i godzina nagrania filmu. Wartość jest podana w formacie ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ).
fileDetails object
Obiekt fileDetails zawiera informacje o pliku wideo przesłanym do YouTube, w tym rozdzielczość pliku, czas trwania, kodeki audio i wideo, szybkość transmisji strumieniowej i inne. Te dane może pobrać tylko właściciel filmu.

Obiekt fileDetails zostanie zwrócony tylko wtedy, gdy właściwość processingDetails.fileAvailability ma wartość available.
fileDetails.fileName string
Nazwa przesłanego pliku. To pole jest obecne niezależnie od tego, czy przesłano plik wideo, czy inny typ pliku.
fileDetails.fileSize unsigned long
Rozmiar przesłanego pliku w bajtach. To pole jest obecne niezależnie od tego, czy przesłano plik wideo, czy inny typ pliku.
fileDetails.fileType string
Typ przesłanego pliku wykryty przez silnik przetwarzania filmów w YouTube. Obecnie YouTube przetwarza tylko pliki wideo, ale to pole jest obecne niezależnie od tego, czy przesłano plik wideo, czy inny typ pliku.

Prawidłowe wartości tej właściwości to:
  • archive – plik jest archiwum, np .plikiem ZIP.
  • audio – plik jest znanym typem pliku audio, np .plikiem MP3.
  • document – plik jest dokumentem lub plikiem tekstowym, np. dokumentem MS Word.
  • image – plik jest plikiem obrazu, np .obrazem w formacie JPEG.
  • other – plik ma inny typ niż wideo.
  • project – plik jest plikiem projektu wideo, np. projektem programu Microsoft Windows Movie Maker, który nie zawiera rzeczywistych danych wideo.
  • video – plik jest znanym typem pliku wideo, np .plikiem MP4.
fileDetails.container string
Format kontenera przesłanego pliku wideo.
fileDetails.videoStreams[] list
Lista strumieni wideo zawartych w przesłanym pliku wideo. Każdy element na liście zawiera szczegółowe metadane dotyczące strumienia wideo.
fileDetails.videoStreams[].widthPixels unsigned integer
Szerokość zakodowanych treści wideo w pikselach. Współczynnik proporcji kodowania filmu możesz obliczyć jako width_pixels / height_pixels.
fileDetails.videoStreams[].heightPixels unsigned integer
Wysokość zakodowanej treści wideo w pikselach.
fileDetails.videoStreams[].frameRateFps double
Liczba klatek na sekundę w strumieniu wideo.
fileDetails.videoStreams[].aspectRatio double
Format obrazu treści wideo, który określa, w jakim formacie obrazu film powinien być wyświetlany.
fileDetails.videoStreams[].codec string
Kodek wideo używany przez strumień.
fileDetails.videoStreams[].bitrateBps unsigned long
Szybkość transmisji strumienia wideo w bitach na sekundę.
fileDetails.videoStreams[].rotation string
Wartość, o jaką YouTube musi obrócić oryginalną treść źródłową, aby prawidłowo wyświetlić film.

Prawidłowe wartości tej właściwości to:
  • clockwise – film należy obrócić o 90 stopni w prawo.
  • counterClockwise – film musi być obrócony o 90 stopni w lewo.
  • none – film nie wymaga obrócenia.
  • other – film musi być obrócony w inny, nietrywialny sposób.
  • upsideDown – film należy obrócić do góry nogami.
fileDetails.videoStreams[].vendor string
Wartość, która jednoznacznie identyfikuje dostawcę filmów. Zwykle jest to 4-literowy kod dostawcy.
fileDetails.audioStreams[] list
Lista strumieni audio zawartych w przesłanym pliku wideo. Każdy element listy zawiera szczegółowe metadane dotyczące strumienia audio.
fileDetails.audioStreams[].channelCount unsigned integer
Liczba kanałów audio, które zawiera strumień.
fileDetails.audioStreams[].codec string
Kodek audio używany przez strumień.
fileDetails.audioStreams[].bitrateBps unsigned long
Szybkość transmisji strumienia audio w bitach na sekundę.
fileDetails.audioStreams[].vendor string
Wartość, która jednoznacznie identyfikuje dostawcę filmów. Zwykle jest to 4-literowy kod dostawcy.
fileDetails.durationMs unsigned long
Długość przesłanego filmu w milisekundach.
fileDetails.bitrateBps unsigned long
Łączna szybkość transmisji bitów (obrazu i dźwięku) przesłanego pliku wideo w bitach na sekundę.
fileDetails.creationTime string
Data i godzina utworzenia przesłanego pliku wideo. Wartość jest podana w formacie ISO 8601. Obecnie obsługiwane są te formaty ISO 8601:
  • Tylko data: YYYY-MM-DD
  • Czas lokalny: YYYY-MM-DDTHH:MM:SS
  • Czas ze strefą czasową: YYYY-MM-DDTHH:MM:SS+HH:MM
processingDetails object
Obiekt processingDetails zawiera informacje o postępach YouTube w przetwarzaniu przesłanego pliku wideo. Właściwości obiektu określają bieżący stan przetwarzania i szacowany czas pozostały do zakończenia przetwarzania filmu przez YouTube. Ta część wskazuje również, czy dla filmu są dostępne różne typy danych lub treści, takie jak szczegóły pliku lub miniatury.

Obiekt processingProgress jest przeznaczony do odpytywania, aby osoba, która przesłała film, mogła śledzić postępy YouTube w przetwarzaniu przesłanego pliku wideo. Te dane może pobrać tylko właściciel filmu.
processingDetails.processingStatus string
Stan przetwarzania filmu. Ta wartość wskazuje, czy YouTube udało się przetworzyć film, czy też film jest nadal przetwarzany.

Prawidłowe wartości tej właściwości to:
  • failed – nie udało się przetworzyć filmu. Zobacz ProcessingFailureReason.
  • processing – film jest obecnie przetwarzany. Zobacz ProcessingProgress.
  • succeeded – film został przetworzony.
  • terminated – informacje o przetwarzaniu nie są już dostępne.
processingDetails.processingProgress object
Obiekt processingProgress zawiera informacje o postępach YouTube w przetwarzaniu filmu. Wartości są istotne tylko wtedy, gdy stan przetwarzania filmu to processing.
processingDetails.processingProgress.partsTotal unsigned long
Szacunkowa łączna liczba części, które muszą zostać przetworzone w przypadku filmu. Podczas przetwarzania filmu przez YouTube liczba ta może być aktualizowana w celu uzyskania dokładniejszych szacunków.
processingDetails.processingProgress.partsProcessed unsigned long
Liczba części filmu, które zostały już przetworzone przez YouTube. Możesz oszacować odsetek filmu, który został już przetworzony przez YouTube, obliczając:
100 * parts_processed / parts_total

Pamiętaj, że szacunkowa liczba części może wzrosnąć bez odpowiadającego jej wzrostu liczby części, które zostały już przetworzone. Dlatego podczas przetwarzania filmu przez YouTube obliczony postęp może okresowo maleć.
processingDetails.processingProgress.timeLeftMs unsigned long
Szacowany czas w milisekundach, jaki YouTube potrzebuje na zakończenie przetwarzania filmu.
processingDetails.processingFailureReason string
Przyczyna, dla której YouTube nie udało się przetworzyć filmu. Ta właściwość będzie miała wartość tylko wtedy, gdy wartość właściwości processingStatus to failed.

Prawidłowe wartości tej właściwości to:
  • other – wystąpił błąd w innym komponencie przetwarzania.
  • streamingFailed – nie udało się wysłać filmu do streamerów.
  • transcodeFailed – nie udało się zmienić formatu treści.
  • uploadFailed – nie udało się dostarczyć pliku.
processingDetails.fileDetailsAvailability string
Ta wartość wskazuje, czy szczegóły pliku są dostępne dla przesłanego filmu. Szczegóły pliku filmu możesz pobrać, wysyłając w żądaniu videos.list() część fileDetails.
processingDetails.processingIssuesAvailability string
Ta wartość wskazuje, czy silnik przetwarzania filmów wygenerował sugestie, które mogą poprawić zdolność YouTube do przetwarzania filmu, ostrzeżenia wyjaśniające problemy z przetwarzaniem filmu lub błędy, które powodują problemy z przetwarzaniem filmu. Możesz pobrać te sugestie, przesyłając w żądaniu videos.list() część suggestions.
processingDetails.tagSuggestionsAvailability string
Ta wartość wskazuje, czy dla filmu są dostępne sugestie słów kluczowych (tagów). Tagi można dodawać do metadanych filmu, aby ułatwić innym użytkownikom jego znalezienie. Możesz pobrać te sugestie, przesyłając w żądaniu videos.list() część suggestions.
processingDetails.editorSuggestionsAvailability string
Ta wartość wskazuje, czy dla filmu dostępne są sugestie dotyczące edycji, które mogą poprawić jakość filmu lub wrażenia z odtwarzania. Możesz je pobrać, wysyłając w żądaniu videos.list() prośbę o suggestions.
processingDetails.thumbnailsAvailability string
Ta wartość wskazuje, czy dla filmu wygenerowano miniatury.
suggestions object
Obiekt suggestions zawiera sugestie, które wskazują możliwości poprawy jakości filmu lub metadanych przesłanego filmu. Te dane może pobrać tylko właściciel filmu.

Obiekt suggestions zostanie zwrócony tylko wtedy, gdy właściwość processingDetails.tagSuggestionsAvailability lub processingDetails.editorSuggestionsAvailability ma wartość available.
suggestions.processingErrors[] list
Lista błędów, które uniemożliwią YouTube prawidłowe przetworzenie przesłanego filmu. Te błędy wskazują, że niezależnie od bieżącego stanu przetwarzania filmu, ostatecznie stan ten prawie na pewno będzie miał wartość failed.

Prawidłowe wartości tej właściwości to:
  • archiveFile – plik archiwum (np. archiwum ZIP);
  • audioFile – plik zawiera tylko dźwięk (np. plik MP3);
  • docFile – dokument lub plik tekstowy (np. dokument MS Word).
  • imageFile – plik obrazu (np. obraz JPEG);
  • notAVideoFile – inny plik, który nie jest filmem.
  • projectFile – plik projektu filmu (np. projekt programu Microsoft Windows Movie Maker);
suggestions.processingWarnings[] list
Lista powodów, dla których YouTube może mieć trudności z transkodowaniem przesłanego filmu lub które mogą spowodować błędne transkodowanie. Te ostrzeżenia są generowane przed przetworzeniem przesłanego pliku wideo przez YouTube. Ponadto wskazują problemy, które niekoniecznie oznaczają, że przetwarzanie filmu się nie powiedzie, ale mogą powodować problemy, takie jak problemy z synchronizacją, artefakty wideo lub brak ścieżki audio.

Prawidłowe wartości tej właściwości to:
  • hasEditlist – edytowanie list nie jest obecnie obsługiwane.
  • inconsistentResolution – Konflikt między rozdzielczością kontenera a rozdzielczością strumienia.
  • problematicAudioCodec – użyto kodeka audio, który powoduje znane problemy.
  • problematicVideoCodec – użyto kodeka wideo, który powoduje problemy.
  • unknownAudioCodec – nierozpoznany kodek audio, transkodowanie prawdopodobnie się nie powiedzie.
  • unknownContainer – nierozpoznany format pliku, transkodowanie prawdopodobnie się nie powiedzie.
  • unknownVideoCodec – nierozpoznany kodek wideo, transkodowanie prawdopodobnie się nie powiedzie.
suggestions.processingHints[] list
Lista sugestii, które mogą poprawić zdolność YouTube do przetwarzania filmu.

Prawidłowe wartości tej właściwości to:
  • nonStreamableMov – plik MP4 nie nadaje się do przesyłania strumieniowego, co spowolni przetwarzanie.
  • sendBestQualityVideo – prawdopodobnie istnieje wersja filmu o lepszej jakości.
suggestions.tagSuggestions[] list
Lista tagów słów kluczowych, które można dodać do metadanych filmu, aby zwiększyć prawdopodobieństwo, że użytkownicy znajdą Twój film podczas wyszukiwania lub przeglądania w YouTube.
suggestions.tagSuggestions[].tag string
Tag słowa kluczowego sugerowany dla filmu.
suggestions.tagSuggestions[].categoryRestricts[] list
Zestaw kategorii filmów, do których tag jest odpowiedni. Możesz użyć tych informacji, aby wyświetlać odpowiednie sugestie tagów na podstawie kategorii filmu, którą osoba przesyłająca film powiązała z filmem. Domyślnie sugestie tagów są odpowiednie dla wszystkich kategorii, jeśli dla słowa kluczowego nie zdefiniowano żadnych ograniczeń.
suggestions.editorSuggestions[] list
Lista operacji edycji wideo, które mogą poprawić jakość lub odtwarzanie przesłanego filmu.

Prawidłowe wartości tej właściwości to:
  • audioQuietAudioSwap – ścieżka audio jest cicha i można ją zastąpić ścieżką o lepszej jakości.
  • videoAutoLevels – poziomy jasności obrazu wydają się nieprawidłowe i mogą wymagać korekty.
  • videoCrop – wykryte marginesy (passe-partout) wokół zdjęcia mogą zostać przycięte.
  • videoStabilize – film jest niestabilny i można go ustabilizować.
liveStreamingDetails object
Obiekt liveStreamingDetails zawiera metadane dotyczące transmisji wideo na żywo. Obiekt będzie obecny w zasobie video tylko wtedy, gdy film jest nadchodzącą, trwającą lub zakończoną transmisją na żywo.
liveStreamingDetails.actualStartTime datetime
Godzina rozpoczęcia transmisji. Wartość jest podana w formacie ISO 8601. Ta wartość będzie dostępna dopiero po rozpoczęciu transmisji.
liveStreamingDetails.actualEndTime datetime
Czas, w którym transmisja faktycznie się zakończyła. Wartość jest podana w formacie ISO 8601. Ta wartość będzie dostępna dopiero po zakończeniu transmisji.
liveStreamingDetails.scheduledStartTime datetime
Zaplanowana godzina rozpoczęcia transmisji. Wartość jest podana w formacie ISO 8601.
liveStreamingDetails.scheduledEndTime datetime
Godzina, o której ma się zakończyć transmisja. Wartość jest podana w formacie ISO 8601. Jeśli wartość jest pusta lub właściwość nie występuje, transmisja ma trwać bezterminowo.
liveStreamingDetails.concurrentViewers unsigned long
Liczba widzów, którzy aktualnie oglądają transmisję. Usługa i jej wartość będą widoczne, jeśli transmisja ma aktualnych widzów, a właściciel transmisji nie ukrył liczby wyświetleń filmu. Pamiętaj, że po zakończeniu transmisji YouTube przestaje śledzić liczbę widzów oglądających ją w tym samym czasie. W związku z tym ta właściwość nie określa liczby widzów oglądających zarchiwizowany film z transmisji na żywo, która już się zakończyła.
Liczba widzów oglądających transmisję w tym samym czasie zwracana przez interfejs YouTube Data API może się różnić od przetworzonej i oczyszczonej z niechcianych treści liczby widzów oglądających transmisję w tym samym czasie dostępnej w Statystykach YouTube. Więcej informacji o statystykach transmisji na żywo znajdziesz w Centrum pomocy YouTube.
liveStreamingDetails.activeLiveChatId string
Identyfikator obecnie aktywnego czatu na żywo dołączonego do tego filmu. To pole jest wypełniane tylko wtedy, gdy film jest obecnie transmitowany na żywo i ma czat na żywo. Gdy transmisja się zakończy, to pole zostanie usunięte, a czat na żywo zostanie zamknięty. W przypadku transmisji ciągłych identyfikator czatu na żywo nie będzie już powiązany z tym filmem, ale z nowym filmem wyświetlanym na stronie ciągłej.
localizations object
Obiekt localizations zawiera tłumaczenia metadanych filmu.
localizations.(key) object
Język zlokalizowanego tekstu powiązanego z wartością klucza. Wartość to ciąg znaków zawierający kod języka BCP-47.
localizations.(key).title string
Zlokalizowany tytuł filmu.
localizations.(key).description string
Zlokalizowany opis filmu.