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