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.