Ta strona została przetłumaczona przez Cloud Translation API.

Subscriptions

Zasób subscription zawiera informacje o subskrypcji użytkownika YouTube. Subskrypcja powiadamia użytkownika, gdy do kanału zostaną dodane nowe filmy lub gdy inny użytkownik wykona jedną z kilku czynności w YouTube, na przykład prześle film, oceni film lub skomentuje film.

Metody

Interfejs API obsługuje następujące metody w przypadku zasobów subscriptions:

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

Reprezentowanie zasobów

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
      }
    }
  }
}

Usługi

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

Usługi
`kind`	`string` Określa typ zasobu interfejsu API. Wartość będzie wynosić `youtube#subscription`.
`etag`	`etag` Otagowanie tego zasobu.
`id`	`string` Identyfikator, którego YouTube używa do jednoznacznego identyfikowania 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ść ma format ISO 8601.
`snippet.channelTitle`	`string` Tytuł kanału, do którego należy subskrypcja.
`snippet.title`	`string` Tytuł subskrypcji.
`snippet.description`	`string` Szczegóły subskrypcji.
`snippet.resourceId`	`object` Obiekt `id` zawiera informacje o kanale, który zasubskrybował 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 subskrybowanego przez użytkownika.
`snippet.channelId`	`string` Identyfikator, który YouTube wykorzystuje do jednoznacznego identyfikowania kanału subskrybenta. Obiekt `resource_id` wskazuje kanał, który zasubskrybował użytkownik.
`snippet.thumbnails`	`object` Mapa miniaturek powiązanych z subskrypcją. Kluczem jest nazwa obrazu miniatury, a wartość to obiekt zawierający inne informacje o miniaturze.
`snippet.thumbnails.(key)`	`object` Prawidłowe wartości to: `default` – domyślny obraz miniatury zasobu. Domyślna miniatura filmu – lub zasób, który odnosi się do filmu – na przykład element playlisty lub wynik wyszukiwania – to 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` – wyższa wersja miniatury obrazu. W przypadku filmu (lub zasobu, który odnosi się do filmu), obraz ma szerokość 320 pikseli i wysokość 180 pikseli. W przypadku kanału obraz ma szerokość 240 pikseli i wysokość 240 pikseli. `high` – wersja miniatury w wysokiej rozdzielczości. W przypadku filmu (lub zasobu, który odnosi się do filmu), obraz ma szerokość 480 i wysokość 360 pikseli. W przypadku kanału obraz ma szerokość 800 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 elementów w subskrypcji od ostatniego przeczytania ich treści.
`contentDetails.activityType`	`string` Typ aktywności, którego dotyczy 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 w YouTube do identyfikowania kanału subskrybenta.
`subscriberSnippet.thumbnails`	`object` Miniaturowe miniatury kanału subskrybenta.
`subscriberSnippet.thumbnails.(key)`	`object` Prawidłowe wartości to: `default` – domyślny obraz miniatury zasobu. Domyślna miniatura filmu – lub zasób, który odnosi się do filmu – na przykład element playlisty lub wynik wyszukiwania – to 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` – wyższa wersja miniatury obrazu. W przypadku filmu (lub zasobu, który odnosi się do filmu), obraz ma szerokość 320 pikseli i wysokość 180 pikseli. W przypadku kanału obraz ma szerokość 240 pikseli i wysokość 240 pikseli. `high` – wersja miniatury w wysokiej rozdzielczości. W przypadku filmu (lub zasobu, który odnosi się do filmu), obraz ma szerokość 480 i wysokość 360 pikseli. W przypadku kanału obraz ma szerokość 800 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.