Activities

YouTube, kanal bülten özelliğini kullanımdan kaldırdı. activities.list yöntemi hâlâ kanal bültenlerini döndürmemektedir 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 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ş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şkilendirilmiş etkinlikleri alabilirsiniz. Hemen deneyin.

activities.insert yöntemi artık desteklenmiyor.

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
    },
    "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ş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şkili kaynağın açıklaması.
snippet.thumbnails object
Öncelikli olarak etkinlikle ilişkili kaynakla ilişkili küçük resimlerin haritası. Haritadaki her bir nesne için anahtar, küçük resmin adı 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 (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 uzunluğundadır.
  • 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 resim 320 piksel genişliğinde ve 180 piksel yüksekliğindedir. 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 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 uzunluğundadır.
  • standard – Küçük resmin high çözünürlüklü resimden daha yüksek çözünürlüklü sürümü. Bu resim, bazı videolarda ve videolara atıfta bulunan diğer kaynaklarda (ör. oynatma listesi öğeleri veya arama sonuçları) kullanılabilir. Bu resim 640 piksel genişliğinde ve 480 piksel yüksekliğinde.
  • maxres – Küçük resim görüntüsünün en yüksek çözünürlüklü sürümü. Bu resim boyutu, bazı videolarda ve videolara atıfta bulunan diğer kaynaklarda (ör. oynatma listesi öğeleri ya da arama sonuçları) 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 mülk 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 etkinliklere ilişkin girişler, kullanıcının etkinlik feed'inde aynı grup kimliğine sahip olur. Kullanıcı arayüzünüzde, etkinlikleri aynı groupId değerine sahip gruplayarak tekrarı önleyebilirsiniz.
contentDetails object
contentDetails nesnesi, etkinlikle ilişkilendirilen içerik hakkında bilgiler 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 bilgiler 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
Derecelendirilmiş kaynak bir videoysa YouTube'un videoyu benzersiz ş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 bilgiler 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şkili 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şkili kanalı benzersiz şekilde tanımlamak için kullandığı kimlik. Bu özellik yalnızca resourceId.kind, youtube#channel ise mevcuttur.
contentDetails.subscription object
subscription nesnesi, bir 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 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ığı kimlik. 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ığı kimlik. 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 geliyorsa 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 kaynaklanıyorsa YouTube'un kanalı benzersiz şekilde tanımlamak için kullandığı kimlik. Bu özellik yalnızca seedResourceId.kind, youtube#channel ise mevcuttur.
contentDetails.recommendation.seedResourceId.playlistId string
Öneri belirli bir oynatma listesinden geliyorsa YouTube'un oynatma listesini benzersiz şekilde tanımlamak için kullandığı kimlik. 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 bir video ile ilgiliyse YouTube'un videoyu benzersiz şekilde tanımlamak için kullandığı kimliktir. Bu özellik yalnızca social.resourceId.kind özelliğinin değeri youtube#video ise mevcuttur.
contentDetails.social.resourceId.channelId string
Bir sosyal ağ yayınında yer alan bir kanalla ilgiliyse YouTube'un kanalı benzersiz şekilde tanımlamak için kullandığı kimlik. Bu özellik yalnızca social.resourceId.kind özelliğinin değeri youtube#channel ise mevcuttur.
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ığı kimlik. Bu özellik yalnızca social.resourceId.kind özelliğinin değeri youtube#playlist ise mevcuttur.
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, kanala eklenen bir 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.