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

Aby uwierzytelnić i autoryzować użytkowników Google Ads, wymagane są dane logowania do uzyskiwania dostępu do serwerów OAuth2 Google. Te dane logowania identyfikują Twoją aplikację w Google i umożliwiają generowanie tokenów OAuth do zarządzania użytkownikami Google Ads. Dostępem do danych uwierzytelniających Google OAuth2 zarządza się w Konsoli interfejsów API Google.

Ostrzeżenie W tym kontekście aplikacja jest definiowana jako unikalny identyfikator klienta OAuth 2.0 w Google Cloud. Ta weryfikacja jest niezależna od wszelkich kontroli przeprowadzanych w ramach procesu zatwierdzania tokena dewelopera.

Weryfikacja Google nie wiąże się z żadnymi opłatami, która zwykle trwa od 3 do 5 dni roboczych. Zasady te dotyczą wszystkich aplikacji.

Zalecamy jak najszybsze przejście procesu weryfikacji Google OAuth, aby uniknąć przerw w działaniu firmy.

Obejrzyj ten film, aby poznać sprawdzone metody związane z projektem Cloud

Tworzenie projektu

Otwórz konsolę interfejsów API Google. Kliknij Utwórz projekt, wpisz nazwę i kliknij Utwórz.

Uwaga: jeśli masz włączone płatności (na przykład Google Cloud), musisz wybrać konto rozliczeniowe do nowego projektu. Za korzystanie z interfejsu Google Ads API nie są pobierane żadne opłaty, jednak całkowita liczba projektów Cloud jest ograniczona. Możesz też zarejestrować nowe konto Google, które obejmuje bezpłatny limit projektu.

Włącz interfejs Google Ads API w swoim 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. W bibliotece API znajdziesz wszystkie dostępne interfejsy API pogrupowane według rodziny usług i popularności.

2. Za pomocą funkcji wyszukiwania znajdź interfejs Google Ads API, jeśli nie jest on widoczny na liście.

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

Wybierz typ aplikacji

W interfejsie Google Ads API są dostępne 2 rodzaje aplikacji:

• Aplikacje komputerowe
• Aplikacje internetowe

W tabeli poniżej możesz określić, który typ jest najbardziej odpowiedni dla aplikacji, którą chcesz stworzyć:

Wybierz typ aplikacji	Jeśli ...
Aplikacja komputerowa	Wszystkimi swoimi kontami Google Ads zarządzasz za pomocą jednego konta menedżera najwyższego poziomu. Jesteś nowym użytkownikiem lub chcesz szybko zacząć korzystać z najprostszej konfiguracji. 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ć aplikacji dostęp do danych na koncie Google Ads. Chcesz łatwo generować wiele danych uwierzytelniających, aby np. zarządzać kontami innych firm. Twoja aplikacja wymaga adresów URL wywołania zwrotnego. Adresy URL wywołań zwrotnych nie są obsługiwane w aplikacji komputerowej.

Ważne: możesz wybrać przepływ aplikacji na komputer, nawet jeśli tworzysz aplikację, która będzie uruchamiana na serwerze. Różnica polega na tym, czy autoryzacja OAuth jest wykonywana lokalnie czy zdalnie. Na komputerze konieczne jest przeprowadzenie autoryzacji na komputerze lokalnym, a proces internetowy umożliwia przeprowadzenie autoryzacji na serwerze autoryzacji Google.

Więcej informacji znajdziesz w dokumentacji OAuth Google Workspace Platform na stronie aplikacji internetowych.

Utwórz identyfikator klienta i tajny klucz klienta

Gdy określisz typ 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 DANE LOGOWANIA i wybierz Identyfikator klienta OAuth.

   1. Jeśli w tym projekcie był wcześniej skonfigurowany ekran zgody OAuth, przekierujemy Cię teraz do tego ekranu. Kliknij SKONFIGURUJ EKRAN ZGODY.

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

      2. Wypełnij wstępny formularz. W razie potrzeby możesz ją 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 konkretnego przypadku użycia.

4. Nadaj mu nazwę, a potem kliknij Utwórz.

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

   W przypadku testów lokalnych zgodnych z domyślną konfiguracją w przykładach z biblioteki klienta użyj metody http://127.0.0.1.

   Uwaga: aby ograniczyć wykorzystanie do określonego portu, do przekierowania URI możesz dodać numer portu. Jeśli port nie został skonfigurowany, klient OAuth może przekierowywać do dowolnego portu.

   W przypadku klientów korzystających z aplikacji komputerowej nadal trzeba używać przekierowania przekierowania IP, ale identyfikator URI nie jest wyraźnie skonfigurowany w Cloud Console.

6. Na stronie potwierdzenia skopiuj do schowka zawartość pola Identyfikator klienta i Tajny klucz klienta, ponieważ będą one potrzebne podczas konfigurowania biblioteki klienta. Możesz też wrócić na stronę danych logowania później, aby uzyskać te informacje.