Wdrożenie: subskrypcje

Poniższe przykłady pokazują, jak korzystać z interfejsu YouTube Data API (v3) w celu wykonywania funkcji związanych z subskrypcjami.

Pobieranie subskrypcji kanału

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

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

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

• Aby pobrać subskrypcje innych kanałów, ustaw wartość parametru channelId na unikalny identyfikator tego kanału w YouTube. Poniżej znajduje się lista 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: interfejs API zwraca kod odpowiedzi HTTP 403 (Forbidden), jeśli określony kanał nie ujawnia publicznie swoich subskrypcji, a żądanie nie jest autoryzowane przez właściciela kanału.

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

Dodawanie subskrypcji

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

• Pole snippet.resourceId.kind zawiera wartość youtube#channel.
• Właściwość snippet.resourceId.channelId wskazuje kanał, który subskrybujesz. Wartość właściwości to unikalny identyfikator kanału YouTube. Identyfikator kanału można uzyskać na różne sposoby, np. wywołując metodę channels.list lub pobierając wyniki wyszukiwania dla kanałów.

Żądanie dotyczące interfejsu API poniżej pozwala zasubskrybować kanał TED w YouTube:

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

Treść żądania to:

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

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

Usuwanie subskrypcji

Ten przykład usuwa subskrypcję. To żądanie musi zostać autoryzowane przez OAuth 2.0. Ten przykład obejmuje 2 kroki:

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

  Wywołaj metodę subscriptions.list, aby pobrać listę subskrypcji. W powyższym przykładzie dotyczącym pobierania subskrypcji kanału wyjaśniono, jak przesłać taką prośbę.

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

• Krok 2. Usuń subskrypcję

  Aby usunąć subskrypcję, wywołaj metodę subscriptions.delete. Ustaw parametr id w żądaniu na identyfikator subskrypcji, którą chcesz usunąć. To żądanie musi zostać autoryzowane przez OAuth 2.0.

  Aby przesłać żądanie w Eksploratorze interfejsów API, 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ą obecnie uwierzytelniony kanał użytkownika, wywołaj metodę subscriptions.list i ustaw wartość parametru mySubscribers na true. Żądanie musi być autoryzowane przez OAuth 2.0.

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