Videos

Wszystkie filmy przesłane przez punkt końcowy videos.insert z niezweryfikowanych projektów API utworzonych po 28 lipca 2020 r. będą ograniczone do trybu wyświetlania prywatnego. Aby znieść to ograniczenie, każdy projekt API musi poddać się kontroli w celu zweryfikowania zgodności 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 w przypadku zasobów videos:

getRating,
Pobiera oceny, które autoryzował użytkownik z 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
wstaw
Przesyła film do YouTube i opcjonalnie ustawia jego metadane.
aktualizacja
Aktualizuje metadane filmu. Wypróbuj teraz
usuń
Usuwa film z YouTube. Wypróbuj teraz
rate [stawka]
Możesz dodać ocenę filmu lub ocenę „Nie podoba mi się” lub usunąć ocenę z filmu. Wypróbuj teraz
zgłoś nadużycie
Zgłoś film, który zawiera nieodpowiednie treści. Wypróbuj teraz

Reprezentacja zasobu

Poniższa struktura JSON 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
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "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

Poniższa tabela definiuje właściwości, które pojawiają się w tym zasobie:

Właściwości
kind string
Określa typ zasobu API. Wartością będzie youtube#video.
etag etag
Tag 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 publikacji filmu. Pamiętaj, że ta godzina może być inna niż data przesłania filmu. Jeśli na przykład film zostanie przesłany jako prywatny, a później upubliczniony, ta właściwość określa czas jego upublicznienia.

Istnieje kilka szczególnych przypadków:
  • Jeśli film został przesłany jako prywatny, a właściciel kanału pobrał metadane, to wartość właściwości określa datę i godzinę przesłania filmu.
  • Jeśli film jest przesyłany jako film niepubliczny, wartość właściwości określa też datę i godzinę przesłania. W takim przypadku każdy, kto zna unikalny identyfikator filmu, będzie mógł pobrać metadane filmu.
Wartość należy podać w formacie ISO 8601.
snippet.channelId string
Identyfikator, na podstawie którego YouTube jednoznacznie identyfikuje kanał, 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 znaków < i >. Ustaw wartość dla tej właściwości, jeśli wywołujesz metodę videos.update i aktualizujesz część snippet zasobu video.
snippet.description string
Opis filmu. Wartość właściwości nie może przekraczać 5000 bajtów i może zawierać wszystkie prawidłowe znaki UTF-8 oprócz < oraz >.
snippet.thumbnails object
Mapa miniatur powiązanych z filmem Kluczem dla każdego obiektu na mapie jest nazwa miniatury obrazu, a wartością jest obiekt zawierający pozostałe informacje na temat miniatury.
snippet.thumbnails.(key) object
Prawidłowe pary klucz-wartość to:
  • default – domyślny obraz miniatury. Domyślna miniatura filmu – lub zasób, który odnosi się do filmu, np. 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 o wyższej rozdzielczości. W przypadku filmu (lub zasobu, który odnosi się do filmu) obraz ma szerokość 320 pikseli i wysokość 180 pikseli. W przypadku kanału obraz ma szerokość 240 pikseli i wysokość 240 pikseli.
  • high – wersja miniatury w wysokiej rozdzielczości. W przypadku filmu (lub zasobu, który odnosi się do filmu) obraz ma szerokość 480 pikseli i wysokość 360 pikseli. W przypadku kanału obraz ma szerokość 800 pikseli i wysokość 800 pikseli.
  • standard – wersja miniatury w wyższej rozdzielczości niż w przypadku obrazu w rozdzielczości high. Obraz jest dostępny w przypadku niektórych filmów i innych zasobów, które odnoszą się do filmów, takich jak pozycje playlist czy wyniki wyszukiwania. Ten obraz ma szerokość 640 pikseli i wysokość 480 pikseli.
  • maxres – wersja miniatury w najwyższej rozdzielczości. Ten rozmiar obrazu jest dostępny w przypadku niektórych filmów i innych zasobów odnoszących się do filmów, takich jak elementy playlist 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, z którego pochodzi 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. Podczas obliczania limitu znaków należy pamiętać o następujących regułach:
  • Wartością właściwości jest lista, a przecinki między elementami na liście pomniejszają limit.
  • Jeśli tag zawiera spację, serwer interfejsu API obsługuje jego wartość tak, jakby była ona ujęta w cudzysłowy. Cudzysłowy są uwzględniane w limicie znaków. Dlatego na potrzeby limitów znaków tag Foo-Baz zawiera siedem znaków, ale tag Foo Baz – dziewięć.
snippet.categoryId string
Kategoria filmu YouTube powiązana z filmem. Jeśli wywołujesz 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ą czy aktywną transmisją na żywo. Jeśli film nie jest nadchodzącą/aktywną transmisją na żywo, wartość może mieć też wartość „none”.

Prawidłowe wartości tej właściwości to:
  • live
  • none
  • upcoming
snippet.defaultLanguage string
Język tekstu we właściwościach snippet.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 we fragmencie kodu zasobu, jeśli w żądaniu videos.list użyto parametru hl do określenia języka, dla którego ma być zwracany zlokalizowany tekst oraz jest w nim dostępny.
  • Metadane dla języka domyślnego są zwracane, jeśli wartość parametru hl nie została określona lub określono wartość, ale zlokalizowane metadane nie są dostępne dla wybranego języka.
