Videos

Wszystkie filmy przesłane za pomocą punktu końcowego videos.insert z niezweryfikowanych projektów API utworzonych po 28 lipca 2020 r. będą dostępne tylko w trybie prywatnym. Aby znieść to ograniczenie, każdy projekt interfejsu API musi przejść kontrolę, która potwierdzi zgodność z Warunkami korzystania z usługi. Więcej informacji znajdziesz w historii zmian interfejsu API.

Zasób video reprezentuje film w YouTube.

Metody

Interfejs API obsługuje te metody dotyczące zasobów videos:

getRating

Pobiera oceny przyznane przez autoryzowanego użytkownika na liście określonych filmów. Wypróbuj teraz

list

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

insert

Prześlij film do YouTube i opcjonalnie ustaw jego metadane.

update

Aktualizuje metadane filmu. Wypróbuj teraz

usuń

Usuwanie filmu w YouTube. Wypróbuj teraz

rate

Dodaj ocenę „Lubię to” lub „Nie lubię tego” do filmu lub usuń ocenę z filmu. Wypróbuj teraz

reportAbuse

Zgłaszanie filmu zawierającego treści obraźliwe. Wypróbuj teraz

Reprezentacja zasobu

Struktura JSON poniżej pokazuje 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łaściwości tego zasobu są opisane w tabeli poniżej:

