Pierwsze kroki z interfejsem AdMob API

Ważne: nowe role i uprawnienia użytkowników będą miały wpływ na dane zwracane przez interfejs AdMob API. Więcej informacji

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

• Konto Google.

• konto Google AdMob,

• Znajomość podstaw REST i autoryzowania żądań za pomocą protokołu OAuth 2.0.

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.

Ważne: nawet jeśli aplikacja ma działać na serwerze, nadal możesz wybrać proces uruchamiania aplikacji na komputerze. Różnica polega na tym, czy autoryzacja OAuth jest przeprowadzana lokalnie czy zdalnie. Proces na komputerze wymaga autoryzacji na komputerze lokalnym, podczas gdy proces w przeglądarce umożliwia autoryzację na serwerze autoryzacji Google.

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.

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.

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.

Uwaga: gdy po raz pierwszy aktywujesz proces OAuth, zostaniesz poproszony o podanie identyfikatora wydawcy AdMob i zaakceptowanie prośby o autoryzację w przeglądarce. Zanim to zrobisz, zaloguj się na konto Google, które ma dostęp do Twojego konta AdMob. Aplikacja będzie mieć dostęp do danych w imieniu konta, na którym jest obecnie zalogowany użytkownik.

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.