Właściwość zawiera wartość tylko do odczytu. Za pomocą obiektu localizations możesz dodawać, aktualizować i usuwać zlokalizowane tytuły.
snippet.localized.title string
Zlokalizowany tytuł filmu.
snippet.localized.description string
Zlokalizowany opis filmu.
snippet.defaultAudioLanguage string
Właściwość default_audio_language określa język, który jest używany na domyślnej ścieżce audio filmu.
contentDetails object
Obiekt contentDetails zawiera informacje o treści wideo, m.in. długość filmu oraz informację o tym, czy dla danego filmu dostępne są napisy.
contentDetails.duration string
Długość filmu. Wartością właściwości jest czas trwania zgodny z normą ISO 8601. Na przykład film, który trwa co najmniej minutę, ale nie trwa dłużej niż godzinę, jest w formacie PT#M#S, w którym litery PT oznaczają przedział czasu, a litery M i S oznaczają długość odpowiednio w minutach i sekundach. Znaki # przed literami M i S są liczbami całkowitymi, które określają liczbę minut (lub sekund) filmu. Na przykład wartość PT15M33S oznacza, że film trwa 15 minut i 33 sekundy.

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

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

Prawidłowe wartości tej właściwości to:
  • false
  • true
contentDetails.licensedContent boolean
Wskazuje, czy film przedstawia licencjonowane treści. Oznacza to, że materiał został przesłany na kanał połączony z kontem partnera YouTube, a potem roszczenie zgłosił ten partner.
contentDetails.regionRestriction object
Obiekt regionRestriction zawiera informacje o krajach, w których film jest (lub nie) można oglądać. Obiekt będzie zawierać właściwość contentDetails.regionRestriction.allowed lub contentDetails.regionRestriction.blocked.
contentDetails.regionRestriction.allowed[] list
Lista kodów regionów określających kraje, w których film jest dostępny. Jeśli istnieje ta właściwość, a kraj nie jest wymieniony w jej wartości, film zostanie zablokowany w tym kraju. Jeśli ta właściwość występuje, a lista jest pusta, film jest zablokowany we wszystkich krajach.
contentDetails.regionRestriction.blocked[] list
Lista kodów regionów określających kraje, w których film jest zablokowany. Jeśli istnieje ta właściwość, a kraj nie jest wymieniony w jej wartości, film jest dostępny w tym kraju. Jeśli ta właściwość występuje i zawiera pustą listę, film jest dostępny we wszystkich krajach.
contentDetails.contentRating object
Określa oceny, jakie film otrzymał w ramach różnych systemów ocen.
contentDetails.contentRating.acbRating string
Ocena filmu podana przez organizację Australian Classification Board (ACB) lub Australian Communications and Media Authority (ACMA). Oceny ACMA służą do klasyfikowania programów telewizyjnych dla dzieci.

Prawidłowe wartości tej właściwości to:
  • acbC – programy, które otrzymały klasyfikację C 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 przez Australian Communications and Media Authority. Programy te są przeznaczone dla dzieci w wieku przedszkolnym.
  • acbPg – PG
  • acbR18plus–18 ZAR
  • acbUnrated
contentDetails.contentRating.agcomRating string
Ocena filmu przyznana przez włoskie biuro Autorità per le Garanzie nelle Comunicazioni (AGCOM).

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

Prawidłowe wartości dla tej właściwości to:
  • anatelA – A
  • anatelF – F
  • anatelI – I
  • anatelI10 – I-10
  • anatelI12 – I-12
  • anatelI7 – I-7
  • anatelR–P
  • anatelUnrated
contentDetails.contentRating.bbfcRating string
Ocena filmu wskazana przez organizację British Board of Film Classification (BBFC).

Prawidłowe wartości tej właściwości to:
  • bbfc12 – 12
  • bbfc12a – 12A
  • bbfc15 – 15
  • bbfc18 – 18
  • bbfcPg – PG
  • bbfcR18–18 ZAR
  • bbfcU – U
  • bbfcUnrated
contentDetails.contentRating.bfvcRating string
Ocena filmu przyznawana przez tajlandzką radę ds. cenzury filmowej i filmowej.

Prawidłowe wartości dla 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 przyznawana przez austriacką komisję klasyfikacji mediów (Bundesministerium für Unterricht, Kunst und Kultur).

Prawidłowe wartości tej właściwości to:
  • bmukk10–10 lub niżej
  • bmukk12 – 12 lat i więcej
  • bmukk14 – 14 lat i więcej
  • bmukk16 – 16+
  • bmukk6–6 lub więcej
  • bmukk8 – 8 lub więcej
  • bmukkAa – nieograniczony
  • bmukkUnrated
contentDetails.contentRating.catvRating string
System oceny kanadyjskiej telewizji – kanadyjski system klasyfikacji telewizji Ocena filmu przyznawana przez Kanadyjską Komisję ds. Telewizji i Telekomunikacji (Kanadyjska Komisja ds. Telewizji i Telekomunikacji) dotycząca kanadyjskich audycji w języku angielskim. Więcej informacji znajdziesz na stronie Canadian Broadcast Standards Council.

Prawidłowe wartości tej właściwości to:
  • catv14plus – 14 lat i więcej
  • catv18plus – 18 lat i więcej
  • catvC – C
  • catvC8 – C8
  • catvG – G
  • catvPg – PG
  • catvUnrated
contentDetails.contentRating.catvfrRating string
Ocena filmu przyznawana przez Kanadyjską Komisję ds. Radia i Telekomunikacji (CRTC) dla audycji w języku francuskim. Więcej informacji znajdziesz na stronie Canadian Broadcast Standards Council.

