Pierwsze kroki z interfejsem AdMob API

Ten przewodnik jest przeznaczony dla deweloperów, którzy chcą automatycznie uzyskiwać informacje o swoim koncie AdMob za pomocą interfejsu AdMob API.

Wszystkie wywołania interfejsu Google AdMob API muszą być autoryzowane za pomocą protokołu OAuth2, aby aplikacja mogła korzystać z usług internetowych w imieniu użytkownika. Protokół OAuth2 umożliwia aplikacji klienckiej interfejsu AdMob API dostęp do konta AdMob użytkownika bez konieczności obsługi i przechowywania nazwy użytkownika i hasła. Więcej informacji o autoryzacji znajdziesz w artykule Autoryzacja.

Wykonaj poniższe czynności, aby wygenerować dane logowania OAuth2 i wysłać pierwsze żądanie.

Wymagania wstępne

Określanie typu uwierzytelniania

Z tej tabeli dowiesz się, który typ uwierzytelniania jest najodpowiedniejszy w przypadku Twojej aplikacji:

Wybieranie typu uwierzytelniania OAuth2 Jeśli ...
Aplikacja komputerowa
  • Zarządzasz wszystkimi kontami AdMob API za pomocą jednego konta menedżera najwyższego poziomu.
  • Jesteś nowym użytkownikiem lub chcesz szybko rozpocząć pracę, korzystając z najprostszej konfiguracji.
  • Twoja aplikacja uwierzytelnia użytkowników Google AdMob tylko za pomocą jednego komputera.
Aplikacja internetowa
  • Chcesz uwierzytelnić się jako użytkownik, który może przyznawać Twojej aplikacji dostęp do danych swojego konta AdMob API.
  • Chcesz łatwo wygenerować wiele danych 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 aplikacji komputerowej.

Utwórz projekt

Aby zacząć korzystać z interfejsu AdMob API, musisz najpierw utworzyć lub wybrać projekt w Konsoli interfejsów API Google i włączyć interfejs API za pomocą narzędzia konfiguracji, które przeprowadzi Cię przez cały proces i automatycznie aktywuje interfejs AdMob API.

Włączanie interfejsu API w istniejącym projekcie

Podane niżej instrukcje dotyczą użytkowników, którzy mają już projekt i wolą ręcznie aktywować w jego przypadku interfejs AdMob API.

Aby włączyć interfejs API dla swojego projektu:

  1. Open the API Library w Google API Console .
  2. If prompted, select a project, or create a new one. API Library zawiera listę wszystkich dostępnych interfejsów API, pogrupowanych według rodziny produktów i popularności.
  3. Jeśli API, które chcesz włączyć, nie jest widoczne na liście, użyj funkcji wyszukiwania, aby go znaleźć, lub kliknij opcję Wyświetl wszystko w rodzinie produktów, do której należy.
  4. Wybierz interfejs API, który chcesz włączyć, a następnie kliknij przycisk Włącz .
  5. If prompted, enable billing.
  6. If prompted, read and accept the API's Terms of Service.

Tworzenie danych logowania OAuth2

Poniżej znajdziesz instrukcje tworzenia identyfikatora klienta OAuth 2.0 do użycia w przepływie zainstalowanych aplikacji.

  1. Go to the Credentials page.

  2. Kliknij UTWÓRZ DANE LOGOWANIA > Identyfikator klienta OAuth.

    Jeśli nie masz w tym projekcie wcześniej skonfigurowanego ekranu zgody OAuth, pojawi się odpowiedni komunikat. Kliknij SKONFIGURUJ EKRAN ZGODY. Istnieje kilka sposobów skonfigurowania ekranu zgody tak, aby używał identyfikatora klienta OAuth 2.0.

    1. Ustaw typ użytkownika na Zewnętrzny, a stan publikowania na Opublikowano.

    2. Możesz też ustawić typ użytkownika na Zewnętrzny, a stan publikowania na Testowanie, a następnie dodać Użytkownicy testowi, wybierając dodaj użytkowników, aby przyznać im dostęp do identyfikatora klienta OAuth 2.0.

      Zapoznaj się z dodatkowymi informacjami o konfigurowaniu ekranu zgody OAuth.

  3. Jako typ aplikacji wybierz Aplikacja komputerowa lub Aplikacja internetowa, nadaj jej nazwę i kliknij Utwórz.

Gdy skończysz, wyświetlą się identyfikatory klienta OAuth 2.0 i tajny klucz klienta, które możesz pobrać w formacie JSON i zapisać na później.

Poproś

Interfejs AdMob API opiera się na protokole HTTP i JSON, więc każdy standardowy klient HTTP może wysyłać do niego żądania i analizować odpowiedzi. Biblioteki klienta interfejsów API Google zapewniają jednak lepszą integrację językową, wyższy poziom bezpieczeństwa i obsługę wysyłania autoryzowanych żądań. Biblioteki klienta są dostępne w wielu językach programowania. Dzięki nim nie musisz ręcznie konfigurować żądań HTTP ani analizować odpowiedzi.

Po utworzeniu danych logowania OAuth 2.0 możesz zacząć korzystać z interfejsu AdMob API. Aby poprosić o dostęp przy użyciu protokołu OAuth 2.0, aplikacja musi też podać informacje o zakresie:

Zakres Znaczenie
https://www.googleapis.com/auth/admob.readonly Wyświetl wszystkie dane AdMob. Te dane mogą obejmować m.in. informacje o koncie, ustawienia zasobów i zapośredniczenia oraz raporty. Nie obejmuje to danych wrażliwych, takich jak informacje o płatnościach czy szczegóły kampanii.
https://www.googleapis.com/auth/admob.report Zobacz raporty o skuteczności reklam i zarobkach. Zobacz identyfikator wydawcy, strefę czasową i kod domyślnej waluty.

Utwórz pierwsze żądanie wygenerowania raportu z użyciem przykładów w języku Java, PHP, Python lub curl.

Unieważnij tokeny udostępnione

Tokeny udostępnione możesz unieważnić na 2 sposoby:

  1. Przejdź na stronę uprawnień do konta Google i cofnij dostęp dla odpowiedniego projektu.

  2. Możesz też unieważnić tokeny aplikacji internetowych za pomocą interfejsu Google Identity API.