Sposób tworzenia i konfigurowania projektu w Konsoli interfejsów API Google zależy od scenariusza autoryzacji OAuth 2.0 w Twojej aplikacji. Wybierz scenariusz autoryzacji, aby dostosować ten przewodnik.
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.
Te dane logowania uwierzytelniają i autoryzują Twoją aplikację lub użytkowników Google Ads na serwerach Google oraz umożliwiają generowanie tokenów OAuth, które można wykorzystywać w wywołaniach interfejsu API.
Wybieranie lub tworzenie projektu w Konsoli interfejsów API Google
Aby skonfigurować nowy projekt, postępuj zgodnie z instrukcjami tworzenia projektu w Konsoli interfejsów API Google. 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 projekty w Cloud podlegają standardowym limitom przydziału.
Włączanie interfejsu Google Ads API w projekcie
Aby włączyć interfejs Google Ads API w projekcie:
Otwórz Bibliotekę interfejsów API w Konsoli interfejsów API Google. Jeśli pojawi się prośba, wybierz projekt lub utwórz nowy. Biblioteka interfejsów API zawiera listę wszystkich dostępnych interfejsów API pogrupowanych według rodziny usług i popularności.
Jeśli nie widzisz na liście interfejsu Google Ads API, użyj wyszukiwarki.
Wybierz interfejs Google Ads API, a następnie kliknij przycisk Włącz.
Włączanie interfejsu Google Ads API
Prośba o dostęp do interfejsu API
Następnie otwórz stronę z omówieniem interfejsu Google Ads API, aby sprawdzić swój obecny poziom dostępu do interfejsu API. Jeśli Twój obecny poziom dostępu do interfejsu API to Test, rozwiń sekcję Uaktualnij poziom dostępu. Postępuj zgodnie z instrukcjami, aby poprosić o dostęp na poziomie Explorer.
Gdy wypełnisz formularz zgłoszeniowy, Google automatycznie sprawdzi Twoją prośbę i w większości przypadków przyzna Ci dostęp do wersji Explorer.
Konfigurowanie ekranu zgody OAuth
Gdy do autoryzacji używasz OAuth 2.0, Google wyświetla użytkownikowi ekran zgody zawierający podsumowanie projektu, jego zasad oraz żądanych zakresów autoryzacji 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ć.
Skonfiguruj ekran zgody OAuth dla aplikacji i dodaj 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 każdego użytkownika Google (Zewnętrzny). Wewnętrzny jest dostępny tylko wtedy, gdy Twój projekt należy do organizacji Google Workspace.
- Stan publikacji: określa, czy aplikacja jest w trybie Testowanie (dostępna tylko dla określonych użytkowników testowych, których dodasz) czy Wersja produkcyjna (dostępna 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 aplikacja jest dostępna dla docelowych użytkowników.
Tworzenie identyfikatora klienta i tajnego klucza klienta
Utwórz identyfikator klienta i klucz tajny klienta. Jako typ aplikacji możesz wybrać Aplikacja na komputer lub Aplikacja internetowa. Po utworzeniu klienta OAuth 2.0 pobierz plik JSON klienta, klikając przycisk Pobierz JSON w oknie potwierdzenia.