Aby tworzyć dane logowania OAuth 2.0, konfigurować ekran zgody użytkownika i włączać interfejs Google Ads API w swojej aplikacji, potrzebujesz projektu konsoli interfejsów API Google.
Dane logowania są potrzebne do uwierzytelniania i autoryzacji użytkowników Google Ads przez serwery Google. Dane logowania pozwalają generować tokeny OAuth do użycia w wywołaniach interfejsu API.
Wybierz lub utwórz projekt Konsoli interfejsów API Google
Jeśli masz już projekt Konsoli interfejsów API Google i chcesz go używać do tworzenia danych logowania, możesz przejść od razu do sekcji Tworzenie identyfikatora klienta i tajnego klucza klienta.
Aby utworzyć projekt:
- Otwórz Konsolę interfejsów API Google.
- Kliknij Create project (Utwórz projekt).
- Wpisz nazwę lub zaakceptuj wygenerowaną sugestię
- Potwierdź lub edytuj pozostałe pola
- Kliknij Utwórz.
Jeśli masz włączone płatności, wybierz konto rozliczeniowe dla nowego projektu. Korzystanie z interfejsu Google Ads API jest bezpłatne, ale w przypadku Google Cloud obowiązuje limit.
Konfigurowanie ekranu zgody OAuth
Jeśli korzystasz z istniejącego projektu Konsoli interfejsów API Google, a masz już skonfigurowany ekran zgody OAuth, możesz pominąć ten krok i zmodyfikować ekran zgody, dodając zakres protokołu OAuth 2.0 interfejsu Google Ads API.
Gdy do autoryzacji używasz protokołu OAuth 2.0, Google wyświetla użytkownikowi ekran zgody zawierający podsumowanie Twojego projektu, jego zasad i żądanych zakresów dostępu. Skonfigurowanie ekranu zgody OAuth aplikacji określa, co jest wyświetlane użytkownikom i osobom sprawdzającym, oraz rejestruje aplikację, aby można było ją później opublikować.
Konfigurowanie nowego ekranu zgody OAuth
- Otwórz stronę ekranu zgody i wybierz swój projekt z menu u góry.
- Wybierz Typ użytkownika i kliknij UTWÓRZ.
- Wypełnij formularz ekranu zgody. W razie potrzeby możesz go później zmienić. Gdy skończysz, kliknij ZAPISZ I KONTYNUUJ.
- Na następnej stronie kliknij DODAJ LUB USUŃ ZAKRES.
- Przewiń w dół i w polu Dodaj zakresy ręcznie wpisz:
https://www.googleapis.com/auth/adwords - Kliknij DODAJ DO TABELI.
- Dodaj inne zakresy, których może potrzebować projekt, a następnie kliknij AKTUALIZUJ.
- Kliknij ZAPISZ I KONTYNUUJ.
- Jeśli nie planujesz od razu opublikować projektu, dodaj adres e-mail każdego konta użytkownika, którego możesz używać do testowania, a potem kliknij ZAPISZ I KONTYNUUJ.
- Przejrzyj stronę podsumowania i kliknij WRÓĆ DO PULPIT.
Konfigurowanie istniejącego ekranu zgody OAuth
- Otwórz stronę ekranu zgody i wybierz swój projekt w menu u góry.
- Kliknij EDYTUJ APLIKACJĘ.
- W formularzu ekranu zgody OAuth kliknij ZAPISZ I KONTYNUUJ.
- Na następnej stronie kliknij DODAJ LUB USUŃ ZAKRES.
- Przewiń w dół i w polu Dodaj zakresy ręcznie wpisz:
https://www.googleapis.com/auth/adwords - Kliknij DODAJ DO TABELI.
- Kliknij ZAPISZ I KONTYNUUJ.
- W formularzu Użytkownicy testowi kliknij ZAPISZ I KONTYNUUJ.
- Przejrzyj stronę podsumowania i kliknij WRÓĆ DO PULPIT.
Tworzenie identyfikatora klienta i tajnego klucza klienta
Możesz pominąć ten krok, jeśli korzystasz z istniejącego projektu Konsoli interfejsów API Google, który ma już wygenerowany identyfikator klienta i obiekt tajny.
Po określeniu typu aplikacji wygeneruj identyfikator i tajny klucz klienta OAuth 2.0, wykonując te instrukcje:
Otwórz stronę Dane logowania. Wybierz wcześniej utworzony projekt lub utwórz nowy.
Na ekranie Dane logowania kliknij UTWÓRZ DANE LOGOWANIA i wybierz Identyfikator klienta OAuth.
Jeśli w tym projekcie nie masz jeszcze skonfigurowanego ekranu zgody OAuth, kliknij SKONFIGURUJ EKRAN ZGODY.
Wybierz typ użytkownika i kliknij UTWÓRZ.
Wypełnij początkowy formularz. W razie potrzeby możesz go później zmienić. Gdy skończysz, kliknij Zapisz.
Aby kontynuować, wróć do sekcji Dane logowania > UTWÓRZ DANE LOGOWANIA > Identyfikator klienta OAuth.
Jako typ aplikacji wybierz Aplikacja komputerowa lub Aplikacja internetowa w zależności od przypadku użycia. W tym przewodniku jako typ aplikacji używana jest aplikacja komputerowa.
Wpisz nazwę aplikacji, a potem kliknij Utwórz.
Na stronie potwierdzenia skopiuj do schowka Your Client ID (Identyfikator klienta) i Your Client Secret (Tajny klucz klienta), aby móc skonfigurować bibliotekę klienta później. Pobierz też dane logowania w formacie JSON do pliku o nazwie
credentials.json.
Włączanie interfejsu Google Ads API w projekcie
Aby włączyć w projekcie interfejs Google Ads API:
Otwórz Bibliotekę API w konsoli interfejsów API Google. Jeśli pojawi się taka prośba, wybierz projekt lub utwórz nowy. Zawiera ona wszystkie dostępne interfejsy API pogrupowane według rodziny usług i popularności.
Jeśli nie widzisz interfejsu Google Ads API, użyj wyszukiwarki, aby go znaleźć.
Wybierz kolejno interfejs Google Ads API i przycisk Włącz.