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.
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łą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 obowiązuje limit łącznej liczby projektów w 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ę 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 interfejs Google Ads API nie jest widoczny na liście, użyj wyszukiwarki.
Wybierz interfejs Google Ads API, a następnie kliknij przycisk Włącz.
Włącz interfejs 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 recenzentom aplikacji, 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 jest 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 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 aplikacja była dostępna dla docelowych użytkowników.
Tworzenie identyfikatora 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.