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:
|
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.