Groups: insert

Tworzy grupę Statystyk YouTube. Po utworzeniu grupy użyj metody groupItems.insert, aby dodać elementy do grupy.

Żądanie

Żądanie HTTP

POST https://youtubeanalytics.googleapis.com/v2/groups

Upoważnienie

To żądanie wymaga autoryzacji z co najmniej jednym z poniższych zakresów (więcej informacji o uwierzytelnianiu i autoryzacji).

Zakresy
https://www.googleapis.com/auth/yt-analytics.readonly Wyświetlaj raporty Statystyk YouTube dotyczące treści w YouTube. Zakres ten zapewnia dostęp do danych o aktywności użytkowników, takich jak liczba wyświetleń i oceny.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly Wyświetlanie raportów finansowych Statystyk YouTube dotyczących treści w YouTube Zakres ten umożliwia dostęp do danych o aktywności użytkowników oraz szacunkowych danych o przychodach i skuteczności reklam.
https://www.googleapis.com/auth/youtube Zarządzaj swoim kontem YouTube. W interfejsie YouTube Analytics API właściciele kanałów używają tego zakresu do zarządzania grupami i elementami grup w YouTube Analytics.
https://www.googleapis.com/auth/youtubepartner Wyświetlanie zasobów YouTube i powiązanych 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 YouTube Analytics.

Parametry

Tabela poniżej zawiera listę parametrów obsługiwanych przez to zapytanie. Wszystkie wymienione parametry są parametrami zapytania.

Parametry
Parametry opcjonalne
onBehalfOfContentOwner string
Ten parametr może być używany tylko w poprawnie autoryzowanym żądaniu. Uwaga: ten parametr jest przeznaczony wyłącznie dla partnerów dostarczających treści do YouTube, którzy mają wiele kanałów YouTube i zarządzają nimi.

Parametr onBehalfOfContentOwner żądania autoryzacji wskazuje użytkownika YouTube, który działa w imieniu właściciela treści określonego w wartości parametru. Umożliwia właścicielom treści uwierzytelnianie tylko raz oraz dostęp do wszystkich filmów i kanałów bez konieczności podawania danych uwierzytelniających dla każdego kanału z osobna. Konto, z którego użytkownik się uwierzytelnia, musi być połączone z określonym właścicielem treści w YouTube.

Treść żądania

Podaj zasób grupy w treści żądania. W przypadku tego zasobu musisz określić wartość następujących właściwości.

  • snippet.title
  • contentDetails.itemType

Odpowiedź

Jeśli operacja się powiedzie, ta metoda zwróci 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. Może jednak zwrócić ogólne błędy interfejsu API wymienione w dokumentacji komunikatu o błędzie.

Wypróbuj

Użyj APIs Explorer, aby wywołać ten interfejs API i wyświetlić żądanie oraz odpowiedź interfejsu API.