members
uç noktası, artık kullanımdan kaldırılan ve 30 Eylül 2020'de veya sonrasında desteklenmeyecek olan sponsors
uç noktasının yerini alıyor. API istemcilerinin, members.list
yöntemini kullanmak için sponsors.list
yöntemine yapılan çağrıları güncellemesi gerekir.
Bu uç nokta, yalnızca bireysel içerik üreticiler tarafından kanal üyelikleri özelliğinin etkinleştirildiği YouTube kanallarında istekte bulunmak için kullanılabilir. Erişim isteğinde bulunmak için Google veya YouTube temsilcinizle iletişime geçin.
member
kaynağı, bir YouTube kanalının kanal üyesini temsil eder. Üyeler, içerik üreticilere düzenli olarak para sunar ve özel avantajlardan yararlanır. Örneğin, içerik üretici sohbet için üyelere özel modunu etkinleştirdiğinde üyeler sohbet edebilir.
Yöntemler
API, member
kaynakları için aşağıdaki yöntemleri destekler:
- list
- Bir kanalın üyelerini (eski adıyla "sponsorlar") listeler. API isteği, kanal sahibi tarafından yetkilendirilmelidir.
Kaynak temsili
Aşağıdaki JSON yapısı, bir member
kaynağının biçimini göstermektedir:
{ "kind": "youtube#member", "etag": etag, "snippet": { "creatorChannelId": string, "memberDetails": { "channelId": string, "channelUrl": string, "displayName": string, "profileImageUrl": string }, "membershipsDetails": { "highestAccessibleLevel": string, "highestAccessibleLevelDisplayName": string, "accessibleLevels": [ string ], "membershipsDuration": { "memberSince": datetime, "memberTotalDurationMonths": integer, }, "membershipsDurationAtLevel": [ { "level": string, "memberSince": datetime, "memberTotalDurationMonths": 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#member olacak. |
etag |
etag Bu kaynağın Etag'i. |
snippet |
object snippet nesnesi, üye hakkındaki ayrıntıları içerir. |
snippet.creatorChannelId |
string Üyelik sunan içerik üreticinin YouTube kanal kimliği. |
snippet.memberDetails |
object Bu nesne, üyelik için ödeme yapan YouTube kanalı hakkındaki profil verilerini içerir. Bir kanalda kullanılmayan profil verilerine sahip üyelerin olabileceğini unutmayın. Örneğin, kanallarını silen ancak üyelikler için ödeme yapmaya devam eden üyeler bu sorunla karşılaşır. Bu üyelerin üyelik avantajlarına erişmeye devam edebileceğini unutmayın. memberDetails nesnelerinin profil ayrıntıları ayarlanmamış olsa bile, API yanıtları bu üyelerin doğru bilgileri bulabileceği kaynaklar içerir. membershipsDetails
bu tür üyelere sunulmaya devam eder. |
snippet.memberDetails.channelId |
string Üye kanalın YouTube kanal kimliği. Ayarlanırsa kanal kimliği, üye için benzersiz bir tanımlayıcı olarak da değerlendirilebilir. Ayarlanmazsa üye benzersiz olarak tanımlanamaz ancak kaynak, üyenin erişebileceği seviyeler ve üyelik süresi gibi üyelik ayrıntılarını yine de iletir. |
snippet.memberDetails.channelUrl |
string Kanalın URL'si. |
snippet.memberDetails.displayName |
string Kanalın görünen adı. |
snippet.memberDetails.profileImageUrl |
string Kanalın avatar URL'si. |
snippet.membershipsDetails |
object Bu nesne, üye kanalın üyelik bilgilerini içeriyor. |
snippet.membershipsDetails.highestAccessibleLevel |
string Üye kanalının şu anda erişebildiği en yüksek üyelik düzeyinin kimliği. Değer, membershipsLevel kaynağındaki id özellik değerine karşılık gelir. |
snippet.membershipsDetails.highestAccessibleLevelDisplayName |
string Üye kanalının şu anda erişebildiği en yüksek üyelik düzeyinin adı. Değer, membershipsLevel kaynağındaki displayName özellik değerine karşılık gelir. |
snippet.membershipsDetails.accessibleLevels[] |
list (of strings) Kullanıcının şu anda erişebildiği tüm üyelik düzeylerinin listesi. Liste, şu anda etkin olan düzeyi ve onun altındaki tüm düzeyleri içerir. |
snippet.membershipsDuration |
object Bu nesne, fiyatlandırma düzeylerine bakılmaksızın mevcut üyenin genel süresiyle ilgili bilgileri içerir. Ardından snippet.membershipsDetails.membershipsDurationAtLevel[] özelliği, üyenin belirli bir üyelik seviyesine erişebildiği üyelik dönemiyle ilgili ayrıntıları içeren nesnelerin listesini içerir.
Örnekte, bu özelliklerin işleyiş şekli gösterilmektedir: Bir üye, Ocak ayında 1. düzeyde yeni bir üyelik satın alır ve bu üyelik Mart'a kadar devam eder. Nisan ve Mayıs'ta üyenin üyeliği yoktur. Üye, Haziran ayında tekrar 1. düzeyde üyeliğini yeniden başlatır. Ardından Ağustos ayında üye, üyeliğini 2. seviyeye yükseltir. Bu nedenle, Ekim ayında yapılan bir API çağrısında member kaynağı aşağıdakileri içerir:
"membershipsDetails": { "membershipsDuration": { "memberSince": "2020-06-01T12:00:00", "memberTotalDurationMonths": 7, }, "membershipsDurationAtLevel": [ { "level": "level_1_ID", "memberSince": "2020-06-01T12:00:00", "memberTotalDurationMonths": 7 }, { "level": "level_2_ID", "memberSince": "2020-08-01T12:00:00", "memberTotalDurationMonths": 2 }, ] } |
snippet.membershipsDuration.memberSince |
datetime Üyenin mevcut üyeliğinin başladığı tarih ve saat. Başka bir deyişle, üye bu tarih ve saatten bu yana sürekli üye olmuştur. Farklı üyelik seviyelerinin farklı üyelik süreleri için harcanmış olabileceğini unutmayın. |
snippet.membershipsDuration.memberTotalDurationMonths |
integer Kullanıcının üyesi olduğu, en yakın tam sayıya yuvarlanmış ay sayısı. Değer, üyenin üyeliğinin tamamlandığı ay sayısını gösterir ancak bu ay boyunca üyenin devamlı olarak üye olduğu anlamına gelmez. |
snippet.memberDetails.membershipsDetails.membershipsDurationAtLevel[] |
list (of objects) Üyelerin, belirli bir üyelik seviyesine erişebildiği üyelik dönemiyle ilgili ayrıntıları içeren nesnelerin listesi. Liste, üyenin şu anda erişebildiği her üyelik düzeyi için bir nesne içerir. |
snippet.memberDetails.membershipsDetails.membershipsDurationAtLevel.level |
string Üyelik seviyesi kimliği. Değer, membershipsLevel kaynağındaki id özellik değerine karşılık gelir. |
snippet.memberDetails.membershipsDetails.membershipsDurationAtLevel.memberSince |
datetime Üyenin, belirtilen üyelik seviyesine erişim tarihi ve saati. Başka bir deyişle, üye bu tarih ve saatten beri devamlı olarak seviyeye erişmiştir. Daha yüksek üyelik seviyelerinde farklı üyelik dönemleri harcanmış olabilir. |
snippet.memberDetails.membershipsDetails.membershipsDurationAtLevel.memberTotalDurationMonths |
integer Kullanıcının belirtilen düzeye erişebildiği en yakın tam sayıya yuvarlanmış ay sayısı. Değer, üyenin düzey erişimine sahip olduğu tam ay sayısını gösterir ancak bu sayı, üyenin söz konusu ay boyunca kesintisiz olarak üyeliğinin olduğu anlamına gelmez. |