Dane logowania umożliwiające dostęp do serwerów OAuth2 Google są wymagane do uwierzytelniania i autoryzowania użytkowników Google Ads. Dane logowania to identyfikator aplikacji dla Google, co umożliwia generowanie tokenów OAuth do zarządzania użytkownikami Google Ads. Dostępem do danych logowania protokołu OAuth2 Google można zarządzać w Konsoli interfejsów API Google.
Obejrzyj ten film, aby poznać niektóre sprawdzone metody dotyczące projektów Cloud
Weryfikacja Google OAuth
Każda aplikacja Google Cloud używana do uzyskiwania danych logowania do zakresu interfejsu Google Ads API będzie musiała przejść weryfikację protokołu Google OAuth, aby uniknąć wyświetlania użytkownikom niezweryfikowanego ekranu interfejsu. W tym kontekście aplikacja jest definiowana jako unikalny identyfikator klienta OAuth 2.0 w Google Cloud.
Ta weryfikacja jest niezależna i uzupełnia wszelkie kontrole przeprowadzone w ramach procesu zatwierdzania tokena dewelopera. Jest ona wymagana, ponieważ zakres interfejsu Google Ads API ma zakres wrażliwy.
Weryfikacja Google jest bezpłatna, zazwyczaj trwa od 3 do 5 dni roboczych. Te zasady dotyczą wszystkich aplikacji.
Aby uniknąć przerw w działaniu usługi, zalecamy jak najszybsze przejście procesu weryfikacji Google OAuth przez Google OAuth.
Tworzenie projektu
Otwórz konsolę interfejsów API Google. Kliknij Utwórz projekt, wpisz nazwę i kliknij Utwórz.
Włączanie interfejsu Google Ads API w projekcie
Aby włączyć interfejs Google Ads API w swoim projekcie:
Otwórz Bibliotekę API w konsoli interfejsów API Google. Jeśli pojawi się taka prośba, wybierz projekt lub utwórz nowy. Zawiera ona wszystkie dostępne interfejsy API pogrupowane według rodziny usług i popularności.
Jeśli nie widzisz interfejsu Google Ads API, użyj wyszukiwarki, aby go znaleźć.
Wybierz kolejno interfejs Google Ads API i przycisk Włącz.
Wybierz typ użytkownika i stan publikacji
Po włączeniu interfejsu API określ Typ użytkownika i Stan publikacji projektu. W tabeli poniżej znajdziesz najważniejsze atrybuty i ograniczenia każdej kombinacji tych ustawień. Więcej informacji znajdziesz w dokumentacji Google Cloud Platform.
Typ użytkowników | Stan publikacji | Ograniczenia |
---|---|---|
Wewnętrzny | Testuję |
|
Zewnętrzny | Testuję |
|
Wewnętrzny | W wersji produkcyjnej |
|
Zewnętrzny | W wersji produkcyjnej |
|
Jeśli nie ukończysz weryfikacji Google OAuth, niezależnie od typu użytkownika lub stanu publikowania projektu:
Podczas procesu autoryzacji użytkownicy widzą niezweryfikowany ekran interfejsu.
Możesz autoryzować tylko 100 użytkowników.
Konfigurowanie ekranu zgody OAuth
Otwórz stronę Ekran zgody i w menu u góry wybierz swój projekt.
Wybierz Typ użytkownika i kliknij UTWÓRZ.
Wypełnij formularz ekranu zgody. W razie potrzeby możesz go później zmienić. Gdy skończysz, kliknij ZAPISZ I KONTYNUUJ.
Na następnej stronie kliknij DODAJ LUB USUŃ ZAKRES.
Przewiń w dół i w polu Ręcznie dodaj zakresy:
https://www.googleapis.com/auth/adwords
Kliknij DODAJ DO TABELI.
Dodaj inne zakresy, których będzie żądać Twój projekt, a następnie kliknij AKTUALIZUJ.
Kliknij ZAPISZ I KONTYNUUJ.
Jeśli nie planujesz od razu opublikować projektu, dodaj adresy e-mail wszystkich kont użytkowników, których będziesz używać do testowania, a potem kliknij ZAPISZ I KONTYNUUJ.
Przejrzyj stronę podsumowania i kliknij WRÓĆ DO PULPIT.
Po przetestowaniu aplikacji i procesie autoryzacji możesz wrócić do panelu i kliknąć OPUBLIKUJ APLIKACJĘ, aby zmienić stan publikowania z Testowanie na W wersji produkcyjnej.
Wybierz typ aplikacji
W interfejsie Google Ads API dostępne są 2 rodzaje aplikacji: komputery i aplikacje internetowe. Zapoznaj się z tą tabelą, aby określić, który typ będzie najbardziej odpowiedni dla aplikacji, którą chcesz utworzyć:
Wybierz ten typ aplikacji | Jeśli ... |
---|---|
Aplikacja komputerowa |
|
Aplikacja internetowa |
|
Więcej informacji znajdziesz w dokumentacji protokołu OAuth Google Identity Platform dotyczącej aplikacji komputerowych lub aplikacji internetowych.
Tworzenie identyfikatora klienta i tajnego klucza klienta
Po określeniu typu aplikacji wykonaj te instrukcje, aby wygenerować identyfikator klienta OAuth2 i tajny klucz klienta:
Otwórz stronę Dane logowania. Wybierz wcześniej utworzony projekt lub utwórz nowy.
Na ekranie Dane logowania kliknij UTWÓRZ DANE LOGOWANIA i wybierz Identyfikator klienta OAuth.
Jeśli nie masz jeszcze w tym projekcie skonfigurowanego ekranu zgody OAuth, przekierujemy Cię teraz do tego celu. Kliknij SKONFIGURUJ EKRAN ZGODY.
Wybierz typ użytkownika i kliknij UTWÓRZ.
Wypełnij początkowy formularz. W razie potrzeby możesz go później zmienić. Gdy skończysz, kliknij Zapisz.
Aby kontynuować, wróć do sekcji Dane logowania > UTWÓRZ DANE LOGOWANIA > Identyfikator klienta OAuth.
Jako typ aplikacji wybierz Aplikacja komputerowa lub Aplikacja internetowa w zależności od przypadku użycia.
Nazwij go i kliknij Utwórz.
W przypadku typu klienta Aplikacja internetowa dodaj co najmniej 1 autoryzowany identyfikator URI przekierowania.
Aby przeprowadzić testy lokalne, które są zgodne z konfiguracją domyślną w naszych przykładach z biblioteką klienta, użyj
http://127.0.0.1
.W przypadku klientów aplikacji komputerowych nadal będzie używane przekierowanie IP w pętli, ale identyfikator URI nie jest wyraźnie skonfigurowany w konsoli Cloud.
Na stronie potwierdzenia skopiuj wartości Your Client ID (Identyfikator klienta) i Your Client Secret (Tajny klucz klienta) do schowka. Będą one potrzebne podczas konfigurowania biblioteki klienta. Aby je pobrać, możesz też wrócić na stronę z danymi logowania później.