Groups

Zasób group reprezentuje grupę w Statystykach YouTube, czyli niestandardową kolekcję zawierającą maksymalnie 500 kanałów, filmów, playlist lub zasobów.

Wszystkie elementy w grupie muszą reprezentować ten sam typ zasobu. Nie możesz np. utworzyć grupy zawierającej 100 filmów i 100 playlist.

Grupa Analytics może zawierać tylko zasoby, które zostały przez Ciebie przesłane lub zgłoszone, albo które są połączone z kanałem, którym zarządzasz. Dzięki temu 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 lub zasobów.

Metody

Interfejs API obsługuje te metody dotyczące zasobów groups:

list
Zwraca listę grup, które pasują do parametrów żądania do interfejsu API. Możesz na przykład pobrać wszystkie grupy należące do uwierzytelnionego użytkownika lub pobrać co najmniej 1 grupę według jej unikalnego identyfikatora. Wypróbuj teraz
insert
Tworzy grupę w Statystykach YouTube. Po utworzeniu grupy użyj metody groupItems.insert, aby dodać do niej elementy. Wypróbuj
update
Zmienia metadane grupy. Obecnie jedyną właściwością, którą można zaktualizować, jest tytuł grupy. (użyj elementów groupItems.insert i groupItems.delete, aby dodawać i usuwać elementy grupy). Wypróbuj
usuń
Usuwanie grupy. Wypróbuj teraz

Reprezentacja zasobu

Struktura JSON poniżej pokazuje format zasobu groups:

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

Właściwości

Tabela poniżej zawiera właściwości widoczne w tym zasobie:

Właściwości
kind string
Określa typ zasobu interfejsu API. Wartość wyniesie youtube#group.
etag etag
Etag tego zasobu.
id string
Identyfikator, którego YouTube używa do jednoznacznego rozpoznawania 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ść jest podana w formacie ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
snippet.title string
Nazwa grupy. Wartość musi być niepustym ciągiem znaków.
contentDetails object
Obiekt contentDetails zawiera dodatkowe informacje o grupie, takie jak liczba i typ elementów, które zawiera.
contentDetails.itemCount unsigned long
Liczba elementów w grupie.
contentDetails.itemType string
Typ zasobów zawartych w grupie.

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