Members

Not: 31 Mart 2020'den itibaren members uç noktası, desteği sonlandırılan ve 30 Eylül 2020'de veya sonrasında desteklenmeyecek olan sponsors uç noktasının yerini almıştır. API istemcileri, sponsors.list yöntemine yapılan çağrıları members.list yöntemini kullanmak üzere güncellemelidir.

Bu uç nokta yalnızca içerik üreticiler tarafından, kendi kanal üyelikleri etkin YouTube kanalları için istek göndermek amacıyla 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 parasal 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ında, member kaynağının biçimi gösterilmektedir:

{
  "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 değeri.
snippet object
snippet nesnesi, üyeyle ilgili 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ı ile ilgili profil verilerini içerir.

Bir kanalın, profil verileri kullanılamayan üyeleri olabileceğini unutmayın. Örneğin, kanallarını silmesine rağmen üyelik ödemeye devam eden üyeler bu durumdan etkilenir. Bu üyelerin üyelik avantajlarından yararlanmaya devam edebileceğini unutmayın.

API yanıtları, memberDetails nesnesi içindeki profil ayrıntıları ayarlanmasa bile bu üyelerin doğru sayılmasını sağlamak için bu üyelere ait kaynakları içerir. Bu tür üyeler için membershipsDetails
snippet.memberDetails.channelId string
Üye kanalın YouTube kanal kimliği. Ayarlanırsa kanal kimliği, üyenin benzersiz tanımlayıcısı olarak da kullanılabilir. Bu ayar ayarlanmamışsa üye benzersiz şekilde tanımlanamaz ancak kaynak, üyenin erişebileceği seviyeler ve üyelik süresi gibi üyelik ayrıntılarını 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 ayrıntılarını içerir.
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 mülk 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 mülk 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 kimliklerinin listesi. Liste, şu anda etkin olan seviyeyi ve altındaki tüm seviyeleri içerir.
snippet.membershipsDuration object
Bu nesne, mevcut üyenin üyeliğinin fiyat düzeylerine bakılmaksızın toplam süresi hakkında bilgi içerir. snippet.membershipsDetails.membershipsDurationAtLevel[] mülkü, üyenin belirli bir üyelik düzeyine eriştiği üyelik dönemine ilişkin ayrıntıları içeren nesnelerin listesini içerir.

Aşağıdaki örnekte bu özelliklerin işleyiş şekli gösterilmektedir: Bir üye Ocak ayında 1. üyelik seviyesinde yeni bir üyelik satın alır ve bu üyeliği Mart ayına kadar kullanır. Üyenin Nisan ve Mayıs aylarında üyeliği yoktur. Haziran ayında üye, üyeliğini 1. seviyeden yeniden başlatır. Ardından, Ağustos ayında üyelik seviyesini 2. seviyeye yükseltir. 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. Başka bir deyişle, üye bu tarih ve saatten beri sürekli olarak üye Üyeliğin farklı dönemlerini farklı üyelik seviyelerinde geçirmiş olabileceğinizi unutmayın.
snippet.membershipsDuration.memberTotalDurationMonths integer
Kullanıcının üye olduğu ay sayısı (en yakın tam sayıya yuvarlanır). Bu değer, üyenin üyelik süresinin tam ay sayısını yansıtır ancak bu sayı, üyenin söz konusu ay boyunca sürekli üyelik sahibi olduğu anlamına gelmez.
snippet.memberDetails.membershipsDetails.membershipsDurationAtLevel[] list (of objects)
Her nesnenin, üyenin belirli bir üyelik düzeyine eriştiği üyelik dönemine ilişkin ayrıntıları içerdiği bir nesne 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 mülk değerine karşılık gelir.
snippet.memberDetails.membershipsDetails.membershipsDurationAtLevel.memberSince datetime
Üyenin belirtilen üyelik düzeyine erişmeye başladığı tarih ve saat. Başka bir deyişle, üye bu tarih ve saatten beri seviyeye sürekli erişebiliyor. Üyeliğin farklı dönemlerinin daha yüksek üyelik seviyelerinde geçirilmiş 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). Bu değer, üyenin seviyeye eriştiği tam ay sayısını yansıtır ancak bu sayı, üyenin söz konusu ay boyunca sürekli üyelik sahibi olduğu anlamına gelmez.