Subscriptions: insert

Dodaje subskrypcję kanału uwierzytelnionego użytkownika.

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

Typowe przypadki użycia

Prośba

Żądanie HTTP

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

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

Treść żądania

Podaj zasób subskrypcji w treści żądania. W przypadku tego zasobu:

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

    • snippet.resourceId

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

    • snippet.resourceId

Odpowiedź

Jeśli operacja się uda, 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 szczegółów 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ługiwana.
badRequest (400) subscriptionForbidden W ostatnim czasie zasubskrybowano zbyt wiele treści. 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 udało się znaleźć zasobu określonego przez właściwość snippet.resourceId żądania.
notFound (404) subscriberNotFound Nie udało się znaleźć subskrybenta wskazanego w żądaniu.
required (400) publisherRequired Zasób subskrypcji podany w prośbie musi używać właściwości snippet.resourceId do identyfikowania subskrybowanego kanału.

Wypróbuj

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