Activities

YouTube, kanal bülteni özelliğini kullanımdan kaldırdı. activities.list yöntemi şunları yapar: kanal bültenlerini döndürmez ve activities.insert yöntemi hayır artık destekleniyor. Daha fazla bilgi için lütfen YouTube Yardım Merkezi.

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şkilendirilen kanalı ve işlemle ilişkilendirilen kaynakları(ör. derecelendirilen 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 olur.
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 de 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şkilendirilen kanalı benzersiz şekilde tanımlamak için kullandığı kimlik.
snippet.title	string Etkinlikle birincil olarak ilişkilendirilen kaynağın başlığı.
snippet.description	string Birincil olarak etkinlikle ilişkili kaynağın açıklaması.
snippet.thumbnails	object Kaynakla ilişkili küçük resimlerin haritası, özellikle de etkinlikle ilişkilidir. Haritadaki her bir nesne için anahtar küçük resmin adıdır, değer ise küçük resim hakkında başka bilgileri içeren bir nesnedir.
snippet.thumbnails.(key)	object Geçerli anahtar değerleri şunlardır: default: Varsayılan küçük resimdir. Bir videonun (veya oynatma listesi öğesi ya da arama sonucu gibi bir videoya atıfta bulunan bir kaynak) varsayılan küçük resmi 120 piksel genişliğinde ve 90 piksel uzunluğundadır. 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ü sürümü. Bir video (veya videoya atıfta bulunan bir kaynak) için bu görüntü 320 piksel genişliğinde ve 180 piksel yüksekliğindedir. 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 videoya atıfta bulunan bir kaynak) için bu görüntü 480 piksel genişliğinde ve 360 piksel yüksekliğindedir. Bir kanal için bu resim 800 piksel genişliğinde ve 800 piksel yüksekliğindedir. standard – Küçük resmin high çözünürlüklü resimden daha da yüksek çözünürlüklü sürümü. Bu görsel, oynatma listesi öğeleri veya arama sonuçları gibi videolarla ilgili bazı videolar ve diğer kaynaklar için kullanılabilir. Bu görselin genişliği 640 piksel, yüksekliği 480 pikseldir. maxres: Küçük resmin en yüksek çözünürlüklü sürümü. Bu resim boyutu, oynatma listesi öğeleri veya arama sonuçları gibi videolara atıfta bulunan bazı videolar ve diğer kaynaklar için kullanılabilir. Bu görsel 1.280 piksel genişliğinde ve 720 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.
snippet.channelTitle	string Bu etkinlikten sorumlu kanalın kanal başlığı
snippet.type	string Kaynağın tanımladığı etkinlik türüdür. Bu mülk için geçerli değerler şunlardır: channelItem comment - (şu anda iade edilmedi) favorite like playlistItem promotedItem recommendation social subscription upload bulletin (desteği sonlandırılmış)
snippet.groupId	string Etkinlikle ilişkilendirilen grup kimliği. Grup kimliği, aynı kullanıcı ve kaynakla ilişkilendirilen kullanıcı etkinliklerini tanımlar. Örneğin, bir kullanıcı bir videoyu derecelendirir ve aynı videoyu favori olarak işaretlerse bu etkinliklere ilişkin girişler, kullanıcının etkinlik feed'indeki aynı grup kimliğine sahip olur. Kullanıcı arayüzünüzde, etkinlikleri aynı groupId değerine sahip gruplayarak tekrarlardan kaçınabilirsiniz.
contentDetails	object contentDetails nesnesi, etkinlikle ilişkilendirilmiş içerik hakkında bilgi 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 kaynak hakkında bilgiler içeriyor. 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 videoysa YouTube'un videoyu benzersiz bir şekilde tanımlamak için kullandığı kimlik. Bu özellik yalnızca resourceId.kind, youtube#video ise mevcuttur.
contentDetails.favorite	object favorite nesnesi, favori video olarak işaretlenen 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ığı kimliktir. 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şkilendirilen 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ığı kimlik. 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 YouTube'un, kullanıcının abone olduğu kanalı benzersiz şekilde tanımlamak için kullandığı kimlik. Bu özellik yalnızca resourceId.kind, youtube#channel ise mevcuttur.
contentDetails.playlistItem	object playlistItem nesnesi, yeni bir oynatma listesi öğesiyle ilgili bilgiler 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ığı kimliktir. 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ğerdir.
contentDetails.playlistItem.playlistItemId	string YouTube'un oynatma listesindeki öğeyi benzersiz şekilde tanımlamak için kullandığı değerdir.
contentDetails.recommendation	object recommendation nesnesi, önerilen bir kaynak hakkında bilgi içeriyor. 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 video ise 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 mülk 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 kaynaklanıyorsa YouTube'un videoyu benzersiz şekilde tanımlamak için kullandığı kimliktir. Bu özellik yalnızca seedResourceId.kind, youtube#video ise mevcuttur.
contentDetails.recommendation.seedResourceId.channelId	string Önerinin belirli bir kanaldan kaynaklanması halinde 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 Gönderi bir videoyla ilgiliyse YouTube'un sosyal ağ yayınında öne çıkan videoyu benzersiz şekilde tanımlamak için kullandığı kimliktir. Bu özellik yalnızca social.resourceId.kind özelliğinin değeri youtube#video olduğunda bulunur.
contentDetails.social.resourceId.channelId	string Gönderi bir kanala atıfta bulunuyorsa YouTube'un sosyal ağ yayınında öne çıkan kanalı benzersiz şekilde tanımlamak için kullandığı kimliktir. Bu özellik yalnızca social.resourceId.kind özelliğinin değeri youtube#channel olduğunda bulunur.
contentDetails.social.resourceId.playlistId	string Gönderi bir oynatma listesine atıfta bulunuyorsa YouTube'un sosyal ağ yayınında öne çıkan oynatma listesini benzersiz şekilde tanımlamak için kullandığı kimliktir. Bu özellik yalnızca social.resourceId.kind özelliğinin değeri youtube#playlist olduğunda bulunur.
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.