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:
|
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:
|
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:
|
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:
|
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. |