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

Dane logowania do serwerów OAuth2 Google są wymagane, aby można było uwierzytelniać i autoryzować użytkowników Google Ads. Te dane logowania pozwalają zidentyfikować aplikację do Google, co umożliwia generowanie tokenów OAuth do zarządzania Google Ads użytkowników. Dostęp do danych logowania Google OAuth2 jest zarządzany z Konsola interfejsów API Google.

Weryfikacja Google OAuth

Każda aplikacja Google Cloud używana do uzyskiwania danych logowania na potrzeby interfejsu Google Ads API musi mieć przejść Google OAuth weryfikacji, aby uniknąć niezweryfikowany ekran UI użytkowników. W tym kontekście aplikacja jest definiowana jako unikalny identyfikator klienta OAuth 2.0. w Google Cloud.

Weryfikacja jest niezależna i stanowi uzupełnienie wszelkich weryfikacji przeprowadzonych jako stanowią część procesu zatwierdzania tokenów programisty, i jest wymagany, ponieważ zakres interfejsu Google Ads API ma wrażliwy charakter zakres.

Weryfikacja Google jest bezpłatna, zwykle trwa to do 3 5 dni roboczych. Te zasady dotyczą wszystkich aplikacji.

Zalecamy, aby wszystkie aplikacje jak najszybciej przeszły proces weryfikacji Google OAuth. aby uniknąć przerw w działalności.

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ę API w konsoli interfejsów API Google. Jeśli pojawi się taka prośba, wybierz lub utwórz nowy projekt. W bibliotece interfejsów API wymienione są 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 projektu Stan publikacji. W poniższej tabeli przedstawiamy niektóre kluczowe atrybuty ograniczeń poszczególnych kombinacji tych ustawień. Więcej informacji: Google Cloud Platform dokumentacji.

Typ użytkownika	Stan publikacji	Ograniczenia
Wewnętrzny	Testowanie	Ta opcja jest dostępna tylko w przypadku projektów powiązanych z Google Cloud. Uporządkowanie materiałów. ograniczona do 100 użytkowników testowych wymienionych w zgodzie na używanie protokołu OAuth, ekranu. Użytkownicy testowi muszą być użytkownikami wewnętrznymi w Google Cloud Organizacja powiązana z projektem. Autoryzacje wygasają po 7 dniach od momentu uzyskania zgody.
Zewnętrzny	Testowanie	Dostępne dla wszystkich projektów. ograniczona do 100 użytkowników testowych wymienionych w zgodzie na używanie protokołu OAuth, ekranu. 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	Ta opcja jest dostępna tylko w przypadku projektów powiązanych z Google Cloud. Uporządkowanie materiałów. Umożliwia autoryzację dowolnego użytkownika w organizacji Google Cloud powiązane z projektem.
Zewnętrzny	W wersji produkcyjnej	Dostępne dla wszystkich projektów. Umożliwia autoryzację każdego użytkownika z kontem Google.

Nieukończenie procesu Google OAuth weryfikacji daje taki efekt, niezależnie od Typu użytkownika czy Publikowanie stan projektu:

• Podczas procesu autoryzacji użytkownicy widzą niezweryfikowany interfejs użytkownika ekranu.

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

Konfigurowanie ekranu zgody OAuth

1. Otwórz aplikację Strona Ekran zgody, i wybierz swój projekt z 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 go później zmienić. Kliknij Gdy skończysz, kliknij ZAPISZ I KONTYNUUJ.

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

   • Przewiń w dół i wpisz następujące dane w polu Dodaj ręcznie: 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 adres e-mail każdego konta użytkownika, które chcesz wykorzystać do testowania, a następnie kliknij ZAPISZ I DALEJ.

6. Przejrzyj stronę podsumowania i kliknij WRÓĆ DO PULPIT.

Po przetestowaniu aplikacji i przeprowadzeniu procesu autoryzacji możesz wróć do panelu i kliknij OPUBLIKUJ APLIKACJĘ, aby zmienić wartość w polu Publikowanie stan 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 w tej tabeli możesz określić, który typ będzie najbardziej odpowiedni dla Twojej aplikacji do stworzenia:

Wybierz ten typ aplikacji	Jeśli ...
Aplikacja komputerowa	Zarządzasz wszystkimi swoimi kontami Google Ads za pomocą jednego najwyższego poziomu. konto menedżera. Jesteś nowym użytkownikiem lub chcesz szybko rozpocząć pracę w najprostszy sposób konfiguracji. Twoja aplikacja będzie uwierzytelniać użytkowników Google tylko z jednego komputera.
Aplikacja internetowa	Chcesz się uwierzytelnić jako użytkownik, który może przyznawać uprawnienia aplikacji uzyskać dostęp do danych z konta Google Ads. Chcesz łatwo wygenerować wiele danych uwierzytelniających, aby zarządzać np. w przypadku kont w usługach innych firm. Aplikacja wymaga adresów URL wywołań zwrotnych. Adresy URL wywołań zwrotnych nie są obsługiwane w aplikacji komputerowej.

Więcej informacji znajdziesz w dokumentacji protokołu OAuth Google Identity Platform dla aplikacji komputerowych lub aplikacji internetowych.

Tworzenie identyfikatora klienta i tajnego klucza klienta

Po określeniu typu aplikacji postępuj zgodnie z poniższymi instrukcjami, aby wygenerować identyfikator klienta i tajny klucz klienta OAuth2:

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, a następnie wybierz OAuth Client ID.

   1. Jeśli w tym projekcie nie masz skonfigurowanego ekranu zgody OAuth musisz zrobić to teraz. 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ć. Kliknij Gdy skończysz, Zapisz.

   2. Wróć do sekcji Dane logowania > UTWÓRZ DANE LOGOWANIA > Identyfikator klienta OAuth aby kontynuować.

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. Jeśli używasz typu klienta Aplikacja internetowa, dodaj co najmniej jedną autoryzowaną identyfikator URI przekierowania.

   Do testów lokalnych zgodnych z domyślną konfiguracją w z przykładami w bibliotece klienta, należy użyć http://127.0.0.1.

   W przypadku klientów aplikacji komputerowych musisz użyć parametru przekierowanie IP w pętli, ale identyfikator URI nie jest wyraźnie skonfigurowany w konsoli Google Cloud.

6. Na stronie potwierdzenia skopiuj Twój identyfikator klienta i Twój tajny klucz klienta. do schowka, ponieważ będą potrzebne podczas konfigurowania klienta. bibliotece. Możesz też wrócić na stronę z danymi logowania później, aby je pobrać .