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 tworzysz. Ten przewodnik zostanie dostosowany do Twojego wyboru.
Aby utworzyć dane logowania OAuth 2.0 i włączyć interfejs Google Ads API w aplikacji, potrzebujesz projektu 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.
Wybieranie lub tworzenie projektu w Konsoli interfejsów API Google
Aby utworzyć projekt, postępuj zgodnie z instrukcjami. Włączenie rozliczeń w projekcie jest opcjonalne. Jeśli masz włączone rozliczenia, wybierz konto rozliczeniowe dla nowego projektu. Korzystanie z interfejsu Google Ads API jest bezpłatne, ale obowiązuje limit łącznej liczby projektów w chmurze.
Włączanie interfejsu Google Ads API w projekcie
Aby włączyć interfejs Google Ads API w projekcie, wykonaj te czynności:
Otwórz Bibliotekę API w Konsoli interfejsów API Google. Jeśli pojawi się prośba, wybierz projekt lub utwórz nowy. Biblioteka API zawiera listę wszystkich dostępnych interfejsów API pogrupowanych według rodziny produktów i popularności.
Jeśli interfejsu Google Ads API nie widać na liście, wyszukaj go.
Wybierz interfejs Google Ads API, a następnie kliknij przycisk Włącz.
Włączanie interfejsu Google Ads API
Składanie wniosku o dostęp do interfejsu API
Następnie otwórz stronę Omówienie interfejsu Google Ads API. Wyświetla ona Twój bieżący poziom dostępu do interfejsu API. Jeśli Twój bieżący poziom dostępu do interfejsu API to Test Poziom dostępu do konta, rozwiń sekcję Złóż wniosek o następny poziom dostępu. Postępuj zgodnie z instrukcjami, aby złożyć wniosek o poziom dostępu eksploratora.
Po przesłaniu zgłoszenia Google automatycznie je sprawdzi i w większości przypadków przyzna Ci poziom dostępu eksploratora.
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 informacje dotyczące typu użytkownika i stanu publikowania
Podczas konfigurowania ekranu zgody OAuth zwróć uwagę na ustawienia Typ użytkownika i Stan publikowania.
- Typ użytkownika: określa, czy aplikacja jest ograniczona do użytkowników w Twojej organizacji („Wewnętrzna”), czy dostępna dla wszystkich użytkowników Google („Zewnętrzna”). Pamiętaj, że opcja „Wewnętrzna” jest dostępna tylko wtedy, gdy Twój projekt jest częścią organizacji Google Workspace.
- Stan publikowania: określa, czy aplikacja jest w trybie „Testowanie” (ograniczona do określonych użytkowników testowych, których dodasz), czy „W wersji produkcyjnej” (dostępna dla odbiorców określonych przez typ użytkownika, co może wymagać weryfikacji aplikacji przez Google).
Aby wybrać najlepsze ustawienia dla 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 aplikacja była 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 tajny klucz 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. Najpierw kliknij ikonę Pobierz klienta OAuth, a potem przycisk POBIERZ JSON na następnym ekranie.