Groups

Zasób group reprezentuje grupę w YouTube Analytics, która jest niestandardową kolekcją maksymalnie 500 kanałów, filmów, playlist lub zasobów.

Wszystkie elementy w grupie muszą mieć ten sam typ zasobu. Nie możesz na przykład utworzyć grupy zawierającej 100 filmów i 100 playlist.

Grupa w Analytics może zawierać tylko zasoby, które zostały przez Ciebie przesłane lub objęte roszczeniem albo są połączone z kanałem, którym zarządzasz. W rezultacie właściciele kanałów mogą tworzyć grupy filmów i playlist. Właściciele treści mogą tworzyć grupy filmów, playlist, kanałów i zasobów.

Metody

Interfejs API obsługuje następujące metody w przypadku zasobów groups:

list
Zwraca listę grup pasujących do parametrów żądania do interfejsu API. Możesz na przykład pobrać wszystkie grupy, których właścicielem jest uwierzytelniony użytkownik, albo pobrać jedną lub kilka grup według ich unikalnych identyfikatorów. Wypróbuj teraz
wstaw
Tworzy grupę Statystyk YouTube Po utworzeniu grupy użyj metody groupItems.insert, aby dodać elementy do grupy. Wypróbuj teraz
zaktualizuj
Modyfikuje metadane grupy. Obecnie jedyną usługą, którą można zaktualizować, jest tytuł grupy. Aby dodawać i usuwać elementy, użyj groupItems.insert i groupItems.delete. Wypróbuj teraz
usuń
Usuwa grupę. Wypróbuj teraz

Reprezentowanie zasobów

Struktura JSON poniżej przedstawia format zasobu groups:

{
  "kind": "youtube#group",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "title": string
  },
  "contentDetails": {
    "itemCount": unsigned long,
    "itemType": string
  }
}

Usługi

Poniższa tabela określa właściwości, które pojawiają się w tym zasobie:

Usługi
kind string
Określa typ zasobu interfejsu API. Wartość będzie wynosić youtube#group.
etag etag
Otagowanie tego zasobu.
id string
Identyfikator, którego YouTube używa do jednoznacznego identyfikowania grupy.
snippet object
Obiekt snippet zawiera podstawowe informacje o grupie, w tym datę i nazwę jej utworzenia.
snippet.publishedAt datetime
Data i godzina utworzenia grupy. Wartość ma format ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
snippet.title string
Nazwa grupy. Wartość nie może być pusta.
contentDetails object
Obiekt contentDetails zawiera dodatkowe informacje o grupie, w tym liczbę i typ elementów, które zawiera.
contentDetails.itemCount unsigned long
Liczba elementów w grupie.
contentDetails.itemType string
Typ zasobów, które zawiera grupa.

Prawidłowe wartości tej właściwości to:
  • youtube#channel
  • youtube#playlist
  • youtube#video
  • youtubePartner#asset