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.

Aby aplikacja mogła korzystać z usług internetowych w imieniu użytkownika, wszystkie wywołania interfejsu Google AdMob API muszą być autoryzowane za pomocą protokołu OAuth2. Protokół OAuth2 umożliwia aplikacji klienckiej interfejsu API AdMob 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 uwierzytelniające OAuth2 i wysłać swoje pierwsze żądanie.

Wymagania wstępne

Określanie typu uwierzytelniania

W tabeli poniżej możesz sprawdzić, który typ uwierzytelniania jest najbardziej odpowiedni 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ę dzięki najprostszej konfiguracji.
  • Twoja aplikacja uwierzytelnia użytkowników Google AdMob tylko z jednego komputera.
Aplikacja internetowa
  • Chcesz się uwierzytelnić jako użytkownik, który może przyznawać Twojej aplikacji dostęp do danych swojego konta interfejsu 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łań zwrotnych. Adresy URL wywołań zwrotnych nie są obsługiwane w procesie aplikacji komputerowej.

Tworzenie projektu

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 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, przekierujemy Cię teraz, aby to zrobić. Kliknij SKONFIGURUJ EKRAN ZGODY. Istnieje kilka sposobów na skonfigurowanie 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.

      Więcej informacji znajdziesz w artykule 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, otrzymasz identyfikator klienta OAuth 2.0 i tajny klucz klienta, które możesz pobrać w formacie JSON i zapisać do użycia w przyszłości.

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ą, większe bezpieczeństwo i obsługę 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 potrzebuje też informacji o zakresie:

Zakres Znaczenie
https://www.googleapis.com/auth/admob.readonly Wyświetlanie wszystkich danych AdMob. Mogą to być 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

Udostępnione tokeny możesz unieważnić na 2 sposoby:

  1. Otwórz stronę uprawnień konta Google i cofnij dostęp dla odpowiedniego projektu.

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