Sposób tworzenia i konfigurowania projektu w Konsoli interfejsów API Google zależy od scenariusza autoryzacji OAuth 2.0 aplikacji. Wybierz scenariusz autoryzacji, aby dostosować ten przewodnik.
Aby utworzyć dane logowania OAuth 2.0 i włączyć interfejs Google Ads API w aplikacji, potrzebujesz projektu w Konsoli interfejsów API Google.
Te dane uwierzytelniają i autoryzują Twoją aplikację lub użytkowników Google Ads na serwerach Google oraz 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 skonfigurować nowy projekt, postępuj zgodnie z instrukcjami tworzenia projektu w Konsoli interfejsów API Google. Włączenie płatności w projekcie 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 chmurze 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ę taka 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, znajdź go za pomocą wyszukiwarki.
Wybierz interfejs Google Ads API, a następnie kliknij przycisk Włącz.
Włączanie interfejsu Google Ads API
Przesyłanie prośby o dostęp do interfejsu API
Następnie wejdź na stronę z omówieniem interfejsu Google Ads API, aby sprawdzić swój bieżący poziom dostępu do interfejsu API. Jeśli Twój obecny poziom dostępu do interfejsu API to Test, rozwiń sekcję Przejdź na wyższy poziom dostępu. Postępuj zgodnie z instrukcjami, aby poprosić o poziom dostępu Eksplorator.
Gdy wypełnisz wniosek, Google automatycznie go sprawdzi i w większości przypadków przyzna Ci dostęp do wersji Explorer.
Konfigurowanie ekranu zgody OAuth
Gdy używasz protokołu OAuth 2.0 do autoryzacji, Google wyświetla użytkownikowi ekran zgody zawierający podsumowanie projektu, jego zasad i żądanych zakresów dostępu. Skonfigurowanie ekranu zgody OAuth aplikacji określa, co jest wyświetlane użytkownikom i recenzentom aplikacji, oraz rejestruje aplikację, aby można było ją później opublikować.
Skonfiguruj ekran zgody OAuth dla aplikacji i dodaj https://www.googleapis.com/auth/adwords jako zakres OAuth.
Ważne informacje 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 dostępna dla wszystkich użytkowników Google (Zewnętrzny). Opcja Wewnętrzna jest dostępna tylko wtedy, gdy projekt należy do organizacji Google Workspace.
- Stan publikacji: określa, czy aplikacja jest w trybie Testowanie (ograniczonym do określonych dodanych przez Ciebie użytkowników testowych) czy W produkcji (dostępnym dla odbiorców określonych przez Typ użytkownika, co może wymagać weryfikacji aplikacji przez Google).
Aby dokonać najlepszych wyborów 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 zapewnić dostępność aplikacji dla docelowych użytkowników.
Tworzenie identyfikatora klienta i tajnego klucza klienta
Utwórz identyfikator klienta i tajny klucz klienta. Jako typ aplikacji możesz wybrać Aplikacja komputerowa lub Aplikacja internetowa. Po utworzeniu klienta OAuth 2.0 pobierz jego plik JSON, klikając przycisk Pobierz JSON w oknie potwierdzenia.