Krótkie wprowadzenie do PHP

Z tego przewodnika dowiesz się, jak skonfigurować prostą aplikację wiersza poleceń w języku PHP, która wysyła żądania do interfejsu YouTube Data API. Z tego przewodnika dowiesz się, jak wysłać 2 żądania do interfejsu API:

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

Wymagania wstępne

Aby uruchomić ten przewodnik, musisz mieć:

  • PHP w wersji 5.4 lub nowszej z zainstalowanym interfejsem wiersza poleceń (CLI) i rozszerzeniem JSON.
  • Narzędzie do zarządzania zależnościami Composer zainstalowane globalnie
  • Bibliotekę klienta interfejsów API Google do języka PHP:
    • Jeśli nie masz jeszcze zainstalowanej biblioteki klienta: 
      composer require google/apiclient:^2.0
    • Jeśli masz już zainstalowaną bibliotekę klienta, zalecamy jej zaktualizowanie, aby mieć pewność, że korzystasz z najnowszych klas biblioteki, którą testujesz: 
      composer update google/apiclient --with-dependencies

Krok 1. Skonfiguruj projekt i dane logowania

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

  1. W panelu biblioteki wyszukaj YouTube Data API v3. Kliknij wpis tego interfejsu API i upewnij się, że jest on włączony w Twoim projekcie.

  2. 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 w 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 w 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 API Explorer w panelu bocznym, aby uzyskać przykładowy kod do pobierania informacji o kanale GoogleDevelopers w 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.

  1. Otwórz dokumentację metody channels.list interfejsu API.

  2. Na tej stronie w sekcji „Typowe przypadki użycia” znajduje się tabela, która wyjaśnia kilka typowych sposobów użycia tej metody. Pierwszy wpis w tabeli dotyczy wyświetlania wyników według identyfikatora kanału.

    Kliknij symbol kodu w pierwszym wpisie, aby otworzyć i wypełnić API Explorer na pełnym ekranie.

    Obraz identyfikujący lokalizację łącza symbolicznego kodu w tabeli, która zawiera przypadki użycia w dokumentacji channels.list. Tekst alternatywny tego obrazu identyfikuje go jako symbol kodu i określa przypadek użycia powiązany z tym linkiem.

  3. Po lewej stronie API 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 w YouTube.

    2. Pod parametrami znajduje się sekcja Dane logowania. W menu w tej sekcji powinna być wyświetlana wartość Klucz interfejsu API. API Explorer domyślnie używa danych logowania do wersji demonstracyjnej, aby ułatwić rozpoczęcie pracy. Aby uruchomić przykład lokalnie, użyjesz jednak własnego klucza interfejsu API.

      Obraz pokazujący sekcję „Dane logowania” w trybie pełnoekranowym APIs Explorer oraz menu z wybraną opcją „Klucz interfejsu API”.

  4. Po prawej stronie API Explorer na pełnym ekranie znajdują się karty z przykładami kodu w różnych językach. Wybierz kartę PHP.

  5. Skopiuj przykładowy kod i zapisz go w pliku o nazwie example.php.

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

  7. Uruchom przykład z wiersza poleceń. W katalogu roboczym uruchom:

    php example.php

  8. 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 w YouTube, pobierał informacje o Twoim kanale w YouTube. To żądanie wymaga autoryzacji użytkownika.

  1. Wróć do dokumentacji metody channels.list interfejsu API.

  2. W sekcji „Typowe przypadki użycia” kliknij symbol kodu w trzecim wpisie w tabeli. Ten przypadek użycia polega na wywołaniu metody list dla „mojego kanału”.

  3. Ponownie po lewej stronie API Explorer na pełnym ekranie zobaczysz listę parametrów, a następnie sekcję Dane logowania. W porównaniu z przykładem, w którym pobierano 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.

      Obraz przedstawiający zakresy w trybie pełnoekranowym narzędzia APIs Explorer i wybraną opcję użycia danych logowania „Google OAuth 2.0”.

  4. Podobnie jak w poprzednim przykładzie wybierz kartę PHP , skopiuj przykładowy kod i zapisz go w pliku example.php.

    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.

  5. Uruchom przykład z wiersza poleceń. W katalogu roboczym uruchom:

    php example.php

  6. 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óre ma być używane do autoryzacji.

  7. Kliknij przycisk, aby przyznać aplikacji dostęp do zakresów określonych w przykładowym kodzie.

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

Więcej informacji