Pierwsze kroki z interfejsem AdMob API

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

Wszystkie wywołania interfejsu Google AdMob API muszą być autoryzowane za pomocą OAuth2, aby aplikacja mogła wchodzić w interakcje z usługami internetowymi w imieniu użytkownika. OAuth2 umożliwia aplikacji klienckiej interfejsu AdMob API dostęp do konta AdMob użytkownika bez konieczności obsługi ani przechowywania jego nazwy użytkownika ani hasła. Informacje o autoryzacji znajdziesz w artykule Autoryzacja.

Aby wygenerować dane logowania OAuth 2 i przesłać pierwsze żądanie, wykonaj podane niżej czynności.

Wymagania wstępne

Określanie typu uwierzytelniania

W tabeli poniżej sprawdzisz, który typ uwierzytelniania jest najbardziej odpowiedni dla Twojej aplikacji:

Wybieranie typu uwierzytelniania OAuth 2 Jeśli
Aplikacja na komputer
  • Zarządzasz wszystkimi kontami AdMob API za pomocą jednego konta menedżera najwyższego poziomu.
  • Jesteś nowym użytkownikiem lub chcesz szybko rozpocząć pracę z najprostszą konfiguracją.
  • Twoja aplikacja uwierzytelnia użytkowników Google AdMob 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 AdMob API.
  • Chcesz łatwo generować wiele danych logowania, aby zarządzać na przykład kontami firm zewnętrznych.
  • Twoja aplikacja wymaga adresów URL wywołania zwrotnego. Adresy URL wywołania zwrotnego nie są obsługiwane w procesie korzystania z aplikacji na komputery.

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ć ten interfejs API za pomocą narzędzia do 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ć dla niego 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

W podanych niżej instrukcjach znajdziesz instrukcje tworzenia identyfikatora klienta OAuth 2.0 do użycia w przepływie dla zainstalowanej aplikacji.

  1. Go to the Credentials page.

  2. Kliknij Utwórz dane logowania > Identyfikator klienta OAuth.

    Jeśli wcześniej nie skonfigurowano ekranu zgody OAuth w przypadku tego projektu, zostaniesz poproszony o jego skonfigurowanie. Kliknij SKONFIGURUJ EKRAN ZGODY. Ekran zgody można skonfigurować na wiele sposobów, aby używać identyfikatora klienta OAuth 2.0.

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

    2. Możesz też ustawić typ użytkownika na Zewnętrzny, a stan publikowania na Testowanie, a potem dodać użytkowników testowych, wybierając Dodaj użytkowników, aby umożliwić im korzystanie z identyfikatora klienta OAuth 2.0.

      Dowiedz się więcej o konfigurowaniu ekranu zgody OAuth.

  3. Jako typ aplikacji wybierz Aplikacja na komputer lub Aplikacja internetowa, nadaj jej nazwę, a potem kliknij Utwórz.

Po zakończeniu zobaczysz identyfikator klienta OAuth 2.0 i obiekt tajny klienta, które możesz pobrać w formacie JSON i zapisać na później.

Poproś

Interfejs AdMob API został zaprojektowany na podstawie protokołu HTTP i JSON, więc każdy standardowy klient HTTP może wysyłać do niego żądania i analizować odpowiedzi. Biblioteki klienta interfejsu API Google zapewniają jednak lepszą integrację językową, wyższy poziom bezpieczeństwa i obsługę wywołań, które wymagają autoryzacji. 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 za pomocą OAuth 2.0, aplikacja potrzebuje też informacji o zakresie:

Zakres Znaczenie
https://www.googleapis.com/auth/admob.readonly Wyświetlanie wszystkich danych AdMob Te dane mogą obejmować m.in. informacje o Twoim 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 Wyświetlanie raportów o skuteczności reklam i zarobkach. Sprawdź identyfikator wydawcy, strefę czasową i kod domyślnej waluty.

Wyślij pierwsze żądanie, aby wygenerować raport, korzystając z przykładów w Java, PHP, Python lub curl.

Unieważnij udostępnione tokeny

Udostępnione tokeny możesz cofnąć na 2 sposoby:

  1. Otwórz stronę uprawnień konta Google i odwołaj dostęp do odpowiedniego projektu.

  2. Możesz też cofnąć tokeny aplikacji internetowej za pomocą interfejsu Google Identity API.