Activities: insert

YouTube wycofał funkcję Biuletyn kanału, która nie jest już obsługiwana.

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:
  • contentDetails
  • id
  • snippet

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.