Subscriptions

Zasób subscription zawiera informacje o subskrypcji użytkownika YouTube. Subskrypcja powiadamia użytkownika, gdy na kanale pojawią się nowe filmy lub gdy inny użytkownik wykona w YouTube jedno z kilku działań, takich jak przesłanie filmu, ocenienie filmu lub skomentowanie filmu.

Metody

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

list
Zwraca zasoby subskrypcji, które spełniają kryteria żądania API. Wypróbuj teraz
wstaw
Dodaje subskrypcję kanału uwierzytelnionego użytkownika. Wypróbuj teraz
usuń
Usuwa subskrypcję. Wypróbuj teraz

Prezentacja zasobów

Poniższa struktura JSON przedstawia 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 zawiera definicje właściwości, które pojawiają się w tym zasobie:

Właściwości
kind string
Określa typ zasobu interfejsu API. Wartość będzie wynosić youtube#subscription.
etag etag
Tag ETag tego zasobu.
id string
Identyfikator, którego YouTube używa do jednoznacznej identyfikacji subskrypcji.
snippet object
Obiekt snippet zawiera podstawowe informacje o subskrypcji, w tym jej tytuł i kanał, który subskrybuje użytkownik.
snippet.publishedAt datetime
Data i godzina utworzenia subskrypcji. Wartość jest podana w formacie ISO 8601.
snippet.title string
Tytuł subskrypcji.
snippet.description string
Szczegóły subskrypcji.
snippet.resourceId object
Obiekt id zawiera informacje o kanale, który subskrybuje użytkownik.
snippet.resourceId.kind string
Typ zasobu interfejsu API.
snippet.resourceId.channelId string
Wartość, której YouTube używa do jednoznacznego identyfikowania kanału, który subskrybuje użytkownik.
snippet.channelId string
Identyfikator, którego YouTube używa do jednoznacznego identyfikowania kanału subskrybenta. Obiekt resource_id określa kanał, który subskrybuje użytkownik.
snippet.thumbnails object
Mapa obrazów miniaturowych powiązanych z subskrypcją. W przypadku każdego obiektu na mapie kluczem jest nazwa miniatury, a wartością jest obiekt zawierający inne informacje o miniaturze.
snippet.thumbnails.(key) object
Prawidłowe wartości klucza to:
  • default – domyślny obraz miniatury tego zasobu. Domyślna miniatura filmu lub zasobu, który odnosi się do filmu, np. elementu playlisty lub wyniku wyszukiwania, ma szerokość 120 pikseli i wysokość 90 pikseli. Domyślna miniatura kanału ma 88 pikseli szerokości i 88 pikseli wysokości.
  • medium – wersja miniatury w wyższej rozdzielczości. W przypadku filmu (lub zasobu, który odwołuje się do filmu) ten obraz ma szerokość 320 pikseli i wysokość 180 pikseli. W przypadku kanału obraz ten ma szerokość 240 pikseli i wysokość 240 pikseli.
  • high – wersja miniatury w wysokiej rozdzielczości. W przypadku filmu (lub zasobu, który odwołuje się do filmu) obraz ma szerokość 480 pikseli i wysokość 360 pikseli. W przypadku kanału obraz ten ma szerokość i wysokość 800 pikseli.
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 dotyczące subskrypcji.
contentDetails.totalItemCount unsigned integer
Przybliżona liczba elementów, do których odnosi się subskrypcja.
contentDetails.newItemCount unsigned integer
Liczba nowych pozycji w subskrypcji od czasu ostatniego przeczytania treści.
contentDetails.activityType string
Typ aktywności, której dotyczy subskrypcja (tylko przesyłanie, wszystko).

Prawidłowe wartości tego pola 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, który YouTube przypisuje, aby jednoznacznie określić kanał subskrybenta.
subscriberSnippet.thumbnails object
Miniatury kanału subskrybenta.
subscriberSnippet.thumbnails.(key) object
Prawidłowe wartości klucza to:
  • default – domyślny obraz miniatury tego zasobu. Domyślna miniatura filmu lub zasobu, który odnosi się do filmu, np. elementu playlisty lub wyniku wyszukiwania, ma szerokość 120 pikseli i wysokość 90 pikseli. Domyślna miniatura kanału ma 88 pikseli szerokości i 88 pikseli wysokości.
  • medium – wersja miniatury w wyższej rozdzielczości. W przypadku filmu (lub zasobu, który odwołuje się do filmu) ten obraz ma szerokość 320 pikseli i wysokość 180 pikseli. W przypadku kanału obraz ten ma szerokość 240 pikseli i wysokość 240 pikseli.
  • high – wersja miniatury w wysokiej rozdzielczości. W przypadku filmu (lub zasobu, który odwołuje się do filmu) obraz ma szerokość 480 pikseli i wysokość 360 pikseli. W przypadku kanału obraz ten ma szerokość i wysokość 800 pikseli.
subscriberSnippet.thumbnails.(key).url string
Adres URL obrazu.
subscriberSnippet.thumbnails.(key).width unsigned integer
Szerokość obrazu.
subscriberSnippet.thumbnails.(key).height unsigned integer
Wysokość obrazu.