Bu sayfa, Cloud Translation API ile çevrilmiştir.

Subscriptions

subscription kaynağı, YouTube kullanıcı aboneliğiyle ilgili bilgileri içerir. Abonelik, bir kanala yeni video eklendiğinde veya başka bir kullanıcı YouTube'da video yükleme, videoyu derecelendirme ya da bir videoya yorum yapma gibi çeşitli işlemlerden birini gerçekleştirdiğinde kullanıcıyı bilgilendirir.

Yöntemler

API, subscriptions kaynakları için aşağıdaki yöntemleri destekler:

list: API isteği ölçütleriyle eşleşen abonelik kaynaklarını döndürür. Hemen deneyin.
ekle: Kimliği doğrulanan kullanıcının kanalı için bir abonelik ekler. Hemen deneyin.
sil: Bir aboneliği siler. Hemen deneyin.

Kaynak temsili

Aşağıdaki JSON yapısı, subscriptions kaynağının biçimini gösterir:

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

Özellikler

Aşağıdaki tabloda bu kaynakta görünen özellikler tanımlanmaktadır:

Özellikler
`kind`	`string` API kaynağının türünü tanımlar. Değer `youtube#subscription` olur.
`etag`	`etag` Bu kaynağın Etag'i.
`id`	`string` YouTube'un aboneliği benzersiz şekilde tanımlamak için kullandığı kimlik.
`snippet`	`object` `snippet` nesnesi, aboneliğin başlığı ve kullanıcının abone olduğu kanal da dahil olmak üzere abonelikle ilgili temel ayrıntıları içerir.
`snippet.publishedAt`	`datetime` Aboneliğin oluşturulduğu tarih ve saat. Değer, ISO 8601 biçiminde belirtilir.
`snippet.channelTitle`	`string` Aboneliğin ait olduğu kanalın başlığı.
`snippet.title`	`string` Aboneliğin başlığı.
`snippet.description`	`string` Abonelik ayrıntıları.
`snippet.resourceId`	`object` `id` nesnesi, kullanıcının abone olduğu kanalla ilgili bilgileri içerir.
`snippet.resourceId.kind`	`string` API kaynağının türü.
`snippet.resourceId.channelId`	`string` YouTube'un, kullanıcının abone olduğu kanalı benzersiz şekilde tanımlamak için kullandığı değerdir.
`snippet.channelId`	`string` YouTube'un, abonenin kanalını benzersiz şekilde tanımlamak için kullandığı kimlik. `resource_id` nesnesi, kullanıcının abone olduğu kanalı tanımlar.
`snippet.thumbnails`	`object` Abonelikle ilişkili küçük resimlerin haritası. Haritadaki her bir nesne için anahtar, küçük resmin adı ve değer, küçük resimle ilgili diğer bilgileri içeren bir nesnedir.
`snippet.thumbnails.(key)`	`object` Geçerli anahtar değerleri şunlardır: `default` – Bu kaynak için varsayılan küçük resim. Bir videonun (veya oynatma listesi öğesi ya da arama sonucu gibi bir videoya atıfta bulunan kaynağın) varsayılan küçük resmi 120 piksel genişliğinde ve 90 piksel yüksekliğindedir. Bir kanalın varsayılan küçük resmi, 88 piksel genişliğinde ve 88 piksel uzunluğundadır. `medium` – Küçük resmin daha yüksek çözünürlüklü sürümü. Bir video (veya videoya atıfta bulunan bir kaynak) için bu resim 320 piksel genişliğinde ve 180 piksel yüksekliğindedir. Kanal için bu resim 240 piksel genişliğinde ve 240 piksel yüksekliğindedir. `high` – Küçük resmin yüksek çözünürlüklü sürümü. Bir video (veya videoya atıfta bulunan bir kaynak) için bu resim 480 piksel genişliğinde ve 360 piksel yüksekliğindedir. Kanal için bu resim 800 piksel genişliğinde ve 800 piksel uzunluğundadır.
`snippet.thumbnails.(key).url`	`string` Resmin URL'si.
`snippet.thumbnails.(key).width`	`unsigned integer` Resmin genişliği.
`snippet.thumbnails.(key).height`	`unsigned integer` Resmin yüksekliği.
`contentDetails`	`object` `contentDetails` nesnesi, abonelikle ilgili temel istatistikleri içerir.
`contentDetails.totalItemCount`	`unsigned integer` Aboneliğin işaret ettiği yaklaşık öğe sayısı.
`contentDetails.newItemCount`	`unsigned integer` İçeriğinin son okunmasından bu yana abonelikteki yeni öğelerin sayısı.
`contentDetails.activityType`	`string` Bu aboneliğin ait olduğu etkinlik türü (yalnızca yüklemeler, her şey). Bu mülk için geçerli değerler şunlardır: `all` `uploads`
`subscriberSnippet`	`object` `subscriberSnippet` nesnesi, aboneyle ilgili temel ayrıntıları içerir.
`subscriberSnippet.title`	`string` Abonenin kanalının başlığı.
`subscriberSnippet.description`	`string` Abonenin kanalının açıklaması.
`subscriberSnippet.channelId`	`string` YouTube'un, abonenin kanalını benzersiz şekilde tanımlamak için atadığı kimliktir.
`subscriberSnippet.thumbnails`	`object` Abonenin kanalı için küçük resimler.
`subscriberSnippet.thumbnails.(key)`	`object` Geçerli anahtar değerleri şunlardır: `default` – Bu kaynak için varsayılan küçük resim. Bir videonun (veya oynatma listesi öğesi ya da arama sonucu gibi bir videoya atıfta bulunan kaynağın) varsayılan küçük resmi 120 piksel genişliğinde ve 90 piksel yüksekliğindedir. Bir kanalın varsayılan küçük resmi, 88 piksel genişliğinde ve 88 piksel uzunluğundadır. `medium` – Küçük resmin daha yüksek çözünürlüklü sürümü. Bir video (veya videoya atıfta bulunan bir kaynak) için bu resim 320 piksel genişliğinde ve 180 piksel yüksekliğindedir. Kanal için bu resim 240 piksel genişliğinde ve 240 piksel yüksekliğindedir. `high` – Küçük resmin yüksek çözünürlüklü sürümü. Bir video (veya videoya atıfta bulunan bir kaynak) için bu resim 480 piksel genişliğinde ve 360 piksel yüksekliğindedir. Kanal için bu resim 800 piksel genişliğinde ve 800 piksel uzunluğundadır.
`subscriberSnippet.thumbnails.(key).url`	`string` Resmin URL'si.
`subscriberSnippet.thumbnails.(key).width`	`unsigned integer` Resmin genişliği.
`subscriberSnippet.thumbnails.(key).height`	`unsigned integer` Resmin yüksekliği.