Więcej informacji znajdziesz w Centrum pomocy YouTube.
Publikuje newsletter dla konkretnego kanału. (Użytkownik, który przesyła prośbę, musi być upoważniony do działania w imieniu kanału).
Uwaga: chociaż zasób activity
może zawierać informacje o działaniach takich jak ocenianie filmu lub oznaczanie go jako ulubionego, do wygenerowania tych zasobów activity
musisz użyć innych metod interfejsu API. Możesz np. użyć metody videos.rate()
interfejsu API, aby ocenić film, lub metody playlistItems.insert()
, aby oznaczyć film jako ulubiony.
Wpływ limitu: wywołanie tej metody ma limit kosztów wynoszący 50 jednostek.
Żądanie
Żądanie HTTP
POST https://www.googleapis.com/youtube/v3/activities
Upoważnienie
To żądanie wymaga autoryzacji z co najmniej jednym z poniższych zakresów (więcej informacji o uwierzytelnianiu i autoryzacji).
Zakres |
---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
Parametry
W poniższej tabeli podano parametry obsługiwane przez to zapytanie. Wszystkie wymienione parametry są parametrami zapytania.
Parametry | ||
---|---|---|
Parametry wymagane | ||
part |
string Parametr part spełnia 2 cele w tej operacji. Określa właściwości, które ustawi operacja zapisu, oraz właściwości, które będzie uwzględniać odpowiedź interfejsu API.Ta lista zawiera nazwy part , które możesz uwzględnić w wartości parametru:
|
Treść żądania
Podaj zasoby w treści żądania. Dla tego zasobu:
-
Musisz określić wartość tych właściwości:
snippet.description
-
Możesz ustawić wartości tych właściwości:
snippet.description
contentDetails.bulletin.resourceId
Odpowiedź
Jeśli operacja się powiedzie, ta metoda zwróci zasób aktywności w treści odpowiedzi.
Błędy
W tabeli poniżej znajdziesz 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 komunikatów o błędach.
Typ błędu | Szczegóły błędu | Opis |
---|---|---|
badRequest (400) |
bulletinTextRequired |
W żądaniu musi znajdować się właściwość description obiektu snippet . |
badRequest (400) |
invalidMetadata |
Właściwość kind nie pasuje do typu podanego identyfikatora. |
forbidden (403) |
forbidden |
Żądanie nie jest poprawnie autoryzowane. |
notFound (404) |
playlistNotFound |
YouTube nie może znaleźć filmu, który próbujesz powiązać z postem w biuletynie. Sprawdź wartość właściwości contentDetails.bulletinPosted.playlistId . |
notFound (404) |
videoNotFound |
YouTube nie może znaleźć filmu, który próbujesz powiązać z postem w biuletynie. Sprawdź wartość właściwości contentDetails.bulletinPosted.videoId . |
userRateLimitExceeded (403) |
rateLimitExceeded |
Nie można zrealizować żądania, ponieważ został przekroczony Twój limit. |