Activities: insert

YouTube wycofał funkcję biuletynu z kanałów, a ta metoda nie jest już obsługiwana.

Więcej informacji znajdziesz w Centrum pomocy YouTube.

Publikuje biuletyn dotyczący konkretnego kanału. (Przesyłający prośbę musi mieć upoważnienie do działania w imieniu kanału).

Uwaga: mimo że zasób activity może zawierać informacje o działaniach takich jak ocenianie filmów przez użytkowników czy oznaczanie filmów jako ulubionych, musisz użyć innych metod API do wygenerowania tych zasobów activity. Na przykład metoda videos.rate() interfejsu API pozwala ocenić film, a metoda playlistItems.insert(), aby oznaczyć go jako ulubiony.

Wpływ na limit: wywołanie tej metody ma koszt limitu wynoszący 50 jednostek.

Prośba

Żądanie HTTP

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

Upoważnienie

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 są parametrami zapytania.

Parametry
Parametry wymagane
part string
Parametr part służy w tej operacji do 2 celów. Określa właściwości, które ustawi operacja zapisu, a także właściwości uwzględnione w odpowiedzi interfejsu API.

Na poniższej liście znajdziesz nazwy typu part, które możesz uwzględnić w wartości parametru:
  • contentDetails
  • id
  • snippet

Treść żądania

Podaj zasób związany z aktywnością w treści żądania. W przypadku tego zasobu:

  • Musisz podać wartość tych właściwości:

    • snippet.description

  • Możesz ustawić wartości dla tych właściwości:

    • snippet.description
    • contentDetails.bulletin.resourceId

Odpowiedź

Jeśli operacja się uda, 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 szczegółów znajdziesz w dokumentacji komunikatów o błędach.

Typ błędu Szczegóły błędu Opis
badRequest (400) bulletinTextRequired W żądaniu można podać tekst posta biuletynu za pomocą właściwości 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ć tej prośby, ponieważ przekroczony został Twój limit.