Members

Not: 31 Mart 2020 itibarıyla 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.