Subscriptions: insert

Dodaje subskrypcję kanału uwierzytelnionego użytkownika.

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

Częste zastosowania

Żądanie

Żądanie HTTP

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

Autoryzacja

To żądanie wymaga autoryzacji z co najmniej jednym z tych 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 tabeli poniżej znajdziesz listę parametrów obsługiwanych przez to zapytanie. Wszystkie wymienione parametry są parametrami zapytania.

Parametry
Parametry wymagane
part string
Parametr part pełni w tej operacji 2 funkcje. 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żej znajdziesz listę part nazw, które możesz uwzględnić w wartości parametru:
  • contentDetails
  • id
  • snippet
  • subscriberSnippet

Treść żądania

W treści żądania podaj zasób subskrypcji. W przypadku 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 w treści odpowiedzi zasób subskrypcji.

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 Osiągnięto maksymalną liczbę subskrypcji.
badRequest (400) subscriptionForbidden Subskrybowanie własnego kanału nie jest obsługiwane.
badRequest (400) subscriptionForbidden Zbyt wiele ostatnich subskrypcji. Spróbuj ponownie za kilka godzin.
forbidden (403) subscriptionForbidden Żądanie nie jest prawidłowo uwierzytelnione lub nie jest obsługiwane w przypadku tego kanału.
notFound (404) publisherNotFound Nie można znaleźć zasobu określonego przez właściwość snippet.resourceId żądania.
notFound (404) subscriberNotFound Nie można znaleźć subskrybenta zidentyfikowanego w żądaniu.
required (400) publisherRequired Zasób subskrypcji określony w żądaniu musi używać właściwości snippet.resourceId, aby zidentyfikować kanał, który jest subskrybowany.

Wypróbuj

Aby wywołać ten interfejs API i zobaczyć żądanie do interfejsu API oraz odpowiedź, użyj APIs Explorer.