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
igroupItems.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:
|