Modyfikuje 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).
Żądanie
Żądanie HTTP
PUT 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 YouTube Analytics API właściciele kanałów mogą zarządzać grupami i ich elementami w Statystykach YouTube. |
| https://www.googleapis.com/auth/youtubepartner | Wyświetlanie zasobów w YouTube oraz powiązanych z nimi treści i zarządzanie nimi w serwisie YouTube 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 |
stringTego 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, za pomocą którego użytkownik się uwierzytelnia, musi być powiązane z określonym właścicielem treści YouTube. |
|
Treść żądania
W treści żądania podaj zasób grupy.
W przypadku tego zasobu musisz podać wartość dla tych właściwości. Pamiętaj, że żądanie aktualizuje wartość pola snippet.title.
idsnippet.title
Odpowiedź
Jeśli operacja się uda, 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. 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.