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 akışlarında bildirilen işlemler arasında videolara puan verme, video paylaşma, videoları favori olarak işaretleme, 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ında, activities kaynağının biçimi gösterilmektedir:

{
  "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 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şkilendirilmiş kaynağın başlığı.
snippet.description	string Etkinlikle öncelikli olarak ilişkili kaynağın açıklaması.
snippet.thumbnails	object Etkinlikle öncelikli olarak ilişkili 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ü bir sürümü. 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ü versiyonu. Bir 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 yüksek çözünürlüklü bir sürümü. Bu resim, bazı videolar ve oynatma listesi öğeleri ya da arama sonuçları gibi videolara atıfta bulunan diğer kaynaklar 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 oynatma listesi öğeleri ya da arama sonuçları gibi videolara atıfta bulunan diğer kaynaklar 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) favorite like playlistItem promotedItem recommendation social subscription upload
snippet.groupId	string Etkinlikle ilişkili 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 derecelendirip aynı videoyu favorilerine eklerse 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.like	object like nesnesi, olumlu (beğeni) puanı alan bir kaynakla ilgili bilgileri içerir. Bu özellik yalnızca snippet.type like ise bulunur.
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 The ID that YouTube uses to uniquely identify the video, if the rated resource is a video. Bu özellik yalnızca resourceId.kind youtube#video ise bulunur.
contentDetails.favorite	object favorite nesnesi, favori video olarak işaretlenen bir video hakkındaki bilgileri içerir. Bu özellik yalnızca snippet.type favorite ise bulunur.
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 youtube#video ise bulunur. Not: activities.list yöntemi şu anda yeni yorumlar için kaynak döndürmemektedir.
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.subscription	object subscription nesnesi, kullanıcının abone olduğu bir kanal hakkında bilgiler içerir. Bu özellik yalnızca snippet.type subscription ise bulunur.
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 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: 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 Ö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 neden olduysa 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 öne çıkarılan 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 referans alıyorsa YouTube'un sosyal ağ gönderisinde öne çıkarılan 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ı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.