Activities

YouTube, kanal bülteni özelliğini kullanımdan kaldırdı. activities.list yöntemi hâlâ kanal bültenlerini döndürmez ve activities.insert yöntemi artık desteklenmemektedir. Daha ayrıntılı bilgi için lütfen YouTube Yardım Merkezi'ni ziyaret edin.

activity kaynağı, belirli bir kanalın veya kullanıcının YouTube'da gerçekleştirdiği bir işlemle ilgili bilgileri içerir. Etkinlik feed'lerinde bildirilen işlemler arasında video derecelendirme, video paylaşma, videoyu favori olarak işaretleme, video yükleme vb. bulunur. Her activity kaynağı; işlemin türünü, işlemle ilişkili kanalı ve işlemle ilişkili kaynakları(ör. puanlanan veya yüklenen video) tanımlar.

Yöntemler

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

list

İstek ölçütleriyle eşleşen kanal etkinliği etkinliklerinin listesini döndürür. Örneğin, belirli bir kanalla veya kullanıcının kendi kanalıyla ilişkili etkinlikleri alabilirsiniz. Hemen deneyin.

activities.insert yöntemi artık desteklenmiyor.

Kaynak temsili

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

{
  "kind": "youtube#activity",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "type": string,
    "groupId": string
  },
  "contentDetails": {
    "upload": {
      "videoId": string
    },
    "like": {
      "resourceId": {
        "kind": string,
        "videoId": string,
      }
    },
    "favorite": {
      "resourceId": {
        "kind": string,
        "videoId": string,
      }
    },
    "comment": {
      "resourceId": {
        "kind": string,
        "videoId": string,
        "channelId": string,
      }
    },
    "subscription": {
      "resourceId": {
        "kind": string,
        "channelId": string,
      }
    },
    "playlistItem": {
      "resourceId": {
        "kind": string,
        "videoId": string,
      },
      "playlistId": string,
      "playlistItemId": string
    },
    "recommendation": {
      "resourceId": {
        "kind": string,
        "videoId": string,
        "channelId": string,
      },
      "reason": string,
      "seedResourceId": {
        "kind": string,
        "videoId": string,
        "channelId": string,
        "playlistId": string
      }
    },
    "social": {
      "type": string,
      "resourceId": {
        "kind": string,
        "videoId": string,
        "channelId": string,
        "playlistId": string
      },
      "author": string,
      "referenceUrl": string,
      "imageUrl": string
    },
    "channelItem": {
      "resourceId": {
      }
    },
  }
}

