Activities

activity kaynağı, belirli bir kanalın veya kullanıcının YouTube'da gerçekleştirdiği bir işlemle ilgili bilgiler içerir. Etkinlik feed'lerinde bildirilen işlemler arasında video paylaşma, video yükleme vb. yer alır. Her bir activity kaynağı, işlem türünü, işlemle ilişkili kanalı ve işlemle ilişkili 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.

Kaynak temsili

Aşağıdaki JSON yapısı, 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
    },
    "comment": {
      "resourceId": {
        "kind": string,
        "videoId": 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 bir ş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şkili kanalı benzersiz şekilde tanımlamak için kullandığı kimlik.
snippet.title	string Etkinlikle öncelikli olarak ilişkili kaynağın başlığı.
snippet.description	string Etkinlikle öncelikli olarak ilişkili kaynağın açıklaması.
snippet.thumbnails	object Etkinlikle öncelikli olarak ilişkili olan kaynakla ilişkili küçük resimlerin haritası. Haritadaki her nesne için anahtar, küçük resmin adı, değer ise küçük resimle ilgili diğer bilgileri içeren bir nesnedir.
snippet.thumbnails.(key)	object Geçerli anahtar değerleri: default: Varsayılan küçük resim. Bir video veya videoya referans veren bir kaynak (ör. oynatma listesi öğesi ya da arama sonucu) için varsayılan küçük resim 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ü versiyonu. Video (veya videoya atıfta bulunan bir kaynak) için bu resim 320 piksel genişliğinde ve 180 piksel yüksekliğindedir. Kanallar 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ü. Video (veya videoya atıfta bulunan bir kaynak) için bu resim 480 piksel genişliğinde ve 360 piksel yüksekliğindedir. Kanallar 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ü bir sürümü. Bu resim, bazı videolar ve videolara referans veren diğer kaynaklar (ör. oynatma listesi öğeleri veya arama sonuçları) için kullanılabilir. Bu resim 640 piksel genişliğinde ve 480 piksel yüksekliğindedir. maxres: Küçük resmin en yüksek çözünürlüklü sürümü. Bu resim boyutu, bazı videolar ve videolara atıfta bulunan diğer kaynaklar (ör. oynatma listesi öğeleri veya arama sonuçları) için kullanılabilir. Bu resim 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ü. Bu özellik için geçerli değerler şunlardır: channelItem comment – (Şu anda döndürülmüyor) playlistItem promotedItem recommendation social upload
snippet.groupId	string Etkinlikle ilişkili grup kimliği. Grup kimliği, aynı kullanıcı ve kaynakla ilişkili kullanıcı etkinliklerini tanımlar. Örneğin, bir kullanıcı video yükleyip aynı videoyu izlerse bu etkinliklerin girişleri, kullanıcının etkinlik feed'inde aynı grup kimliğine sahip olur. Kullanıcı arayüzünüzde, aynı groupId değerine sahip etkinlikleri gruplandırarak tekrardan kaçınabilirsiniz.
contentDetails	object contentDetails nesnesi, etkinlikle ilişkili içerik hakkında bilgiler içerir. Örneğin, snippet.type değeri videoRated ise contentDetails nesnesinin içeriği, derecelendirilmiş videoyu tanımlar.
contentDetails.upload	object upload nesnesi, yüklenen video hakkında bilgiler içerir. Bu özellik yalnızca snippet.type upload ise bulunur.
contentDetails.upload.videoId	string YouTube'un yüklenen videoyu benzersiz şekilde tanımlamak için kullandığı kimlik.
contentDetails.comment	object comment nesnesi, yorum alan bir kaynakla ilgili bilgileri içerir. Bu özellik yalnızca snippet.type comment ise bulunur.
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şkili videoyu benzersiz şekilde tanımlamak için kullandığı kimlik. Bu özellik yalnızca resourceId.kind youtube#video ise bulunur.
contentDetails.comment.resourceId.channelId	string YouTube'un, bir yorumla ilişkili kanalı benzersiz şekilde tanımlamak için kullandığı kimlik. Bu özellik yalnızca resourceId.kind youtube#channel ise bulunur.
contentDetails.playlistItem	object playlistItem nesnesi, yeni bir oynatma listesi öğesiyle ilgili bilgileri içerir. Bu özellik yalnızca snippet.type playlistItem ise bulunur.
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 bulunur.
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 bulunur.
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ığı kimlik. Bu özellik yalnızca resourceId.kind youtube#video ise bulunur.
contentDetails.recommendation.resourceId.channelId	string Önerilen kaynak bir kanalsa YouTube'un kanalı benzersiz şekilde tanımlamak için kullandığı kimlik. Bu özellik yalnızca resourceId.kind youtube#channel ise bulunur.
contentDetails.recommendation.reason	string Kaynağın kullanıcıya önerilme nedeni. Bu özellik için geçerli değerler şunlardır: 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 Öneriye belirli bir video neden olduysa YouTube'un videoyu benzersiz şekilde tanımlamak için kullandığı kimlik. Bu özellik yalnızca seedResourceId.kind youtube#video ise bulunur.
contentDetails.recommendation.seedResourceId.channelId	string Öneriye belirli bir kanalın neden olduğu durumlarda YouTube'un kanalı benzersiz şekilde tanımlamak için kullandığı kimlik. Bu özellik yalnızca seedResourceId.kind youtube#channel ise bulunur.
contentDetails.recommendation.seedResourceId.playlistId	string Öneriye belirli bir oynatma listesi neden olduysa YouTube'un oynatma listesini benzersiz şekilde tanımlamak için kullandığı kimlik. Bu özellik yalnızca seedResourceId.kind youtube#playlist ise bulunur.
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 bulunur.
contentDetails.social.type	string Sosyal ağın adı. Bu özellik 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 kapsar.
contentDetails.social.resourceId.kind	string API kaynağının türü.
contentDetails.social.resourceId.videoId	string Gönderi bir videoyu referans alıyorsa YouTube'un sosyal ağ gönderisinde yer alan videoyu benzersiz şekilde tanımlamak için kullandığı kimlik. Bu özellik yalnızca social.resourceId.kind özelliğinin değeri youtube#video ise bulunur.
contentDetails.social.resourceId.channelId	string Gönderi bir kanaldan bahsediyorsa YouTube'un sosyal ağ gönderisinde yer alan kanalı benzersiz bir şekilde tanımlamak için kullandığı kimlik. Bu özellik yalnızca social.resourceId.kind özelliğinin değeri youtube#channel ise bulunur.
contentDetails.social.resourceId.playlistId	string Gönderi bir oynatma listesini ifade ediyorsa YouTube'un sosyal ağ gönderisinde yer alan oynatma listesini benzersiz şekilde tanımlamak için kullandığı kimlik. Bu özellik yalnızca social.resourceId.kind özelliğinin değeri youtube#playlist ise bulunur.
contentDetails.social.author	string Sosyal ağ gönderisinin yazarı.
contentDetails.social.referenceUrl	string Sosyal ağ gönderisinin URL'si.
contentDetails.social.imageUrl	string Yayın yazarının resmi.
contentDetails.channelItem	object channelItem nesnesi, kanala eklenen bir kaynakla ilgili ayrıntıları içerir. Bu özellik yalnızca snippet.type channelItem ise bulunur.
contentDetails.channelItem.resourceId	object resourceId nesnesi, kanala eklenen kaynağı tanımlayan bilgileri içerir.