Subscriptions: insert

Dodaje subskrypcję kanału uwierzytelnionego użytkownika.

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

Typowe przypadki użycia

Żądanie

Żądanie HTTP

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

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/youtubepartner
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
  • subscriberSnippet

Treść żądania

Zasób subskrypcji w treści żądania. Dla tego zasobu:

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

    • snippet.resourceId

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

    • snippet.resourceId

Odpowiedź

Jeśli operacja się uda, ta metoda zwróci zasób subskrypcji 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) subscriptionDuplicate Subskrypcja, którą próbujesz utworzyć, już istnieje.
badRequest (400) subscriptionForbidden Masz już maksymalną liczbę subskrypcji.
badRequest (400) subscriptionForbidden Subskrybowanie własnego kanału nie jest obsługiwane.
badRequest (400) subscriptionForbidden Zbyt wiele nowych subskrypcji. Spróbuj ponownie za kilka godzin.
forbidden (403) subscriptionForbidden Żądanie nie zostało prawidłowo uwierzytelnione lub nie jest obsługiwane w przypadku tego kanału.
notFound (404) publisherNotFound Nie można znaleźć zasobu określonego we właściwości snippet.resourceId żądania.
notFound (404) subscriberNotFound Nie udało się znaleźć subskrybenta określonego w żądaniu.
required (400) publisherRequired Zasób subskrypcji określony w żądaniu musi używać właściwości snippet.resourceId do identyfikacji subskrybowanego kanału.

Wypróbuj

Użyj APIs Explorer, aby wywołać ten interfejs API i wyświetlić żądanie oraz odpowiedź interfejsu API.