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
    ]
  },
  "liveDetails": {
    "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
kindstring
Określa typ zasobu interfejsu API. Wartość będzie wynosić youtube#video.
etagetag
Etag tego zasobu.
idstring
Identyfikator, którego YouTube używa do jednoznacznej identyfikacji filmu.
snippetobject
Obiekt snippet zawiera podstawowe informacje o filmie, takie jak tytuł, opis i kategoria.
snippet.publishedAtdatetime
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.channelIdstring
Identyfikator używany przez YouTube do jednoznacznej identyfikacji kanału, na który został przesłany film.
snippet.titlestring
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.descriptionstring
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.thumbnailsobject
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).urlstring
Adres URL obrazu.
snippet.thumbnails.(key).widthunsigned integer
Szerokość obrazu.
snippet.thumbnails.(key).heightunsigned integer
Wysokość obrazu.
snippet.channelTitlestring
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.categoryIdstring
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.liveBroadcastContentstring
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.defaultLanguagestring
Język tekstu w atrybutach snippet.titlesnippet.description zasobu video.
snippet.localizedobject
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.titlestring
Zlokalizowany tytuł filmu.
snippet.localized.descriptionstring
Przetłumaczony opis filmu.
snippet.defaultAudioLanguagestring
Właściwość default_audio_language określa język domyślnej ścieżki dźwiękowej filmu.
contentDetailsobject
Obiekt contentDetails zawiera informacje o treści filmu, w tym jego długość i wskazanie, czy do filmu są dostępne napisy.
contentDetails.durationstring
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 MS 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 PT są rozdzielone, a wartość ma format P#DT#H#M#S. Szczegółowe informacje znajdziesz w specyfikacji ISO 8601.
contentDetails.dimensionstring
Wskazuje, czy film jest dostępny w 3D czy 2D.
contentDetails.definitionstring
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.captionstring
Wskazuje, czy w filmie są dostępne napisy.

Dozwolone wartości tej właściwości to:
  • false
  • true
contentDetails.licensedContentboolean
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.regionRestrictionobject
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.contentRatingobject
Określa oceny, jakie otrzymał film w ramach różnych systemów oceny.
contentDetails.contentRating.acbRatingstring
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.agcomRatingstring
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.anatelRatingstring
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.bbfcRatingstring
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.bfvcRatingstring
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.bmukkRatingstring
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.catvRatingstring
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.catvfrRatingstring
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.cbfcRatingstring
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.cccRatingstring
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.cceRatingstring
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.chfilmRatingstring
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.chvrsRatingstring
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.cicfRatingstring
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.cnaRatingstring
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.cncRatingstring
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.csaRatingstring
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.cscfRatingstring
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.czfilmRatingstring
Ocena filmu w Czechach.

Dozwolone wartości tego atrybutu:
  • czfilm12 – 12
  • czfilm14 – 14
  • czfilm18 – 18
  • czfilmU – U
  • czfilmUnrated
contentDetails.contentRating.djctqRatingstring
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.ecbmctRatingstring
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.eefilmRatingstring
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.egfilmRatingstring
Ocena filmu w Egipcie.

Dozwolone wartości tej właściwości to:
  • egfilm18 – 18
  • egfilmBn – BN
  • egfilmGn – GN
  • egfilmUnrated
contentDetails.contentRating.eirinRatingstring
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.fcbmRatingstring
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.fcoRatingstring
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.fmocRatingstring
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.fpbRatingstring
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.fskRatingstring
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.grfilmRatingstring
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.icaaRatingstring
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.ifcoRatingstring
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.ilfilmRatingstring
Ocena filmu w Izraelu.

Dozwolone wartości tej właściwości to:
  • ilfilm12 – 12
  • ilfilm16 – 16
  • ilfilm18 – 18
  • ilfilmAa – AA
  • ilfilmUnrated
contentDetails.contentRating.incaaRatingstring
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.kfcbRatingstring
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.kijkwijzerRatingstring
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.kmrbRatingstring
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.lsfRatingstring
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.mccaaRatingstring
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.mccypRatingstring
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.mcstRatingstring
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.mdaRatingstring
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.medietilsynetRatingstring
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.mekuRatingstring
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.mibacRatingstring
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.mocRatingstring
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.moctwRatingstring
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.mpaaRatingstring
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.mpaatRatingstring
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.mtrcbRatingstring
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.nbcRatingstring
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.nfrcRatingstring
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.nfvcbRatingstring
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.nkclvRatingstring
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.oflcRatingstring
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.pefilmRatingstring
Ocena filmu w Peru.

Dozwolone wartości tej właściwości to:
  • pefilm14 – 14
  • pefilm18 – 18
  • pefilmPg – PG
  • pefilmPt – PT
  • pefilmUnrated
contentDetails.contentRating.resorteviolenciaRatingstring
Ocena filmu w Wenezueli.

Dozwolone wartości tego atrybutu to:
  • resorteviolenciaA – A
  • resorteviolenciaB – B
  • resorteviolenciaC – C
  • resorteviolenciaD – D
  • resorteviolenciaE – E
  • resorteviolenciaUnrated
contentDetails.contentRating.rtcRatingstring
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.rteRatingstring
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.russiaRatingstring
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.skfilmRatingstring
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.smaisRatingstring
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.smsaRatingstring
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.tvpgRatingstring
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.ytRatingstring
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.projectionstring
Określa format projekcji filmu.

Dopuszczalne wartości tej właściwości to:
  • 360
  • rectangular
contentDetails.hasCustomThumbnailboolean
Wskazuje, czy przesyłający film udostępnił niestandardową miniaturę filmu. Ta usługa jest widoczna tylko dla osoby, która przesyła film.
statusobject
Obiekt status zawiera informacje o przesyłaniu, przetwarzaniu i prywatności filmu.
status.uploadStatusstring
Stan przesłanego filmu.

