Tworzy grupę w Statystykach YouTube. Po utworzeniu grupy możesz dodawać do niej elementy za pomocą metody groupItems.insert
.
Żądanie
Żądanie HTTP
POST https://youtubeanalytics.googleapis.com/v2/groups
Autoryzacja
To żądanie wymaga autoryzacji przy użyciu co najmniej 1 z tych zakresów (więcej informacji o uwierzytelnianiu i autoryzacji).
Zakresy | |
---|---|
https://www.googleapis.com/auth/yt-analytics.readonly | Wyświetlanie raportów Statystyk YouTube dotyczących treści w YouTube. Ten zakres uprawnień zapewnia dostęp do danych o aktywności użytkowników, takich jak liczba wyświetleń i liczba ocen. |
https://www.googleapis.com/auth/yt-analytics-monetary.readonly | Wyświetlanie raportów finansowych Statystyk YouTube dotyczących treści w YouTube Ten zakres uprawnień zapewnia dostęp do danych o aktywności użytkowników oraz szacowanych przychodów i danych o skuteczności reklam. |
https://www.googleapis.com/auth/youtube | Zarządzanie kontem YouTube. W interfejsie API Statystyk YouTube właściciele kanałów używają tego zakresu do zarządzania grupami i elementami grup w Statystykach YouTube. |
https://www.googleapis.com/auth/youtubepartner | Wyświetlanie zasobów YouTube i powiązanych z nimi treści w YouTube oraz zarządzanie nimi. W interfejsie YouTube Analytics API właściciele treści używają tego zakresu do zarządzania grupami i elementami grup w Statystykach YouTube. |
Parametry
Tabela poniżej zawiera listę parametrów obsługiwanych przez to zapytanie. Wszystkie wymienione parametry są parametrami zapytania.
Parametry | ||
---|---|---|
Parametry opcjonalne | ||
onBehalfOfContentOwner |
string Tego parametru można używać tylko w prawidłowo autoryzowanym żądaniu. Uwaga: ten parametr jest przeznaczony wyłącznie dla partnerów treści w YouTube, którzy są właścicielami wielu kanałów w YouTube i nimi zarządzają. Parametr onBehalfOfContentOwner wskazuje, że dane uwierzytelniające autoryzacji prośby identyfikują użytkownika YouTube, który działa w imieniu właściciela treści określonego w wartości parametru. Umożliwia ona właścicielom treści jednorazową weryfikację i uzyskanie dostępu do wszystkich danych o filmach i kanałach bez konieczności podawania danych uwierzytelniających dla każdego kanału. Konto, na którym użytkownik się uwierzytelnia, musi być powiązane z określonym właścicielem treści w YouTube. |
Treść żądania
W treści żądania podaj zasób grupy. W przypadku tego zasobu musisz podać wartość dla tych właściwości.
snippet.title
contentDetails.itemType
Odpowiedź
Jeśli operacja się powiedzie, zwróci ona zasób grupy w treści odpowiedzi.
Błędy
Interfejs API nie definiuje żadnych komunikatów o błędach, które są unikalne dla tej metody. Ta metoda może jednak zwracać ogólne błędy interfejsu API wymienione w dokumentacji komunikatów o błędach.
Wypróbuj
Użyj adresu APIs Explorer, aby wywołać ten interfejs API i zobaczyć żądanie oraz odpowiedź interfejsu API.