Subscriptions

Zasób subscription zawiera informacje o subskrypcji użytkownika YouTube. Subskrypcja powiadamia użytkownika, gdy na kanale dodawany jest nowy film lub gdy inny użytkownik wykona jedną z kilku czynności w YouTube, takich jak przesłanie filmu, wystawienie oceny lub skomentowanie.

Metody

Interfejs API obsługuje te metody zasobów subscriptions:

list

Zwraca zasoby subskrypcji pasujące do kryteriów żądań do interfejsu API. Wypróbuj teraz

wstaw

Dodaje subskrypcję kanału uwierzytelnionego użytkownika. Wypróbuj teraz

usuń

Usuwa subskrypcję. Wypróbuj teraz

Reprezentacja zasobu

Poniższa struktura JSON pokazuje format zasobu subscriptions:

{
  "kind": "youtube#subscription",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelTitle": string,
    "title": string,
    "description": string,
    "resourceId": {
      "kind": string,
      "channelId": string,
    },
    "channelId": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    }
  },
  "contentDetails": {
    "totalItemCount": unsigned integer,
    "newItemCount": unsigned integer,
    "activityType": string
  },
  "subscriberSnippet": {
    "title": string,
    "description": string,
    "channelId": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    }
  }
}

Właściwości

Poniższa tabela przedstawia właściwości, które pojawiają się w tym zasobie:

Właściwości
kind	string Określa typ zasobu interfejsu API. Wartością będzie youtube#subscription.
etag	etag ETag tego zasobu.
id	string Identyfikator, którego YouTube używa do jednoznacznego zidentyfikowania subskrypcji.
snippet	object Obiekt snippet zawiera podstawowe informacje o subskrypcji, w tym tytuł i kanał zasubskrybowany przez użytkownika.
snippet.publishedAt	datetime Data i godzina utworzenia subskrypcji. Wartość należy podać w formacie ISO 8601.
snippet.channelTitle	string Tytuł kanału, którego dotyczy subskrypcja.
snippet.title	string Tytuł subskrypcji.
snippet.description	string Szczegóły subskrypcji.
snippet.resourceId	object Obiekt id zawiera informacje o kanale zasubskrybowanym przez użytkownika.
snippet.resourceId.kind	string Typ zasobu API.
snippet.resourceId.channelId	string Wartość, której używa YouTube do jednoznacznej identyfikacji kanału, który subskrybował użytkownik.
snippet.channelId	string Identyfikator, którego YouTube używa do jednoznacznej identyfikacji kanału subskrybenta. Obiekt resource_id identyfikuje kanał zasubskrybowany przez użytkownika.
snippet.thumbnails	object Mapa miniaturek obrazów powiązanych z subskrypcją. W przypadku każdego obiektu na mapie kluczem jest nazwa obrazu miniatury, a wartością jest obiekt zawierający inne informacje na temat miniatury.
snippet.thumbnails.(key)	object Prawidłowe pary klucz-wartość to: default – domyślna miniatura tego zasobu. Domyślna miniatura filmu lub zasobu nawiązującego do filmu, np. elementu playlisty czy wyniku wyszukiwania – ma 120 pikseli szerokości i 90 pikseli wysokości. Domyślna miniatura kanału ma 88 pikseli szerokości i 88 pikseli wysokości. medium – wersja obrazu miniatury w wyższej rozdzielczości. W przypadku filmu (lub zasobu, który odnosi się do filmu) obraz ten ma 320 pikseli szerokości i 180 pikseli wysokości. W przypadku kanału obraz ma 240 pikseli szerokości i 240 pikseli wysokości. high – wersja obrazu miniatury w wysokiej rozdzielczości. W przypadku filmu (lub zasobu, który odnosi się do filmu) obraz ten ma 480 pikseli szerokości i 360 pikseli wysokości. W przypadku kanału obraz ma 800 pikseli szerokości i 800 pikseli wysokości.
snippet.thumbnails.(key).url	string Adres URL obrazu.
snippet.thumbnails.(key).width	unsigned integer Szerokość obrazu.
snippet.thumbnails.(key).height	unsigned integer Wysokość obrazu.
contentDetails	object Obiekt contentDetails zawiera podstawowe statystyki subskrypcji.
contentDetails.totalItemCount	unsigned integer Przybliżona liczba produktów, do których odnosi się subskrypcja.
contentDetails.newItemCount	unsigned integer Liczba nowych elementów w subskrypcji od momentu ostatniego przeczytania jej treści.
contentDetails.activityType	string Rodzaj aktywności, do której odnosi się ta subskrypcja (tylko przesyłanie, wszystko). Prawidłowe wartości tej usługi to: all uploads
subscriberSnippet	object Obiekt subscriberSnippet zawiera podstawowe informacje o subskrybencie.
subscriberSnippet.title	string Tytuł kanału subskrybenta.
subscriberSnippet.description	string Opis kanału subskrybenta.
subscriberSnippet.channelId	string Identyfikator przypisywany przez YouTube jednoznacznie identyfikujący kanał subskrybenta.
subscriberSnippet.thumbnails	object Miniatury kanału subskrybenta.
subscriberSnippet.thumbnails.(key)	object Prawidłowe pary klucz-wartość to: default – domyślna miniatura tego zasobu. Domyślna miniatura filmu lub zasobu nawiązującego do filmu, np. elementu playlisty czy wyniku wyszukiwania – ma 120 pikseli szerokości i 90 pikseli wysokości. Domyślna miniatura kanału ma 88 pikseli szerokości i 88 pikseli wysokości. medium – wersja obrazu miniatury w wyższej rozdzielczości. W przypadku filmu (lub zasobu, który odnosi się do filmu) obraz ten ma 320 pikseli szerokości i 180 pikseli wysokości. W przypadku kanału obraz ma 240 pikseli szerokości i 240 pikseli wysokości. high – wersja obrazu miniatury w wysokiej rozdzielczości. W przypadku filmu (lub zasobu, który odnosi się do filmu) obraz ten ma 480 pikseli szerokości i 360 pikseli wysokości. W przypadku kanału obraz ma 800 pikseli szerokości i 800 pikseli wysokości.
subscriberSnippet.thumbnails.(key).url	string Adres URL obrazu.
subscriberSnippet.thumbnails.(key).width	unsigned integer Szerokość obrazu.
subscriberSnippet.thumbnails.(key).height	unsigned integer Wysokość obrazu.