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 Google OAuth2 są wymagane do uwierzytelniania i autoryzowania użytkowników Google Ads. Te dane logowania pozwalają Google zidentyfikować Twoją aplikację, 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 interfejsów API Google.

Obejrzyj ten film przedstawiający 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 musi przejść weryfikację Google OAuth, aby uniknąć wyświetlania użytkownikom niezweryfikowanego ekranu UI. Aplikacja jest w tym kontekście definiowana jako unikalny identyfikator klienta OAuth 2.0 w Google Cloud.

Ta weryfikacja jest niezależna i stanowi uzupełnienie procesu zatwierdzania tokena dewelopera i jest wymagana, ponieważ zakres interfejsu API Google Ads ma wrażliwy zakres.

Weryfikacja przez Google nie wiąże się z żadnymi opłatami. Trwa ona zazwyczaj od 3 do 5 dni roboczych. Ta zasada dotyczy wszystkich aplikacji.

Aby uniknąć przerw w działalności, zalecamy jak najszybsze przejście procesu weryfikacji OAuth przez Google w przypadku wszystkich aplikacji.

Tworzenie projektu

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. 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 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 i Stan publikowania projektu. W tabeli poniżej opisujemy niektóre kluczowe 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 Testowanie
  • Opcja dostępna tylko w przypadku projektów powiązanych z organizacją Google Cloud.
  • 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.
  • Zezwolenia wygasają po 7 dniach od momentu wyrażenia zgody.
Zewnętrzny Testowanie
  • Dostępne dla wszystkich projektów.
  • Maksymalnie 100 użytkowników testowych wymienionych na ekranie zgody OAuth.
  • Użytkownikami testowymi może być dowolny użytkownik mający konto Google.
  • Zezwolenia wygasają po 7 dniach od momentu wyrażenia zgody.
Wewnętrzny W wersji produkcyjnej
  • Opcja dostępna 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 zakończysz weryfikacji Google OAuth, niezależnie od typu użytkownika i stanu publikacji projektu:

  1. Otwórz stronę ekranu z prośbą o zgodę 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 akceptacji. W razie potrzeby możesz ją później zmienić. Gdy skończysz, kliknij ZAPISZ I KONTYNUUJ.

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

    • Przewiń stronę w dół i w sekcji Ręcznie dodaj zakresy wpisz te wartości:

      https://www.googleapis.com/auth/adwords
      
    • Kliknij DODAJ DO TABELI.

    • Dodaj inne zakresy, o które może prosić projekt, a następnie kliknij AKTUALIZUJ.

    • Kliknij ZAPISZ I KONTYNUUJ.

  5. Jeśli nie planujesz opublikować 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. Przejrzyj stronę podsumowania i kliknij WRÓĆ DO PANELU.

Po przetestowaniu aplikacji i procesie autoryzacji możesz wrócić do panelu i kliknąć OPUBLIKUJ APLIKACJĘ, aby zmienić jej stan publikowania z Testowanie na W wersji produkcyjnej.

Wybierz typ aplikacji

Interfejs Google Ads API ma 2 rodzaje aplikacji: na komputery i w przeglądarce. W tej tabeli możesz określić, który typ jest 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.
  • Korzystasz z tego typu informacji po raz pierwszy lub chcesz szybko rozpocząć pracę dzięki najprostszej 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ć Twojej aplikacji uprawnienia dostępu do danych na swoim koncie Google Ads.
  • Chcesz łatwo wygenerować wiele danych uwierzytelniających uwierzytelniających, aby np. zarządzać kontami w usługach innych firm.
  • Twoja aplikacja wymaga adresów URL wywołania zwrotnego. Adresy URL wywołań zwrotnych nie są obsługiwane w przepływie aplikacji komputerowej.

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 skonfigurowanego ekranu zgody OAuth w tym projekcie, przekierujemy Cię teraz, aby to zrobić. Kliknij SKONFIGURUJ EKRAN ZGODY.

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

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

    2. Aby kontynuować, wróć do strony 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ę i kliknij Utwórz.

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

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

    W przypadku klientów aplikacji komputerowych nadal używasz przekierowania adresu IP w pętli, ale identyfikator URI nie jest bezpośrednio skonfigurowany w konsoli Cloud.

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