Prawidłowe wartości tej właściwości to:
  • catvfr13plus – 13 lat i więcej
  • catvfr16plus – 16+
  • catvfr18plus – 18 lat i więcej
  • catvfr8plus – 8 lub więcej
  • catvfrG – G
  • catvfrUnrated
contentDetails.contentRating.cbfcRating string
Ocena filmu wskazana przez Central Board of Film Certification (CBFC – India).

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

Prawidłowe wartości dla tej właściwości to:
  • ccc14 – 14 lat i więcej
  • ccc18 – 18 lat i więcej
  • ccc18s – 18+ – contenido pornográfico
  • ccc18v – od 18 lat – contenido excesivamente Udostępnij przemoc
  • ccc6 – od 6 lat – Niedogodność para menores de 7 años
  • cccTe – Todo espectador
  • cccUnrated
contentDetails.contentRating.cceRating string
Ocena filmu przyznana przez portugalskiego Comissão de Classificação de Espect ’culos.

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

Prawidłowe wartości dla tej właściwości to:
  • chfilm0 – 0
  • chfilm12 – 12
  • chfilm16 – 16
  • chfilm18 – 18
  • chfilm6 – 6
  • chfilmUnrated
contentDetails.contentRating.chvrsRating string
Ocena filmu podana w kanadyjskim systemie CHVRS (Canadian Home Video Rating System).

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

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

Prawidłowe wartości dla tej właściwości to:
  • cna12 – 12
  • cna15 – 15
  • cna18 – 18
  • cna18plus – 18 lat i więcej
  • cnaAp – AP
  • cnaUnrated
contentDetails.contentRating.cncRating string
System ocen we Francji – prowizja od klasyfikacji Cinematographique

Prawidłowe wartości dla 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 przyznawana przez francuską agencję Conseil supérieur de l?audiovisuel, która ocenia treści transmitowane.

Prawidłowe wartości dla tej właściwości to:
  • csa10 – 10
  • csa12 – 12
  • csa16 – 16
  • csa18 – 18
  • csaInterdiction – przerwa
  • csaT – T
  • csaUnrated
contentDetails.contentRating.cscfRating string
Ocena filmu przyznana przez luksemburską Komisję de surveillance de laClassification des films (CSCF).

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

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

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

Prawidłowe wartości dla tej nieruchomości to:
  • ecbmct13a – 13A
  • ecbmct13plus – 13 lat i więcej
  • ecbmct15a – 15A
  • ecbmct15plus – 15 lat i więcej
  • ecbmct18plus – 18 lat i więcej
  • ecbmct7a – 7A
  • ecbmct7plus–7 lub więcej
  • ecbmctG – G
  • ecbmctUnrated
  • ecbmct6a – 6A
  • ecbmct6plus–6 lub więcej
  • ecbmct10a – 10A
  • ecbmct10plus–10 lub niżej
  • ecbmct16plus – 16+
contentDetails.contentRating.eefilmRating string
Ocena filmu w Estonii.

Prawidłowe wartości dla tej właściwości to:
  • eefilmK12–szkoły podstawowe i średnie
  • eefilmK14–szkoły podstawowe i średnie
  • eefilmK16–szkoły podstawowe i średnie
  • eefilmK6–6 szkół podstawowych i średnich
  • eefilmL – L
  • eefilmMs12 – MS-12
  • eefilmMs6 – MS-6
  • eefilmPere – Pere
  • eefilmUnrated
contentDetails.contentRating.egfilmRating string
Ocena filmu w Egipcie.

Prawidłowe wartości dla tej właściwości to:
  • egfilm18 – 18
  • egfilmBn – BN
  • egfilmGn – GN
  • egfilmUnrated
contentDetails.contentRating.eirinRating string
Ocena Eirin (映倫) filmu. Eirin to japoński system ocen.

Prawidłowe wartości tej właściwości to:
  • eirinG – G
  • eirinPg12 – PG-12
  • eirinR15plus–15 ZAR
  • eirinR18plus–18 ZAR
  • eirinUnrated
contentDetails.contentRating.fcbmRating string
Ocena filmu przyznana przez malezyjską komisję cenzury filmowej.

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

Prawidłowe wartości dla tej właściwości to:
  • fcoI – I
  • fcoIi – II
  • fcoIia – IIA
  • fcoIib – IIB
  • fcoIii – III
  • fcoUnrated
contentDetails.contentRating.fmocRating string
Ta usługa jest wycofana 2 listopada 2015 r. Zamiast tego użyj właściwości contentDetails.contentRating.cncRating.

Ocena filmu podana przez Centre National du cinéma et de l'image animé (francuskie Ministerstwo Kultury) o ocenie.

Prawidłowe wartości dla tej właściwości to:
  • fmoc10 – 10
  • fmoc12 – 12
  • fmoc16 – 16
  • fmoc18 – 18
  • fmocE – E
  • fmocU – U
  • fmocUnrated
contentDetails.contentRating.fpbRating string
Ocena filmu przyznana przez South Africa's Film and Publication Board.

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

Prawidłowe wartości dla tej właściwości to:
  • fsk0 – FSK 0
  • fsk12 – FSK 12
  • fsk16–16 FSK
  • fsk18–18 FSK
  • 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–szkoły podstawowe i średnie
  • grfilmK15–szkoły podstawowe i średnie
  • grfilmK17–szkoły podstawowe i średnie
  • grfilmK18 – szkoły podstawowe i średnie
  • grfilmUnrated
contentDetails.contentRating.icaaRating string
Ocena filmu przyznana przez Instituto de la Cinematografía y de las Artes AudioVisuales (ICAA – Hiszpania).

