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 do listy określonych filmów. Wypróbuj teraz

list

Zwraca listę filmów pasujących do parametrów żądania do 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 [stawka]

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

reportAbuse

Zgłoś film, w którym znajdują się nieodpowiednie treści. Wypróbuj teraz

Reprezentacja zasobu

Struktura JSON poniżej 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łaściwości występujące w tym zasobie 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 wskazywać 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 takim przypadku każda osoba, która zna unikalny identyfikator filmu, może pobrać metadane filmu. Wartość jest podana 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ą jest obiekt zawierający inne informacje o miniaturze.
snippet.thumbnails.(key)	object Prawidłowe wartości klucza: default – domyślna miniatura. Domyślna miniatura filmu – lub zasób należący do filmu, taki jak element playlisty lub wynik wyszukiwania – ma 120 pikseli szerokości i 90 pikseli wysokości. 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 powiązanego z filmem) obraz ma 320 pikseli szerokości i 180 pikseli wysokości. 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 odniesienia do filmu) obraz ma 480 pikseli szerokości i 360 pikseli wysokości. W przypadku kanału ten obraz ma 800 pikseli szerokości i 800 pikseli wysokości. standard – wersja obrazu miniatury o 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 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 związanych z filmami, 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 spację, serwer interfejsu API obsługuje jego wartość tak, jakby była ona umieszczona w cudzysłowie. Dodatkowo cudzysłowy są wliczane 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ącym lub trwającym programem na żywo. Dozwolone wartości tej właściwości to: live none upcoming
snippet.defaultLanguage	string Język tekstu we właściwościach 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 metadanych filmu. Zlokalizowany tekst jest zwracany w fragmentach zasobów, jeśli żądanie videos.list używa parametru hl, aby określić język, 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. Do dodawania, aktualizowania i usuwania zlokalizowanych tytułów używaj 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 jeden dzień, litery P i T są rozdzielone, a wartość ma format P#DT#H#M#S. Szczegółowe informacje można znaleźć 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 do filmu są dostępne napisy. Prawidłowe 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 zgłoszone 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ł właściwość contentDetails.regionRestriction.allowed lub contentDetails.regionRestriction.blocked.
contentDetails.regionRestriction.allowed[]	list Lista kodów regionów identyfikujących 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 będzie 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, film jest widoczny w tym 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 otrzymane przez film w ramach różnych systemów oceny.
contentDetails.contentRating.acbRating	string Ocena filmu wydana przez Australian Communications and Media Authority (ACMA) lub Australian Classification Board (ACB). Oceny ACMA służą do klasyfikowania programów telewizyjnych dla dzieci. Dopuszczalne 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 (oprócz przedszkolaków), 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 Anatel (Asociación Nacional de Televisión) dla chilijskiej telewizji. Prawidłowe 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+ bmukk14 – 14 lat i więcej bmukk16 – 16 lat i starsze bmukk6 – 6 i więcej bmukk8 – 8+ bmukkAa – bez ograniczeń bmukkUnrated
contentDetails.contentRating.catvRating	string System oceniania kanadyjskiej telewizji – kanadyjski system klasyfikacji telewizyjnej Ocena filmu wydana przez Kanadyjską Komisję ds. Radia, Telewizji i Telekomunikacji (CRTC) w przypadku 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+ catvfr8plus – 8+ catvfrG – G catvfrUnrated
contentDetails.contentRating.cbfcRating	string Ocena filmu (Central Board of Film Certification, CBFC – Indie). Prawidłowe wartoś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 więcej 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 według rumuńskiej organizacji 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 ocen we Francji – Commission de classification cinematographique Dostępne 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–czw. 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–Alabama 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+ ecbmct15a – 15A ecbmct15plus – 15 lat i starsze ecbmct18plus – 18 lat i starsze ecbmct7a – 7A ecbmct7plus – 7+ ecbmctG – G ecbmctUnrated ecbmct6a – 6A ecbmct6plus–6 lub 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 ocen. Prawidłowe wartości dla tej właściwości to: eirinG – G eirinPg12 – PG-12 eirinR15plus – R15+ eirinR18plus – R18+ eirinUnrated
contentDetails.contentRating.fcbmRating	string Ocena filmu przyznana malezyjskiej komisji Censorship Board (Film Censorship Board). 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's 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 właściwość została wycofana 2 listopada 2015 r. Użyj właściwości contentDetails.contentRating.cncRating. Ocena filmu's Centre National du cinéma et de l'image animé (francuskie Ministerstwo Kultury) 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–9 PG fpbA – A fpbPg – PG fpbUnrated fpbX18 – X18 fpbXx – XX
contentDetails.contentRating.fpbRatingReasons[]	list Przyczyny, dla których film otrzymał ocenę FPB (Republika Południowej Afryki).
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. Prawidłowe wartości dla tej właściwości to: grfilmE – E grfilmK – K grfilmK12 – szkoły podstawowe i średnie grfilmK13 – K-13 grfilmK15–szkoły podstawowe i średnie grfilmK17 – K-17 grfilmK18–szkoły podstawowe i średnie grfilmUnrated
contentDetails.contentRating.icaaRating	string Ocena filmu według Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA – Hiszpania). 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. 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. 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 – dostawca technologii reklamowych (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 (영상물등급위원회) dla filmu. KMRB ocenia filmy w Korei Południowej. Prawidłowe wartości dla tej usługi to: kmrb12plus – 12세 이상 관람가 kmrb15plus – 15세 이상 관람가 kmrbAll – 전체관람가 kmrbR – 청소년 관람불가 kmrbTeenr kmrbUnrated
contentDetails.contentRating.lsfRating	string Ocena filmu według indonezyjskiej organizacji 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 roku. 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 przyznana przez Radę Mediów dla Dzieci i Młodzieży (Det Danske Filminstitut) przynależną do Duńskiego Instytutu Filmowego (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 nadana 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 – Zablokowane mocE – E mocT – T mocUnrated mocX – X
contentDetails.contentRating.moctwRating	string Ocena filmu ustalona 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 (zielony pasek – zatwierdzone dla wszystkich odbiorców) 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 na Malediwach. Dozwolone wartości tej właściwości to: nbc12plus – 12 lat i starsze nbc15plus – 15 lat i starsze nbc18plus – 18 lat i starsze nbc18plusr–18+ 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 nigeryjską komisję cenzury filmów i telewizji. 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 przyznawana przez Nacionălais Kinocentrs (Narodowe Centrum Filmowe na Łotwie). Prawidłowe wartości tej właściwości to: nkclv12plus – 12 lat i starsze nkclv18plus – 18 lat i starsze nkclv7plus – 7+ nkclvU – U nkclvUnrated
contentDetails.contentRating.oflcRating	string Ocena OFLC (Office of Film and Literature Classification) filmu. Prawidłowe wartości dla 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. Prawidłowe wartości dla 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 to: 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 lub więcej russia12 – 12+ 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 wyświetlania filmu. Prawidłowe wartości tej właściwości to: 360 rectangular
contentDetails.hasCustomThumbnail	boolean Wskazuje, czy przesyłający udostępnił obraz niestandardowej miniatury filmu. Ta właściwość jest widoczna tylko dla osoby, która przesłał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. Prawidłowe wartości tej usługi to: 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 informacjach 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 atrybutu privacyStatus z private na public.
status.license	string Licencja na film. Prawidłowe wartości w przypadku tej usługi 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 takie dane jak liczba 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 do interfejsu API.
status.containsSyntheticMedia	boolean W żądaniu videos.insert lub videos.update ta właściwość umożliwia właścicielowi kanału poinformowanie, że film zawiera realistyczne treści zmodyfikowane lub syntetyczne (A/S). Dowiedz się więcej o zasadach YouTube dotyczących treści związanych z A/S. Przykłady treści A/S to filmy, które: treści, które przedstawiają prawdziwą osobę, która mówi lub robi coś, czego wcale nie powiedziała ani nie zrobiła; zmodyfikować materiał przedstawiający prawdziwe wydarzenie lub miejsce; tworzy 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.
statistics.likeCount	unsigned long Liczba użytkowników, którzy wyrazili swoją aprobatę dla filmu.
statistics.dislikeCount	unsigned long Uwaga: 13 grudnia 2021 r. usługa statistics.dislikeCount została ustawiona jako prywatna. Oznacza to, że właściwość jest uwzględniona 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 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 wartość 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 umieszcza odtwarzacz, na którym można odtworzyć film. Jeśli żądanie interfejsu API służące do pobierania zasobu określa wartość parametru 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ść umieszczonego odtwarzacza zwróconego 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 znana proporcja obrazu.
player.embedWidth	long Szerokość umieszczonego odtwarzacza zwróconego we właściwości 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 usługa 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 Ameryki Łacińskiej /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 przygodowo-zręcznościowa /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 Wikipedii, które zawierają ogólny opis treści 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. 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, który został przesłany do YouTube, w tym jego rozdzielczość, czas trwania, kodeki audio i wideo, szybkość transmisji bitów strumienia i inne informacje. 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ść zakodowanej treści 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 być obrócony o 90 stopni w prawo. counterClockwise – film musi być 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 w transmisji.
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 podawana 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 w YouTube. Właściwości w obiekcie wskazują bieżący stan przetwarzania oraz szacunkowy 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 wykonywania ankiet. Dzięki temu można ś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 też 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 dotyczące przetwarzania nie są już dostępne.
processingDetails.processingProgress	object Obiekt processingProgress zawiera informacje o postępach YouTube w przetwarzaniu filmu. 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 już 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 zwiększenia 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 Powód, dla którego nie udało się przetworzyć filmu w YouTube. 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 osób transmitujących na żywo. 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 dotyczące przesłanego filmu są dostępne. Szczegóły pliku filmu możesz pobrać, wysyłając w prośbie videos.list() część videos.list().
processingDetails.processingIssuesAvailability	string Ta wartość wskazuje, czy mechanizm 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 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 danego filmu są dostępne sugestie zmian, które mogą poprawić jego jakość lub wygodę odtwarzania. Aby uzyskać te sugestie, poproś o częścią suggestions w swojej prośbie o videos.list().
processingDetails.thumbnailsAvailability	string Ta wartość wskazuje, czy dla filmu zostały wygenerowane 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 inny niż wideo. 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. Ostrzeżenia te pojawiają się, 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. Dopuszczalne wartości tej właściwości to: hasEditlist – edytowanie list nie jest obecnie obsługiwane. inconsistentResolution – konflikt 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 propozycje 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 danego słowa kluczowego.
suggestions.editorSuggestions[]	list Lista operacji edycji filmu, 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 (matowe) wykryte wokół zdjęcia mogą zostać przycięte. videoStabilize – obraz wydaje się drżący, może być ustabilizowany.
liveStreamingDetails	object Obiekt liveStreamingDetails zawiera metadane dotyczące transmisji wideo na żywo. Obiekt będzie widoczny w zasobie video tylko wtedy, gdy materiał wideo jest zbliżającym się, transmitowanym lub zakończonym transmisją na żywo.
liveStreamingDetails.actualStartTime	datetime Godzina rozpoczęcia transmisji. Wartość jest określona w formacie ISO 8601. Ta wartość nie będzie dostępna do czasu rozpoczęcia transmisji.
liveStreamingDetails.actualEndTime	datetime Czas zakończenia transmisji. Wartość jest podana w formacie ISO 8601. Ta wartość będzie dostępna dopiero po zakończeniu transmisji.
liveStreamingDetails.scheduledStartTime	datetime Godzina rozpoczęcia transmisji. Wartość jest podawana w formacie ISO 8601.
liveStreamingDetails.scheduledEndTime	datetime Czas zakończenia transmisji. Wartość jest podawana w formacie ISO 8601. Jeśli wartość jest pusta lub brakuje właściwości, transmisja jest zaplanowana na czas nieokreślony.
liveStreamingDetails.concurrentViewers	unsigned long Liczba widzów, którzy obecnie oglądają transmisję. Właściwość i jej wartość będą dostępne, jeśli aktualnie oglądają transmisję, a właściciel transmisji nie ukrył liczby wyświetleń filmu. Pamiętaj, że YouTube przestaje monitorować liczbę równoczesnych widzów transmisji po jej zakończeniu. Nie określa więc liczby widzów, którzy oglądają zarchiwizowany film trwającej 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 obecnie nadawany na żywo i ma czat na żywo. Gdy transmisja zakończy się, to pole zostanie usunięte, a czat na żywo zamknięty. W przypadku transmisji trwałych 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ść jest ciągiem znaków zawierającym kod języka BCP-47.
localizations.(key).title	string Zlokalizowany tytuł filmu.
localizations.(key).description	string Przetłumaczony opis filmu.