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

Aby uwierzytelniać i autoryzować użytkowników Google Ads, musisz mieć dane logowania do serwerów OAuth2 Google. Te dane uwierzytelniające identyfikują Twoją aplikację w Google, umożliwiając generowanie tokenów OAuth do zarządzania użytkownikami Google Ads. Dostępem do danych logowania OAuth2 Google zarządzasz w Konsoli interfejsów API Google.

Obejrzyj ten film, aby poznać sprawdzone metody dotyczące projektów w chmurze

Weryfikacja Google OAuth

Każda aplikacja Google Cloud używana do uzyskiwania danych logowania do zakresu interfejsu Google Ads API musi przejść weryfikację Google OAuth, aby użytkownicy nie widzieli niezatwierdzonego interfejsu użytkownika. W tym kontekście aplikacja jest definiowana jako unikalny identyfikator klienta OAuth 2.0 w Google Cloud.

Ta weryfikacja jest niezależna od wszelkich innych kontroli przeprowadzonych w ramach procesu zatwierdzania tokena programisty i jest wymagana, ponieważ zakres interfejsu Google Ads API jest zakresem wrażliwym.

Weryfikacja przez Google jest bezpłatna i zwykle trwa 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.

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

Korzystanie z interfejsu Google Ads API jest bezpłatne, ale obowiązuje limit dotyczący łącznej liczby projektów Cloud. Możesz też zarejestrować nowe konto Google, które obejmuje bezpłatną pulę projektów.

Włączanie interfejsu Google Ads API w projekcie

Aby włączyć interfejs Google Ads API w projekcie, wykonaj te czynności:

1. Otwórz Bibliotekę API w konsoli interfejsów API Google. Jeśli pojawi się monit, wybierz projekt lub utwórz nowy. Biblioteka interfejsów API zawiera listę wszystkich dostępnych interfejsów API, pogrupowanych według rodziny produktów i popularności.

2. Jeśli interfejs Google Ads API nie jest widoczny na liście, poszukaj go w sekcji wyszukiwania.

3. Wybierz interfejs Google Ads API, a potem kliknij przycisk Włącz.

Wybierz typ użytkownika i stan publikacji

Po włączeniu interfejsu API musisz określić typ użytkownika i stan publikacji projektu. W tabeli poniżej znajdziesz najważniejsze cechy i ograniczenia każdej kombinacji tych ustawień. Więcej informacji znajdziesz w dokumentacji Google Cloud Platform.

Typ użytkownika	Stan publikacji	Ograniczenia
Wewnętrzny	Testowanie	Dostępne tylko w przypadku projektów powiązanych z organizacją Google Cloud. Dostęp do aplikacji jest ograniczony do 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. Autoryzacje wygasają po 7 dniach od wyrażenia zgody.
Zewnętrzny	Testowanie	Dostępne we wszystkich projektach. Dostęp do aplikacji jest ograniczony do maksymalnie 100 użytkowników testowych wymienionych na ekranie zgody OAuth. Użytkownikami testowymi mogą być wszyscy użytkownicy mający konto Google. Upoważnienia wygasają po 7 dniach od wyrażenia zgody.
Wewnętrzny	W wersji produkcyjnej	Dostępne tylko w przypadku projektów powiązanych z organizacją Google Cloud. Umożliwia autoryzowanie dowolnego użytkownika w organizacji Google Cloud powiązanej z projektem.
Zewnętrzny	W wersji produkcyjnej	Dostępne we wszystkich projektach. Umożliwia autoryzowanie każdego użytkownika mającego konto Google.

Nieukończenie weryfikacji Google OAuth powoduje, niezależnie od typu użytkownika i stanu publikacji projektu:

• Podczas procesu autoryzacji użytkownicy widzą ekran niezweryfikowanego interfejsu użytkownika.

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

Konfigurowanie ekranu zgody OAuth

