Members

Zasób member reprezentuje wspierającego kanał w YouTube kanał. Wspierający regularnie przekazuje twórcom środki pieniężne i otrzymuje specjalne korzyści. Wspierający mogą na przykład czatować, gdy twórca włączy tryb czatu tylko dla wspierających.

Obowiązują te ograniczenia dostępu:

  • Dostęp do punktów końcowych members i membershipsLevels jest ograniczony do twórców YouTube, którzy mają dedykowanego menedżera ds. twórców YouTube.
  • Dostęp jest przyznawany na poziomie kanału. Ze względu na to, że dostęp jest przyznawany na poziomie kanału, zakres OAuth youtube.channel-memberships.creator nie przechodzi standardowego procesu weryfikacji OAuth w Google Cloud.

Metody

Interfejs API obsługuje te metody w przypadku zasobów member:

list
Wyświetla listę wspierających (wcześniej nazywanych „sponsorami”) kanału. Żądanie do interfejsu API musi być autoryzowane przez właściciela kanału.

Prezentacja zasobów

Ta struktura JSON pokazuje format zasobu member:

{
  "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,
        }
      ]
    }
  }
}

Właściwości

W tej tabeli znajdziesz definicje właściwości, które pojawiają się w tym zasobie:

Właściwości
kind string
Określa typ zasobu interfejsu API. Wartość to youtube#member.
etag etag
Etag tego zasobu.
snippet object
Obiekt snippet zawiera szczegółowe informacje o wspierającym.
snippet.creatorChannelId string
Identyfikator kanału w YouTube twórcy, który oferuje wspieranie.
snippet.memberDetails object
Ten obiekt zawiera dane profilu kanału w YouTube, który płaci za wspieranie.

Pamiętaj, że kanał może mieć wspierających z niedostępnymi danymi profilu. Dzieje się tak na przykład w przypadku wspierających, którzy usunęli swoje kanały, ale nadal płacą za wspieranie. Pamiętaj, że ci wspierający nadal mogą korzystać z korzyści z subskrypcji.

Odpowiedzi interfejsu API zawierają zasoby dla tych wspierających, aby zapewnić dokładne liczby, nawet jeśli szczegóły profilu w obiekcie memberDetails nie są ustawione. Informacje membershipsDetails są nadal podawane w przypadku takich wspierających.
snippet.memberDetails.channelId string
Identyfikator kanału w YouTube wspierającego. Jeśli jest ustawiony, identyfikator kanału można też traktować jako unikalny identyfikator wspierającego. Jeśli nie jest ustawiony, nie można jednoznacznie zidentyfikować wspierającego, ale zasób nadal zawiera szczegółowe informacje o wspieraniu, takie jak poziomy, do których wspierający ma dostęp, oraz czas trwania wspierania.
snippet.memberDetails.channelUrl string
Adres URL kanału.
snippet.memberDetails.displayName string
Nazwa wyświetlana kanału.
snippet.memberDetails.profileImageUrl string
Adres URL awatara kanału.
snippet.membershipsDetails object
Ten obiekt zawiera szczegółowe informacje o wspieraniu kanału wspierającego.
snippet.membershipsDetails.highestAccessibleLevel string
Identyfikator najwyższego poziomu wspierania, do którego kanał wspierającego ma obecnie dostęp. Wartość odpowiada wartości właściwości id w zasobie membershipsLevel
snippet.membershipsDetails.highestAccessibleLevelDisplayName string
Nazwa najwyższego poziomu wspierania, do którego kanał wspierającego ma obecnie dostęp. Wartość odpowiada wartości właściwości displayName w zasobie membershipsLevel.
snippet.membershipsDetails.accessibleLevels[] list (of strings)
Lista identyfikatorów wszystkich poziomów wspierania, do których użytkownik ma obecnie dostęp. Lista obejmuje obecnie aktywny poziom i wszystkie poziomy poniżej niego.
snippet.membershipsDuration object
Ten obiekt zawiera informacje o łącznym czasie trwania obecnego wspierania bez względu na poziomy cenowe. Właściwość snippet.membershipsDetails.membershipsDurationAtLevel[] zawiera listę obiektów, które zawierają szczegółowe informacje o okresie wspierania, w którym wspierający miał dostęp do określonego poziomu wspierania.

Ten przykład pokazuje, jak działają te właściwości: wspierający kupuje nowe wspieranie w styczniu na poziomie 1 i ma je do marca. W kwietniu i maju wspierający nie ma wspierania. W czerwcu wspierający ponownie włącza wspieranie, ponownie na poziomie 1. Następnie w sierpniu wspierający przechodzi na poziom 2. Jeśli wywołanie interfejsu API zostanie wykonane w październiku, zasób member będzie zawierać te informacje: 
"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
Data i godzina rozpoczęcia obecnego wspierania. Innymi słowy, wspierający nieprzerwanie wspiera kanał od tej daty i godziny. Pamiętaj, że różne okresy wspierania mogły być spędzone na różnych poziomach wspierania.
snippet.membershipsDuration.memberTotalDurationMonths integer
Liczba miesięcy, zaokrąglona w dół do najbliższej liczby całkowitej, przez które użytkownik wspiera kanał. Wartość odzwierciedla liczbę pełnych miesięcy, przez które wspierający wspierał kanał, ale nie oznacza, że wspierający nieprzerwanie wspierał kanał przez tyle miesięcy.
snippet.memberDetails.membershipsDetails.membershipsDurationAtLevel[] list (of objects)
Lista obiektów, z których każdy zawiera szczegółowe informacje o okresie wspierania, w którym wspierający miał dostęp do określonego poziomu wspierania. Lista zawiera 1 obiekt dla każdego poziomu wspierania, do którego wspierający ma obecnie dostęp.
snippet.memberDetails.membershipsDetails.membershipsDurationAtLevel.level string
Identyfikator poziomu wspierania. Wartość odpowiada wartości właściwości id w zasobie membershipsLevel.
snippet.memberDetails.membershipsDetails.membershipsDurationAtLevel.memberSince datetime
Data i godzina, od których wspierający ma dostęp do określonego poziomu wspierania. Innymi słowy, wspierający nieprzerwanie ma dostęp do tego poziomu od tej daty i godziny. Pamiętaj, że różne okresy wspierania mogły być spędzone na wyższych poziomach wspierania.
snippet.memberDetails.membershipsDetails.membershipsDurationAtLevel.memberTotalDurationMonths integer
Liczba miesięcy, zaokrąglona w dół do najbliższej liczby całkowitej, przez które użytkownik miał dostęp do określonego poziomu. Wartość odzwierciedla liczbę pełnych miesięcy, przez które wspierający miał dostęp do tego poziomu, ale nie oznacza, że wspierający nieprzerwanie wspierał kanał przez tyle miesięcy.