Prawidłowe wartości dla tej usługi to:
  • icaa12 – 12
  • icaa13 – 13
  • icaa16 – 16
  • icaa18 – 18
  • icaa7 – 7
  • icaaApta – APTA
  • icaaUnrated
  • icaaX – X
contentDetails.contentRating.ifcoRating string
Klasyfikacja filmu prowadzona przez Irlandzki Urząd Klasyfikacji Filmów (IFCO – Irlandia) Więcej informacji znajdziesz na stronie IFCO.

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

Prawidłowe wartości dla tej usługi to:
  • ilfilm12 – 12
  • ilfilm16 – 16
  • ilfilm18 – 18
  • ilfilmAa – AA
  • ilfilmUnrated
contentDetails.contentRating.incaaRating string
Klasyfikacja INCAA (Instituto Nacional de Cine y Artes AudioVisuales – Argentyna) filmu.

Prawidłowe wartości dla 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 przyznana przez Kenya Film Classification Board.

Prawidłowe wartości dla 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).

Prawidłowe wartości dla tej usługi to:
  • kijkwijzer12 – 12
  • kijkwijzer14 – 14
  • kijkwijzer16 – 16
  • kijkwijzer18 – 18
  • kijkwijzer6 – 6
  • kijkwijzer9 – 9
  • kijkwijzerAl – AL
  • kijkwijzerUnrated
contentDetails.contentRating.kmrbRating string
Ocena filmu przyznawana przez Korea Media Rating Board (영원물방물시플레콤) dla filmu. KMRB ocenia filmy w Korei Południowej.

Prawidłowe wartości dla tej właściwości to:
  • kmrb12plus – 12세 이션 씨람
  • kmrb15plus – 15세 이즈 원람원
  • kmrbAll – 전체 napisów람원
  • kmrbR – 청로년 시람불원
  • kmrbTeenr
  • kmrbUnrated
contentDetails.contentRating.lsfRating string
Ocena filmu pochodząca od indonezyjskiej firmy Lembaga Sensor Film.

Prawidłowe wartości dla tej właściwości to:
  • lsf13 – 13
  • lsf17 – 17
  • lsf21 – 21
  • lsfA – A
  • lsfBo – BO
  • lsfD – D
  • lsfR–P
  • lsfSu – SU
  • lsfUnrated
contentDetails.contentRating.mccaaRating string
Ocena filmu przyznana przez maltańską komisję klasyfikacji wiekowej filmu.

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

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

Prawidłowe wartości tej właściwości to:
  • mcst0 – 0
  • mcst16plus – 16+
  • mcstC13 – C13
  • mcstC16 – C16
  • mcstC18 – C18
  • mcstP – P
  • mcstUnrated
  • mcstT13 – T13
  • mcstT16 – T16
  • mcstT18 – T18
  • mcstK – K
contentDetails.contentRating.mdaRating string
Ocena filmu przyznana przez singapurski urząd ds. rozwoju mediów (Media Development Authority, MDA), a konkretnie rada ds. cenzury filmowej (BFC).

Prawidłowe wartości dla tej właściwości to:
  • mdaG – G
  • mdaM18 – M18
  • mdaNc16 – NC16
  • mdaPg – PG
  • mdaPg13 – PG13
  • mdaR21–Z21
  • mdaUnrated
contentDetails.contentRating.medietilsynetRating string
Ocena filmu przyznana przez Medietilsynet, norweski urząd 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 przyznana przez fiński Kansallinen Audiovisuaalinen Instituutti (Narodowy Instytut Audiowizualny).

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

Prawidłowe wartości dla tej usługi to:
  • mibacT
  • mibacUnrated
  • mibacVap
  • mibacVm6
  • mibacVm12
  • mibacVm14
  • mibacVm18
contentDetails.contentRating.mocRating string
Ocena filmu Ministerio de Cultura (Kolumbia).

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

Prawidłowe wartości dla tej właściwości to:
  • moctwG – G
  • moctwP – P
  • moctwPg – PG
  • moctwR–P
  • moctwR12 – R-12
  • moctwR15–15 zł
  • moctwUnrated
contentDetails.contentRating.mpaaRating string
Ocena filmu podana przez organizację 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–P
  • mpaaUnrated
contentDetails.contentRating.mpaatRating string
Ocena zwiastunów filmów i podglądów przyznawana przez Stowarzyszenie Filmów Produkcyjnych Ameryki.

Prawidłowe wartości tej właściwości to:
  • mpaatGb–GB (zielona opaska – zatwierdzona dla wszystkich odbiorców)
  • mpaatRb – RB (czerwona opaska – zalecana dla osób powyżej 17 roku życia)
contentDetails.contentRating.mtrcbRating string
Ocena filmu przyznawana przez Filipińską Komisję Recenzencji i Klasyfikacji Filmów i TV (Film and Television Review and Classification Board).

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

Prawidłowe wartości tej właściwości to:
  • nbc12plus – 12 lat i więcej
  • nbc15plus – 15 lat i więcej
  • nbc18plus – 18 lat i więcej
  • nbc18plusr – 18+R
  • nbcG – G
  • nbcPg – PG
  • nbcPu – PU
  • nbcUnrated
contentDetails.contentRating.nfrcRating string
Ocena filmu przyznana przez Bułgarskie Centrum Filmu pełnometrażowego.

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

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

Prawidłowe wartości dla tej usługi to:
  • nkclv12plus – 12 lat i więcej
  • nkclv18plus – 18 lat i więcej
  • nkclv7plus–7 lub więcej
  • nkclvU – U
  • nkclvUnrated
