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

Subscriptions

subscription kaynağı, YouTube kullanıcı aboneliği hakkında bilgi içerir. Abonelik, kanala yeni video eklendiğinde veya başka bir kullanıcı YouTube'daki video yükleme, video derecelendirme ya da 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ğrulanmış kullanıcının kanalı için abonelik ekler. Hemen deneyin.
sil: Bir aboneliği siler. Hemen deneyin.

Kaynak temsili

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

{
  "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` olacak.
`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, uygulamanın 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` Aboneliğin 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ğer.
`snippet.channelId`	`string` YouTube'un, abonelerin kanalını benzersiz şekilde tanımlamak için kullandığı kimliktir. `resource_id` nesnesi, kullanıcının abone olduğu kanalı tanımlar.
`snippet.thumbnails`	`object` Abonelikle ilişkili küçük resim haritası. Haritadaki her bir nesne için anahtar, küçük resmin adı, değer de küçük resim hakkında diğer bilgileri içeren bir nesnedir.
`snippet.thumbnails.(key)`	`object` Geçerli anahtar değerleri şunlardır: `default` – Bu kaynağın varsayılan küçük resmi. 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 yüksekliğindedir. `medium` – Küçük resmin daha yüksek çözünürlüklü bir sürümü. Bir video (veya bir videoya atıfta bulunan kaynaklar) için bu resim 320 piksel genişliğinde ve 180 piksel yüksekliğinde. Bir 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 bir videoya referans veren 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 yüksekliğindedir.
`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` Abonelikteki son okuma işleminden bu yana geçen yeni öğe 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ığıdır.
`subscriberSnippet.description`	`string` Abonenin kanalının açıklaması.
`subscriberSnippet.channelId`	`string` Abonenin kanalını benzersiz şekilde tanımlamak için YouTube'un atadığı kimlik.
`subscriberSnippet.thumbnails`	`object` Abonenin kanalının küçük resmi.
`subscriberSnippet.thumbnails.(key)`	`object` Geçerli anahtar değerleri şunlardır: `default` – Bu kaynağın varsayılan küçük resmi. 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 yüksekliğindedir. `medium` – Küçük resmin daha yüksek çözünürlüklü bir sürümü. Bir video (veya bir videoya atıfta bulunan kaynaklar) için bu resim 320 piksel genişliğinde ve 180 piksel yüksekliğinde. Bir 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 bir videoya referans veren 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 yüksekliğindedir.
`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.