Właściwości
kind	string Określa typ zasobu interfejsu API. Wartość będzie wynosić 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 ten czas może być inny niż czas przesłania filmu. Jeśli na przykład film został przesłany jako prywatny, a później został publicznie udostępniony, ta właściwość będzie zawierać czas, w którym film został publicznie udostępniony. Istnieją pewne przypadki szczególne: Jeśli film został przesłany jako film prywatny, a właściciel kanału pobiera metadane filmu, wartość właściwości określa datę i godzinę przesłania filmu. Jeśli film został przesłany jako niepubliczny, wartość właściwości zawiera również datę i godzinę przesłania filmu. W tym przypadku metadane filmu może pobrać każdy, kto zna jego unikalny identyfikator. Wartość jest podawana w formacie ISO 8601.
snippet.channelId	string Identyfikator używany przez YouTube 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 może zawierać wszystkie prawidłowe znaki UTF-8 z wyjątkiem < i >. Jeśli wywołasz metodę videos.update i aktualizujesz część snippet zasobu video, musisz ustawić wartość tej właściwości.
snippet.description	string Opis filmu. Wartość właściwości może mieć maksymalnie 5000 bajtów i może zawierać wszystkie prawidłowe znaki UTF-8 z wyjątkiem < i >.
snippet.thumbnails	object Mapa miniatur powiązanych z filmem. W przypadku każdego obiektu na mapie kluczem jest nazwa miniatury, a wartością obiekt, który zawiera inne informacje o miniaturze.
snippet.thumbnails.(key)	object Prawidłowe wartości klucza: default – domyślna miniatura. Domyślna miniatura filmu lub zasobu odwołującego 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 odwołującego się do filmu) obraz ma szerokość 320 pikseli i wysokość 180 pikseli. W przypadku kanału obraz ma 240 pikseli szerokości i 240 pikseli wysokości. high – wersja miniatury w wysokiej rozdzielczości. W przypadku filmu (lub zasobu odwołującego się do filmu) obraz ma szerokość 480 pikseli i wysokość 360 pikseli. W przypadku kanału obraz ma 800 pikseli szerokości i 800 pikseli wysokości. standard – wersja miniatury w jeszcze wyższej rozdzielczości niż obraz o rozdzielczości high. Ten obraz jest dostępny w przypadku niektórych filmów i innych zasobów, które odnoszą się do filmów, takich jak elementy playlisty czy wyniki wyszukiwania. Ten obraz ma 640 pikseli szerokości i 480 pikseli wysokości. 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 odnoszą się do filmów, takich jak elementy playlisty czy wyniki wyszukiwania. Ten obraz ma 1280 pikseli szerokości i 720 pikseli wysokości.
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. Wartość właściwości może mieć maksymalnie 500 znaków. Pamiętaj o tych zasadach dotyczących sposobu obliczania limitu znaków: Wartość właściwości to lista, a przecinki między elementami na liście są wliczane do limitu. Jeśli tag zawiera spacje, serwer interfejsu API traktuje wartość tagu tak, jakby była ona ujęta w cudzysłowie, a cudzysłowy wlicza się do limitu znaków. Dlatego w celu zachowania limitu 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 tym filmem. Jeśli wywołasz metodę videos.update i aktualizujesz część snippet zasobu video, musisz ustawić wartość tej właściwości.
snippet.liveBroadcastContent	string Wskazuje, czy film jest nadchodzącą lub aktywną transmisją na żywo. Może też być „none” (brak), jeśli film nie jest nadchodzącą lub aktywną transmisją na żywo. Dopuszczalne wartości tej właściwości to: live none upcoming
snippet.defaultLanguage	string Język tekstu w atrybutach snippet.title i snippet.description zasobu video.
snippet.localized	object Obiekt snippet.localized zawiera zlokalizowany tytuł i opis filmu lub tytuł w domyślnym języku dla metadanych filmu. Zlokalizowany tekst jest zwracany w fragmentach zasobów, jeśli żądanie videos.list używa parametru hl do określenia języka, w którym ma być zwrócony zlokalizowany tekst i zlokalizowany tekst jest dostępny w tym języku. Metadane w języku domyślnym są zwracane, jeśli wartość parametru hl nie jest określona lub jeśli wartość jest określona, ale zlokalizowane metadane nie są dostępne w wybranym języku. Właściwość zawiera wartość tylko do odczytu. Aby dodawać, aktualizować i usuwać przetłumaczone tytuły, użyj obiektu localizations.
snippet.localized.title	string Zlokalizowany tytuł filmu.
snippet.localized.description	string Przetłumaczony opis filmu.
snippet.defaultAudioLanguage	string Właściwość default_audio_language określa język domyślnej ścieżki dźwiękowej filmu.
contentDetails	object Obiekt contentDetails zawiera informacje o treści filmu, w tym jego długość i wskazanie, czy do filmu 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 trwającego co najmniej minutę, ale krócej niż godzinę, czas trwania jest podawany w formacie PT#M#S, gdzie litery PT wskazują, że wartość określa okres czasu, a litery M i S odnoszą się odpowiednio do długości w minutach i sekundach. # znaków poprzedzających litery M i S to liczby całkowite określające liczbę minut (lub sekund) filmu. Na przykład wartość PT15M33S wskazuje, że film trwa 15 minut i 33 sekund. Jeśli film trwa co najmniej godzinę, jego czas trwania jest podany w formacie PT#H#M#S, gdzie # poprzedzający literę H określa czas trwania filmu w godzinach, a wszystkie inne szczegóły są takie same jak opisane powyżej. Jeśli film trwa co najmniej 1 dzień, litery P i T są rozdzielone, a wartość ma format 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 2D.
contentDetails.definition	string Wskazuje, czy film jest dostępny w wysokiej rozdzielczości (HD) czy tylko w standardowej rozdzielczości. Dopuszczalne wartości tej właściwości to: hd sd
contentDetails.caption	string Wskazuje, czy w filmie są dostępne napisy. Dozwolone wartości tej właściwości to: false true
contentDetails.licensedContent	boolean Wskazuje, czy film zawiera treści objęte licencją, co oznacza, że zostały one przesłane na kanał powiązany z partnerem YouTube, a następnie objęte roszczeniem przez tego partnera.
contentDetails.regionRestriction	object Obiekt regionRestriction zawiera informacje o tym, w których krajach film jest (lub nie jest) dostępny. Obiekt będzie zawierać albo właściwość contentDetails.regionRestriction.allowed, albo właściwość contentDetails.regionRestriction.blocked.
contentDetails.regionRestriction.allowed[]	list Lista kodów regionów, które wskazują kraje, w których film jest dostępny. Jeśli ta właściwość jest obecna, a jej wartość nie zawiera nazwy kraju, film nie jest wyświetlany w tym kraju. Jeśli ta właściwość jest obecna i zawiera pustą listę, film jest zablokowany we wszystkich krajach.
contentDetails.regionRestriction.blocked[]	list Lista kodów regionów identyfikujących kraje, w których film jest zablokowany. Jeśli ta usługa jest obecna, ale nie ma w niej podanego kraju, oznacza to, że film jest dostępny w danym kraju. Jeśli ta właściwość jest obecna i zawiera pustą listę, film jest dostępny we wszystkich krajach.
contentDetails.contentRating	object Określa oceny, jakie otrzymał film w ramach różnych systemów oceny.
contentDetails.contentRating.acbRating	string Ocena filmu według Australian Classification Board (ACB) lub Australian Communications and Media Authority (ACMA). Oceny ACMA służą do klasyfikowania programów telewizyjnych dla dzieci. Dozwolone wartości tej właściwości to: acbC – programy, które otrzymały klasyfikację C wydaną przez Australian Communications and Media Authority. Programy te są 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óre otrzymały klasyfikację P wydaną przez Australian Communications and Media Authority. Te programy są przeznaczone dla dzieci w wieku przedszkolnym. acbPg – PG acbR18plus – R18+ acbUnrated
contentDetails.contentRating.agcomRating	string Ocena filmu przyznana przez włoską organizację Autorità per le Garanzie nelle Comunicazioni (AGCOM). Dopuszczalne wartości tej właściwości to: agcomT – T agcomUnrated agcomVm14 – VM14 agcomVm18 – VM18
contentDetails.contentRating.anatelRating	string Ocena filmu według Anatel (Asociación Nacional de Televisión) dla telewizji chilijskiej. Dozwolone wartości tej właściwości 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 według brytyjskiej organizacji British Board of Film Classification (BBFC). Akceptowane 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 wydana przez tajski urząd cenzury filmów i telewizji. Dopuszczalne 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 wydana przez austriacki urząd ds. klasyfikacji mediów (Bundesministerium für Unterricht, Kunst und Kultur). Dopuszczalne wartości tej właściwości to: bmukk10 – 10 i więcej bmukk12 – 12 lat i starsze bmukk14 – 14 lat i starsze bmukk16 – 16 lat i starsze bmukk6 – 6 i więcej bmukk8 – 8 lub więcej bmukkAa – bez ograniczeń bmukkUnrated
contentDetails.contentRating.catvRating	string System klasyfikacji kanadyjskiej telewizji – kanadyjski system klasyfikacji telewizyjnej Ocena filmu wydana przez Kanadyjską Komisję ds. Radia, Telewizji i Telekomunikacji (CRTC) dla kanadyjskich transmisji w języku angielskim. Więcej informacji znajdziesz na stronie Canadian Broadcast Standards Council (Kanadyjskiej Rady ds. Standardów Nadawania). Dopuszczalne wartości tej właściwości to: catv14plus – 14 lat i starsze catv18plus – 18 lat i starsze catvC – C catvC8 – C8 catvG – G catvPg – PG catvUnrated
contentDetails.contentRating.catvfrRating	string Ocena filmu wydana przez Kanadyjską Komisję ds. Radia, Telewizji i Telekomunikacji (CRTC) dla kanadyjskich transmisji w języku francuskim. Więcej informacji znajdziesz na stronie Canadian Broadcast Standards Council (Kanadyjskiej Rady ds. Standardów Nadawania). Dopuszczalne wartości tej właściwości to: catvfr13plus – 13 lat i starsze catvfr16plus – 16 lat i starsze catvfr18plus – 18 lat i starsze catvfr8plus – 8 lub więcej catvfrG – G catvfrUnrated
contentDetails.contentRating.cbfcRating	string Ocena filmu według Central Board of Film Certification (CBFC – Indie). Dopuszczalne 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 przyznana filmowi przez Consejo de Calificación Cinematográfica (Chile). Dozwolone wartości tej właściwości to: ccc14 – 14 lat i starsze ccc18 – 18 lat i starsze 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 według portugalskiej komisji ds. klasyfikacji filmów (Comissão de Classificação de Espect´culos). Dopuszczalne 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. Dozwolone wartości tej właściwości to: chfilm0 – 0 chfilm12 – 12 chfilm16 – 16 chfilm18 – 18 chfilm6 – 6 chfilmUnrated
contentDetails.contentRating.chvrsRating	string Ocena filmu według kanadyjskiego systemu klasyfikacji filmów domowych (CHVRS). Dozwolone 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 według 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ński CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA). Prawidłowe wartości tej właściwości to: cna12 – 12 cna15 – 15 cna18 – 18 cna18plus – 18 lat i starsze cnaAp – AP cnaUnrated
contentDetails.contentRating.cncRating	string System oceny we Francji – Commission de classification cinematographique Dopuszczalne 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 francuski Conseil supérieur de l’audiovisuel, który ocenia treści nadawane w ramach transmisji. Dopuszczalne wartości tej właściwości to: csa10 – 10 csa12 – 12 csa16 – 16 csa18 – 18 csaInterdiction – Przechwytywanie csaT – T csaUnrated
contentDetails.contentRating.cscfRating	string Ocena filmu według Commission de surveillance de la classification des films (CSCF) w Luksemburgu. Dopuszczalne 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. Dozwolone wartości tego atrybutu: czfilm12 – 12 czfilm14 – 14 czfilm18 – 18 czfilmU – U czfilmUnrated
contentDetails.contentRating.djctqRating	string Ocena Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT – Brazylia) dla filmu. Dopuszczalne 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ł ocenę DJCQT (Brazylia).
contentDetails.contentRating.ecbmctRating	string System oceny w Turcji – Komisja ds. Oceny i Klasyfikacji przy Ministerstwie Kultury i Turystyki Dopuszczalne wartości tej właściwości to: ecbmct13a – 13A ecbmct13plus – 13 lat i starsze ecbmct15a – 15A ecbmct15plus – 15 i więcej ecbmct18plus – 18 lat i starsze ecbmct7a – 7A ecbmct7plus – 7 i więcej ecbmctG – G ecbmctUnrated ecbmct6a – 6A ecbmct6plus – 6 i więcej ecbmct10a – 10A ecbmct10plus – 10 i więcej ecbmct16plus – 16 lat i starsze
contentDetails.contentRating.eefilmRating	string Ocena filmu w Estonii. Dozwolone wartości tej właściwości to: eefilmK12 – szkoły podstawowe i średnie eefilmK14 – K-14 eefilmK16 – K-16 eefilmK6 – klasy K-6 eefilmL – L eefilmMs12 – MS-12 eefilmMs6 – MS-6 eefilmPere – Pere eefilmUnrated
contentDetails.contentRating.egfilmRating	string Ocena filmu w Egipcie. Dozwolone wartości tej właściwości to: egfilm18 – 18 egfilmBn – BN egfilmGn – GN egfilmUnrated
contentDetails.contentRating.eirinRating	string Ocena Eirin (映倫) dla filmu. Eirin to japoński system oceny. Prawidłowe wartości tej właściwości to: eirinG – G eirinPg12 – PG-12 eirinR15plus – R15+ eirinR18plus – R18+ eirinUnrated
contentDetails.contentRating.fcbmRating	string Ocena filmu wydana przez malajską Radę Cenzur Filmowej. Prawidłowe wartości tej właściwości to: fcbm13 – 13 fcbm16 – 16 fcbm18 – 18 fcbm18pa – 18 PA fcbm18pl – 18PL fcbm18sg – 18SG fcbm18sx – 18SX fcbmP12 – P12 fcbmP13 – P13 fcbmPg13 – PG13 fcbmU – U fcbmUnrated
contentDetails.contentRating.fcoRating	string Ocena filmu z Hong Kong Office for Film, Newspaper and Article Administration. 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 Ta usługa została wycofana 2 listopada 2015 r. Zamiast tego użyj właściwości contentDetails.contentRating.cncRating. Ocena filmu według Centre national du cinéma et de l'image animé (francuskiego Ministerstwa Kultury). Prawidłowe wartości tej właściwości to: fmoc10 – 10 fmoc12 – 12 fmoc16 – 16 fmoc18 – 18 fmocE – E fmocU – U fmocUnrated
contentDetails.contentRating.fpbRating	string Ocena filmu według południowoafrykańskiego Urzędu ds. Filmów i Publikacji. Akceptowane 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 Freiwillige Selbstkontrolle der Filmwirtschaft (FSK – Niemcy). Dopuszczalne 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. Dozwolone wartości tej właściwości to: grfilmE – E grfilmK – K grfilmK12 – szkoły podstawowe i średnie grfilmK13 – K-13 grfilmK15 – K-15 grfilmK17 – K-17 grfilmK18 – K-18 grfilmUnrated
contentDetails.contentRating.icaaRating	string Ocena Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA – Hiszpania) dla filmu. Dopuszczalne 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 wydana przez urząd ds. klasyfikacji filmów w Irlandii (IFCO). Więcej informacji znajdziesz na stronie IFCO. Dopuszczalne 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. Dozwolone wartości tej właściwości to: ilfilm12 – 12 ilfilm16 – 16 ilfilm18 – 18 ilfilmAa – AA ilfilmUnrated
contentDetails.contentRating.incaaRating	string Ocena filmu według INCAA (Instituto Nacional de Cine y Artes Audiovisuales – Argentyna). Dopuszczalne 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 wydana przez kenijska komisja ds. klasyfikacji filmów. Prawidłowe wartości tej właściwości to: kfcb16plus – 16 kfcbG – GE kfcbPg – PG kfcbR – 18 kfcbUnrated
contentDetails.contentRating.kijkwijzerRating	string voor de Classificatie van Audiovisuele Media (Holandia). Dopuszczalne 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 Korea Media Rating Board (영상물등급위원회) KMRB ocenia filmy w Korei Południowej. Dozwolone wartości tej właściwości to: kmrb12plus – 12세 이상 관람가 kmrb15plus – 15세 이상 관람가 kmrbAll – 전체관람가 kmrbR – 청소년 관람불가 kmrbTeenr kmrbUnrated
contentDetails.contentRating.lsfRating	string Ocena filmu według indonezyjskiego Lembaga Sensor Film. Dopuszczalne wartości tej właściwości to: lsf13 – 13 lsf17 – 17 lsf21 – 21 lsfA – A lsfBo – BO lsfD – D lsfR – R lsfSu – SU lsfUnrated
contentDetails.contentRating.mccaaRating	string Ocena filmu wydana przez maltański urząd ds. klasyfikacji wiekowej filmów. Dopuszczalne 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 r. mccaa15 – 15 mccaa16 – 16 – ta ocena została usunięta z nowej struktury klasyfikacji wprowadzonej w 2013 r. mccaa18 – 18 mccaaPg – PG mccaaU – U mccaaUnrated
contentDetails.contentRating.mccypRating	string Ocena filmu nadana przez Radę Mediów dla Dzieci i Młodzieży (Det Danske Filminstitut) przy współpracy z Instytutem Filmowym Danii (Det Danske Filminstitut). Dopuszczalne wartości tej właściwości to: mccyp11 – 11 mccyp15 – 15 mccyp7 – 7 mccypA – A mccypUnrated
contentDetails.contentRating.mcstRating	string System oceny filmów w Wietnamie – MCST Dozwolone wartości tej właściwości to: mcst0 – 0 mcst16plus – 16 lat i starsze mcstC13 – C13 mcstC16 – C16 mcstC18 – C18 mcstP – P mcstUnrated mcstT13 – T13 mcstT16 – T16 mcstT18 – T18 mcstK – K
contentDetails.contentRating.mdaRating	string Klasyfikacja filmu wydana przez singapurską Media Development Authority (MDA), a w szczególności przez jej Board of Film Censors (BFC). Dopuszczalne 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 Medietilsynet, norweską instytucję ds. mediów. Prawidłowe wartości tej właściwości to: medietilsynet11 – 11 medietilsynet12 – 12 medietilsynet15 – 15 medietilsynet18 – 18 medietilsynet6 – 6 medietilsynet7 – 7 medietilsynet9 – 9 medietilsynetA – A medietilsynetUnrated
contentDetails.contentRating.mekuRating	string Ocena filmu z fińskiego Kansallinen Audiovisuaalinen Instituutti (National Audiovisual Institute). Dopuszczalne 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). Dopuszczalne wartości tej właściwości to: mibacT mibacUnrated mibacVap mibacVm6 mibacVm12 mibacVm14 mibacVm18
contentDetails.contentRating.mocRating	string Ocena filmu według Ministerio de Cultura (Kolumbia). Dopuszczalne wartości tej właściwości to: moc12 – 12 moc15 – 15 moc18 – 18 moc7 – 7 mocBanned – Zablokowani mocE – E mocT – T mocUnrated mocX – X
contentDetails.contentRating.moctwRating	string Ocena filmu wydana przez tajwańskie Ministerstwo Kultury (文化部). 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 według Motion Picture Association of America (MPAA). Prawidłowe wartości tej właściwości to: mpaaG – G mpaaNc17 – NC-17 mpaaPg – PG mpaaPg13 – PG-13 mpaaR – R mpaaUnrated
contentDetails.contentRating.mpaatRating	string Ocena przyznana przez Motion Picture Association of America dla zwiastunów i zwiastunów przedpremierowych. Dopuszczalne wartości tej właściwości to: mpaatGb – GB (Green Band - Approved for all audiences) mpaatRb – RB (czerwona opaska – zalecana dla osób powyżej 17 roku życia)
contentDetails.contentRating.mtrcbRating	string Ocena filmu według filipińskiej komisji ds. oceny i klasyfikacji filmów i telewizji. Dozwolone 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 według National Bureau of Classification (Maldives). Dozwolone wartości tej właściwości to: nbc12plus – 12 lat i starsze nbc15plus – 15 lat i więcej nbc18plus – 18 lat i starsze nbc18plusr – 18+R nbcG – G nbcPg – PG nbcPu – PU nbcUnrated
contentDetails.contentRating.nfrcRating	string Ocena filmu z Bułgarskiego Narodowego Centrum Filmowego. Dopuszczalne 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 wydana przez nigeryjski Urząd Cenzury Filmów i Programów Telewizyjnych. Dopuszczalne 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). Dopuszczalne wartości tej właściwości to: nkclv12plus – 12 lat i starsze nkclv18plus – 18 lat i starsze nkclv7plus – 7 i więcej nkclvU – U nkclvUnrated
contentDetails.contentRating.oflcRating	string Ocena filmu według nowozelandzkiego urzędu ds. klasyfikacji filmów i literatury (OFLC). Dozwolone wartości tej właściwości to: 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. Dozwolone wartości tej właściwości to: pefilm14 – 14 pefilm18 – 18 pefilmPg – PG pefilmPt – PT pefilmUnrated
contentDetails.contentRating.resorteviolenciaRating	string Ocena filmu w Wenezueli. Dozwolone wartości tego atrybutu to: resorteviolenciaA – A resorteviolenciaB – B resorteviolenciaC – C resorteviolenciaD – D resorteviolenciaE – E resorteviolenciaUnrated
contentDetails.contentRating.rtcRating	string Ocena filmu wydana przez General Directorate of Radio, Television and Cinematography (Meksyk). Dozwolone wartości tej właściwości: rtcA – A rtcAa – AA rtcB – B rtcB15 – B15 rtcC – C rtcD – D rtcUnrated
contentDetails.contentRating.rteRating	string Ocena filmu z irlandzkiej stacji Raidió Teilifís Éireann. Prawidłowe wartości tej właściwości to: rteCh – CH rteGa – GA rteMa – MA rtePs – PS rteUnrated
contentDetails.contentRating.russiaRating	string Ocena filmu w Narodowym Rejestrze Filmów Federacji Rosyjskiej (MKRF). Prawidłowe wartości tej właściwości to: russia0 – 0+ russia12 – 12 lat i starsze russia16 – 16 lat i starsze russia18 – 18 lat i starsze russia6 – 6 i więcej russiaUnrated
contentDetails.contentRating.skfilmRating	string Ocena filmu na Słowacji. Dozwolone wartości tej właściwości to: skfilmG – G skfilmP2 – P2 skfilmP5 – P5 skfilmP8 – P8 skfilmUnrated
contentDetails.contentRating.smaisRating	string Ocena filmu na Islandii. Dozwolone wartości tej właściwości 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 (szwedzki urząd ds. mediów). Dopuszczalne wartości tej właściwości to: smsa11 – 11 smsa15 – 15 smsa7 – 7 smsaA – wszystkie grupy wiekowe smsaUnrated
contentDetails.contentRating.tvpgRating	string Ocena wideo według wytycznych dotyczących treści dla dzieci (TVPG). Dozwolone wartości tej właściwości 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 objętych ograniczeniem wiekowym. Dopuszczalne wartości tej właściwości to: ytAgeRestricted
contentDetails.projection	string Określa format projekcji filmu. Dopuszczalne wartości tej właściwości to: 360 rectangular
contentDetails.hasCustomThumbnail	boolean Wskazuje, czy przesyłający film udostępnił niestandardową miniaturę filmu. Ta usługa jest widoczna tylko dla osoby, która przesyła film.
status	object Obiekt status zawiera informacje o przesyłaniu, przetwarzaniu i prywatności filmu.
status.uploadStatus	string Stan przesłanego filmu. Dozwolone 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ść jest obecna tylko wtedy, gdy właściwość uploadStatus wskazuje, że przesyłanie się nie powiodło. Dopuszczalne 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ść jest obecna tylko wtedy, gdy właściwość uploadStatus wskazuje, że przesłanie zostało odrzucone. Dozwolone 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. Dozwolone wartości tej właściwości: private public unlisted
status.publishAt	datetime Data i godzina zaplanowanej publikacji filmu. Można go ustawić tylko wtedy, gdy film jest ustawiony jako prywatny. Wartość jest określona w formacie ISO 8601. Pamiętaj o tych 2 dodatkowych kwestiach dotyczących zachowania tej usługi: Jeśli podczas wywoływania metody videos.update ustawisz wartość tej właściwości, musisz też ustawić wartość właściwości status.privacyStatus na private, nawet jeśli film jest już prywatny. Jeśli Twoje żądanie spowoduje zaplanowanie publikacji filmu w przeszłości, film zostanie opublikowany od razu. W związku z tym ustawienie właściwości status.publishAt na datę i godzinę w przeszłości ma taki sam efekt jak zmiana wartości właściwości privacyStatus z private na public.
status.license	string Licencja filmu. Dozwolone wartości tej właściwości to: creativeCommon youtube
status.embeddable	boolean Ta wartość wskazuje, czy film może być umieszczany w innej witrynie.
status.publicStatsViewable	boolean Ta wartość wskazuje, czy rozszerzone statystyki filmu na stronie odtwarzania filmu są publicznie dostępne. Domyślnie te statystyki są widoczne, a liczby wyświetleń i oceny filmu będą nadal publicznie dostępne, nawet jeśli wartość tej właściwości zostanie ustawiona na false.
status.madeForKids	boolean Ta wartość wskazuje, czy film jest przeznaczony dla dzieci, i zawiera aktualny stan „przeznaczony dla dzieci”. Stan może być na przykład określany na podstawie wartości właściwości selfDeclaredMadeForKids. Więcej informacji o określaniu 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 żądaniu videos.list wartość właściwości jest zwracana tylko wtedy, gdy właściciel kanału autoryzował żądanie interfejsu API.
status.containsSyntheticMedia	boolean W żądaniu videos.insert lub videos.update ta właściwość pozwala właścicielowi kanału ujawnić, że film zawiera realistyczne zmodyfikowane lub wygenerowane syntetycznie (Z/Z) treści. Dowiedz się więcej o zasadach YouTube dotyczących treści związanych z A/S. Przykłady treści związanych z usługami i świadczeniem usług: treści, które sprawiają wrażenie, że dana osoba powiedziała lub zrobiła coś, czego wcale nie powiedziała ani nie zrobiła; Treści zmieniają 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 parametr viewCount będzie zwracać liczbę razy, ile rozpoczęto lub ponowiono odtwarzanie filmu Short, bez minimalnego czasu oglądania.
statistics.likeCount	unsigned long Liczba użytkowników, którzy wyrazili swoją aprobatę dla filmu.
statistics.dislikeCount	unsigned long Uwaga: usługa statistics.dislikeCount została ustawiona jako prywatna 13 grudnia 2021 r. Oznacza to, że usługa jest uwzględniana w odpowiedzi interfejsu API tylko wtedy, gdy żądanie interfejsu API zostało uwierzytelnione przez właściciela filmu. Więcej informacji znajdziesz w historii zmian. Liczba użytkowników, którzy wskazali, że film im się nie podoba.
statistics.favoriteCount	unsigned long Uwaga: ta właściwość została wycofana. Wycofanie weszło w życie 28 sierpnia 2015 r. Wartość tej właściwości jest teraz zawsze ustawiana 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 na true, jeśli treści zawierają płatne lokowanie produktu. Domyślna wartość to false.
player	object Obiekt player zawiera informacje, których używasz do odtwarzania filmu w odtwarzaczu umieszczonym na stronie internetowej.
player.embedHtml	string Tag <iframe>, który umożliwia umieszczenie odtwarzacza do odtwarzania filmu. Jeśli żądanie interfejsu API służące do pobierania zasobu określa wartość parametrów maxHeight lub maxWidth, rozmiar wbudowanego odtwarzacza jest dostosowywany do wymagań maxHeight lub maxWidth. Jeśli współczynnik proporcji filmu jest nieznany, wbudowany odtwarzacz domyślnie przyjmuje format 4:3.
player.embedHeight	long Wysokość zwróconego w usłudze player.embedHtml odtwarzacza umieszczonego na stronie. Ta właściwość jest zwracana tylko wtedy, gdy żądanie określa wartość parametrów maxHeight lub maxWidth i jest znany format obrazu wideo.
player.embedWidth	long Szerokość odtwarzacza umieszczonego w usłudze player.embedHtml. Ta właściwość jest zwracana tylko wtedy, gdy żądanie określa wartość parametrów maxHeight lub maxWidth i jest znany format obrazu wideo.
topicDetails	object Obiekt topicDetails zawiera informacje o tematach związanych z filmem. Ważne: aby dowiedzieć się więcej o nadchodzących zmianach dotyczących identyfikatorów tematów, zapoznaj się z definicjami właściwości topicDetails.relevantTopicIds[] i topicDetails.topicIds[] oraz z historią zmian.
topicDetails.topicIds[]	list Ważne: ta usługa została wycofana 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 ona obsługiwana do 10 listopada 2017 r. Ważne: ze względu na wycofanie Freebase i interfejsu Freebase API od 27 lutego 2017 r. identyfikatory tematów działają inaczej. Wtedy YouTube zaczął zwracać niewielki zestaw zweryfikowanych identyfikatorów tematów. Zobacz identyfikatory tematów obsługiwane od 15 lutego 2017 r. Tematy Tematy muzyczne /m/04rlf Muzyka (temat nadrzędny) /m/02mscn chrześcijańska /m/0ggq0m Muzyka klasyczna /m/01lyv Kraj /m/02lkt Muzyka elektroniczna /m/0glt670 Muzyka hip-hop /m/05rwpb Muzyka niezależna /m/03_d0 Jazz /m/028sqc Muzyka azjatycka /m/0g293 Muzyka latynoamerykańska /m/064t9 Muzyka pop /m/06cqb Reggae /m/06j6l Rhythm and blues /m/06by7 Muzyka rockowa /m/0gywn Muzyka soul Tematy dotyczące gier /m/0bzvm2 Gry (temat nadrzędny) /m/025zzc Gra akcji /m/02ntfj Gra akcji i przygodowa /m/0b1vjn Gra rekreacyjna /m/02hygl Muzyczna gra wideo /m/04q1x3q Logiczna gra wideo /m/01sjng Wyścigowa gra wideo /m/0403l3g Fabularna gra wideo /m/021bp2 Symulacyjna gra wideo /m/022dc6 Gra sportowa /m/03hf_rm Strategiczna gra wideo Tematy związane ze sportem /m/06ntj Sport (temat nadrzędny) /m/0jm_ Futbol amerykański /m/018jz Baseball /m/018w8 Koszykówka /m/01cgz Boks /m/09xp_ Krykiet /m/02vx4 Futbol amerykański /m/037hz Golf /m/03tmr Hokej na lodzie /m/01h7lh Mieszane sztuki walki /m/0410tth Sporty motorowe /m/07bs0 Tenis /m/07_53 Siatkówka Tematy dotyczące rozrywki /m/02jjt Rozrywka (temat nadrzędny) /m/09kqc Humor /m/02vxn filmy, /m/05qjc Sztuki sceniczne /m/066wd Wrestling zawodowy /m/0f2f9 seriale i programy telewizyjne, Tematy dotyczące stylu życia /m/019_rr Styl życia (temat nadrzędny) /m/032tl Moda /m/027x7n Fitness /m/02wbm Jedzenie /m/03glg Hobby /m/068hy Zwierzęta domowe /m/041xxh atrakcyjność fizyczna [uroda], /m/07c1v Technologia /m/07bxq Turystyka /m/07yv9 Pojazdy Tematy związane ze społeczeństwem /m/098wr Społeczeństwo (temat nadrzędny) /m/09s1f Firma /m/0kt51 Zdrowie /m/01h6rj Wojsko /m/05qt0 Polityka /m/06bvp Religia Inne tematy /m/01k8wb Wiedza
topicDetails.topicCategories[]	list Lista adresów URL stron w Wikipedii, które opisują ogólnie treść filmu.
recordingDetails	object Obiekt recordingDetails zawiera informacje o lokalizacji, dacie i adresie, w których nagrano film.
recordingDetails.locationDescription	string Ta usługa została wycofana 1 czerwca 2017 r. Więcej informacji znajdziesz w ogłoszeniu o wycofaniu funkcji. Opis tekstowy lokalizacji, w której nagrano film.
recordingDetails.location	object Informacje o geolokalizacji powiązane z filmem. Pamiętaj, że wartości właściwości podrzędnej wskazują lokalizację, którą właściciel filmu chce powiązać z filmem. Wartość można edytować, można ją wyszukać w publicznych filmach, a użytkownicy mogą ją zobaczyć.
recordingDetails.location.latitude	double Ta usługa 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 usługa 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 usługa została wycofana 9 lipca 2018 r. Więcej informacji znajdziesz w ogłoszeniu o wycofaniu funkcji. Wysokość nad elipsoidem odniesienia w metrach.
recordingDetails.recordingDate	datetime Data i godzina nagrania filmu. Wartość jest podawana 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ść, czas trwania, kodek audio i wideo, bitrate strumienia i inne. Tylko właściciel filmu może pobrać te dane. 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 widoczne 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 widoczne niezależnie od tego, czy przesłano plik wideo czy inny typ pliku.
fileDetails.fileType	string Typ przesłanego pliku wykryty przez mechanizm 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. Poprawne wartości tej właściwości to: archive – plik jest plikiem archiwum, np .archiwum ZIP. audio – plik jest znanym typem pliku audio, np .MP3. document – plik jest dokumentem lub plikiem tekstowym, np. dokumentem MS Word. image – plik jest plikiem graficznym, np. obrazem w formacie .jpeg. other – plik jest innego typu niż plik wideo. project – plik jest plikiem projektu wideo, na przykład projektem programu Microsoft Windows Movie Maker, który nie zawiera rzeczywistych danych wideo. video – plik jest plikiem wideo znanego typu, np. .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ść zakodowanego materiału wideo w pikselach. Współczynnik proporcji kodowania filmu można obliczyć jako width_pixels / height_pixels.
fileDetails.videoStreams[].heightPixels	unsigned integer Wysokość zakodowanego materiału wideo w pikselach.
fileDetails.videoStreams[].frameRateFps	double Liczba klatek strumienia wideo (w klatkach na sekundę).
fileDetails.videoStreams[].aspectRatio	double Format obrazu treści wideo, który określa format obrazu, w jakim film powinien być wyświetlany.
fileDetails.videoStreams[].codec	string Kodek wideo używany przez strumień.
fileDetails.videoStreams[].bitrateBps	unsigned long Szybkość transmisji bitów strumienia wideo (w bitach na sekundę).
fileDetails.videoStreams[].rotation	string Wartość, o którą YouTube musi obrócić oryginalny materiał źródłowy, aby prawidłowo wyświetlić film. Dopuszczalne wartości tej właściwości to: clockwise – film musi zostać obrócony o 90 stopni w prawo. counterClockwise – film musi zostać obrócony o 90 stopni w lewo. none – filmu nie trzeba obracać. other – film musi zostać obrócony w inny sposób. upsideDown – film musi być obrócony do góry nogami.
fileDetails.videoStreams[].vendor	string Wartość jednoznacznie identyfikująca dostawcę filmu. Zwykle jest to 4-literowy kod dostawcy.
fileDetails.audioStreams[]	list Lista strumieni audio zawartych w przesłanym pliku wideo. Każdy element na liście 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 bitów strumienia audio (w bitach na sekundę).
fileDetails.audioStreams[].vendor	string Wartość jednoznacznie identyfikująca dostawcę filmu. Zwykle jest to 4-literowy kod dostawcy.
fileDetails.durationMs	unsigned long Czas trwania przesłanego filmu w milisekundach.
fileDetails.bitrateBps	unsigned long Szybkość transmisji bitów (obrazu i dźwięku) przesłanego pliku wideo wyrażona w bitach na sekundę.
fileDetails.creationTime	string Data i godzina utworzenia przesłanego pliku wideo. Wartość jest określona w formacie ISO 8601. Obecnie obsługiwane są następujące formaty ISO 8601: Tylko data: YYYY-MM-DD Naiwny czas: YYYY-MM-DDTHH:MM:SS Czas z uwzględnieniem strefy czasowej: YYYY-MM-DDTHH:MM:SS+HH:MM
processingDetails	object Obiekt processingDetails zawiera informacje o postępie przetwarzania przesłanego pliku wideo przez YouTube. Właściwości w obiekcie wskazują bieżący stan przetwarzania oraz szacowany czas pozostały do zakończenia przetwarzania filmu przez YouTube. W tym miejscu możesz też sprawdzić, czy w przypadku filmu dostępne są różne typy danych lub treści, np. szczegóły pliku czy miniatury. Obiekt processingProgress jest przeznaczony do sondowania, aby przesłany film mógł śledzić postępy YouTube w przetwarzaniu przesłanego pliku wideo. Tylko właściciel filmu może pobrać te dane.
processingDetails.processingStatus	string Stan przetwarzania filmu. Ta wartość wskazuje, czy YouTube udało się przetworzyć film, czy jest on nadal przetwarzany. Dopuszczalne wartości tej właściwości to: failed – przetwarzanie filmu nie powiodło się. Informacje o przyczynie niepowodzenia przetwarzania znajdziesz w polu 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. Te wartości mają znaczenie tylko wtedy, gdy stan przetwarzania filmu to processing.
processingDetails.processingProgress.partsTotal	unsigned long Szacowana łączna liczba części, które należy przetworzyć w przypadku filmu. Podczas przetwarzania filmu liczba ta może zostać zaktualizowana i zastąpiona dokładniejszymi szacunkami.
processingDetails.processingProgress.partsProcessed	unsigned long Liczba części filmu, które YouTube przetworzył. Możesz oszacować odsetek filmu, który YouTube już przetworzył, wykonując obliczenia: 100 * parts_processed / parts_total Pamiętaj, że oszacowana liczba części może wzrosnąć bez odpowiedniego wzrostu liczby części, które zostały już przetworzone, więc możliwe jest, że obliczone postępy mogą okresowo spadać, gdy YouTube przetwarza film.
processingDetails.processingProgress.timeLeftMs	unsigned long Szacowany czas w milisekundach, jaki YouTube potrzebuje na przetworzenie filmu.
processingDetails.processingFailureReason	string Przyczyna, dla której YouTube nie mógł 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 – transkodowanie treści się nie powiodło. uploadFailed – nie udało się dostarczyć pliku.
processingDetails.fileDetailsAvailability	string Ta wartość wskazuje, czy szczegóły pliku przesłanego filmu są dostępne. Szczegóły pliku filmu możesz pobrać, wysyłając w prośbie fileDetails.videos.list()
processingDetails.processingIssuesAvailability	string Ta wartość wskazuje, czy mechanizm przetwarzania filmów wygenerował sugestie, które mogą poprawić przetwarzanie filmu przez YouTube, ostrzeżenia wyjaśniające problemy z przetwarzaniem filmu lub błędy powodujące problemy z przetwarzaniem filmu. Aby pobrać te sugestie, w prośbie videos.list() podaj część suggestions.
processingDetails.tagSuggestionsAvailability	string Ta wartość wskazuje, czy w przypadku 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. Aby pobrać te sugestie, w prośbie videos.list() podaj część suggestions.
processingDetails.editorSuggestionsAvailability	string Ta wartość wskazuje, czy w przypadku filmu dostępne są sugestie dotyczące edycji, które mogą poprawić jakość filmu lub odtwarzanie. Aby pobrać te sugestie, w prośbie videos.list() podaj część suggestions.
processingDetails.thumbnailsAvailability	string Ta wartość informuje, czy dla filmu wygenerowano miniatury.
suggestions	object Obiekt suggestions zawiera sugestie, które wskazują możliwości poprawy jakości filmu lub jego metadanych. Tylko właściciel filmu może pobrać te dane. 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żliwiają YouTube przetworzenie przesłanego filmu. Te błędy wskazują, że niezależnie od bieżącego stanu przetwarzania filmu, w końcu stanie się on failed. Dopuszczalne 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. dokumentu programu MS Word). imageFile – plik graficzny (np. JPEG). notAVideoFile – inny plik niebędący filmem. projectFile – plik projektu filmu (np. projektu programu Microsoft Windows Movie Maker).
suggestions.processingWarnings[]	list Lista powodów, dla których YouTube może mieć problemy z przekodowaniem przesłanego filmu lub które mogą spowodować błędne przekodowanie. Te ostrzeżenia są generowane, zanim YouTube przetworzy przesłany plik wideo. Ponadto identyfikują problemy, które niekoniecznie oznaczają, że przetwarzanie filmu zakończy się niepowodzeniem, 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 – sprzeczne rozdzielczości kontenera i strumienia. problematicAudioCodec – użyto kodeka audio, który powoduje 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 – nieznana kompresja wideo, transkodowanie prawdopodobnie się nie powiedzie.
suggestions.processingHints[]	list Lista sugestii, które mogą ułatwić YouTube przetwarzanie filmu. Dopuszczalne wartości tej właściwości to: nonStreamableMov – plik MP4 nie jest strumieniem, co spowolni przetwarzanie. sendBestQualityVideo – istnieje prawdopodobnie 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ą go 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 pasuje tag. Możesz użyć tych informacji, aby wyświetlić odpowiednie sugestie tagów na podstawie kategorii filmu, którą przesyłający z nią powiązał. Domyślnie sugestie tagów są trafne w przypadku wszystkich kategorii, jeśli nie ma żadnych ograniczeń dotyczących słowa kluczowego.
suggestions.editorSuggestions[]	list Lista operacji edycji wideo, które mogą poprawić jakość przesłanego filmu lub odtwarzanie. Dopuszczalne wartości tej właściwości to: audioQuietAudioSwap – ścieżka audio jest bez dźwięku i można ją zastąpić ścieżką o lepszej jakości. videoAutoLevels – poziomy jasności obrazu wydają się nieprawidłowe i mogą zostać skorygowane. videoCrop – marginesy (maty) wykryte wokół obrazu mogą zostać przycięte. videoStabilize – Film jest niestabilny i można go wygładzić.
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ącym, trwającym lub zakończonym programem na żywo.
liveStreamingDetails.actualStartTime	datetime Czas, w którym transmisja została faktycznie rozpoczęta. Wartość jest określona w formacie ISO 8601. Ta wartość będzie dostępna dopiero po rozpoczęciu transmisji.
liveStreamingDetails.actualEndTime	datetime Czas zakończenia transmisji. Wartość jest określona w formacie ISO 8601. Ta wartość będzie dostępna dopiero po zakończeniu transmisji.
liveStreamingDetails.scheduledStartTime	datetime Czas rozpoczęcia transmisji. Wartość jest określona w formacie ISO 8601.
liveStreamingDetails.scheduledEndTime	datetime Czas zakończenia transmisji. Wartość jest określona w formacie ISO 8601. Jeśli wartość jest pusta lub parametr jest nieobecny, transmisja jest zaplanowana na czas nieokreślony.
liveStreamingDetails.concurrentViewers	unsigned long Liczba widzów, którzy obecnie oglądają transmisję. Usługa i jej wartość będą obecne, jeśli transmisja ma obecnych 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 równocześnie oglądających transmisję. W związku z tym ta usługa nie podaje liczby widzów oglądających archiwalną wersję zakończonej już transmisji na żywo. Liczba jednoczesnych widzów zwracana przez interfejs YouTube Data API może różnić się od przetworzonej, pozbawionej spamu liczby jednoczesnych widzów dostępnej w Statystykach YouTube. Więcej informacji o danych dotyczących transmisji na żywo znajdziesz w Centrum pomocy YouTube.
liveStreamingDetails.activeLiveChatId	string Identyfikator aktualnie aktywnego czatu na żywo powiązanego z tym filmem. To pole jest wypełniane tylko wtedy, gdy film jest transmisją na żywo, która zawiera czat na żywo. Gdy transmisja zakończy się, to pole zostanie usunięte, a czat na żywo zamknięty. W przypadku transmisji na stałe identyfikator czatu na żywo nie będzie już powiązany z tym filmem, ale z nowym filmem wyświetlanym na stronie trwał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 zgodny ze standardem BCP-47.
localizations.(key).title	string Zlokalizowany tytuł filmu.
localizations.(key).description	string Przetłumaczony opis filmu.