contentDetails.contentRating.oflcRating string
Ocena filmu [Office of Film and Literature Classification (OFLC – Nowa Zelandia)].

Prawidłowe wartości tej właściwości to:
  • oflcG – G
  • oflcM – M
  • oflcPg – PG
  • oflcR13–13 ZAR
  • oflcR15–15 ZAR
  • oflcR16–16 ZAR
  • oflcR18–18 ZAR
  • 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.

Prawidłowe wartości tej usługi to:
  • resorteviolenciaA – A
  • resorteviolenciaB – B
  • resorteviolenciaC – C
  • resorteviolenciaD – D
  • resorteviolenciaE – E
  • resorteviolenciaUnrated
contentDetails.contentRating.rtcRating string
Ocena Generalna Dyrekcji Radia, Telewizji i Kinematografii (Meksyk) dla tego filmu.

Prawidłowe wartości dla 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 została dokonana przez irlandzki Raidió Teilifís Éireann.

Prawidłowe wartości dla tej właściwości to:
  • rteCh – CH
  • rteGa – GA
  • rteMa – MA
  • rtePs – PS
  • rteUnrated
contentDetails.contentRating.russiaRating string
Ocena filmu w Krajowym rejestrze filmów Federacji Rosyjskiej (MKRF – Rosja).

Prawidłowe wartości dla tej właściwości to:
  • russia0 – 0+
  • russia12 – 12 lat i więcej
  • russia16 – 16+
  • russia18 – 18 lat i więcej
  • russia6–6 lub więcej
  • russiaUnrated
contentDetails.contentRating.skfilmRating string
Ocena filmu w Słowacji.

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

Prawidłowe wartości dla 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 (Szwedeńska National Media Council).

Prawidłowe wartości dla tej właściwości to:
  • smsa11 – 11
  • smsa15 – 15
  • smsa7 – 7
  • smsaA – wszystkie grupy wiekowe
  • smsaUnrated
contentDetails.contentRating.tvpgRating string
Ocena filmu zgodnie z wytycznymi dla rodziców dotyczącymi telewizji (TVPG).

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

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

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

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

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

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

Prawidłowe wartości dla tej właściwości to:
  • private
  • public
  • unlisted
status.publishAt datetime
Data i godzina zaplanowanej publikacji filmu. Można ją ustawić tylko wtedy, gdy film jest ustawiony jako prywatny. Wartość musi być podana w formacie ISO 8601. Zwróć uwagę na te 2 dodatkowe uwagi dotyczące działania tej usługi:
  • Jeśli ustawisz wartość tej właściwości podczas wywoływania metody videos.update, musisz też ustawić wartość właściwości status.privacyStatus na private nawet wtedy, gdy film jest już prywatny.
  • Jeśli zaplanowano publikację filmu w przeszłości, zostanie on opublikowany od razu. Z tego względu ustawienie właściwości status.publishAt na datę i godzinę z przeszłości jest takie samo jak zmiana ustawienia privacyStatus filmu z private na public.
status.license string
Licencja filmu.

Prawidłowe wartości tej właściwości to:
  • creativeCommon
  • youtube
status.embeddable boolean
Ta wartość wskazuje, czy film można umieścić na innej stronie.
status.publicStatsViewable boolean
Ta wartość wskazuje, czy rozszerzone statystyki filmu dostępne na stronie odtwarzania filmu są dostępne publicznie. Domyślnie te statystyki są widoczne i takie statystyki jak liczba wyświetleń i oceny filmu są widoczne publicznie, nawet jeśli wartość tej właściwości to false.
status.madeForKids boolean
Ta wartość wskazuje, czy film jest oznaczony jako przeznaczony dla dzieci i ma obecny stan „przeznaczony dla dzieci”. Stan może być np. określany na podstawie wartości właściwości selfDeclaredMadeForKids. Więcej informacji o określaniu odbiorców kanału, filmów i transmisji znajdziesz w Centrum pomocy YouTube.
status.selfDeclaredMadeForKids boolean
W żądaniu videos.insert lub videos.update ta właściwość pozwala właścicielowi kanału oznaczyć film jako przeznaczony dla 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.
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 zaznaczyli, że film im się podobał.
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 zaznaczyli, że film im się nie podobał.
statistics.favoriteCount unsigned long
Uwaga: ta właściwość została wycofana. Ta zmiana wejdzie w życie 28 sierpnia 2015 r. Wartość właściwości jest teraz zawsze ustawiona na 0.
statistics.commentCount unsigned long
Liczba komentarzy dodanych do filmu.
player object
Obiekt player zawiera informacje, których można użyć do odtworzenia filmu w umieszczonym odtwarzaczu.
player.embedHtml string
Tag <iframe>, który pozwala na umieszczenie odtwarzacza, który odtwarza film.
  • Jeśli w żądaniu do interfejsu API pobierającym zasób określono wartość parametrów maxHeight lub maxWidth, rozmiar umieszczonego odtwarzacza jest skalowany w celu spełnienia wymagań maxHeight lub maxWidth.
  • Jeśli współczynnik proporcji filmu jest nieznany, odtwarzacz umieszczony na stronie domyślnie ustawia format 4:3.