Ö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#activity olacak.
etag	etag Bu kaynağın Etag'i.
id	string YouTube'un etkinliği benzersiz şekilde tanımlamak için kullandığı kimlik.
snippet	object snippet nesnesi, etkinliğin türü ve grup kimliği dahil olmak üzere etkinlikle ilgili temel ayrıntıları içerir.
snippet.publishedAt	datetime Etkinliğin gerçekleştiği tarih ve saat. Değer ISO 8601 biçiminde belirtilir.
snippet.channelId	string YouTube'un etkinlikle ilişkili kanalı benzersiz şekilde tanımlamak için kullandığı kimlik.
snippet.title	string Asıl olarak etkinlikle ilişkilendirilen kaynağın başlığı.
snippet.description	string Öncelikli olarak etkinlikle ilişkilendirilen kaynağın açıklaması.
snippet.thumbnails	object Birincil olarak etkinlikle ilişkili kaynakla ilişkili küçük resimlerin haritası. Haritadaki her bir nesne için anahtar, küçük resmin adıdır 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 – Varsayılan küçük resim. Bir videonun varsayılan küçük resmi (veya oynatma listesi öğesi ya da arama sonucu gibi bir videoya atıfta bulunan bir kaynak) 120 piksel genişliğinde ve 90 piksel yüksekliğindedir. Kanalları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üdür. 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 söz konusu olduğunda 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. Kanallarda bu resmin genişliği 800 piksel ve yüksekliği 800 pikseldir. standard – Küçük resmin high çözünürlüklü resimden daha da yüksek çözünürlüklü sürümü. Bu resim, oynatma listesi öğeleri veya arama sonuçları gibi videolara atıfta bulunan bazı videolarda ve diğer kaynaklarda kullanılabilir. Bu resim 640 piksel genişliğinde ve 480 piksel yüksekliğinde. maxres: Küçük resmin en yüksek çözünürlüklü sürümüdür. Bu resim boyutu, oynatma listesi öğeleri veya arama sonuçları gibi videolara atıfta bulunan bazı videolarda ve diğer kaynaklarda kullanılabilir. Bu resim 1.280 piksel genişliğinde ve 720 piksel yüksekliğinde.
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.
snippet.channelTitle	string Bu etkinlikten sorumlu kanalın kanal başlığı
snippet.type	string Kaynağın açıkladığı etkinlik türü. Bu özellik için geçerli değerler şunlardır: channelItem comment - (şu anda döndürülmedi) favorite like playlistItem promotedItem recommendation social subscription upload bulletin (kullanımdan kaldırıldı)
snippet.groupId	string Etkinlikle ilişkilendirilen grup kimliği. Grup kimliği, aynı kullanıcı ve kaynakla ilişkilendirilmiş kullanıcı etkinliklerini tanımlar. Örneğin, bir kullanıcı bir videoyu derecelendirirse ve aynı videoyu favori olarak işaretlerse, bu etkinliklerin girişlerinde kullanıcının etkinlik feed'inde aynı grup kimliği olur. Kullanıcı arayüzünüzde tekrarlanmayı önlemek için etkinlikleri aynı groupId değeriyle gruplandırabilirsiniz.
contentDetails	object contentDetails nesnesi, etkinlikle ilişkilendirilen içerikle ilgili bilgileri içerir. Örneğin, snippet.type değeri videoRated ise contentDetails nesnesinin içeriği derecelendirilen videoyu tanımlar.
contentDetails.upload	object upload nesnesi, yüklenen videoyla ilgili bilgileri içerir. Bu özellik yalnızca snippet.type, upload ise mevcuttur.
contentDetails.upload.videoId	string YouTube'un yüklenen videoyu benzersiz şekilde tanımlamak için kullandığı kimlik.
contentDetails.like	object like nesnesi, olumlu (ör.) puan alan bir kaynakla ilgili bilgileri içerir. Bu özellik yalnızca snippet.type, like ise mevcuttur.
contentDetails.like.resourceId	object resourceId nesnesi, derecelendirilen kaynağı tanımlayan bilgileri içerir.
contentDetails.like.resourceId.kind	string API kaynağının türü.
contentDetails.like.resourceId.videoId	string Derecelendirilen kaynak bir video ise YouTube'un videoyu benzersiz bir şekilde tanımlamak için kullandığı kimliktir. Bu özellik yalnızca resourceId.kind, youtube#video ise mevcuttur.
contentDetails.favorite	object favorite nesnesi, favori video olarak işaretlenmiş bir videoyla ilgili bilgileri içerir. Bu özellik yalnızca snippet.type, favorite ise mevcuttur.
contentDetails.favorite.resourceId	object resourceId nesnesi, favori olarak işaretlenen kaynağı tanımlayan bilgileri içerir.
contentDetails.favorite.resourceId.kind	string API kaynağının türü.
contentDetails.favorite.resourceId.videoId	string YouTube'un favori videoyu benzersiz şekilde tanımlamak için kullandığı kimlik. Bu özellik yalnızca resourceId.kind değeri youtube#video ise mevcuttur. Not: activities.list yöntemi şu anda yeni yorumlar için kaynak döndürmez.
contentDetails.comment	object comment nesnesi, yorum alan bir kaynakla ilgili bilgileri içerir. Bu özellik yalnızca snippet.type, comment ise mevcuttur.
contentDetails.comment.resourceId	object resourceId nesnesi, yorumla ilişkili kaynağı tanımlayan bilgileri içerir.
contentDetails.comment.resourceId.kind	string API kaynağının türü.
contentDetails.comment.resourceId.videoId	string YouTube'un bir yorumla ilişkilendirilen videoyu benzersiz şekilde tanımlamak için kullandığı kimlik. Bu özellik yalnızca resourceId.kind, youtube#video ise mevcuttur.
contentDetails.comment.resourceId.channelId	string YouTube'un bir yorumla ilişkilendirilen kanalı benzersiz şekilde tanımlamak için kullandığı kimliktir. Bu özellik yalnızca resourceId.kind, youtube#channel ise mevcuttur.
contentDetails.subscription	object subscription nesnesi, kullanıcının abone olduğu kanalla ilgili bilgileri içerir. Bu özellik yalnızca snippet.type, subscription ise mevcuttur.
contentDetails.subscription.resourceId	object resourceId nesnesi, kullanıcının abone olduğu kaynağı tanımlayan bilgileri içerir.
contentDetails.subscription.resourceId.kind	string API kaynağının türü.
contentDetails.subscription.resourceId.channelId	string Kullanıcının abone olduğu kanalı benzersiz şekilde tanımlamak için YouTube'un kullandığı kimlik. Bu özellik yalnızca resourceId.kind, youtube#channel ise mevcuttur.
contentDetails.playlistItem	object playlistItem nesnesi, yeni bir oynatma listesi öğesiyle ilgili bilgileri içerir. Bu özellik yalnızca snippet.type, playlistItem ise mevcuttur.
contentDetails.playlistItem.resourceId	object resourceId nesnesi, oynatma listesine eklenen kaynağı tanımlayan bilgileri içerir.
contentDetails.playlistItem.resourceId.kind	string API kaynağının türü.
contentDetails.playlistItem.resourceId.videoId	string YouTube'un oynatma listesine eklenen videoyu benzersiz şekilde tanımlamak için kullandığı kimlik. Bu özellik yalnızca resourceId.kind, youtube#video ise mevcuttur.
contentDetails.playlistItem.playlistId	string YouTube'un oynatma listesini benzersiz şekilde tanımlamak için kullandığı değer.
contentDetails.playlistItem.playlistItemId	string YouTube'un oynatma listesindeki öğeyi benzersiz şekilde tanımlamak için kullandığı değer.
contentDetails.recommendation	object recommendation nesnesi, önerilen bir kaynakla ilgili bilgileri içerir. Bu özellik yalnızca snippet.type, recommendation ise mevcuttur.
contentDetails.recommendation.resourceId	object resourceId nesnesi, önerilen kaynağı tanımlayan bilgileri içerir.
contentDetails.recommendation.resourceId.kind	string API kaynağının türü.
contentDetails.recommendation.resourceId.videoId	string Önerilen kaynak bir videoysa YouTube'un videoyu benzersiz şekilde tanımlamak için kullandığı kimliktir. Bu özellik yalnızca resourceId.kind, youtube#video ise mevcuttur.
contentDetails.recommendation.resourceId.channelId	string Önerilen kaynak bir kanalsa YouTube'un kanalı benzersiz şekilde tanımlamak için kullandığı kimliktir. Bu özellik yalnızca resourceId.kind, youtube#channel ise mevcuttur.
contentDetails.recommendation.reason	string Kaynağın kullanıcıya önerilme nedeni. Bu özellik için geçerli değerler şunlardır: videoFavorited videoLiked videoWatched
contentDetails.recommendation.seedResourceId	object seedResourceId nesnesi, öneriye neden olan kaynakla ilgili bilgileri içerir.
contentDetails.recommendation.seedResourceId.kind	string API kaynağının türü.
contentDetails.recommendation.seedResourceId.videoId	string Öneri belirli bir videodan kaynaklandıysa YouTube'un videoyu benzersiz şekilde tanımlamak için kullandığı kimlik. Bu özellik yalnızca seedResourceId.kind, youtube#video ise mevcuttur.
contentDetails.recommendation.seedResourceId.channelId	string Öneri belirli bir kanaldan geldiyse YouTube'un kanalı benzersiz şekilde tanımlamak için kullandığı kimliktir. Bu özellik yalnızca seedResourceId.kind, youtube#channel ise mevcuttur.
contentDetails.recommendation.seedResourceId.playlistId	string Öneri belirli bir oynatma listesinden kaynaklanıyorsa YouTube'un oynatma listesini benzersiz şekilde tanımlamak için kullandığı kimliktir. Bu özellik yalnızca seedResourceId.kind, youtube#playlist ise mevcuttur.
contentDetails.social	object social nesnesi, bir sosyal ağ yayınıyla ilgili ayrıntıları içerir. Bu özellik yalnızca snippet.type, social ise mevcuttur.
contentDetails.social.type	string Sosyal ağın adı. Bu mülk için geçerli değerler şunlardır: facebook googlePlus twitter unspecified
contentDetails.social.resourceId	object resourceId nesnesi, bir sosyal ağ yayınıyla ilişkili kaynağı tanımlayan bilgileri içerir.
contentDetails.social.resourceId.kind	string API kaynağının türü.
contentDetails.social.resourceId.videoId	string Bir sosyal ağ yayınında yer alan videoyu benzersiz bir şekilde tanımlamak için (yayın bir videoyla ilgiliyse) YouTube'un kullandığı kimliktir. Bu özellik yalnızca social.resourceId.kind özelliğinin değeri youtube#video ise mevcut olur.
contentDetails.social.resourceId.channelId	string Bir sosyal ağ yayınında yer alan kanalı benzersiz bir şekilde tanımlamak için (yayın bir kanalla ilgiliyse) YouTube'un kullandığı kimliktir. Bu özellik yalnızca social.resourceId.kind özelliğinin değeri youtube#channel ise mevcut olur.
contentDetails.social.resourceId.playlistId	string Bir sosyal ağ yayınında yer alan oynatma listesini (yayın bir oynatma listesiyle ilgiliyse) benzersiz şekilde tanımlamak için YouTube'un kullandığı kimliktir. Bu özellik yalnızca social.resourceId.kind özelliğinin değeri youtube#playlist ise mevcut olur.
contentDetails.social.author	string Sosyal ağ yayınının yazarı.
contentDetails.social.referenceUrl	string Sosyal ağ yayınının URL'si.
contentDetails.social.imageUrl	string Yayının yazarının resmi.
contentDetails.channelItem	object channelItem nesnesi, bir kanala eklenen kaynakla ilgili ayrıntıları içerir. Bu özellik yalnızca snippet.type, channelItem ise mevcuttur.
contentDetails.channelItem.resourceId	object resourceId nesnesi, kanala eklenen kaynağı tanımlayan bilgileri içerir.