Wdrożenie: kanały

Z tego artykułu dowiesz się, jak korzystać z interfejsu YouTube Data API (v3), aby wykonywać funkcje związane z pobieraniem i aktualizowaniem danych kanału. Zasób channel zawiera identyfikatory playlist, które identyfikują przesłane i polubione filmy. Aby pobrać te informacje przy wywołaniu metody channels.list, sprawdź, czy wartość parametru part zawiera część zasobu contentDetails.

Pobieranie informacji o kanale

Wywołaj metodę channels.list, aby pobrać informacje o konkretnym kanale. 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

    Aplikacja może wyświetlić pobrane ustawienia, co pozwala użytkownikowi na zmianę ustawień.

  • Krok 2. Zaktualizuj opcje marki kanału

    Wywołaj metodę channels.list i ustaw następujące wartości:

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

    Link do eksploratora API 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 przesłać żądanie w eksploratorze interfejsów API, 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łów

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

W przykładzie poniżej pobieramy sekcje kanału z oficjalnego kanału Google. Żądanie wywołuje metodę channelSections.list i ustawia wartość parametru channelId na UCK8sQmJBp8GCxrOtXWBpyEA, który jest identyfikatorem 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 ustawiasz wartość parametru mine na true. Ten parametr wskazuje, że pobierasz sekcje kanału obecnie uwierzytelnionego kanału użytkownika.

Prześlij i ustaw znak wodny kanału.

Możesz wywołać metodę watermarks.set, aby przesłać obraz ze znakiem wodnym i ustawić go dla kanału. Obraz jest wyświetlany podczas odtwarzania filmów z określonego kanału. Możesz też podać kanał docelowy, do którego będzie prowadził obraz, a także szczegóły czasowe, które określają, kiedy znak wodny się pojawi i jak długo go widać.

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

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.