Members

Not: 31 Mart 2020 itibarıyla members uç noktası, artık kullanımdan kaldırılan ve 30 Eylül 2020'de veya bu tarihten sonra desteklenmeyecek olan sponsors uç noktasının yerini almıştır. API istemcileri, bunun yerine members.list yöntemini kullanmak için sponsors.list yöntemine yapılan çağrıları güncellemelidir.

Bu uç nokta, yalnızca bireysel içerik üreticiler tarafından kanal üyeliklerinin etkinleştirildiği kendi YouTube kanalları için istekte bulunmak amacıyla kullanılabilir. Erişim istemek için Google veya YouTube temsilcinizle iletişime geçin.

member kaynağı, bir YouTube kanalının üyelerini temsil eder. Üyeler, içerik üreticiye düzenli olarak maddi destek sağlar ve özel avantajlardan yararlanır. Örneğin, içerik üretici bir sohbet için üyelere özel modu 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ı, member kaynağının biçimini gösterir:

{
  "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 olur.
etag etag
Bu kaynağın Etag'i.
snippet object
snippet nesnesi, üyeyle ilgili ayrıntıları içerir.
snippet.creatorChannelId string
Üyelikler sunan içerik üreticinin YouTube kanal kimliği.
snippet.memberDetails object
Bu nesne, üyelik için ödeme yapan YouTube kanalıyla ilgili profil verilerini içerir.

Kanalda, profil verileri bulunmayan üyeler olabileceğini unutmayın. Örneğin bu durum, kanallarını silen ancak üyelikler için ödeme yapmaya devam eden üyeler için geçerlidir. Bu üyelerin, üyelik avantajlarına erişmeye devam edebileceğini unutmayın.

API yanıtları, memberDetails nesnesinin içindeki profil ayrıntıları ayarlanmamış olsa bile doğru sayıların sağlanması için bu üyelere yönelik kaynaklar içerir. Bu tür üyeler için membershipsDetails özelliği 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 bir şekilde tanımlanamaz ancak kaynak, üyenin erişebileceği seviyeler ve üyelik süresi gibi üyelik ayrıntılarını iletmeye devam eder.
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 ayrıntılarını içerir.
snippet.membershipsDetails.highestAccessibleLevel string
Üye kanalın şu anda erişebildiği en yüksek üyelik seviyesinin kimliği. Değer, bir membershipsLevel kaynağındaki id özellik değerine karşılık gelir.
snippet.membershipsDetails.highestAccessibleLevelDisplayName string
Üye kanalın şu anda erişebildiği en yüksek üyelik seviyesinin 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 seviyeleri için kimliklerin listesi. Listede şu anda etkin olan seviye ve altındaki tüm seviyeler yer alır.
snippet.membershipsDuration object
Bu nesne, fiyatlandırma seviyelerine bakılmaksızın mevcut üyenin toplam üyelik süresiyle ilgili bilgileri içerir. Ardından snippet.membershipsDetails.membershipsDurationAtLevel[] özelliği, üyenin belirli bir üyelik seviyesine erişebildiği dönemle ilgili ayrıntıların yer aldığı nesnelerin listesini içerir.

Aşağıdaki örnekte bu mülklerin işleyiş şekli gösterilmektedir: Bir üye Ocak ayında 1. üyelik düzeyinde yeni bir üyelik satın alır ve Mart'a kadar bu üyeliğe sahip olur. Nisan ve Mayıs aylarında üyenin üyelik özelliği bulunmaz. Haziran ayında üye, tekrar 1. düzeyden üyeliğini yeniden başlatır. Ardından, Ağustos ayında üye üyeliklerini 2. seviyeye çıkarır. Bu nedenle, Ekim ayında bir API çağrısı yapılırsa member kaynağı şunları 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. Diğer bir deyişle, üye bu tarih ve saatten beri sürekli olarak üyedir. Üyelik dönemlerinin farklı üyelik seviyelerinde harcanmış olabileceğini unutmayın.
snippet.membershipsDuration.memberTotalDurationMonths integer
Kullanıcının üye olduğu ay sayısı (en yakın tam sayıya yuvarlanır). Değer, üyenin tam olarak üye olduğu ayların sayısını yansıtır ancak sayı, üyenin bu ay boyunca sürekli olarak üye olduğunu ima etmez.
snippet.memberDetails.membershipsDetails.membershipsDurationAtLevel[] list (of objects)
Her nesnenin, üyenin belirli bir üyelik seviyesine erişimi olduğu üyelik dönemiyle ilgili ayrıntıları içerdiği nesnelerin listesi. Liste, üyenin şu anda erişebildiği her üyelik seviyesi için bir nesne içerir.
snippet.memberDetails.membershipsDetails.membershipsDurationAtLevel.level string
Üyelik seviyesi kimliği. Değer, bir membershipsLevel kaynağındaki id özellik değerine karşılık gelir.
snippet.memberDetails.membershipsDetails.membershipsDurationAtLevel.memberSince datetime
Üyenin belirtilen üyelik seviyesine erişim sahibi olduğu tarih ve saat. Başka bir deyişle, üye bu tarih ve saatten bu yana seviyeye sürekli olarak erişebilir. Üyelik dönemlerinin daha yüksek üyelik düzeylerinde harcanmış olabileceğini unutmayın.
snippet.memberDetails.membershipsDetails.membershipsDurationAtLevel.memberTotalDurationMonths integer
Kullanıcının belirtilen düzeye erişebildiği ay sayısı (en yakın tam sayıya yuvarlanır). Değer, üyenin seviyeye erişebildiği tam ay sayısını yansıtır ancak sayı, üyenin o ay boyunca sürekli olarak üye olduğunu ima etmez.