player.embedHeight long
Wysokość umieszczonego odtwarzacza zwrócona we właściwości player.embedHtml. Ta właściwość jest zwracana tylko wtedy, gdy w żądaniu określono wartość parametrów maxHeight lub maxWidth oraz znany jest współczynnik proporcji filmu.
player.embedWidth long
Szerokość umieszczonego odtwarzacza zwrócona we właściwości player.embedHtml. Ta właściwość jest zwracana tylko wtedy, gdy w żądaniu określono wartość parametrów maxHeight lub maxWidth oraz znany jest współczynnik proporcji filmu.
topicDetails object
Obiekt topicDetails zawiera informacje o tematach powiązanych z filmem.

Ważne: więcej informacji o nadchodzących zmianach związanych z identyfikatorami tematów znajdziesz w definicjach właściwości topicDetails.relevantTopicIds[] i topicDetails.topicIds[], a także w historii zmian.
topicDetails.topicIds[] list
Ważne: ta usługa została wycofana 10 listopada 2016 r. Interfejs API nie zwraca już wartości dla 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 odnoszących się do filmu.

Ta usługa została wycofana 10 listopada 2016 r. Będzie on obsługiwany do 10 listopada 2017 r.

Ważne: w związku z wycofaniem interfejsów Freebase i Freebase API od 27 lutego 2017 r. identyfikatory tematów zaczęły działać inaczej. W tym czasie YouTube zaczął zwracać niewielki zestaw wybranych identyfikatorów tematów.
topicDetails.topicCategories[] list
Lista adresów URL Wikipedii, które zapewniają ogólny opis treści filmu.
recordingDetails object
Obiekt recordingDetails zawiera informacje o lokalizacji, dacie i adresie nagrania filmu.
recordingDetails.locationDescription string
Ta usługa została wycofana 1 czerwca 2017 r. Więcej informacji znajdziesz w ogłoszeniu o wycofaniu.

Opis tekstowy miejsca, w którym nagrano film.
recordingDetails.location object
Dane geolokalizacji powiązane z filmem. Pamiętaj, że wartości właściwości podrzędnych określają lokalizację, którą właściciel filmu chce powiązać z filmem. Tę wartość można edytować i wyszukać w przypadku filmów publicznych, a także wyświetlać ją użytkownikom w przypadku filmów publicznych.
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.

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.

Wysokość powyżej elipsoidy referencyjnej (w metrach).
recordingDetails.recordingDate datetime
Data i godzina nagrania filmu. Wartość musi być podana w formacie ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ).
fileDetails object
Obiekt fileDetails zawiera informacje o pliku wideo przesłanym do YouTube, w tym o rozdzielczości, czasie trwania, kodekach audio i wideo, szybkości transmisji strumienia i innych parametrach. Te dane może pobrać tylko właściciel filmu.

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

Prawidłowe wartości tej właściwości to:
  • archive – plik jest archiwum ZIP, np.
  • audio – plik jest znanym typem pliku audio, np. .mp3;
  • document – plik jest dokumentem lub plikiem tekstowym, takim jak dokument programu MS Word.
  • image – plik jest plikiem graficznym, np. .jpeg.
  • other – plik jest innym typem pliku niż wideo.
  • project – jest to plik projektu wideo (np. Microsoft Windows Movie Maker), który nie zawiera rzeczywistych danych filmu.
  • video – plik jest znanym typem pliku wideo, np. .mp4.
fileDetails.container string
Format kontenera przesłanego pliku wideo.
fileDetails.videoStreams[] list
Lista strumieni wideo zawartych w przesłanym pliku wideo. Każda pozycja na liście zawiera szczegółowe metadane strumienia wideo.
fileDetails.videoStreams[].widthPixels unsigned integer
Szerokość zakodowanej treści 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
Współczynnik proporcji wyświetlanego materiału wideo, określający współczynnik proporcji, w jakim powinien być wyświetlany film.
fileDetails.videoStreams[].codec string
Kodek wideo używany w strumieniu.
fileDetails.videoStreams[].bitrateBps unsigned long
Szybkość transmisji strumienia wideo (w bitach na sekundę).
fileDetails.videoStreams[].rotation string
Określa, ile razy YouTube musi obrócić oryginalne treści źródłowe, aby prawidłowo wyświetlić film.

Prawidłowe 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 – nie trzeba obracać filmu.
  • other – film musi zostać obrócony w jakiś inny, nieskomplikowany sposób.
  • upsideDown – film musi zostać obrócony do góry nogami.
fileDetails.videoStreams[].vendor string
Wartość, która jednoznacznie identyfikuje dostawcę wideo. Zazwyczaj wartością jest czteroliterowy kod dostawcy.
fileDetails.audioStreams[] list
Lista strumieni audio zawartych w przesłanym pliku wideo. Każda pozycja na liście zawiera szczegółowe metadane strumienia audio.
fileDetails.audioStreams[].channelCount unsigned integer
Liczba kanałów audio zawartych w transmisji.
fileDetails.audioStreams[].codec string
Kodek audio używany w strumieniu.
fileDetails.audioStreams[].bitrateBps unsigned long
Szybkość transmisji strumienia audio (w bitach na sekundę).
fileDetails.audioStreams[].vendor string
Wartość, która jednoznacznie identyfikuje dostawcę wideo. Zazwyczaj wartością jest czteroliterowy kod dostawcy.
fileDetails.durationMs unsigned long
Długość przesłanego filmu w milisekundach.
fileDetails.bitrateBps unsigned long
Łączna szybkość transmisji bitów przesłanego pliku wideo (wideo i dźwięk) wyrażona w bitach na sekundę.
fileDetails.creationTime string
Data i godzina utworzenia przesłanego pliku wideo. Wartość musi być podana w formacie ISO 8601. Obecnie obsługiwane są następujące formaty ISO 8601:
  • Tylko data: YYYY-MM-DD
  • Czas naiwny: YYYY-MM-DDTHH:MM:SS
  • Czas w strefie czasowej: YYYY-MM-DDTHH:MM:SS+HH:MM
