Czynności, które należy wykonać, aby utworzyć i skonfigurować projekt w Konsoli interfejsów API Google, zależą od typu scenariusza autoryzacji OAuth 2.0, który tworzysz w aplikacji. Wybierz scenariusz autoryzacji, który chcesz utworzyć. Ten przewodnik zostanie dostosowany do Twojego wyboru.
Aby utworzyć dane logowania OAuth 2.0 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. Te dane logowania umożliwiają generowanie tokenów OAuth, które będą używane w wywołaniach interfejsu API.
Chociaż możesz używać jednego tokena programisty w wielu projektach, każdy projekt może używać tylko jednego tokena programisty.
Wybieranie lub tworzenie projektu w Konsoli interfejsów API Google
Postępuj zgodnie z instrukcjami, aby utworzyć projekt. Włączanie płatności za projekt jest opcjonalne. Jeśli masz włączone płatności, wybierz konto rozliczeniowe dla nowego projektu. Korzystanie z interfejsu Google Ads API jest bezpłatne, ale istnieje limit łącznej liczby projektów w Google Cloud.
Włączanie interfejsu Google Ads API w projekcie
Aby włączyć interfejs Google Ads API w projekcie, wykonaj te czynności:
Otwórz Bibliotekę interfejsów API w Konsoli interfejsów API Google. Jeśli pojawi się monit, wybierz projekt lub utwórz nowy. W bibliotece interfejsów API znajdziesz wszystkie dostępne interfejsy API pogrupowane według rodziny usług i popularności.
Jeśli interfejsu Google Ads API nie ma na liście, znajdź go za pomocą wyszukiwarki.
Wybierz interfejs Google Ads API, a następnie kliknij przycisk Włącz.
Włączanie interfejsu Google Ads API
Konfigurowanie ekranu zgody OAuth
Gdy stosujesz autoryzację z użyciem OAuth 2.0, Google wyświetla użytkownikowi ekran zgody zawierający podsumowanie projektu, stosowanych w nim zasad oraz żądanych zakresów dostępu. Skonfigurowanie ekranu zgody OAuth aplikacji określa, co jest wyświetlane użytkownikom i osobom sprawdzającym aplikację, oraz rejestruje aplikację, aby można ją było później opublikować.
Postępuj zgodnie z instrukcjami, aby skonfigurować ekran zgody OAuth dla aplikacji i dodać https://www.googleapis.com/auth/adwords jako zakres OAuth.
Ważne uwagi dotyczące typu użytkownika i stanu publikacji
Podczas konfigurowania ekranu zgody OAuth zwróć uwagę na ustawienia Typ użytkownika i Stan publikacji.
- Typ użytkownika:określa, czy aplikacja jest ograniczona do użytkowników w Twojej organizacji („Wewnętrzny”), czy jest dostępna dla wszystkich użytkowników Google („Zewnętrzny”). Pamiętaj, że opcja „Wewnętrzny” jest dostępna tylko wtedy, gdy Twój projekt należy do organizacji Google Workspace.
- Stan publikowania: określa, czy aplikacja jest w trybie „Testowanie” (ograniczonym do określonych użytkowników testowych, których dodasz) czy „W wersji produkcyjnej” (dostępnym dla odbiorców określonych przez typ użytkownika, co może wymagać weryfikacji aplikacji przez Google).
Aby dokonać najlepszego wyboru w przypadku swojej aplikacji, zapoznaj się ze szczegółowymi wyjaśnieniami i konsekwencjami tych ustawień w oficjalnej dokumentacji pomocy Google Cloud:
Zrozumienie tych ustawień jest kluczowe, aby mieć pewność, że Twoja aplikacja jest dostępna dla docelowych użytkowników.
Tworzenie identyfikatora klienta i tajnego klucza klienta
Możesz pominąć ten krok, jeśli używasz istniejącego projektu w Konsoli interfejsów API Google, który ma już wygenerowany identyfikator klienta i klucz tajny klienta. W przeciwnym razie utwórz identyfikator klienta i tajny klucz klienta, postępując zgodnie z instrukcjami. Jako typ aplikacji możesz wybrać Aplikacja na komputer lub Aplikacja internetowa. Po utworzeniu klienta OAuth 2.0 pobierz plik JSON klienta. W tym celu najpierw kliknij ikonę Pobierz klienta OAuth, a potem przycisk POBIERZ PLIK JSON na następnym ekranie.