Wdrożenie: kanały

Z tej strony dowiesz się, jak używać interfejsu YouTube Data API (wersja 3) do wykonywania funkcji związanych z pobieraniem i aktualizowaniem danych kanału. Zasób channel zawiera identyfikatory playlist, które identyfikują przesłane i polubione filmy na kanale. Aby pobrać te informacje podczas wywoływania metody channels.list, upewnij się, że wartość parametru part zawiera część zasobu contentDetails.

Pobieranie informacji o kanale

Aby pobrać informacje o konkretnym kanale, wywołaj metodę channels.list. Kanał można zidentyfikować na kilka sposobów:

Ustawianie informacji o marce kanału

Ten przykład aktualizuje opcje marki kanału. Przykład składa się z 2 kroków:

  • Krok 1. Pobierz opcje marki kanału

    Wywołaj metodę channels.list i ustaw wartość parametru part na brandingSettings, a wartość parametru mine na true.

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
        part=brandingSettings
        &mine=true

    Twoja aplikacja może wyświetlać pobrane ustawienia, umożliwiając użytkownikowi ich modyfikowanie.

  • Krok 2. Zaktualizuj opcje marki kanału

    Wywołaj metodę channels.list i ustaw te wartości:

    • Ustaw właściwość id na unikalny identyfikator kanału w YouTube. Identyfikator można wyodrębnić z odpowiedzi interfejsu API w kroku 1.
    • Ustaw wartość parametru part na brandingSettings.

    Link do narzędzia APIs Explorer poniżej tworzy zasób channel z tymi ustawieniami marki:

    {
  "id": "CHANNEL_ID",
  "brandingSettings": {
    "channel": {
      "description": "A great channel to be enjoyed by all.",
      "moderateComments": true,
      "showRelatedChannels": true,
      "showBrowseView": true,
      "featuredChannelsTitle": "Featured Channel Stuff",
      "featuredChannelsUrls": [
        "UC_x5XG1OV2P6uZZ5FSM9Ttw",
        "UCBR8-60-B28hp2BmDPdntcQ",
        "UCK8sQmJBp8GCxrOtXWBpyEA"
      ],
      "profileColor": "#006600"
    }
  }
}

    Aby zrealizować żądanie w narzędziu APIs Explorer, musisz ustawić wartość właściwości id na identyfikator kanału uwierzytelnionego użytkownika. Warto też ustawić właściwości obrazu tak, aby pasowały do bieżących ustawień.

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.update?
        part=brandingSettings

Zarządzanie sekcjami kanału

Interfejs API obsługuje metody channelSections.list, channelSections.insert, channelSections.update i channelSections.delete do zarządzania sekcjami kanału. Sekcja kanału to zestaw filmów, które są wyróżnione na kanale. Sekcja może na przykład zawierać najnowsze filmy, najpopularniejsze filmy lub filmy z co najmniej 1 playlisty.

Poniższy przykład pobiera sekcje kanału oficjalnego kanału Google w YouTube. Żądanie wywołuje metodę channelSections.list i ustawia wartość parametru channelId na UCK8sQmJBp8GCxrOtXWBpyEA, czyli identyfikator kanału Google.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channelSections.list?
part=snippet,contentDetails
&channelId=UCK8sQmJBp8GCxrOtXWBpyEA

To żądanie wymaga autoryzacji, jeśli zamiast parametru channelId ustawisz wartość parametru mine na true. Ten parametr wskazuje, że pobierasz sekcje kanału aktualnie uwierzytelnionego użytkownika.

Przesyłanie i ustawianie obrazu znaku wodnego na kanale

Aby przesłać obraz znaku wodnego i ustawić go na kanale, możesz wywołać metodę watermarks.set. Obraz będzie się wtedy wyświetlać podczas odtwarzania filmów z określonego kanału. Możesz też określić kanał docelowy, do którego będzie prowadzić link, oraz szczegóły dotyczące czasu, które określają, kiedy znak wodny ma się pojawiać i jak długo ma być widoczny.

Metoda watermarks.unset usuwa obraz znaku wodnego kanału.

Niestety, tego zapytania nie można przetestować za pomocą narzędzia APIs Explorer, ponieważ nie obsługuje ono przesyłania plików multimedialnych, co jest wymagane w przypadku tej metody.