Uwaga: Zasady dla deweloperów YouTube zawierają wskazówki i przykłady, które pomogą Ci zadbać o to, aby klienci korzystający z interfejsu API przestrzegali określonych części Warunków i zasad (Warunki korzystania z usługi API). Przewodnik zawiera informacje o tym, jak YouTube egzekwuje określone aspekty Warunków korzystania z usługi interfejsu API, ale nie zastępuje żadnych istniejących dokumentów.
Ten dokument określa minimalne wymagania funkcjonalne dla klientów API, którzy implementują lub zapewniają dostęp do określonych funkcji usług interfejsu API YouTube („Klienci API”).
Te wymagania i wytyczne gwarantują, że klienci interfejsu API zapewniają spójne wrażenia użytkowników, które chronią interesy użytkowników YouTube, właścicieli treści i reklamodawców. Te zasady są integralną częścią Warunków korzystania z interfejsu API YouTube i muszą być przestrzegane podczas tworzenia i wdrażania dowolnego klienta API.
Należy się spodziewać, że wymagania w tym dokumencie ulegną zmianie, abyśmy mogli zapewnić użytkownikom lepsze wrażenia podczas korzystania z dotychczasowych funkcji YouTube. Zmiany będą też wprowadzane w reakcji na nowe i zaktualizowane funkcje YouTube. Czasami takie zmiany mogą wymagać aktualizacji klientów interfejsu API w celu spełnienia nowych wymagań. Historia zmian Warunków korzystania z usługi będzie zawierać informacje o wszystkich zmianach, dlatego często sprawdzaj ten dokument lub zasubskrybuj jego strumień RSS, aby szybko dowiadywać się o zmianach, które mogą mieć wpływ na Twoich klientów interfejsu API.
Oprócz wymagań podanych w tym dokumencie zdecydowanie zalecamy stosowanie sprawdzonych metod opisanych w zasadach dotyczących usług YouTube API oraz w innej dokumentacji usług YouTube API. Nawet jeśli nie jest to wymagane, te metody pomagają klientom API szybciej odzyskiwać się po błędach i optymalizować wykorzystanie limitu, jeśli korzystają z usług interfejsu API YouTube, które przypisują limit. Jednocześnie te praktyki pomagają zapewnić prawidłowe działanie ekosystemu YouTube i przede wszystkim zapewnić jak najlepsze wrażenia użytkownikom klientów interfejsu API i aplikacji YouTube.
Osadzony odtwarzacz YouTube i odtwarzanie filmów
Wymagania w tej sekcji dotyczą w szczególności umieszczonych odtwarzaczy YouTube. Zasady dotyczące usług interfejsu API YouTube obejmują też kilka zasad dotyczących klientów interfejsu API, które odtwarzają treści audiowizualne z YouTube.
Rozmiar umieszczonego odtwarzacza YouTube
Odtwarzacz umieszczony na stronie musi mieć okno wyświetlania o rozmiarze co najmniej 200 x 200 pikseli. Jeżeli w odtwarzaczu mają być widoczne elementy sterujące, musi on być na tyle duży, aby elementy te były całkowicie widoczne bez zmniejszania okna wyświetlania poniżej rozmiaru minimalnego. W przypadku odtwarzaczy 16:9 zalecamy rozmiar co najmniej 480 pikseli szerokości i 270 pikseli wysokości.
Automatyczne odtwarzanie i odtwarzanie ze skryptem
Ta sekcja dotyczy automatycznego odtwarzania. Dotyczy to umieszczonych odtwarzaczy YouTube, które używają parametru autoplay lub inicjują automatyczne odtwarzanie za pomocą interfejsu YouTube IFrame Player API lub innego interfejsu YouTube API.
-
Wbudowane odtwarzacze, które automatycznie odtwarzają film, powinny rozpocząć odtwarzanie natychmiast po załadowaniu strony lub gdy tylko wbudowany odtwarzacz będzie w pełni widoczny. Klient interfejsu API nie może jednak zainicjować automatycznego odtwarzania, dopóki odtwarzacz nie będzie widoczny i nie będzie widoczna co najmniej połowa odtwarzacza na stronie lub ekranie.
-
Na stronie lub ekranie nie może być więcej niż 1 odtwarzacza YouTube, który automatycznie odtwarza treści jednocześnie.
-
Miniatura w YouTube, która inicjuje odtwarzanie, musi mieć co najmniej 120 pikseli szerokości i 70 pikseli wysokości.
Atrybuty odtwarzacza YouTube
Atrybuty i parametry odtwarzacza YouTube, w tym np. wygląd marki YouTube w odtwarzaczu, są określone w dokumentacji i specyfikacjach interfejsu YouTube API (https://developers.google.com/youtube). Nie możesz wprowadzać w odtwarzaczu YouTube zmian, które nie są wyraźnie opisane w dokumentacji interfejsu API.
Nakładki i ramki
Nie wolno wyświetlać nakładek, ramek ani innych elementów wizualnych na części odtwarzacza YouTube, w tym elementów sterujących. Nie możesz też używać nakładek, ramek ani innych elementów wizualnych, aby zasłonić jakąkolwiek część wbudowanego odtwarzacza, w tym elementów sterujących.
Przesunięcia kursora myszy
Nie wolno używać zdarzeń przesuwania kursora ani dotykania w odtwarzaczu YouTube w celu zainicjowania jakiegokolwiek działania w imieniu użytkownika, takiego jak otwarcie okna czy subskrypcja kanału.
Przesyłanie filmów wideo
Jeśli klienci interfejsu API umożliwiają użytkownikom przesyłanie treści na wiele platform, użytkownicy powinni mieć możliwość wybrania i odznaczenia platform, na które chcą przesłać filmy.
Wymagania dotyczące danych
Klienci interfejsu API, którzy umożliwiają użytkownikom przesyłanie filmów do YouTube, muszą umożliwić użytkownikom ustawianie wartości z poniższej listy. Wszystkie właściwości, które nie są wymienione, są opcjonalne.
| Nazwa | Opis | |
|---|---|---|
| Właściwości zasobu | ||
snippet.title |
Wymagany. Tytuł filmu. YouTube zwraca błąd, jeśli wartość przekracza 100 znaków. YouTube obsługuje wszystkie prawidłowe znaki UTF-8 z wyjątkiem znaków < i >.
| |
snippet.description |
Wymagany. Opis filmu. YouTube zwraca błąd, jeśli wartość przekracza 5000 bajtów. YouTube obsługuje wszystkie prawidłowe znaki UTF-8 z wyjątkiem znaków < i >. |
|
status.privacyStatus |
Wymagany. ustawienia prywatności filmu, Użytkownicy muszą mieć możliwość wyboru, czy przesłany film ma być publiczny, prywatny czy niepubliczny. | |
| Parametry żądania | ||
onBehalfOfContentOwnerChannel |
Wymagany warunkowo. Jeśli dane autoryzacyjne żądania wskazują na właściciela treści i jeśli parametr onBehalfOfContentOwner jest ustawiony, użytkownik interfejsu API musi też mieć możliwość określenia kanału YouTube, na który ma zostać przesłany film. |
|
Wyświetlanie komentarzy
| Nazwa | Opis | |
|---|---|---|
| Właściwości zasobu | ||
snippet.textDisplay |
Wymagany. Tekst komentarza. Klient interfejsu API musi (a) wyświetlać pełny tekst komentarza lub odpowiedzi na komentarz albo (b) obciąć tekst i zapewnić widzom łatwy dostęp do pełnej wersji obciętego tekstu. To wymaganie dotyczy wszystkich komentarzy i odpowiedzi na komentarze, niezależnie od typu zasobu, z którym są powiązane (filmy, kanały itp.). Wartość właściwości snippet.topLevelComment zasobu commentThread to zasób comment, a właściwość replies.comments[] to lista zasobów comment. Dlatego ten wymóg dotyczy też właściwości snippet.topLevelComment.snippet.textDisplay i replies.comments[].snippet.textDisplay. |
|
snippet.title( channel) |
Wymagany (sugestia). Tytuł kanału.
|
|
snippet.title( video) |
Wymagany warunkowo (propozycja). Tytuł filmu. Ta wartość musi być wyświetlana, jeśli komentarz dotyczy filmu. | |
snippet.moderationStatus |
Wymagany warunkowo. Jeśli wartość parametru moderationStatus w żądaniu interfejsu API to heldForReview lub likelySpam, wyświetlenie musi wyraźnie wskazywać ten stan za pomocą wartości właściwości, podobnego języka (np. „Ten komentarz jest wstrzymany do sprawdzenia”), nagłówka (np. „Wstrzymany do sprawdzenia”) lub innego jednoznacznego języka. Metoda commentThreads.list umożliwia pobieranie komentarzy na podstawie ich stanu moderowania. |
|
Dodawanie komentarzy
| Nazwa | Opis | |
|---|---|---|
| Właściwości zasobu | ||
snippet.title( channel) |
Wymagany. Tytuł kanału.
|
|
snippet.title( video) |
Wymagany. Jeśli użytkownik dodaje komentarz do filmu, klient interfejsu API musi wyświetlić tytuł filmu. | |
| Inne wymagania | ||
Comment author's channel name |
Wymagany. Klient interfejsu API musi wyraźnie wskazać konto użytkownika YouTube, do którego zostanie przypisany komentarz. Jeśli dane logowania autoryzacji żądania wskazują na właściciela treści i jeśli parametr onBehalfOfContentOwner jest ustawiony, użytkownik interfejsu API musi też mieć możliwość określenia kanału w YouTube, do którego zostanie przypisany komentarz. |
|
Dodawanie odpowiedzi na komentarze
| Nazwa | Opis | |
|---|---|---|
| Właściwości zasobu | ||
snippet.textDisplay |
Wymagany. Tekst komentarza. Klient interfejsu API musi wyświetlać tekst komentarza, na który użytkownik odpowiada, zgodnie z zasadami określonymi w sekcji Wyświetlanie komentarzy tego dokumentu. | |
snippet.title( channel) |
Wymagany. Tytuł kanału.
|
|
snippet.title( video) |
Wymagany. Jeśli użytkownik odpowiada na komentarz dotyczący filmu, klient interfejsu API musi wyświetlić tytuł filmu. | |
| Inne wymagania | ||
Comment author's channel name |
Wymagany. Klient interfejsu API musi wyraźnie zidentyfikować konto użytkownika YouTube, do którego zostanie przypisana odpowiedź na komentarz. Jeśli dane autoryzacyjne żądania wskazują na właściciela treści i jeśli parametr onBehalfOfContentOwner jest ustawiony, użytkownik interfejsu API musi też mieć możliwość określenia kanału w YouTube, do którego zostanie przypisana odpowiedź na komentarz. |
|
Edytowanie i usuwanie odpowiedzi na komentarze
| Nazwa | Opis | |
|---|---|---|
| Właściwości zasobu | ||
snippet.textDisplay |
Wymagany. Tekst komentarza. Klient interfejsu API musi wyświetlać tekst komentarza, który użytkownik edytuje lub usuwa, zgodnie z zasadami określonymi w sekcji Wyświetlanie komentarzy tego dokumentu. | |
snippet.title( channel) |
Wymagany. Tytuł kanału.
|
|
snippet.title( video) |
Wymagany. Jeśli użytkownik edytuje lub usuwa komentarz do filmu, klient interfejsu API musi wyświetlić tytuł filmu. | |
| Inne wymagania | ||
Comment author's channel name |
Wymagany. Klient interfejsu API musi wyraźnie wskazać konto użytkownika YouTube, do którego jest przypisany komentarz. | |
Blokowanie użytkownika w czacie na żywo (lub usuwanie blokady)
| Nazwa | Opis | |
|---|---|---|
| Właściwości zasobu | ||
snippet.title( channel) |
Wymagany. Nazwa kanału YouTube, który jest banowany lub odbanowywany. Dodatkowo nazwa musi zawierać link do kanału lub musi być wyświetlany adres URL kanału. | |
| Inne wymagania | ||
| Nazwa kanału autora komentarza | Wymagany. Klient interfejsu API musi wyraźnie określić konto użytkownika YouTube, którego dotyczy dodanie lub usunięcie blokady. | |