Konfigurowanie projektu Konsoli interfejsów API firmy Google pod kątem interfejsu Google Ads API

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.

Ważne: jeśli masz włączone płatności (na przykład Google Cloud), musisz wybrać konto rozliczeniowe dla nowego projektu.

Korzystanie z interfejsu Google Ads API jest bezpłatne, ale obowiązuje limit łącznej liczby projektów Cloud. Możesz też założyć nowe konto Google, które obejmuje bezpłatny limit projektów.

Włączanie interfejsu Google Ads API w projekcie

Aby włączyć interfejs Google Ads API w swoim projekcie:

1. 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.

2. Jeśli nie widzisz interfejsu Google Ads API, użyj wyszukiwarki, aby go znaleźć.

3. 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ę	Dostępne tylko w przypadku projektów powiązanych z organizacją Google Cloud. Ograniczenie do 100 użytkowników testowych wymienionych na ekranie zgody OAuth. Użytkownicy testowi muszą być użytkownikami wewnętrznymi w organizacji Google Cloud powiązanej z projektem. Autoryzacje wygasają po 7 dniach od momentu uzyskania zgody.
Zewnętrzny	Testuję	Dostępne dla wszystkich projektów. Ograniczenie do 100 użytkowników testowych wymienionych na ekranie zgody OAuth. Użytkownikiem testowym może być dowolny użytkownik mający konto Google. Autoryzacje wygasają po 7 dniach od momentu uzyskania zgody.
Wewnętrzny	W wersji produkcyjnej	Dostępne tylko w przypadku projektów powiązanych z organizacją Google Cloud. Umożliwia autoryzację dowolnego użytkownika w organizacji Google Cloud powiązanej z projektem.
Zewnętrzny	W wersji produkcyjnej	Dostępne dla wszystkich projektów. Umożliwia autoryzację każdego użytkownika z kontem Google.

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

1. Otwórz stronę Ekran zgody i w menu u góry wybierz swój projekt.

2. Wybierz Typ użytkownika i kliknij UTWÓRZ.

3. Wypełnij formularz ekranu zgody. W razie potrzeby możesz go później zmienić. Gdy skończysz, kliknij ZAPISZ I KONTYNUUJ.

4. 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.

5. 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.

6. 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	Zarządzasz wszystkimi swoimi kontami Google Ads za pomocą jednego konta menedżera najwyższego poziomu. Jesteś nowym użytkownikiem lub chcesz szybko rozpocząć najprostszą konfigurację. Twoja aplikacja będzie uwierzytelniać użytkowników Google tylko z jednego komputera.
Aplikacja internetowa	Chcesz uwierzytelnić się jako użytkownik, który może przyznawać Twojej aplikacji uprawnienia dostępu do danych ze swojego konta Google Ads. Chcesz łatwo wygenerować wiele danych uwierzytelniających, np. do zarządzania kontami w usługach innych firm. Twoja aplikacja wymaga adresów URL wywołań zwrotnych. Adresy URL wywołań zwrotnych nie są obsługiwane w przepływie aplikacji komputerowej.

Ważne: nawet wtedy, gdy tworzysz aplikację, która ma działać na serwerze, możesz wybrać przepływ procesu w aplikacji komputerowej. Różnica polega na tym, czy autoryzacja OAuth jest przeprowadzana lokalnie, czy zdalnie. Proces dla wersji komputerowej wymaga przeprowadzenia autoryzacji na komputerze lokalnym, natomiast przepływ internetowy umożliwia przeprowadzenie autoryzacji na serwerze autoryzacji Google.

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:

1. Otwórz stronę Dane logowania. Wybierz wcześniej utworzony projekt lub utwórz nowy.

2. Na ekranie Dane logowania kliknij UTWÓRZ DANE LOGOWANIA i wybierz Identyfikator klienta OAuth.

   1. Jeśli nie masz jeszcze w tym projekcie skonfigurowanego ekranu zgody OAuth, przekierujemy Cię teraz do tego celu. Kliknij SKONFIGURUJ EKRAN ZGODY.

      1. Wybierz typ użytkownika i kliknij UTWÓRZ.

      2. Wypełnij początkowy formularz. W razie potrzeby możesz go później zmienić. Gdy skończysz, kliknij Zapisz.

   2. Aby kontynuować, wróć do sekcji Dane logowania > UTWÓRZ DANE LOGOWANIA > Identyfikator klienta OAuth.

3. Jako typ aplikacji wybierz Aplikacja komputerowa lub Aplikacja internetowa w zależności od przypadku użycia.

4. Nazwij go i kliknij Utwórz.

5. 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.

   Uwaga: możesz dodać numer portu do identyfikatora URI przekierowania, aby ograniczyć użycie do określonego portu. Jeśli port nie jest ustawiony, klient OAuth może przekierowywać użytkowników do dowolnego portu.

   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.

6. 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.