Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Python – krótkie wprowadzenie

Z tego przewodnika dowiesz się, jak skonfigurować prostą aplikację wiersza poleceń w Pythonie, która wysyła żądania do interfejsu YouTube Data API. Ten przewodnik wyjaśnia, jak wysłać 2 żądania do interfejsu API:

Aby pobrać informacje o kanale GoogleDevelopers na YouTube, użyjesz klucza interfejsu API, który identyfikuje Twoją aplikację.
Aby przesłać autoryzowane żądanie, które pobiera informacje o Twoim kanale na YouTube, użyjesz identyfikatora klienta OAuth 2.0.

Wymagania wstępne

Aby uruchomić ten przewodnik, musisz mieć:

Pythona 2.7 lub Pythona 3.5 lub nowszego,
narzędzie do zarządzania pakietami pip,
bibliotekę klienta interfejsów API Google do języka Python:
```
pip install --upgrade google-api-python-client
```
biblioteki google-auth-oauthlib i google-auth-httplib2 do autoryzacji użytkownika.
```
pip install --upgrade google-auth-oauthlib google-auth-httplib2
```

Krok 1. Skonfiguruj projekt i dane logowania

Utwórz lub wybierz projekt w konsoli Google Cloud. W konsoli Cloud wykonaj te czynności dla swojego projektu:

W panelu biblioteki wyszukaj YouTube Data API v3. Kliknij listę tego interfejsu API i upewnij się, że jest on włączony w Twoim projekcie.
W panelu danych logowania utwórz 2 dane logowania:
1. Utwórz klucz interfejsu API. Będziesz go używać do wysyłania żądań do interfejsu API, które nie wymagają autoryzacji użytkownika. Na przykład nie musisz mieć autoryzacji użytkownika, aby pobrać informacje o publicznym kanale na YouTube.
2. Utwórz identyfikator klienta OAuth 2.0 Ustaw typ aplikacji na aplikacja komputerowa. W przypadku żądań, które wymagają autoryzacji użytkownika, musisz użyć danych logowania OAuth 2.0. Na przykład musisz mieć autoryzację użytkownika, aby pobrać informacje o kanale na YouTube aktualnie uwierzytelnionego użytkownika.
  
  Pobierz plik JSON zawierający dane logowania OAuth 2.0. Plik ma nazwę podobną do client_secret_CLIENTID.json, gdzie CLIENTID to identyfikator klienta Twojego projektu.

Krok 2. Skonfiguruj i uruchom przykład

Użyj widżetu APIs Explorer w panelu bocznym, aby uzyskać przykładowy kod do pobierania informacji o kanale GoogleDevelopers na YouTube. To żądanie używa klucza interfejsu API do identyfikowania Twojej aplikacji i nie wymaga autoryzacji użytkownika ani żadnych specjalnych uprawnień od użytkownika uruchamiającego przykład.

Otwórz dokumentację metody channels.list interfejsu API.
Na tej stronie w sekcji „Typowe przypadki użycia” znajduje się tabela, która wyjaśnia kilka typowych sposobów użycia tej metody. Pierwsza pozycja w tabeli dotyczy wyświetlania wyników według identyfikatora kanału.

Kliknij symbol kodu w przypadku pierwszej pozycji, aby otworzyć i wypełnić APIs Explorer na pełnym ekranie.
Po lewej stronie APIs Explorer na pełnym ekranie zobaczysz:
1. Pod nagłówkiem Parametry żądania znajduje się lista parametrów obsługiwanych przez tę metodę. Należy ustawić wartości parametrów part i id. Wartość parametru id, UC_x5XG1OV2P6uZZ5FSM9Ttw, to identyfikator kanału GoogleDevelopers na YouTube.
2. Pod parametrami znajduje się sekcja Dane logowania. W menu w tej sekcji powinna być wyświetlana wartość Klucz interfejsu API. Aby ułatwić rozpoczęcie pracy, APIs Explorer domyślnie używa danych logowania do wersji demonstracyjnej. Aby uruchomić przykład lokalnie, użyjesz jednak własnego klucza interfejsu API.
Po prawej stronie APIs Explorer na pełnym ekranie zobaczysz karty z przykładami kodu w różnych językach. Wybierz kartę Python.
Skopiuj przykładowy kod i zapisz go w pliku o nazwie example.py.
W pobranym przykładzie znajdź ciąg znaków YOUR_API_KEY i zastąp go kluczem interfejsu API utworzonym w kroku 1 tego przewodnika.
Uruchom przykład z wiersza poleceń. W katalogu roboczym uruchom:

python example.py
Przykład powinien wykonać żądanie i wydrukować odpowiedź w STDOUT.

Krok 3. Uruchom autoryzowane żądanie

W tym kroku zmodyfikujesz przykładowy kod tak, aby zamiast pobierać informacje o kanale GoogleDevelopers na YouTube, pobierał informacje o Twoim kanale na YouTube. To żądanie wymaga autoryzacji użytkownika.

Wróć do dokumentacji metody channels.list interfejsu API.
W sekcji „Typowe przypadki użycia” kliknij symbol kodu w przypadku trzeciej pozycji w tabeli. Ten przypadek użycia polega na wywołaniu metody list dla „mojego kanału”.
Ponownie po lewej stronie APIs Explorer na pełnym ekranie zobaczysz listę parametrów, a następnie sekcję Dane logowania. W porównaniu z przykładem, w którym pobierasz informacje o kanale GoogleDevelopers, występują jednak 2 zmiany:
1. W sekcji parametrów zamiast ustawionej wartości parametru id wartość parametru mine powinna być ustawiona na true. Informuje to serwer interfejsu API, aby pobrał informacje o kanale aktualnie uwierzytelnionego użytkownika.
2. W sekcji Dane logowania w menu powinna być wybrana opcja Google OAuth 2.0.
  
  Jeśli klikniesz link Pokaż zakresy, powinien być zaznaczony zakres https://www.googleapis.com/auth/youtube.readonly.
Podobnie jak w poprzednim przykładzie wybierz kartę Python, skopiuj przykładowy kod i zapisz go w pliku example.py.

W kodzie znajdź ciąg znaków YOUR_CLIENT_SECRET_FILE.json i zastąp go lokalizacją pliku tajnego klucza klienta pobranego w kroku 1 tego przewodnika.
Uruchom przykład z wiersza poleceń. W katalogu roboczym uruchom:

python example.py
Skopiuj adres URL z konsoli i otwórz go w przeglądarce.

Jeśli nie zalogujesz się na konto Google, pojawi się prośba o zalogowanie. Jeśli zalogujesz się na kilka kont Google, pojawi się prośba o wybranie konta, którego chcesz użyć do autoryzacji.
Kliknij przycisk, aby przyznać aplikacji dostęp do zakresów określonych w przykładowym kodzie.
Skopiuj kod autoryzacji z przeglądarki i wklej go w terminalu. Następnie możesz zamknąć kartę przeglądarki używaną do procesu autoryzacji.

Odpowiedź interfejsu API powinna zostać ponownie wydrukowana w STDOUT.