processingDetails object
Obiekt processingDetails zawiera informacje o postępach przetwarzania przesłanego pliku wideo przez YouTube. Właściwości tego obiektu identyfikują bieżący stan przetwarzania oraz szacowany czas, jaki pozostał do zakończenia przetwarzania filmu przez YouTube. Ta część określa też, czy w przypadku filmu są dostępne różne typy danych lub treści, np. szczegóły pliku czy miniatury.

Obiekt processingProgress jest przeznaczony do ankietowania, aby w przesłanym filmie można było śledzić postęp przetwarzania przesłanego przez YouTube pliku wideo. Te dane może pobrać tylko właściciel filmu.
processingDetails.processingStatus string
Stan przetwarzania filmu. Ta wartość wskazuje, czy YouTube udało się przetworzyć film czy jeszcze trwa przetwarzanie.

Prawidłowe wartości tej właściwości to:
  • failed – nie udało się przetworzyć filmu. Zobacz ProcessingFailureReason.
  • processing – film jest teraz przetwarzany. Zobacz Postęp przetwarzania.
  • succeeded – film został przetworzony.
  • terminated – informacje o przetwarzaniu nie są już dostępne.
processingDetails.processingProgress object
Obiekt processingProgress zawiera informacje o postępach przetwarzania filmu przez YouTube. Wartości są istotne tylko wtedy, gdy stan przetwarzania filmu to processing.
processingDetails.processingProgress.partsTotal unsigned long
Szacowana łączna liczba części, które muszą zostać przetworzone w przypadku filmu. W trakcie przetwarzania filmu przez YouTube liczba może zostać zaktualizowana o dokładniejsze szacunki.
processingDetails.processingProgress.partsProcessed unsigned long
Liczba części filmu przetworzonych już przez YouTube. Aby oszacować, jaki procent filmu został już przetworzonych przez YouTube, oblicz:
100 * parts_processed / parts_total

Pamiętaj, że skoro szacowana liczba części może wzrosnąć bez odpowiadającego mu wzrostu liczby przetworzonych już fragmentów, możliwe, że obliczony postęp może okresowo się zmniejszać podczas przetwarzania filmu przez YouTube.
processingDetails.processingProgress.timeLeftMs unsigned long
Szacunkowy czas (w milisekundach) potrzebny YouTube na zakończenie przetwarzania filmu.
processingDetails.processingFailureReason string
Powód, dla którego YouTube nie przetworzył filmu. Ta właściwość będzie miała wartość tylko wtedy, gdy processingStatus będzie mieć wartość failed.

Prawidłowe wartości tej właściwości to:
  • other – wystąpił błąd innego komponentu przetwarzania.
  • streamingFailed – nie udało się wysłać filmu do transmitujących.
  • transcodeFailed – nie udało się transkodować treści.
  • uploadFailed – nie udało się dostarczyć pliku.
processingDetails.fileDetailsAvailability string
Ta wartość wskazuje, czy w przypadku przesłanego filmu dostępne są szczegóły pliku. Aby pobrać szczegóły pliku wideo, poproś o części fileDetails w żądaniu videos.list().
processingDetails.processingIssuesAvailability string
Ta wartość wskazuje, czy mechanizm przetwarzania filmu wygenerował sugestie, które mogą poprawić zdolność YouTube do przetworzenia filmu, ostrzeżenia wyjaśniające problemy z przetwarzaniem filmu lub błędy powodujące problemy z przetwarzaniem filmu. Aby uzyskać te sugestie, poproś o część suggestions w prośbie o videos.list().
processingDetails.tagSuggestionsAvailability string
Ta wartość wskazuje, czy w przypadku filmu dostępne są propozycje słów kluczowych (tagów). Do metadanych filmu można dodawać tagi, aby ułatwić innym użytkownikom jego odnalezienie. Aby uzyskać te sugestie, poproś o część suggestions w prośbie o videos.list().
processingDetails.editorSuggestionsAvailability string
Ta wartość wskazuje, czy w przypadku danego filmu dostępne są sugestie dotyczące edytowania filmów, które mogą poprawić jakość filmu lub zapewnić lepsze wrażenia podczas odtwarzania. Aby uzyskać te sugestie, poproś o część suggestions w 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 przesłanego filmu lub jego metadanych. Te dane może pobrać tylko właściciel filmu.

Obiekt suggestions zostanie zwrócony tylko wtedy, gdy właściwość processingDetails.tagSuggestionsAvailability lub processingDetails.editorSuggestionsAvailability ma wartość available.
suggestions.processingErrors[] list
Listę błędów, które uniemożliwią YouTube przetworzenie przesłanego filmu. Błędy te wskazują, że niezależnie od obecnego stanu przetwarzania filmu, w końcu ten stan będzie miał wartość failed.

Prawidłowe wartości tej właściwości to:
  • archiveFile – plik archiwum (np. archiwum ZIP).
  • audioFile – plik zawiera tylko dźwięk (np. plik MP3).
  • docFile – plik dokumentu lub pliku tekstowego (np. dokumentu MS Word).
  • imageFile – plik graficzny (np. obraz JPEG).
  • notAVideoFile – plik inny niż wideo.
  • projectFile – plik projektu filmu (np. Microsoft Windows Movie Maker).
