Skonfiguruj projekt Konsoli interfejsów API firmy Google dla interfejsu Google Ads API

Dane logowania w celu uzyskania dostępu do serwerów OAuth2 Google są wymagane do uwierzytelniania i autoryzacji użytkowników Google Ads. Te dane logowania identyfikują Twoją aplikację w Google, co umożliwia generowanie tokenów OAuth do zarządzania użytkownikami Google Ads. Dostępem do danych logowania Google OAuth2 możesz zarządzać w konsoli Google API.

Weryfikacja Google OAuth

Każda aplikacja Google Cloud używana do uzyskiwania danych uwierzytelniających w zakresie interfejsu Google Ads API musi przejść weryfikację Google OAuth, aby uniknąć niezweryfikowanego ekranu interfejsu dla użytkowników. W tym kontekście aplikacja jest definiowana jako unikalny identyfikator klienta OAuth 2.0 w Google Cloud.

Ta weryfikacja jest niezależna i obejmuje wszystkie kontrole przeprowadzane w ramach procesu zatwierdzania tokena dewelopera oraz jest wymagana, ponieważ zakres interfejsu Google Ads API jest zakresem wrażliwym.

Weryfikacja Google jest bezpłatna, co zazwyczaj trwa od 3 do 5 dni roboczych. Ta zasada dotyczy wszystkich aplikacji.

Aby uniknąć przerw w działaniu usług, zalecamy jak najszybsze przejście procesu weryfikacji Google OAuth.

Utwórz projekt

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:

1. 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 wszystkie dostępne interfejsy API, pogrupowane według rodziny usług i popularności.

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

3. Wybierz interfejs Google Ads API i kliknij przycisk Włącz.

Wybierz typ użytkownika i stan publikacji

Po włączeniu interfejsu API musisz określić Typ użytkownika swojego projektu oraz Stan publikacji. W tabeli poniżej znajdziesz kilka najważniejszych atrybutów i ograniczeń ich kombinacji. Więcej informacji znajdziesz w dokumentacji Google Cloud Platform.

Typ użytkowników	Stan publikacji	Ograniczenia
Wewnętrzny	Testowanie	Dostępne tylko w projektach powiązanych z organizacją w Google Cloud. Możesz mieć maksymalnie 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. Upoważnienia wygasają po 7 dniach od momentu wyrażenia zgody.
Zewnętrzne	Testowanie	Dostępne dla wszystkich projektów. Możesz mieć maksymalnie 100 użytkowników testowych wymienionych na ekranie zgody OAuth. Użytkownikami testowymi mogą być wszyscy użytkownicy mający konta Google. Upoważnienia wygasają po 7 dniach od momentu wyrażenia zgody.
Wewnętrzny	W wersji produkcyjnej	Dostępne tylko w projektach powiązanych z organizacją w Google Cloud. Umożliwia autoryzację wszystkich użytkowników w organizacji Google Cloud powiązanej z projektem.
Zewnętrzne	W wersji produkcyjnej	Dostępne dla wszystkich projektów. Zezwala na autoryzację dowolnego użytkownika mającego konto Google.

Niezależnie od weryfikacji Google OAuth niezależnie od typu użytkownika lub stanu publikacji projektu:

• Podczas autoryzacji użytkownicy widzą niezweryfikowany ekran interfejsu.

• Możesz autoryzować maksymalnie 100 użytkowników.

Skonfiguruj ekran zgody OAuth

1. Otwórz stronę Ekran ze zgodą i wybierz projekt w menu u góry strony.

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

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

4. Na następnej stronie kliknij DODAJ LUB USUŃ ZAKRESY.

   • Przewiń w dół i w polu zakresy ręczne wpisz:

     https://www.googleapis.com/auth/adwords
     

   • Kliknij DODAJ DO tabel.

   • Dodaj inne zakresy, których żąda Twój projekt, a potem kliknij AKTUALIZUJ.

   • Kliknij ZAPISZ I KONTYNUUJ.

5. Jeśli nie planujesz opublikować projektu natychmiast, dodaj adres e-mail każdego konta użytkownika, którego chcesz używać do testowania, a następnie kliknij ZAPISZ I KONTYNUUJ.

6. Przejrzyj stronę podsumowania i kliknij POWRÓT DO PANELU.

Po przetestowaniu aplikacji i zakończeniu procesu autoryzacji możesz wrócić do panelu i kliknąć OPUBLIKUJ APLIKACJĘ, aby zmienić Stan publikacji z Testowanie na W wersji produkcyjnej.

Wybierz typ aplikacji

W interfejsie Google Ads API dostępne są 2 rodzaje aplikacji: na komputery i internet. W tabeli poniżej znajdziesz informacje o tym, który typ aplikacji jest najlepszy dla Twojej aplikacji:

Wybierz ten typ aplikacji	Jeśli ...
Aplikacja komputerowa	Wszystkimi swoimi kontami Google Ads zarządzasz za pomocą jednego konta menedżera najwyższego poziomu. Korzystasz z usługi po raz pierwszy lub chcesz szybko zacząć z niej korzystać. Aplikacja będzie uwierzytelniać użytkowników Google tylko na jednym komputerze.
Aplikacja internetowa	Chcesz się uwierzytelnić jako użytkownik, który może przyznawać aplikacji uprawnienia dostępu do danych konta Google Ads. Chcesz łatwo wygenerować wiele danych uwierzytelniających, aby na przykład zarządzać kontami innych firm. Twoja aplikacja wymaga adresów URL wywołania zwrotnego. URL-e wywołania zwrotnego nie są obsługiwane w aplikacji komputerowej.

Więcej informacji znajdziesz w dokumentacji protokołu OAuth na platformie Google Identity Platform dotyczącego aplikacji komputerowych i aplikacji internetowych.

Utwórz identyfikator klienta i tajny klucz klienta

Po określeniu typu aplikacji wykonaj poniższe instrukcje, aby wygenerować identyfikator klienta OAuth 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 KWALIFIKACJE, a następnie wybierz Identyfikator klienta OAuth.

   1. Jeśli w tym projekcie nie został jeszcze skonfigurowany ekran zgody OAuth, przekierujemy Cię do niego teraz. Kliknij SKONFIGURUJ EKRAN UZGODNIENIA.

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

      2. Wypełnij wstępny formularz. W razie potrzeby możesz je później edytować. Gdy skończysz, kliknij Zapisz.

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

3. Jako typ aplikacji wybierz Aplikacja komputerowa lub Aplikacja internetowa.

4. Nazwij go i kliknij Utwórz.

5. Jeśli typ klienta to Aplikacja internetowa, dodaj co najmniej 1 autoryzowany identyfikator URI przekierowania.

   W przypadku testów lokalnych, które są zgodne z domyślną konfiguracją w naszych przykładach bibliotek klienta, użyj http://127.0.0.1.

   W przypadku klientów aplikacji komputerowych nadal będziesz używać pętli adresów IP przekierowania, ale identyfikator URI nie będzie jawnie skonfigurowany w konsoli Google Cloud.

6. Na stronie potwierdzenia skopiuj identyfikator klienta i tajny klucz klienta do schowka, ponieważ będą one potrzebne podczas konfigurowania biblioteki klienta. Możesz też wrócić później na stronę danych logowania, aby sprawdzić szczegóły.