Konfigurowanie projektu w Konsoli interfejsów API Google

Sposób tworzenia i konfigurowania projektu w Konsoli interfejsów API Google zależy od scenariusza autoryzacji OAuth 2.0 w Twojej aplikacji. Aby dostosować ten przewodnik, wybierz scenariusz autoryzacji.

Aby utworzyć dane logowania OAuth 2.0 i włączyć interfejs Google Ads API w aplikacji, musisz mieć projekt w Konsoli interfejsów API Google.

Te dane logowania uwierzytelniają i autoryzują Twoją aplikację lub użytkowników Google Ads na serwerach Google oraz umożliwiają generowanie tokenów OAuth, które można używać w wywołaniach interfejsu API.

Wybieranie lub tworzenie projektu w Konsoli interfejsów API Google

Aby skonfigurować nowy projekt, postępuj zgodnie z instrukcjami tworzenia projektu w Konsoli interfejsów API Google. Włączenie rozliczeń w projekcie jest opcjonalne. Jeśli masz włączone rozliczenia, wybierz konto rozliczeniowe dla nowego projektu. Korzystanie z interfejsu Google Ads API jest bezpłatne, ale projekty w chmurze podlegają standardowym limitom przydziału projektu.

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ę interfejsów API w Konsoli interfejsów API Google. Jeśli pojawi się prośba, 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, użyj wyszukiwarki.

  3. Wybierz interfejs Google Ads API, a następnie kliknij przycisk Włącz.

Włączanie interfejsu Google Ads API

Zgłaszanie prośby o dostęp do interfejsu API

Następnie otwórz stronę Przegląd interfejsu Google Ads API, aby sprawdzić bieżący poziom dostępu do interfejsu API. Jeśli Twój obecny poziom dostępu do interfejsu API to Test, rozwiń sekcję Podniesienie poziomu dostępu. Postępuj zgodnie z instrukcjami, aby poprosić o poziom dostępu Eksplorator.

Gdy skończysz wypełniać zgłoszenie, Google automatycznie je sprawdzi i w większości przypadków podniesie poziom dostępu do Eksploratora.

Gdy używasz OAuth 2.0 do autoryzacji, Google wyświetla użytkownikowi ekran zgody zawierający podsumowanie projektu, jego zasad oraz żądanych zakresów autoryzacji dostępu. Skonfigurowanie ekranu zgody OAuth w aplikacji określa, co jest wyświetlane użytkownikom i recenzentom aplikacji, oraz rejestruje aplikację, aby można ją było później opublikować.

Skonfiguruj ekran zgody OAuth w aplikacji i dodaj https://www.googleapis.com/auth/adwords jako zakres OAuth.

Ważne informacje dotyczące typu użytkownika i stanu publikacji

Podczas konfigurowania ekranu zgody OAuth zwróć uwagę na ustawienia Typ użytkownika i Stan publikacji.

  • Typ użytkownika:określa, czy aplikacja jest ograniczona do użytkowników w Twojej organizacji (Wewnętrzny), czy jest dostępna dla wszystkich użytkowników Google (Zewnętrzny). Opcja Wewnętrzny jest dostępna tylko wtedy, gdy Twój projekt jest częścią organizacji Google Workspace.
  • Stan publikacji: określa, czy aplikacja jest w trybie Testowanie (ograniczona do określonych użytkowników testowych, których dodasz), czy W produkcji (dostępna dla odbiorców określonych przez Typ użytkownika, co może wymagać weryfikacji aplikacji przez Google).

Aby wybrać najlepsze opcje dla swojej aplikacji, zapoznaj się ze szczegółowymi wyjaśnieniami i konsekwencjami tych ustawień w oficjalnej dokumentacji pomocy Google Cloud:

Zrozumienie tych ustawień jest kluczowe, aby aplikacja była dostępna dla docelowych użytkowników.

Tworzenie identyfikatora klienta i tajnego klucza klienta

Utwórz identyfikator klienta i tajny klucz klienta. Jako typ aplikacji możesz wybrać aplikację komputerową lub aplikację internetową. Gdy utworzysz klienta OAuth 2.0, pobierz plik JSON klienta, klikając przycisk Pobierz JSON w oknie potwierdzenia.