suggestions.processingWarnings[] list
Lista powodów, dla których YouTube może mieć trudności z transkodowaniem przesłanego filmu lub może skutkować błędną transkodowaniem. Ostrzeżenia te są generowane, zanim YouTube faktycznie przetworzy przesłany film. Ponadto wykrywają problemy, które niekoniecznie oznaczają, że przetwarzanie wideo się nie powiedzie, ale które mogą być przyczyną problemów, takich jak problemy z synchronizacją, artefakty wideo lub brakująca ścieżka dźwiękowa.

Prawidłowe wartości tej usługi to:
  • hasEditlist – edytowanie list nie jest obecnie obsługiwane.
  • inconsistentResolution – konflikt rozdzielczości kontenera i strumienia.
  • problematicAudioCodec – użyto kodeka audio, o którym wiadomo, że powoduje problemy.
  • problematicVideoCodec – użyto kodeka wideo, o którym wiadomo, że powoduje problemy.
  • unknownAudioCodec – nierozpoznany kodek audio, transkodowanie prawdopodobnie się nie uda.
  • unknownContainer – nierozpoznany format pliku, transkodowanie prawdopodobnie się nie uda.
  • unknownVideoCodec – nierozpoznany kodek wideo, transkodowanie prawdopodobnie się nie uda.
suggestions.processingHints[] list
Lista sugestii, które mogą zwiększyć możliwości YouTube w zakresie przetwarzania filmu.

Prawidłowe wartości tej właściwości to:
  • nonStreamableMov – pliku MP4 nie można przesyłać strumieniowo, co spowalnia przetwarzanie.
  • sendBestQualityVideo – prawdopodobnie istnieje wersja filmu o lepszej jakości.
suggestions.tagSuggestions[] list
Lista tagów słów kluczowych, które można dodać do metadanych filmu, aby zwiększyć prawdopodobieństwo, że użytkownicy znajdą Twój film podczas wyszukiwania lub przeglądania treści w YouTube.
suggestions.tagSuggestions[].tag string
Tag słowa kluczowego proponowany dla filmu.
suggestions.tagSuggestions[].categoryRestricts[] list
Zbiór kategorii filmów, do których odnosi się tag. Na podstawie tych informacji możesz wyświetlać sugestie tagów w oparciu o kategorię filmu, którą użytkownik, który go przesłał, powiąza. Domyślnie propozycje tagów są trafne dla wszystkich kategorii, jeśli nie zdefiniowano ograniczeń dla słowa kluczowego.
suggestions.editorSuggestions[] list
Lista operacji edycji filmu, które mogą poprawić jakość lub wygodę odtwarzania przesłanego filmu.

Prawidłowe wartości tej właściwości to:
  • audioQuietAudioSwap – ścieżka dźwiękowa wydaje się być cicha i można ją zastąpić inną w lepszej jakości.
  • videoAutoLevels – poziom jasności obrazu wydaje się być wyłączony i można go poprawić.
  • videoCrop – wokół zdjęcia mogą zostać przycięte marginesy (matowe).
  • videoStabilize – obraz jest niestabilny, a obraz może być ustabilizowany.
liveStreamingDetails object
Obiekt liveStreamingDetails zawiera metadane dotyczące transmisji na żywo. Obiekt będzie obecny w zasobie video tylko wtedy, gdy film jest nadchodzącą, trwającą lub zakończoną transmisją na żywo.
liveStreamingDetails.actualStartTime datetime
Godzina, o której transmisja się rozpoczęła. Wartość musi być podana w formacie ISO 8601. Ta wartość nie będzie dostępna do czasu rozpoczęcia transmisji.
liveStreamingDetails.actualEndTime datetime
Godzina, o której transmisja faktycznie się zakończyła. Wartość musi być podana w formacie ISO 8601. Ta wartość będzie niedostępna do czasu zakończenia transmisji.
liveStreamingDetails.scheduledStartTime datetime
Godzina, o której ma się rozpocząć transmisja. Wartość musi być podana w formacie ISO 8601.
liveStreamingDetails.scheduledEndTime datetime
Planowana godzina zakończenia transmisji. Wartość musi być podana w formacie ISO 8601. Jeśli wartość jest pusta lub właściwość nie występuje, transmisja jest zaplanowana na czas nieokreślony.
liveStreamingDetails.concurrentViewers unsigned long
Liczba osób, które w danej chwili oglądają transmisję Właściwość i jej wartość będą widoczne, 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 oglądających transmisję jednocześnie. Nie określa więc liczby osób oglądających zarchiwizowaną transmisję na żywo, która już się zakończyła.
Liczba równoczesnych widzów zwracana przez interfejs YouTube Data API może różnić się od liczby przetworzonych, pozbawionych spamu liczby widzów dostępnych w Statystykach YouTube. Więcej informacji o danych transmisji na żywo znajdziesz w Centrum pomocy YouTube.
liveStreamingDetails.activeLiveChatId string
Identyfikator aktywnego czatu na żywo dołączonego do tego filmu. To pole jest wypełnione tylko wtedy, gdy film jest transmisją na żywo i czatem na żywo. Po przejściu do wypełnienia tego pola informacje o transmisjach zostaną usunięte, a czat na żywo zostanie zamknięty. W przypadku trwałych transmisji identyfikator czatu na żywo nie będzie już powiązany z 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 parą kluczową. Wartość jest ciągiem znaków zawierającym kod języka BCP-47.
localizations.(key).title string
Zlokalizowany tytuł filmu.
localizations.(key).description string
Zlokalizowany opis filmu.