Wdrożenie: subskrypcje

Poniższe przykłady pokazują, jak używać interfejsu YouTube Data API (w wersji 3) do wykonywania funkcji związanych z subskrypcjami.

Pobieranie subskrypcji kanału

Aby pobrać subskrypcje konkretnego kanału, wywołaj metodę subscriptions.list. Kanał można zidentyfikować na 2 sposoby:

• Aby pobrać subskrypcje aktualnie uwierzytelnionego użytkownika, ustaw wartość parametru mine na true. Pamiętaj, że żądanie, które używa parametru mine, musi być autoryzowane za pomocą OAuth 2.0.

  https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
          part=snippet,contentDetails
          &mine=true

• Aby pobrać subskrypcje z dowolnego innego kanału, ustaw wartość parametru channelId na unikalny identyfikator kanału YouTube. Przykład poniżej pobiera listę kanałów subskrybowanych przez kanał TED w YouTube.

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

  Uwaga: jeśli wybrany kanał nie udostępnia publicznie swoich subskrypcji, a żądanie nie zostało autoryzowane przez właściciela kanału, interfejs API zwraca kod odpowiedzi HTTP 403 (Forbidden).

Przykłady kodu znajdziesz w dokumentacji metody subscriptions.list.

Dodawanie subskrypcji

Aby dodać subskrypcję kanału, wywołaj metodę subscriptions.insert. To żądanie musi być autoryzowane za pomocą OAuth 2.0. Treść żądania to zasób subscription, który określa te wartości:

• snippet.resourceId.kind zawiera wartość youtube#channel.
• Właściwość snippet.resourceId.channelId identyfikuje kanał, który jest subskrybowany. Wartość właściwości to unikalny identyfikator kanału w YouTube. Identyfikator kanału można uzyskać na kilka sposobów, m.in. wywołując metodę channels.list lub pobierając wyniki wyszukiwania kanałów.

Poniższe żądanie interfejsu API subskrybuje kanał TED w YouTube:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.insert?
        part=snippet

Treść żądania:

{
  "snippet": {
    "resourceId": {
      "kind": "youtube#channel",
      "videoId": "UCAuUUnT6oDeKwE6v1NGQxug"
    }
  }
}

Przykłady kodu znajdziesz w dokumentacji metody subscriptions.insert.

Usuwanie subskrypcji

W tym przykładzie subskrypcja zostaje usunięta. To żądanie musi być autoryzowane za pomocą OAuth 2.0. W tym przykładzie należy wykonać 2 kroki:

• Krok 1. Pobierz subskrypcje kanału uwierzytelnionego użytkownika

  Aby pobrać listę subskrypcji, wywołaj metodę subscriptions.list. Jak przesłać prośbę, pokazuje przykład powyżej dotyczący pobierania subskrypcji kanału.

  Aplikacja wywołująca interfejs API może przetworzyć odpowiedź interfejsu API, aby wyświetlić listę subskrypcji, używając identyfikatora każdej subskrypcji jako klucza. W odpowiedzi właściwość id każdego elementu identyfikuje identyfikator subskrypcji, który jednoznacznie identyfikuje odpowiednią subskrypcję. W następnym kroku użyjesz tej wartości, aby usunąć element z listy.

• Krok 2. Usuń subskrypcję

  Aby usunąć subskrypcję, wywołaj metodę subscriptions.delete. Ustaw parametr id żądania na identyfikator subskrypcji, którą chcesz usunąć. To żądanie musi być autoryzowane za pomocą OAuth 2.0.

  Aby przesłać żądanie w interfejsie APIs Explorer, musisz ustawić wartość właściwości id.

  https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.delete?
          id=SUBSCRIPTION_ID

Przykłady kodu znajdziesz w dokumentacji metody subscriptions.delete.

Pobieranie listy subskrybentów kanału autoryzowanego użytkownika

Aby pobrać listę kanałów, które subskrybują kanał aktualnie uwierzytelnionego użytkownika, wywołaj metodę subscriptions.list i ustaw wartość parametru mySubscribers na true. Żądanie musi być autoryzowane za pomocą OAuth 2.0.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
        part=snippet,contentDetails
        &mySubscribers=true