GroupItems: insert

Tworzy element grupy.

Żądanie

Żądanie HTTP

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

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 na temat treści w YouTube. Ten zakres zapewnia dostęp do danych o aktywności użytkowników, takich jak liczba wyświetleń i 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ądzaj swoim 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. Dzięki niej właściciele treści mogą dokonać uwierzytelnienia raz i uzyskać dostęp do wszystkich danych dotyczących filmów i kanału 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 groupItem. W przypadku tego zasobu musisz określić wartości poniższych właściwości.

  • groupId
  • resource.id

Odpowiedź

Jeśli element zostanie pomyślnie wstawiony, metoda zwróci w treści odpowiedzi zasób groupItem.

Jeśli element określony w żądaniu był już uwzględniony w grupie przed przesłaniem żądania, ta metoda zwraca kod odpowiedzi HTTP 204 (No Content).

Błędy

Tabela poniżej zawiera komunikaty o błędach, które interfejs API może zwrócić w odpowiedzi na wywołanie tej metody. Więcej informacji znajdziesz w dokumentacji komunikatu o błędzie.

Typ błędu Szczegóły błędu Opis
forbidden (403) groupContainsMaximumNumberOfItems Grupa zawiera już maksymalną dozwoloną liczbę elementów.

Wypróbuj

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