Activities: insert

YouTube wycofał funkcję biuletynu kanału, więc ta metoda nie jest już obsługiwana.

Więcej informacji znajdziesz w Centrum pomocy YouTube.

Publikuje komunikat na konkretnym kanale. (Użytkownik przesyłający prośbę musi mieć uprawnienia do działania w imieniu kanału).

Uwaga: chociaż activity może zawierać informacje o działaniach, takich jak ocena filmu przez użytkownika lub oznaczenie filmu jako ulubionego, do wygenerowania tych activity musisz użyć innych metod interfejsu API. Na przykład do oceny filmu użyjesz metody videos.rate(), a do oznaczenia filmu jako ulubionego – metody playlistItems.insert().

Wpływ na limit: wywołanie tej metody wiąże się z kosztem limitu w wysokości 50 jednostek.

Żądanie

Żądanie HTTP

POST https://www.googleapis.com/youtube/v3/activities

Autoryzacja

To żądanie wymaga autoryzacji z użyciem co najmniej jednego z tych 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 tabeli poniżej znajdziesz parametry obsługiwane przez to zapytanie. Wszystkie wymienione parametry to parametry zapytania.

Parametry
Parametry wymagane
part string
Parametr part w tej operacji służy do dwóch celów. Określa właściwości, które operacja zapisu ustawi, oraz właściwości, które będą uwzględnione w odpowiedzi interfejsu API.

Poniższa lista zawiera partnazwy, które możesz uwzględnić w wartości parametru:
  • contentDetails
  • id
  • snippet

Treść żądania

W treści żądania podaj zasób aktywności. W przypadku tego zasobu:

  • Musisz podać 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ę uda, ta metoda zwróci w treści odpowiedzi zasób działania.

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 komunikatu o błędzie.

Typ błędu Szczegóły błędu Opis
badRequest (400) bulletinTextRequired W żądaniu należy użyć właściwości description obiektu snippet, aby podać tekst posta na tablicy.
badRequest (400) invalidMetadata Usługa kind nie pasuje do podanego typu identyfikatora.
forbidden (403) forbidden Żądanie nie zostało prawidłowo autoryzowane.
notFound (404) playlistNotFound YouTube nie może znaleźć filmu, który próbujesz powiązać z postem na karcie Społeczność. 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 na karcie Społeczność. Sprawdź wartość właściwości contentDetails.bulletinPosted.videoId.
userRateLimitExceeded (403) rateLimitExceeded Nie można zrealizować tej prośby, ponieważ został przekroczony limit.