subscription
kaynağı, YouTube kullanıcı aboneliği hakkında bilgi içerir. Abonelik, kanala yeni video eklendiğinde veya başka bir kullanıcı YouTube'daki video yükleme, video derecelendirme ya da videoya yorum yapma gibi çeşitli işlemlerden birini gerçekleştirdiğinde kullanıcıyı bilgilendirir.
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.
- ekle
- Kimliği doğrulanmış kullanıcının kanalı için abonelik ekler. Hemen deneyin.
- sil
- Bir aboneliği siler. Hemen deneyin.
Kaynak temsili
Aşağıdaki JSON yapısı, bir subscriptions
kaynağının biçimini göstermektedir:
{ "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 olacak. |
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, uygulamanın başlığı ve kullanıcının abone olduğu kanal da dahil olmak üzere abonelikle ilgili temel ayrıntıları içerir. |
snippet.publishedAt |
datetime Aboneliğin oluşturulduğu tarih ve saat. Değer ISO 8601 biçiminde belirtilir. |
snippet.channelTitle |
string Aboneliğin ait olduğu kanalın başlığı. |
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 kanalla ilgili bilgileri 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, abonelerin kanalını benzersiz şekilde tanımlamak için kullandığı kimliktir. resource_id nesnesi, kullanıcının abone olduğu kanalı tanımlar. |
snippet.thumbnails |
object Abonelikle ilişkili küçük resim haritası. Haritadaki her bir nesne için anahtar, küçük resmin adı, değer de küçük resim hakkında 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. |
contentDetails |
object contentDetails nesnesi, abonelikle ilgili temel istatistikleri içerir. |
contentDetails.totalItemCount |
unsigned integer Aboneliğin işaret ettiği yaklaşık öğe sayısı. |
contentDetails.newItemCount |
unsigned integer Abonelikteki son okuma işleminden bu yana geçen yeni öğe sayısı. |
contentDetails.activityType |
string Bu aboneliğin ait olduğu etkinlik türü (yalnızca yüklemeler, her şey). Bu mülk için geçerli değerler şunlardır:
|
subscriberSnippet |
object subscriberSnippet nesnesi, aboneyle ilgili temel ayrıntıları içerir. |
subscriberSnippet.title |
string Abonenin kanalının başlığıdır. |
subscriberSnippet.description |
string Abonenin kanalının açıklaması. |
subscriberSnippet.channelId |
string Abonenin kanalını benzersiz şekilde tanımlamak için YouTube'un atadığı kimlik. |
subscriberSnippet.thumbnails |
object Abonenin kanalının küçük resmi. |
subscriberSnippet.thumbnails.(key) |
object Geçerli anahtar değerleri şunlardır:
|
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. |