Dozwolone wartości tej właściwości to:
  • deleted
  • failed
  • processed
  • rejected
  • uploaded
status.failureReasonstring
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.rejectionReasonstring
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.privacyStatusstring
Stan prywatności filmu.

Dozwolone wartości tej właściwości:
  • private
  • public
  • unlisted
status.publishAtdatetime
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 privacyStatusprivate na public.
status.licensestring
Licencja filmu.

Dozwolone wartości tej właściwości to:
  • creativeCommon
  • youtube
status.embeddableboolean
Ta wartość wskazuje, czy film może być umieszczany w innej witrynie.
status.publicStatsViewableboolean
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.madeForKidsboolean
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.selfDeclaredMadeForKidsboolean
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.containsSyntheticMediaboolean
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.
statisticsobject
Obiekt statistics zawiera statystyki dotyczące filmu.
statistics.viewCountunsigned 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.likeCountunsigned long
Liczba użytkowników, którzy wyrazili swoją aprobatę dla filmu.
statistics.dislikeCountunsigned 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.favoriteCountunsigned 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.commentCountunsigned long
Liczba komentarzy do filmu.
paidProductPlacementDetailsobject
Obiekt paidProductPlacementDetails zawiera informacje o płatnym lokowaniu produktu w filmie.
paidProductPlacementDetails.hasPaidProductPlacementboolean
Ustaw na true, jeśli treści zawierają płatne lokowanie produktu. Domyślna wartość to false.
playerobject
Obiekt player zawiera informacje, których używasz do odtwarzania filmu w odtwarzaczu umieszczonym na stronie internetowej.
player.embedHtmlstring
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.embedHeightlong
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.embedWidthlong
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.
topicDetailsobject
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[]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.

topicDetails.topicCategories[]list
Lista adresów URL stron w Wikipedii, które opisują ogólnie treść filmu.
recordingDetailsobject
Obiekt recordingDetails zawiera informacje o lokalizacji, dacie i adresie, w których nagrano film.
recordingDetails.locationDescriptionstring
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.locationobject
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.latitudedouble
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.longitudedouble
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.altitudedouble
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.recordingDatedatetime
Data i godzina nagrania filmu. Wartość jest podawana w formacie ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ).
fileDetailsobject
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.fileNamestring
Nazwa przesłanego pliku. To pole jest widoczne niezależnie od tego, czy przesłano plik wideo czy inny typ pliku.
fileDetails.fileSizeunsigned 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.fileTypestring
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.containerstring
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[].widthPixelsunsigned integer
Szerokość zakodowanego materiału wideo w pikselach. Współczynnik proporcji kodowania filmu można obliczyć jako width_pixels / height_pixels.
fileDetails.videoStreams[].heightPixelsunsigned integer
Wysokość zakodowanego materiału wideo w pikselach.
fileDetails.videoStreams[].frameRateFpsdouble
Liczba klatek strumienia wideo (w klatkach na sekundę).
fileDetails.videoStreams[].aspectRatiodouble
Format obrazu treści wideo, który określa format obrazu, w jakim film powinien być wyświetlany.
fileDetails.videoStreams[].codecstring
Kodek wideo używany przez strumień.
fileDetails.videoStreams[].bitrateBpsunsigned long
Szybkość transmisji bitów strumienia wideo (w bitach na sekundę).
fileDetails.videoStreams[].rotationstring
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[].vendorstring
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[].channelCountunsigned integer
Liczba kanałów audio, które zawiera strumień.
fileDetails.audioStreams[].codecstring
Kodek audio używany przez strumień.
fileDetails.audioStreams[].bitrateBpsunsigned long
Szybkość transmisji bitów strumienia audio (w bitach na sekundę).
fileDetails.audioStreams[].vendorstring
Wartość jednoznacznie identyfikująca dostawcę filmu. Zwykle jest to 4-literowy kod dostawcy.
fileDetails.durationMsunsigned long
Czas trwania przesłanego filmu w milisekundach.
fileDetails.bitrateBpsunsigned long
Szybkość transmisji bitów (obrazu i dźwięku) przesłanego pliku wideo wyrażona w bitach na sekundę.
fileDetails.creationTimestring
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
processingDetailsobject
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.processingStatusstring
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.processingProgressobject
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.partsTotalunsigned 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.partsProcessedunsigned 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.timeLeftMsunsigned long
Szacowany czas w milisekundach, jaki YouTube potrzebuje na przetworzenie filmu.
processingDetails.processingFailureReasonstring
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.
  • Failed – 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.fileDetailsAvailabilitystring
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.processingIssuesAvailabilitystring
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.tagSuggestionsAvailabilitystring
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.editorSuggestionsAvailabilitystring
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.thumbnailsAvailabilitystring
Ta wartość informuje, czy dla filmu wygenerowano miniatury.
suggestionsobject
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[].tagstring
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ć.
liveDetailsobject
Obiekt liveDetails 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.
liveDetails.actualStartTimedatetime
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.
liveDetails.actualEndTimedatetime
Czas zakończenia transmisji. Wartość jest określona w formacie ISO 8601. Ta wartość będzie dostępna dopiero po zakończeniu transmisji.
liveDetails.scheduledStartTimedatetime
Czas rozpoczęcia transmisji. Wartość jest określona w formacie ISO 8601.
liveDetails.scheduledEndTimedatetime
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.
liveDetails.concurrentViewersunsigned 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.
liveDetails.activeLiveChatIdstring
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.
localizationsobject
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).titlestring
Zlokalizowany tytuł filmu.
localizations.(key).descriptionstring
Przetłumaczony opis filmu.