1. Otwórz stronę ekranu z prośbą o zgodę i w menu u góry strony wybierz swój projekt.

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

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

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

   • Przewiń w dół i w polu Ręczne dodawanie zakresów wpisz:

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

   • Kliknij DODAJ DO TABELI.

   • Dodaj inne zakresy, których potrzebuje Twój projekt, a potem kliknij Zaktualizuj.

   • Kliknij ZAPISZ I KONTYNUUJ.

5. Jeśli nie planujesz opublikowania projektu od razu, dodaj adres e-mail każdego konta użytkownika, którego będziesz używać do testowania, a potem kliknij ZAPISZ I KONTYNUUJ.

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

Gdy przetestujesz aplikację i proces autoryzacji, możesz wrócić do panelu sterowania i kliknąć PUBLISH APP (Opublikuj aplikację), aby zmienić stan publikacji z Testowanie na Wersja produkcyjna.

Wybierz typ aplikacji

W przypadku interfejsu Google Ads API dostępne są 2 typy aplikacji: na komputery i na urządzenia mobilne. Aby określić, który typ jest najbardziej odpowiedni dla aplikacji, którą chcesz utworzyć, zapoznaj się z tabelą poniżej:

Wybierz ten typ aplikacji	Jeśli
Aplikacja na komputer	Zarządzasz wszystkimi kontami Google Ads za pomocą jednego konta menedżera najwyższego poziomu. Jesteś nowym użytkownikiem lub chcesz szybko rozpocząć pracę z najprostszym ustawieniem. 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 przyznać aplikacji uprawnienia do dostępu do danych na swoim koncie Google Ads. Chcesz łatwo generować wiele danych logowania, aby zarządzać np. kontami innych firm. Twoja aplikacja wymaga adresów URL wywołań zwrotnych. Adresy URL wywołań zwrotnych nie są obsługiwane w procesie aplikacji na komputery.

Ważne: nawet jeśli aplikacja ma działać na serwerze, nadal możesz wybrać proces uruchamiania aplikacji na komputerze. Różnica polega na tym, czy autoryzacja OAuth jest przeprowadzana lokalnie, czy zdalnie. Proces na komputerze wymaga autoryzacji na komputerze lokalnym, natomiast proces w przeglądarce umożliwia autoryzację na serwerze autoryzacji Google.

Więcej informacji znajdziesz w dokumentacji platformy Google Identity OAuth dotyczącej aplikacji na komputer lub aplikacji internetowych.

Tworzenie identyfikatora i tajnego klucza klienta

Po określeniu typu aplikacji wykonaj instrukcje poniżej, aby wygenerować identyfikator klienta OAuth2 i tajny klucz klienta:

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

2. Na ekranie Dane logowania kliknij UTWÓRZ DANE LOGOWANIA, a następnie wybierz Identyfikator klienta OAuth.

   1. Jeśli wcześniej nie skonfigurowano ekranu zgody OAuth w przypadku tego projektu, zostaniesz poproszony o jego skonfigurowanie. Kliknij SKONFIGURUJ EKRAN ZGODY.

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

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

   2. Aby kontynuować, wróć do sekcji Dane logowania > Utwórz dane logowania > Identyfikator klienta OAuth.

3. W zależności od przypadku użycia wybierz jako typ aplikacji Aplikacja na komputer lub Aplikacja internetowa.

4. Nadaj mu nazwę i kliknij Utwórz.

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

   Aby przeprowadzić testowanie lokalne zgodne z domyślną konfiguracją w naszych przykładach bibliotek klienta, użyj http://127.0.0.1.

   Uwaga: możesz dodać numer portu do adresu URI przekierowania, aby ograniczyć korzystanie z określonego portu. Jeśli port nie jest ustawiony, klient OAuth może przekierować na dowolny port.

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

6. Na stronie potwierdzenia skopiuj identyfikator klienta i tajny klucz klienta do schowka, ponieważ będą Ci potrzebne do skonfigurowania biblioteki klienta. Możesz też później wrócić na stronę danych logowania, aby wyświetlić te informacje.