Konfigurowanie projektu w Konsoli interfejsów API Google

Aby utworzyć dane logowania OAuth 2.0, skonfigurować ekran zgody użytkownika i włączyć interfejs Google Ads API w aplikacji, musisz mieć projekt w Konsoli interfejsów API Google.

Dane logowania są potrzebne do uwierzytelniania i autoryzacji użytkowników Google Ads przez serwery Google. Dane logowania umożliwiają generowanie tokenów OAuth do użycia w wywołaniach interfejsu API.

Wybieranie lub tworzenie projektu w Konsoli interfejsów API Google

Jeśli masz już projekt Konsoli interfejsów API Google i chcesz go użyć do utworzenia danych logowania, możesz przejść 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 obowiązuje limit łącznej liczby projektów Cloud.

Jeśli korzystasz z istniejącego projektu w Konsoli interfejsów API Google, a masz już skonfigurowany ekran zgody OAuth, możesz pominąć ten krok i zmienić ekran zgody przez dodanie zakresu OAuth 2.0 interfejsu Google Ads API.

Gdy do autoryzacji używasz protokołu OAuth 2.0, Google wyświetla użytkownikowi ekran zgody z podsumowaniem projektu, stosowanych w nim zasad oraz żądanych zakresów autoryzacji dostępu. Skonfigurowanie ekranu zgody OAuth w aplikacji określa, co jest wyświetlane użytkownikom i weryfikatorom, oraz rejestruje aplikację, dzięki czemu możesz ją później opublikować.

  1. Otwórz stronę Ekran z prośbą o zgodę i wybierz projekt z menu u góry strony.
  2. Wybierz Typ użytkownika i kliknij UTWÓRZ.
  3. Wypełnij formularz ekranu akceptacji. W razie potrzeby możesz ją później zmienić. Gdy skończysz, kliknij ZAPISZ I KONTYNUUJ.
  4. Na następnej stronie kliknij DODAJ LUB USUŃ ZAKRESY.
  5. Przewiń stronę w dół i w polu w sekcji Dodaj zakresy ręcznie wpisz te informacje:

    https://www.googleapis.com/auth/adwords

  6. Kliknij DODAJ DO TABELI.
  7. Dodaj inne zakresy, których może potrzebować Twój projekt, a następnie kliknij AKTUALIZUJ.
  8. Kliknij ZAPISZ I KONTYNUUJ.
  9. Jeśli nie planujesz opublikować projektu od razu, dodaj adres e-mail każdego konta użytkownika, którego możesz użyć do testowania, a następnie kliknij ZAPISZ I KONTYNUUJ.
  10. Przejrzyj stronę podsumowania i kliknij WRÓĆ DO PANELU.
  1. Otwórz stronę Ekran z prośbą o zgodę i wybierz projekt z menu u góry strony.
  2. Kliknij EDYTUJ APLIKACJĘ.
  3. Kliknij ZAPISZ I KONTYNUUJ w formularzu na ekranie akceptacji OAuth.
  4. Na następnej stronie kliknij DODAJ LUB USUŃ ZAKRESY.
  5. Przewiń stronę w dół i w polu w sekcji Dodaj zakresy ręcznie wpisz te informacje:

    https://www.googleapis.com/auth/adwords

  6. Kliknij DODAJ DO TABELI.
  7. Kliknij ZAPISZ I KONTYNUUJ.
  8. W formularzu Użytkownicy testowi kliknij ZAPISZ I KONTYNUUJ.
  9. Przejrzyj stronę podsumowania i kliknij WRÓĆ DO PANELU.

Tworzenie identyfikatora klienta i tajnego klucza klienta

Możesz pominąć ten krok, jeśli korzystasz z istniejącego projektu w Konsoli interfejsów API Google, który ma już wygenerowany identyfikator klienta i tajny klucz.

Po określeniu typu aplikacji wykonaj te instrukcje, aby wygenerować identyfikator klienta OAuth 2.0 i tajny klucz klienta:

  1. Otwórz stronę Dane logowania. Wybierz wcześniej utworzony projekt lub utwórz nowy.

  2. Na ekranie Dane logowania kliknij UTWÓRZ DANE LOGOWANIA i wybierz Identyfikator klienta OAuth.

    • Jeśli nie masz jeszcze skonfigurowanego ekranu zgody OAuth w tym projekcie, kliknij SKONFIGURUJ EKRAN ZGODY.

      • Wybierz typ użytkownika i kliknij UTWÓRZ.

      • Wypełnij formularz wstępny. W razie potrzeby możesz ją później zmienić. Gdy skończysz, kliknij Zapisz.

    • Aby kontynuować, wróć do strony Dane logowania > UTWÓRZ DANE LOGOWANIA > Identyfikator klienta OAuth.

  3. Jako typ aplikacji wybierz Aplikacja komputerowa lub Aplikacja internetowa w zależności od konkretnego przypadku użycia. W tym przewodniku typ aplikacji to Aplikacja komputerowa.

  4. Wpisz nazwę aplikacji i kliknij Utwórz.

  5. Na stronie potwierdzenia skopiuj Twój identyfikator klienta i Twój tajny klucz klienta do schowka, aby później skonfigurować bibliotekę klienta. Pobierz też dane logowania w formacie JSON do pliku o nazwie credentials.json.

Włączanie interfejsu Google Ads API w projekcie

Aby włączyć interfejs Google Ads API w projekcie, wykonaj te czynności:

  1. Otwórz Bibliotekę interfejsów API w Konsoli interfejsów API Google. Jeśli pojawi się taka prośba, wybierz projekt lub utwórz nowy. W bibliotece interfejsów API wymienione są wszystkie dostępne interfejsy API, pogrupowane według rodziny usług i popularności.

  2. Jeśli nie widzisz interfejsu Google Ads API, użyj wyszukiwarki, aby go znaleźć.

  3. Wybierz interfejs Google Ads API i kliknij przycisk Włącz.