Wdrożenie: kanały

Na tej stronie wyjaśniamy, jak używać interfejsu YouTube Data API (v3) do wykonywania funkcji związanych z pobieraniem i aktualizowaniem danych kanału. Zasób channel zawiera identyfikatory playlist, które wskazują 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żesz zidentyfikować na kilka sposobów:

Ustawianie informacji o elementach marki kanału

W tym przykładzie aktualizujemy opcje marki kanału. Przykład składa się z 2 etapó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

    Aplikacja może wyświetlać odzyskane ustawienia, umożliwiając użytkownikowi ich modyfikowanie w celu aktualizacji.

  • 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 YouTube. Identyfikator można wyodrębnić z odpowiedzi interfejsu API w kroku 1.
    • Ustaw wartość parametru part na brandingSettings.

    Poniższy link do narzędzia API Explorer 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 wykonać żądanie w interfejsie APIs Explorer, musisz ustawić wartość właściwości id na identyfikator kanału uwierzytelnionego użytkownika. Musisz też ustawić właściwości obrazu zgodnie z bieżącymi ustawieniami.

    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 zbiór filmów, które są wyświetlane na kanale. Może to być na przykład sekcja z najnowszymi przesłanymi filmami, najczęściej przesyłanymi filmami lub filmami z jednej lub większej liczby playlist.

Przykład poniżej zwraca sekcje kanału na oficjalnym kanale YouTube Google. Żą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 dla kanału aktualnie uwierzytelnionego użytkownika.

Przesyłanie i ustawianie graficznego 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 wyświetlany podczas odtwarzania filmów na określonym kanale. Możesz też określić kanał docelowy, do którego będzie prowadzić link z obrazem, a także szczegóły dotyczące czasu, który określa, kiedy i jak długo ma być widoczne znak wodny.

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.