Bu sayfa, Cloud Translation API ile çevrilmiştir.

Activities

YouTube, kanal bülteni özelliğini kullanımdan kaldırdı. activities.list yöntemi şunları yapar: kanal bültenlerini döndürmez ve activities.insert yöntemi hayır artık destekleniyor. Daha fazla bilgi için lütfen YouTube Yardım Merkezi.

activity kaynağı, belirli bir kanalın veya kullanıcının YouTube'da gerçekleştirdiği bir 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şkilendirilen 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.

activities.insert yöntemi artık desteklenmiyor.

Kaynak temsili

Aşağıdaki JSON yapısı, bir 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şkilendirilen kanalı benzersiz şekilde tanımlamak için kullandığı kimlik.
`snippet.title`	`string` Etkinlikle birincil olarak ilişkilendirilen kaynağın başlığı.
`snippet.description`	`string` Birincil olarak etkinlikle ilişkili kaynağın açıklaması.
`snippet.thumbnails`	`object` Kaynakla ilişkili küçük resimlerin haritası, özellikle de etkinlikle ilişkilidir. Haritadaki her bir nesne için anahtar küçük resmin adıdır, değer ise küçük resim hakkında başka bilgileri içeren bir nesnedir.
`snippet.thumbnails.(key)`	`object` Geçerli anahtar değerleri şunlardır: `default`: Varsayılan küçük resimdir. Bir videonun (veya oynatma listesi öğesi ya da arama sonucu gibi bir videoya atıfta bulunan bir kaynak) varsayılan küçük resmi 120 piksel genişliğinde ve 90 piksel uzunluğundadır. 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ü sürümü. Bir video (veya videoya atıfta bulunan bir kaynak) için bu görüntü 320 piksel genişliğinde ve 180 piksel yüksekliğindedir. Bir 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 görüntü 480 piksel genişliğinde ve 360 piksel yüksekliğindedir. Bir kanal 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ü sürümü. Bu görsel, oynatma listesi öğeleri veya arama sonuçları gibi videolarla ilgili bazı videolar ve diğer kaynaklar için kullanılabilir. Bu görselin genişliği 640 piksel, yüksekliği 480 pikseldir. `maxres`: Küçük resmin en yüksek çözünürlüklü sürümü. Bu resim boyutu, oynatma listesi öğeleri veya arama sonuçları gibi videolara atıfta bulunan bazı videolar ve diğer kaynaklar için kullanılabilir. Bu görsel 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üdür. Bu mülk için geçerli değerler şunlardır: `channelItem` `comment` - (şu anda iade edilmedi) `favorite` `like` `playlistItem` `promotedItem` `recommendation` `social` `subscription` `upload` `bulletin` (desteği sonlandırılmış)
`snippet.groupId`	`string` Etkinlikle ilişkilendirilen grup kimliği. Grup kimliği, aynı kullanıcı ve kaynakla ilişkilendirilen kullanıcı etkinliklerini tanımlar. Örneğin, bir kullanıcı bir videoyu derecelendirir ve aynı videoyu favori olarak işaretlerse bu etkinliklere ilişkin girişler, kullanıcının etkinlik feed'indeki aynı grup kimliğine sahip olur. Kullanıcı arayüzünüzde, etkinlikleri aynı `groupId` değerine sahip gruplayarak tekrarlardan kaçınabilirsiniz.
`contentDetails`	`object` `contentDetails` nesnesi, etkinlikle ilişkilendirilmiş içerik hakkında bilgi 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 kaynak hakkında bilgiler içeriyor. 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` Derecelendirilen kaynak bir videoysa YouTube'un videoyu benzersiz bir ş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 bilgileri 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ığı kimliktir. 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şkilendirilen 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şkilendirilen 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şkilendirilen kanalı benzersiz şekilde tanımlamak için kullandığı kimlik. Bu özellik yalnızca `resourceId.kind`, `youtube#channel` ise mevcuttur.
`contentDetails.subscription`	`object` `subscription` nesnesi, 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 bilgiler 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ığı kimliktir. 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ğerdir.
`contentDetails.playlistItem.playlistItemId`	`string` YouTube'un oynatma listesindeki öğeyi benzersiz şekilde tanımlamak için kullandığı değerdir.
`contentDetails.recommendation`	`object` `recommendation` nesnesi, önerilen bir kaynak hakkında bilgi içeriyor. 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 video ise YouTube'un videoyu benzersiz şekilde tanımlamak için kullandığı kimliktir. 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ığı kimliktir. 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 kaynaklanıyorsa YouTube'un videoyu benzersiz şekilde tanımlamak için kullandığı kimliktir. Bu özellik yalnızca `seedResourceId.kind`, `youtube#video` ise mevcuttur.
`contentDetails.recommendation.seedResourceId.channelId`	`string` Önerinin belirli bir kanaldan kaynaklanması halinde YouTube'un kanalı benzersiz şekilde tanımlamak için kullandığı kimliktir. Bu özellik yalnızca `seedResourceId.kind`, `youtube#channel` ise mevcuttur.
`contentDetails.recommendation.seedResourceId.playlistId`	`string` Öneri belirli bir oynatma listesinden kaynaklanıyorsa YouTube'un oynatma listesini benzersiz şekilde tanımlamak için kullandığı kimliktir. 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` Gönderi bir videoyla ilgiliyse YouTube'un sosyal ağ yayınında öne çıkan videoyu benzersiz şekilde tanımlamak için kullandığı kimliktir. Bu özellik yalnızca `social.resourceId.kind` özelliğinin değeri `youtube#video` olduğunda bulunur.
`contentDetails.social.resourceId.channelId`	`string` Gönderi bir kanala atıfta bulunuyorsa YouTube'un sosyal ağ yayınında öne çıkan kanalı benzersiz şekilde tanımlamak için kullandığı kimliktir. Bu özellik yalnızca `social.resourceId.kind` özelliğinin değeri `youtube#channel` olduğunda bulunur.
`contentDetails.social.resourceId.playlistId`	`string` Gönderi bir oynatma listesine atıfta bulunuyorsa YouTube'un sosyal ağ yayınında öne çıkan oynatma listesini benzersiz şekilde tanımlamak için kullandığı kimliktir. Bu özellik yalnızca `social.resourceId.kind` özelliğinin değeri `youtube#playlist` olduğunda bulunur.
`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, bir kanala eklenen 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.