videos.insert
z niezweryfikowanych projektów API utworzonych po 28 lipca 2020 roku będą miały ograniczony dostęp do trybu prywatnego
wyświetlania. Aby znieść to ograniczenie, każdy projekt API musi przejść audyt, który potwierdzi zgodność z Warunkami usługi. Więcej informacji znajdziesz w historii zmian interfejsu API.
video zasób reprezentuje film na YouTube.
Metody
Interfejs API obsługuje te metody dla zasobów videos:
- getRating
- Pobiera oceny, które autoryzowany użytkownik przyznał określonej liście filmów. Wypróbuj teraz
- list
- Zwraca listę filmów, które pasują do parametrów żądania do interfejsu API. Wypróbuj teraz
- batchGetStats
- Pobiera listę statystyk filmów, które pasują do parametrów żądania do interfejsu API. Wypróbuj teraz
- wstaw
- Przesyła film do YouTube i opcjonalnie ustawia metadane filmu.
- aktualizować
- Aktualizuje metadane filmu. Wypróbuj teraz
- usuń
- Usuwa film na YouTube. Wypróbuj teraz
- rate [stawka]
- Dodawanie oceny „Lubię” lub „Nie lubię” do filmu albo usuwanie oceny z filmu. Wypróbuj teraz
- reportAbuse
- Zgłoś film, który zawiera nieodpowiednie treści. Wypróbuj teraz
Prezentacja zasobów
Poniższa struktura JSON przedstawia format zasobu videos:
{
"kind": "youtube#video",
"etag": etag,
"id": string,
"snippet": {
"publishedAt": datetime,
"channelId": string,
"title": string,
"description": string,
"thumbnails": {
(key): {
"url": string,
"width": unsigned integer,
"height": unsigned integer
}
},
"channelTitle": string,
"tags": [
string
],
"categoryId": string,
"liveBroadcastContent": string,
"defaultLanguage": string,
"localized": {
"title": string,
"description": string
},
"defaultAudioLanguage": string
},
"contentDetails": {
"duration": string,
"dimension": string,
"definition": string,
"caption": string,
"licensedContent": boolean,
"regionRestriction": {
"allowed": [
string
],
"blocked": [
string
]
},
"contentRating": {
"acbRating": string,
"agcomRating": string,
"anatelRating": string,
"bbfcRating": string,
"bfvcRating": string,
"bmukkRating": string,
"catvRating": string,
"catvfrRating": string,
"cbfcRating": string,
"cccRating": string,
"cceRating": string,
"chfilmRating": string,
"chvrsRating": string,
"cicfRating": string,
"cnaRating": string,
"cncRating": string,
"csaRating": string,
"cscfRating": string,
"czfilmRating": string,
"djctqRating": string,
"djctqRatingReasons": [,
string
],
"ecbmctRating": string,
"eefilmRating": string,
"egfilmRating": string,
"eirinRating": string,
"fcbmRating": string,
"fcoRating": string,
"fmocRating": string,
"fpbRating": string,
"fpbRatingReasons": [,
string
],
"fskRating": string,
"grfilmRating": string,
"icaaRating": string,
"ifcoRating": string,
"ilfilmRating": string,
"incaaRating": string,
"kfcbRating": string,
"kijkwijzerRating": string,
"kmrbRating": string,
"lsfRating": string,
"mccaaRating": string,
"mccypRating": string,
"mcstRating": string,
"mdaRating": string,
"medietilsynetRating": string,
"mekuRating": string,
"mibacRating": string,
"mocRating": string,
"moctwRating": string,
"mpaaRating": string,
"mpaatRating": string,
"mtrcbRating": string,
"nbcRating": string,
"nbcplRating": string,
"nfrcRating": string,
"nfvcbRating": string,
"nkclvRating": string,
"oflcRating": string,
"pefilmRating": string,
"rcnofRating": string,
"resorteviolenciaRating": string,
"rtcRating": string,
"rteRating": string,
"russiaRating": string,
"skfilmRating": string,
"smaisRating": string,
"smsaRating": string,
"tvpgRating": string,
"ytRating": string
},
"projection": string,
"hasCustomThumbnail": boolean
},
"status": {
"uploadStatus": string,
"failureReason": string,
"rejectionReason": string,
"privacyStatus": string,
"publishAt": datetime,
"license": string,
"embeddable": boolean,
"publicStatsViewable": boolean,
"madeForKids": boolean,
"selfDeclaredMadeForKids": boolean,
"containsSyntheticMedia": boolean
},
"statistics": {
"viewCount": string,
"likeCount": string,
"dislikeCount": string,
"favoriteCount": string,
"commentCount": string
},
"paidProductPlacementDetails": {
"hasPaidProductPlacement": boolean
},
"player": {
"embedHtml": string,
"embedHeight": long,
"embedWidth": long
},
"topicDetails": {
"topicIds": [
string
],
"relevantTopicIds": [
string
],
"topicCategories": [
string
]
},
"recordingDetails": {
"recordingDate": datetime
},
"fileDetails": {
"fileName": string,
"fileSize": unsigned long,
"fileType": string,
"container": string,
"videoStreams": [
{
"widthPixels": unsigned integer,
"heightPixels": unsigned integer,
"frameRateFps": double,
"aspectRatio": double,
"codec": string,
"bitrateBps": unsigned long,
"rotation": string,
"vendor": string
}
],
"audioStreams": [
{
"channelCount": unsigned integer,
"codec": string,
"bitrateBps": unsigned long,
"vendor": string
}
],
"durationMs": unsigned long,
"bitrateBps": unsigned long,
"creationTime": string
},
"processingDetails": {
"processingStatus": string,
"processingProgress": {
"partsTotal": unsigned long,
"partsProcessed": unsigned long,
"timeLeftMs": unsigned long
},
"processingFailureReason": string,
"fileDetailsAvailability": string,
"processingIssuesAvailability": string,
"tagSuggestionsAvailability": string,
"editorSuggestionsAvailability": string,
"thumbnailsAvailability": string
},
"suggestions": {
"processingErrors": [
string
],
"processingWarnings": [
string
],
"processingHints": [
string
],
"tagSuggestions": [
{
"tag": string,
"categoryRestricts": [
string
]
}
],
"editorSuggestions": [
string
]
},
"liveStreamingDetails": {
"actualStartTime": datetime,
"actualEndTime": datetime,
"scheduledStartTime": datetime,
"scheduledEndTime": datetime,
"concurrentViewers": unsigned long,
"activeLiveChatId": string
},
"localizations": {
(key): {
"title": string,
"description": string
}
}
}Właściwości
W tej tabeli znajdziesz definicje właściwości, które pojawiają się w tym zasobie:
| Właściwości | |
|---|---|
kind |
stringOkreśla typ zasobu interfejsu API. Wartość to youtube#video. |
etag |
etagEtag tego zasobu. |
id |
stringIdentyfikator, którego YouTube używa do jednoznacznej identyfikacji filmu. |
snippet |
objectObiekt snippet zawiera podstawowe informacje o filmie, takie jak tytuł, opis i kategoria. |
snippet.publishedAt |
datetimeData i godzina opublikowania filmu. Pamiętaj, że może się on różnić od czasu przesłania filmu. Jeśli na przykład film zostanie przesłany jako film prywatny, a później udostępniony publicznie, ta właściwość określi czas, w którym film został udostępniony publicznie. Istnieje kilka przypadków specjalnych:
|
snippet.channelId |
stringIdentyfikator, którego YouTube używa do jednoznacznej identyfikacji kanału, na który został przesłany film. |
snippet.title |
stringTytuł filmu. Wartość właściwości może mieć maksymalnie 100 znaków i zawierać wszystkie prawidłowe znaki UTF-8 z wyjątkiem < i >. Musisz ustawić wartość tej właściwości, jeśli wywołujesz metodę videos.update i aktualizujesz część snippet zasobu video. |
snippet.description |
stringOpis filmu. Wartość właściwości może mieć maksymalnie 5000 bajtów i zawierać wszystkie prawidłowe znaki UTF-8 z wyjątkiem < i >. |
snippet.thumbnails |
objectMapa miniatur powiązanych z filmem. W przypadku każdego obiektu na mapie kluczem jest nazwa miniatury, a wartością jest obiekt zawierający inne informacje o miniaturze. |
snippet.thumbnails.(key) |
objectPrawidłowe wartości klucza to:
|
snippet.thumbnails.(key).url |
stringAdres URL obrazu. |
snippet.thumbnails.(key).width |
unsigned integerSzerokość obrazu. |
snippet.thumbnails.(key).height |
unsigned integerWysokość obrazu. |
snippet.channelTitle |
stringTytuł kanału, do którego należy film. |
snippet.tags[] |
listLista tagów słów kluczowych powiązanych z filmem. Tagi mogą zawierać spacje. Maksymalna długość wartości właściwości to 500 znaków. Pamiętaj o tych zasadach dotyczących sposobu obliczania limitu znaków:
|
snippet.categoryId |
stringKategoria filmu w YouTube powiązana z filmem. Musisz ustawić wartość tej właściwości, jeśli wywołujesz metodę videos.update i aktualizujesz część snippet zasobu video. |
snippet.liveBroadcastContent |
stringWskazuje, czy film jest nadchodzącą lub aktywną transmisją na żywo. Jeśli film nie jest nadchodzącą lub aktywną transmisją na żywo, wartość to Prawidłowe wartości tej właściwości to:
|
snippet.defaultLanguage |
stringJęzyk tekstu we właściwościach snippet.title i snippet.description zasobu video. |
snippet.localized |
objectObiekt snippet.localized zawiera zlokalizowany tytuł i opis filmu lub tytuł w języku domyślnym dla metadanych filmu.
localizations, aby dodawać, aktualizować lub usuwać zlokalizowane tytuły. |
snippet.localized.title |
stringZlokalizowany tytuł filmu. |
snippet.localized.description |
stringZlokalizowany opis filmu. |
snippet.defaultAudioLanguage |
stringWłaściwość default_audio_language określa język używany w domyślnej ścieżce dźwiękowej filmu. |
contentDetails |
objectObiekt contentDetails zawiera informacje o treści wideo, w tym długość filmu i informację o tym, czy są dostępne napisy. |
contentDetails.duration |
stringDługość filmu. Wartość właściwości to czas trwania w formacie ISO 8601. Na przykład w przypadku filmu, który trwa co najmniej minutę, ale nie dłużej niż godzinę, czas trwania jest podawany w formacie PT#M#S, w którym litery PT oznaczają, że wartość określa okres, a litery M i S odnoszą się odpowiednio do długości w minutach i sekundach. # znaki przed literami M i S to liczby całkowite określające liczbę minut (lub sekund) filmu. Na przykład wartość PT15M33S oznacza, że film trwa 15 minut i 33 sekundy.Jeśli film trwa co najmniej godzinę, czas trwania jest podany w formacie PT#H#M#S, w którym # przed literą H określa długość filmu w godzinach, a wszystkie inne szczegóły są takie same jak opisane powyżej. Jeśli film trwa co najmniej 1 dzień, litery 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 |
stringWskazuje, czy film jest dostępny w 3D czy w 2D. |
contentDetails.definition |
stringOkreśla, czy film jest dostępny w wysokiej rozdzielczości ( HD), czy tylko w standardowej.Prawidłowe wartości tej właściwości to:
|
contentDetails.caption |
stringWskazuje, czy napisy są dostępne w przypadku filmu. Prawidłowe wartości tej właściwości to:
|
contentDetails.licensedContent |
booleanWskazuje, czy film zawiera licencjonowane treści, co oznacza, że zostały one przesłane na kanał powiązany z partnerem YouTube ds. treści, a następnie objęte roszczeniem przez tego partnera. |
contentDetails.regionRestriction |
objectObiekt regionRestriction zawiera informacje o krajach, w których film jest (lub nie jest) dostępny. Obiekt będzie zawierać właściwość contentDetails.regionRestriction.allowed lub właściwość contentDetails.regionRestriction.blocked. |
contentDetails.regionRestriction.allowed[] |
listLista kodów regionów, które identyfikują kraje, w których film jest widoczny. Jeśli ta właściwość jest obecna, a kraj nie jest wymieniony w jej wartości, film jest blokowany w tym kraju. Jeśli ta właściwość jest obecna i zawiera pustą listę, film jest blokowany we wszystkich krajach. |
contentDetails.regionRestriction.blocked[] |
listLista kodów regionów, które identyfikują kraje, w których film jest zablokowany. Jeśli ta właściwość jest obecna, a kraj nie jest wymieniony w jej wartości, film jest dostępny w tym kraju. Jeśli ta właściwość jest obecna i zawiera pustą listę, film jest widoczny we wszystkich krajach. |
contentDetails.contentRating |
objectOkreśla oceny, jakie otrzymał film w ramach różnych systemów oceniania. |
contentDetails.contentRating.acbRating |
stringOcena filmu przyznana przez Australian Classification Board (ACB) lub Australian Communications and Media Authority (ACMA). Oceny ACMA służą do klasyfikowania programów telewizyjnych dla dzieci. Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.agcomRating |
stringOcena filmu przyznana przez włoski organ Autorità per le Garanzie nelle Comunicazioni (AGCOM). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.anatelRating |
stringOcena filmu przyznana przez Anatel (Asociación Nacional de Televisión) w przypadku telewizji w Chile. Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.bbfcRating |
stringOcena filmu przyznana przez British Board of Film Classification (BBFC). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.bfvcRating |
stringOcena filmu przyznana przez tajlandzką Radę Cenzorów Filmów i Materiałów Wideo. Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.bmukkRating |
stringOcena filmu przyznana przez austriacką Radę ds. Klasyfikacji Mediów (Bundesministerium für Unterricht, Kunst und Kultur). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.catvRating |
stringSystem oceniania kanadyjskich programów telewizyjnych – kanadyjski system klasyfikacji programów telewizyjnych. Ocena filmu przyznana przez Kanadyjską Komisję ds. Radia i Telewizji (CRTC) w przypadku kanadyjskich programów nadawanych w języku angielskim. Więcej informacji znajdziesz na stronie Canadian Broadcast Standards Council. Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.catvfrRating |
stringOcena filmu przyznana przez Kanadyjską Komisję ds. Radia i Telewizji (CRTC) w przypadku francuskojęzycznych transmisji w Kanadzie. Więcej informacji znajdziesz na stronie Canadian Broadcast Standards Council. Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.cbfcRating |
stringOcena filmu przyznana przez Centralną Radę Cenzury Filmowej (CBFC) w Indiach. Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.cccRating |
stringOcena filmu przyznana przez Consejo de Calificación Cinematográfica (Chile). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.cceRating |
stringOcena filmu przyznana przez portugalską organizację Comissão de Classificação de Espect´culos. Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.chfilmRating |
stringOcena filmu w Szwajcarii. Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.chvrsRating |
stringOcena filmu w kanadyjskim systemie klasyfikacji filmów na nośnikach domowych (CHVRS). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.cicfRating |
stringOcena filmu przyznana przez Commission de Contrôle des Films (Belgia). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.cnaRating |
stringOcena filmu przyznana przez rumuńską organizację CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA). Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.cncRating |
stringSystem ocen we Francji – Commission de classification cinematographique Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.csaRating |
stringOcena filmu przyznana przez francuską instytucję Conseil supérieur de l'audiovisuel, która ocenia treści nadawane w telewizji. Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.cscfRating |
stringOcena filmu w Luksemburgu przyznana przez Commission de surveillance de la classification des films (CSCF). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.czfilmRating |
stringOcena filmu w Czechach. Prawidłowe wartości tego pola to:
|
contentDetails.contentRating.djctqRating |
stringOcena filmu przyznana przez Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT) w Brazylii. Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.djctqRatingReasons[] |
listPrzyczyny, dla których film otrzymał klasyfikację DJCQT (Brazylia). |
contentDetails.contentRating.ecbmctRating |
stringSystem ocen w Turcji – Rada ds. Oceny i Klasyfikacji przy Ministerstwie Kultury i Turystyki Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.eefilmRating |
stringOcena filmu w Estonii. Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.egfilmRating |
stringOcena filmu w Egipcie. Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.eirinRating |
stringOcena filmu w systemie EIRIN (映倫). EIRIN to japoński system ocen. Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.fcbmRating |
stringOcena filmu przyznana przez malezyjską Radę Cenzury Filmowej. Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.fcoRating |
stringOcena filmu przyznana przez Office for Film, Newspaper and Article Administration w Hongkongu. Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.fmocRating |
stringTen atrybut został wycofany 2 listopada 2015 r. Zamiast niego używaj atrybutu contentDetails.contentRating.cncRating.Ocena filmu przyznana przez Centre national du cinéma et de l'image animé (francuskie Ministerstwo Kultury). Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.fpbRating |
stringOcena filmu przyznana przez Film and Publication Board w Republice Południowej Afryki. Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.fpbRatingReasons[] |
listPrzyczyny, dla których film otrzymał ocenę FPB (RPA). |
contentDetails.contentRating.fskRating |
stringKlasyfikacja filmu według Freiwillige Selbstkontrolle der Filmwirtschaft (FSK – Niemcy). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.grfilmRating |
stringOcena filmu w Grecji. Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.icaaRating |
stringOcena filmu przyznana przez Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA – Hiszpania). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.ifcoRating |
stringOcena filmu przyznana przez Irish Film Classification Office (IFCO – Irlandia). Więcej informacji znajdziesz na stronie IFCO. Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.ilfilmRating |
stringOcena filmu w Izraelu. Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.incaaRating |
stringOcena filmu przyznana przez INCAA (Instituto Nacional de Cine y Artes Audiovisuales – Argentyna). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.kfcbRating |
stringOcena filmu przyznana przez Kenya Film Classification Board. Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.kijkwijzerRating |
stringvoor de Classificatie van Audiovisuele Media (Holandia). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.kmrbRating |
stringOcena filmu przyznana przez Korea Media Rating Board (영상물등급위원회). KMRB ocenia filmy w Korei Południowej. Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.lsfRating |
stringOcena filmu przyznana przez indonezyjską organizację Lembaga Sensor Film. Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.mccaaRating |
stringOcena filmu przyznana przez maltańską Radę ds. Klasyfikacji Wiekowej Filmów. Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.mccypRating |
stringOcena filmu przyznana przez Radę ds. Mediów dla Dzieci i Młodzieży (Media Council for Children and Young People) Duńskiego Instytutu Filmowego (Det Danske Filminstitut). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.mcstRating |
stringSystem oceniania filmów w Wietnamie – MCST Prawidłowe wartości tej właściwości:
|
contentDetails.contentRating.mdaRating |
stringOcena filmu przyznana przez Media Development Authority (MDA) w Singapurze, a konkretnie przez Board of Film Censors (BFC). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.medietilsynetRating |
stringOcena filmu przyznana przez norweski organ ds. mediów Medietilsynet. Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.mekuRating |
stringOcena filmu przyznana przez fiński Kansallinen Audiovisuaalinen Instituutti (Narodowy Instytut Audiowizualny). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.mibacRating |
stringOcena filmu przyznana przez Ministero dei Beni e delle Attività Culturali e del Turismo (Włochy). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.mocRating |
stringOcena filmu przyznana przez Ministerio de Cultura (Kolumbia). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.moctwRating |
stringOcena filmu przyznana przez Ministerstwo Kultury Tajwanu (文化部). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.mpaaRating |
stringOcena filmu przyznana przez Motion Picture Association of America (MPAA). Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.mpaatRating |
stringOcena zwiastunów i zapowiedzi filmów przyznana przez Motion Picture Association of America. Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.mtrcbRating |
stringOcena filmu z Filipińskiej Rady ds. Oceny i Klasyfikacji Filmów i Programów Telewizyjnych. Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.nbcRating |
stringOcena filmu przyznana przez malediwskie Krajowe Biuro Klasyfikacji. Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.nfrcRating |
stringOcena filmu przyznana przez Bułgarskie Narodowe Centrum Filmowe. Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.nfvcbRating |
stringOcena filmu przyznana przez nigeryjską National Film and Video Censors Board. Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.nkclvRating |
stringOcena filmu przyznana przez Nacionãlais Kino centrs (Narodowe Centrum Filmowe Łotwy). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.oflcRating |
stringOcena filmu przyznana przez nowozelandzki urząd ds. klasyfikacji filmów i literatury (OFLC). Prawidłowe wartości tej właściwości:
|
contentDetails.contentRating.pefilmRating |
stringOcena filmu w Peru. Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.resorteviolenciaRating |
stringOcena filmu w Wenezueli. Prawidłowe wartości tego pola to:
|
contentDetails.contentRating.rtcRating |
stringOcena filmu przyznana przez Generalną Dyrekcję ds. Radia, Telewizji i Kinematografii (Meksyk). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.rteRating |
stringOcena filmu przyznana przez irlandzką stację Raidió Teilifís Éireann. Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.russiaRating |
stringOcena filmu w rejestrze filmów Narodowego Rejestru Filmów Federacji Rosyjskiej (MKRF – Rosja). Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.skfilmRating |
stringOcena filmu w Słowacji. Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.smaisRating |
stringOcena filmu w Islandii. Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.smsaRating |
stringOcena filmu przyznana przez Statens medieråd (szwedzką Radę ds. Mediów). Prawidłowe wartości tej właściwości to:
|
contentDetails.contentRating.tvpgRating |
stringOcena filmu zgodnie z wytycznymi TV Parental Guidelines (TVPG). Prawidłowe wartości tego atrybutu to:
|
contentDetails.contentRating.ytRating |
stringOcena, której YouTube używa do identyfikowania treści z ograniczeniem wiekowym. Prawidłowe wartości tej właściwości to:
|
contentDetails.projection |
stringOkreśla format projekcji filmu. Prawidłowe wartości tej właściwości to:
|
contentDetails.hasCustomThumbnail |
booleanOkreśla, czy osoba, która przesłała film, dodała do niego niestandardową miniaturę. Ta właściwość jest widoczna tylko dla osoby, która przesłała film. |
status |
objectObiekt status zawiera informacje o stanie przesyłania, przetwarzania i prywatności filmu. |
status.uploadStatus |
stringStan przesłanego filmu. Prawidłowe wartości tej właściwości to:
|
status.failureReason |
stringTa wartość wyjaśnia, dlaczego nie udało się przesłać filmu. Ta właściwość występuje tylko wtedy, gdy właściwość uploadStatus wskazuje, że przesyłanie nie powiodło się.Prawidłowe wartości tej właściwości to:
|
status.rejectionReason |
stringTa wartość wyjaśnia, dlaczego YouTube odrzucił przesłany film. Ta właściwość występuje tylko wtedy, gdy właściwość uploadStatus wskazuje, że przesłanie zostało odrzucone.Prawidłowe wartości tej właściwości to:
|
status.privacyStatus |
stringStan prywatności filmu. Prawidłowe wartości tej właściwości to:
|
status.publishAt |
datetimeData i godzina, o której film ma zostać opublikowany. Można ją ustawić tylko wtedy, gdy stan prywatności filmu to „prywatny”. Wartość jest podana w formacie ISO 8601. Zwróć uwagę na te 2 dodatkowe kwestie dotyczące działania tej właściwości:
|
status.license |
stringLicencja filmu. Prawidłowe wartości tego pola to:
|
status.embeddable |
booleanTa wartość wskazuje, czy film można umieścić w innej witrynie. |
status.publicStatsViewable |
booleanTa wartość określa, czy rozszerzone statystyki filmu na stronie odtwarzania filmu są widoczne publicznie. Domyślnie te statystyki są widoczne, a statystyki takie jak liczba wyświetleń i oceny filmu będą nadal widoczne publicznie, nawet jeśli wartość tej właściwości jest ustawiona na false. |
status.madeForKids |
booleanTa wartość wskazuje, czy film jest skierowany do dzieci, i zawiera aktualny stan „przeznaczone dla dzieci”. Stan może być określany na podstawie wartości właściwości selfDeclaredMadeForKids. Więcej informacji o ustawianiu odbiorców kanału, filmów lub transmisji znajdziesz w Centrum pomocy YouTube. |
status.selfDeclaredMadeForKids |
booleanW żądaniu videos.insert lub videos.update ta właściwość umożliwia właścicielowi kanału oznaczenie filmu jako skierowanego do dzieci. W przypadku żądania videos.list wartość właściwości jest zwracana tylko wtedy, gdy właściciel kanału autoryzował żądanie do interfejsu API. |
status.containsSyntheticMedia |
booleanW przypadku żądania videos.insert lubvideos.update ta właściwość umożliwia właścicielowi kanału poinformowanie, że film zawiera realistyczne treści zmodyfikowane lub wygenerowane syntetycznie (A/S). Dowiedz się więcej o zasadach YouTube dotyczących treści związanych z alkoholem, tytoniem i innymi substancjami.Przykłady treści związanych z alkoholem, tytoniem i innymi substancjami obejmują filmy, które:
|
statistics |
objectObiekt statistics zawiera statystyki dotyczące filmu. |
statistics.viewCount |
unsigned longLiczba wyświetleń filmu. Od 31 marca 2025 r. w przypadku filmów Short pole viewCount będzie zwracać liczbę rozpoczęć lub ponowień odtwarzania filmu Short, bez minimalnego czasu oglądania. |
statistics.likeCount |
unsigned longLiczba użytkowników, którzy polubili film. |
statistics.dislikeCount |
unsigned longUwaga: od 13 grudnia 2021 r. usługa statistics.dislikeCount jest prywatna. Oznacza to, że usługa jest uwzględniana w odpowiedzi interfejsu API tylko wtedy, gdy żądanie do interfejsu API zostało uwierzytelnione przez właściciela filmu. Więcej informacji znajdziesz w historii zmian.Liczba użytkowników, którzy wyrazili swoją dezaprobatę dla filmu. |
statistics.favoriteCount |
unsigned longUwaga: ta właściwość została wycofana. Wycofanie nastąpiło 28 sierpnia 2015 r. Wartość właściwości jest teraz zawsze ustawiona na 0. |
statistics.commentCount |
unsigned longLiczba komentarzy do filmu. |
paidProductPlacementDetails |
objectObiekt paidProductPlacementDetails zawiera informacje o płatnym lokowaniu produktu w filmie. |
paidProductPlacementDetails.hasPaidProductPlacement |
booleanUstaw wartość true, jeśli w treściach występuje płatne lokowanie produktu. Domyślna wartość to false. |
player |
objectObiekt player zawiera informacje, które umożliwiają odtworzenie filmu w odtwarzaczu umieszczonym na stronie. |
player.embedHtml |
stringTag <iframe>, który osadza odtwarzacz odtwarzający film.
|
player.embedHeight |
longWysokość odtwarzacza umieszczonego na stronie zwrócona we właściwości player.embedHtml. Ta właściwość jest zwracana tylko wtedy, gdy w żądaniu określono wartość parametrów maxHeight lub maxWidth i znany jest współczynnik proporcji filmu. |
player.embedWidth |
longSzerokość odtwarzacza umieszczonego na stronie zwrócona we właściwości player.embedHtml. Ta właściwość jest zwracana tylko wtedy, gdy w żądaniu określono wartość parametrów maxHeight lub maxWidth i znany jest współczynnik proporcji filmu. |
topicDetails |
objectObiekt topicDetails zawiera informacje o tematach powiązanych z filmem.Ważne: więcej informacji o nadchodzących zmianach związanych z identyfikatorami tematów znajdziesz w definicjach właściwości topicDetails.relevantTopicIds[] i topicDetails.topicIds[] oraz w historii zmian. |
topicDetails.topicIds[] |
listWażne: to pole zostało wycofane 10 listopada 2016 r. Interfejs API nie zwraca już wartości tej właściwości, a wszystkie tematy powiązane z filmem są teraz zwracane przez wartość właściwości topicDetails.relevantTopicIds[]. |
topicDetails.relevantTopicIds[] |
listLista identyfikatorów tematów związanych z filmem. Ta właściwość została wycofana 10 listopada 2016 r. Będzie on obsługiwany do 10 listopada 2017 r. Ważne: ze względu na wycofanie Freebase i interfejsu Freebase API identyfikatory tematów zaczęły działać inaczej od 27 lutego 2017 r. W tym czasie YouTube zaczął zwracać niewielki zestaw wyselekcjonowanych identyfikatorów tematów. |
topicDetails.topicCategories[] |
listLista adresów URL Wikipedii, które zawierają ogólny opis treści filmu. |
recordingDetails |
objectObiekt recordingDetails zawiera informacje o lokalizacji, dacie i adresie, pod którym nagrano film. |
recordingDetails.locationDescription |
stringTa właściwość została wycofana 1 czerwca 2017 r. Więcej informacji znajdziesz w ogłoszeniu o wycofaniu funkcji. Tekstowy opis miejsca, w którym nagrano film. |
recordingDetails.location |
objectInformacje o geolokalizacji powiązane z filmem. Pamiętaj, że wartości właściwości podrzędnej określają lokalizację, którą właściciel filmu chce powiązać z filmem. Wartość można edytować, wyszukiwać w publicznych filmach i może być wyświetlana użytkownikom w przypadku publicznych filmów. |
recordingDetails.location.latitude |
doubleTa właściwość została wycofana 1 czerwca 2017 r. Więcej informacji znajdziesz w ogłoszeniu o wycofaniu funkcji. Szerokość geograficzna w stopniach. |
recordingDetails.location.longitude |
doubleTa właściwość została wycofana 1 czerwca 2017 r. Więcej informacji znajdziesz w ogłoszeniu o wycofaniu funkcji. Długość geograficzna w stopniach. |
recordingDetails.location.altitude |
doubleTa właściwość została wycofana 9 lipca 2018 r. Więcej informacji znajdziesz w ogłoszeniu o wycofaniu. Wysokość nad elipsoidą odniesienia w metrach. |
recordingDetails.recordingDate |
datetimeData i godzina nagrania filmu. Wartość jest podana w formacie ISO 8601 ( YYYY-MM-DDThh:mm:ss.sssZ). |
fileDetails |
objectObiekt fileDetails zawiera informacje o pliku wideo przesłanym do YouTube, w tym rozdzielczość pliku, czas trwania, kodeki audio i wideo, szybkość transmisji strumieniowej i inne. Te dane może pobrać tylko właściciel filmu.Obiekt fileDetails zostanie zwrócony tylko wtedy, gdy właściwość processingDetails.fileAvailability ma wartość available. |
fileDetails.fileName |
stringNazwa przesłanego pliku. To pole jest obecne niezależnie od tego, czy przesłano plik wideo, czy inny typ pliku. |
fileDetails.fileSize |
unsigned longRozmiar przesłanego pliku w bajtach. To pole jest obecne niezależnie od tego, czy przesłano plik wideo, czy inny typ pliku. |
fileDetails.fileType |
stringTyp przesłanego pliku wykryty przez silnik przetwarzania filmów w YouTube. Obecnie YouTube przetwarza tylko pliki wideo, ale to pole jest obecne niezależnie od tego, czy przesłano plik wideo, czy inny typ pliku. Prawidłowe wartości tej właściwości to:
|
fileDetails.container |
stringFormat kontenera przesłanego pliku wideo. |
fileDetails.videoStreams[] |
listLista strumieni wideo zawartych w przesłanym pliku wideo. Każdy element na liście zawiera szczegółowe metadane dotyczące strumienia wideo. |
fileDetails.videoStreams[].widthPixels |
unsigned integerSzerokość zakodowanych treści wideo w pikselach. Współczynnik proporcji kodowania filmu możesz obliczyć jako width_pixels / height_pixels. |
fileDetails.videoStreams[].heightPixels |
unsigned integerWysokość zakodowanej treści wideo w pikselach. |
fileDetails.videoStreams[].frameRateFps |
doubleLiczba klatek na sekundę w strumieniu wideo. |
fileDetails.videoStreams[].aspectRatio |
doubleFormat obrazu treści wideo, który określa, w jakim formacie obrazu film powinien być wyświetlany. |
fileDetails.videoStreams[].codec |
stringKodek wideo używany przez strumień. |
fileDetails.videoStreams[].bitrateBps |
unsigned longSzybkość transmisji strumienia wideo w bitach na sekundę. |
fileDetails.videoStreams[].rotation |
stringWartość, o jaką YouTube musi obrócić oryginalną treść źródłową, aby prawidłowo wyświetlić film. Prawidłowe wartości tej właściwości to:
|
fileDetails.videoStreams[].vendor |
stringWartość, która jednoznacznie identyfikuje dostawcę filmów. Zwykle jest to 4-literowy kod dostawcy. |
fileDetails.audioStreams[] |
listLista strumieni audio zawartych w przesłanym pliku wideo. Każdy element listy zawiera szczegółowe metadane dotyczące strumienia audio. |
fileDetails.audioStreams[].channelCount |
unsigned integerLiczba kanałów audio, które zawiera strumień. |
fileDetails.audioStreams[].codec |
stringKodek audio używany przez strumień. |
fileDetails.audioStreams[].bitrateBps |
unsigned longSzybkość transmisji strumienia audio w bitach na sekundę. |
fileDetails.audioStreams[].vendor |
stringWartość, która jednoznacznie identyfikuje dostawcę filmów. Zwykle jest to 4-literowy kod dostawcy. |
fileDetails.durationMs |
unsigned longDługość przesłanego filmu w milisekundach. |
fileDetails.bitrateBps |
unsigned longŁączna szybkość transmisji bitów (obrazu i dźwięku) przesłanego pliku wideo w bitach na sekundę. |
fileDetails.creationTime |
stringData i godzina utworzenia przesłanego pliku wideo. Wartość jest podana w formacie ISO 8601. Obecnie obsługiwane są te formaty ISO 8601:
|
processingDetails |
objectObiekt processingDetails zawiera informacje o postępach YouTube w przetwarzaniu przesłanego pliku wideo. Właściwości obiektu określają bieżący stan przetwarzania i szacowany czas pozostały do zakończenia przetwarzania filmu przez YouTube. Ta część wskazuje również, czy dla filmu są dostępne różne typy danych lub treści, takie jak szczegóły pliku lub miniatury.Obiekt processingProgress jest przeznaczony do odpytywania, aby osoba, która przesłała film, mogła śledzić postępy YouTube w przetwarzaniu przesłanego pliku wideo. Te dane może pobrać tylko właściciel filmu. |
processingDetails.processingStatus |
stringStan przetwarzania filmu. Ta wartość wskazuje, czy YouTube udało się przetworzyć film, czy też film jest nadal przetwarzany. Prawidłowe wartości tej właściwości to:
|
processingDetails.processingProgress |
objectObiekt processingProgress zawiera informacje o postępach YouTube w przetwarzaniu filmu. Wartości są istotne tylko wtedy, gdy stan przetwarzania filmu to processing. |
processingDetails.processingProgress.partsTotal |
unsigned longSzacunkowa łączna liczba części, które muszą zostać przetworzone w przypadku filmu. Podczas przetwarzania filmu przez YouTube liczba ta może być aktualizowana w celu uzyskania dokładniejszych szacunków. |
processingDetails.processingProgress.partsProcessed |
unsigned longLiczba części filmu, które zostały już przetworzone przez YouTube. Możesz oszacować odsetek filmu, który został już przetworzony przez YouTube, obliczając: 100 * parts_processed / parts_totalPamiętaj, że szacunkowa liczba części może wzrosnąć bez odpowiadającego jej wzrostu liczby części, które zostały już przetworzone. Dlatego podczas przetwarzania filmu przez YouTube obliczony postęp może okresowo maleć. |
processingDetails.processingProgress.timeLeftMs |
unsigned longSzacowany czas w milisekundach, jaki YouTube potrzebuje na zakończenie przetwarzania filmu. |
processingDetails.processingFailureReason |
stringPrzyczyna, dla której YouTube nie udało się przetworzyć filmu. Ta właściwość będzie miała wartość tylko wtedy, gdy wartość właściwości processingStatus to failed.Prawidłowe wartości tej właściwości to:
|
processingDetails.fileDetailsAvailability |
stringTa wartość wskazuje, czy szczegóły pliku są dostępne dla przesłanego filmu. Szczegóły pliku filmu możesz pobrać, wysyłając w żądaniu videos.list() część fileDetails. |
processingDetails.processingIssuesAvailability |
stringTa wartość wskazuje, czy silnik przetwarzania filmów wygenerował sugestie, które mogą poprawić zdolność YouTube do przetwarzania filmu, ostrzeżenia wyjaśniające problemy z przetwarzaniem filmu lub błędy, które powodują problemy z przetwarzaniem filmu. Możesz pobrać te sugestie, przesyłając w żądaniu videos.list() część suggestions. |
processingDetails.tagSuggestionsAvailability |
stringTa wartość wskazuje, czy dla filmu są dostępne sugestie słów kluczowych (tagów). Tagi można dodawać do metadanych filmu, aby ułatwić innym użytkownikom jego znalezienie. Możesz pobrać te sugestie, przesyłając w żądaniu videos.list() część suggestions. |
processingDetails.editorSuggestionsAvailability |
stringTa wartość wskazuje, czy dla filmu dostępne są sugestie dotyczące edycji, które mogą poprawić jakość filmu lub wrażenia z odtwarzania. Możesz je pobrać, wysyłając w żądaniu videos.list() prośbę o suggestions. |
processingDetails.thumbnailsAvailability |
stringTa wartość wskazuje, czy dla filmu wygenerowano miniatury. |
suggestions |
objectObiekt suggestions zawiera sugestie, które wskazują możliwości poprawy jakości filmu lub metadanych przesłanego filmu. Te dane może pobrać tylko właściciel filmu. Obiekt suggestions zostanie zwrócony tylko wtedy, gdy właściwość processingDetails.tagSuggestionsAvailability lub processingDetails.editorSuggestionsAvailability ma wartość available. |
suggestions.processingErrors[] |
listLista błędów, które uniemożliwią YouTube prawidłowe przetworzenie przesłanego filmu. Te błędy wskazują, że niezależnie od bieżącego stanu przetwarzania filmu, ostatecznie stan ten prawie na pewno będzie miał wartość failed.Prawidłowe wartości tej właściwości to:
|
suggestions.processingWarnings[] |
listLista powodów, dla których YouTube może mieć trudności z transkodowaniem przesłanego filmu lub które mogą spowodować błędne transkodowanie. Te ostrzeżenia są generowane przed przetworzeniem przesłanego pliku wideo przez YouTube. Ponadto wskazują problemy, które niekoniecznie oznaczają, że przetwarzanie filmu się nie powiedzie, ale mogą powodować problemy, takie jak problemy z synchronizacją, artefakty wideo lub brak ścieżki audio. Prawidłowe wartości tej właściwości to:
|
suggestions.processingHints[] |
listLista sugestii, które mogą poprawić zdolność YouTube do przetwarzania filmu. Prawidłowe wartości tej właściwości to:
|
suggestions.tagSuggestions[] |
listLista tagów słów kluczowych, które można dodać do metadanych filmu, aby zwiększyć prawdopodobieństwo, że użytkownicy znajdą Twój film podczas wyszukiwania lub przeglądania w YouTube. |
suggestions.tagSuggestions[].tag |
stringTag słowa kluczowego sugerowany dla filmu. |
suggestions.tagSuggestions[].categoryRestricts[] |
listZestaw kategorii filmów, do których tag jest odpowiedni. Możesz użyć tych informacji, aby wyświetlać odpowiednie sugestie tagów na podstawie kategorii filmu, którą osoba przesyłająca film powiązała z filmem. Domyślnie sugestie tagów są odpowiednie dla wszystkich kategorii, jeśli dla słowa kluczowego nie zdefiniowano żadnych ograniczeń. |
suggestions.editorSuggestions[] |
listLista operacji edycji wideo, które mogą poprawić jakość lub odtwarzanie przesłanego filmu. Prawidłowe wartości tej właściwości to:
|
liveStreamingDetails |
objectObiekt liveStreamingDetails zawiera metadane dotyczące transmisji wideo na żywo. Obiekt będzie obecny w zasobie video tylko wtedy, gdy film jest nadchodzącą, trwającą lub zakończoną transmisją na żywo. |
liveStreamingDetails.actualStartTime |
datetimeGodzina rozpoczęcia transmisji. Wartość jest podana w formacie ISO 8601. Ta wartość będzie dostępna dopiero po rozpoczęciu transmisji. |
liveStreamingDetails.actualEndTime |
datetimeCzas, w którym transmisja faktycznie się zakończyła. Wartość jest podana w formacie ISO 8601. Ta wartość będzie dostępna dopiero po zakończeniu transmisji. |
liveStreamingDetails.scheduledStartTime |
datetimeZaplanowana godzina rozpoczęcia transmisji. Wartość jest podana w formacie ISO 8601. |
liveStreamingDetails.scheduledEndTime |
datetimeGodzina, o której ma się zakończyć transmisja. Wartość jest podana w formacie ISO 8601. Jeśli wartość jest pusta lub właściwość nie występuje, transmisja ma trwać bezterminowo. |
liveStreamingDetails.concurrentViewers |
unsigned longLiczba widzów, którzy aktualnie oglądają transmisję. Usługa i jej wartość będą widoczne, jeśli transmisja ma aktualnych widzów, a właściciel transmisji nie ukrył liczby wyświetleń filmu. Pamiętaj, że po zakończeniu transmisji YouTube przestaje śledzić liczbę widzów oglądających ją w tym samym czasie. W związku z tym ta właściwość nie określa liczby widzów oglądających zarchiwizowany film z transmisji na żywo, która już się zakończyła. Liczba widzów oglądających transmisję w tym samym czasie zwracana przez interfejs YouTube Data API może się różnić od przetworzonej i oczyszczonej z niechcianych treści liczby widzów oglądających transmisję w tym samym czasie dostępnej w Statystykach YouTube. Więcej informacji o statystykach transmisji na żywo znajdziesz w Centrum pomocy YouTube.
|
liveStreamingDetails.activeLiveChatId |
stringIdentyfikator obecnie aktywnego czatu na żywo dołączonego do tego filmu. To pole jest wypełniane tylko wtedy, gdy film jest obecnie transmitowany na żywo i ma czat na żywo. Gdy transmisja się zakończy, to pole zostanie usunięte, a czat na żywo zostanie zamknięty. W przypadku transmisji ciągłych identyfikator czatu na żywo nie będzie już powiązany z tym filmem, ale z nowym filmem wyświetlanym na stronie ciągłej. |
localizations |
objectObiekt localizations zawiera tłumaczenia metadanych filmu. |
localizations.(key) |
objectJęzyk zlokalizowanego tekstu powiązanego z wartością klucza. Wartość to ciąg znaków zawierający kod języka BCP-47. |
localizations.(key).title |
stringZlokalizowany tytuł filmu. |
localizations.(key).description |
stringZlokalizowany opis filmu. |