Subscriptions

subscription kaynağı, YouTube kullanıcı aboneliğiyle ilgili bilgiler içerir. Abonelik, bir kanala yeni videolar eklendiğinde veya başka bir kullanıcı YouTube'da video yükleme, videoyu değerlendirme ya da videoya yorum yapma gibi işlemlerden birini gerçekleştirdiğinde kullanıcıya bildirim gönderir.

Yöntemler

API, subscriptions kaynakları için aşağıdaki yöntemleri destekler:

list
API isteği ölçütleriyle eşleşen abonelik kaynaklarını döndürür. Hemen deneyin.
insert
Kimliği doğrulanmış kullanıcının kanalına abonelik ekler. Hemen deneyin.
sil
Aboneliği siler. Hemen deneyin.

Kaynak temsili

Aşağıdaki JSON yapısında, subscriptions kaynağının biçimi gösterilmektedir:

{
  "kind": "youtube#subscription",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelTitle": string,
    "title": string,
    "description": string,
    "resourceId": {
      "kind": string,
      "channelId": string,
    },
    "channelId": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    }
  },
  "contentDetails": {
    "totalItemCount": unsigned integer,
    "newItemCount": unsigned integer,
    "activityType": string
  },
  "subscriberSnippet": {
    "title": string,
    "description": string,
    "channelId": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    }
  }
}

Ö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#subscription olur.
etag etag
Bu kaynağın ETag'i.
id string
YouTube'un aboneliği benzersiz şekilde tanımlamak için kullandığı kimlik.
snippet object
snippet nesnesi, abonelikle ilgili temel bilgileri (başlığı ve kullanıcının abone olduğu kanal dahil) içerir.
snippet.publishedAt datetime
Aboneliğin oluşturulduğu tarih ve saat. Değer, ISO 8601 biçiminde belirtilir.
snippet.title string
Aboneliğin başlığı.
snippet.description string
Aboneliğin ayrıntıları.
snippet.resourceId object
id nesnesi, kullanıcının abone olduğu kanal hakkında bilgiler içerir.
snippet.resourceId.kind string
API kaynağının türü.
snippet.resourceId.channelId string
YouTube'un, kullanıcının abone olduğu kanalı benzersiz şekilde tanımlamak için kullandığı değer.
snippet.channelId string
YouTube'un abonenin kanalını benzersiz şekilde tanımlamak için kullandığı kimlik. resource_id nesnesi, kullanıcının abone olduğu kanalı tanımlar.
snippet.thumbnails object
Abonelikle 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: Bu kaynağın varsayılan küçük resmi. 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ü 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. Kanallar için bu resim 800 piksel genişliğinde ve 800 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.
contentDetails object
contentDetails nesnesi, abonelikle ilgili temel istatistikleri içerir.
contentDetails.totalItemCount unsigned integer
Aboneliğin işaret ettiği öğelerin yaklaşık sayısı.
contentDetails.newItemCount unsigned integer
İçeriği son okunduğundan beri abonelikteki yeni öğelerin sayısı.
contentDetails.activityType string
Bu aboneliğin geçerli olduğu etkinlik türü (yalnızca yüklemeler, her şey).

Bu özellik için geçerli değerler şunlardır:
  • all
  • uploads
subscriberSnippet object
subscriberSnippet nesnesi, aboneyle ilgili temel ayrıntıları içerir.
subscriberSnippet.title string
Abonenin kanalının başlığı.
subscriberSnippet.description string
Abone olan kullanıcının kanalının açıklaması.
subscriberSnippet.channelId string
YouTube'un, abonenin kanalını benzersiz şekilde tanımlamak için atadığı kimlik.
subscriberSnippet.thumbnails object
Abonenin kanalının küçük resimleri.
subscriberSnippet.thumbnails.(key) object
Geçerli anahtar değerleri:
  • default: Bu kaynağın varsayılan küçük resmi. 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ü 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. Kanallar için bu resim 800 piksel genişliğinde ve 800 piksel yüksekliğindedir.
subscriberSnippet.thumbnails.(key).url string
Resmin URL'si.
subscriberSnippet.thumbnails.(key).width unsigned integer
Resmin genişliği.
subscriberSnippet.thumbnails.(key).height unsigned integer
Resmin yüksekliği.