Pierwsze kroki z interfejsem AdMob API

Ten przewodnik jest przeznaczony dla deweloperów, którzy chcą używać interfejsu AdMob API do programowego pobierania danymi na koncie AdMob.

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

Aby wygenerować dane logowania OAuth2 i wysłać pierwsze żądanie, wykonaj te czynności.

Wymagania wstępne

Określanie typu uwierzytelniania

W tabeli poniżej znajdziesz informacje, który typ uwierzytelniania jest najbardziej odpowiedni w przypadku Twojej aplikacji:

Wybieranie typu uwierzytelniania OAuth2 Jeśli…
Aplikacja na komputer
  • Zarządzasz wszystkimi kontami interfejsu AdMob API za pomocą jednego konta menedżera najwyższego poziomu.
  • Jesteś nowym użytkownikiem lub chcesz szybko rozpocząć pracę z najprostszą konfiguracją.
  • Aplikacja uwierzytelnia użytkowników Google AdMob tylko na jednym urządzeniu.
Aplikacja internetowa
  • Chcesz uwierzytelnić się jako użytkownik, który może przyznać aplikacji uprawnienia do uzyskiwania dostępu do danych konta AdMob API.
  • Chcesz łatwo generować wiele danych logowania, aby zarządzać np. kontami innych firm.
  • Aplikacja wymaga adresów URL wywołania zwrotnego. Nie są one obsługiwane w przypadku aplikacji na komputery.

Utwórz projekt

Aby rozpocząć korzystanie 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 do konfiguracji, które przeprowadzi Cię przez ten proces i automatycznie aktywuje interfejs AdMob API.

Włączanie interfejsu API w istniejącym projekcie

Poniższe czynności dotyczą użytkowników, którzy mają już projekt i wolą ręcznie aktywować w nim interfejs AdMob API.

Aby włączyć interfejs API w projekcie:

  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 usług i popularności.
  3. Jeśli interfejs API, który chcesz włączyć, nie jest widoczny na liście, użyj wyszukiwarki, aby go znaleźć, lub kliknij Wyświetl wszystkie w grupie 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, który będzie używany w przepływie aplikacji zainstalowanej.

  1. Go to the Credentials page.

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

    Jeśli nie masz jeszcze skonfigurowanego ekranu zgody OAuth dla tego projektu, teraz pojawi się prośba o jego skonfigurowanie. Kliknij SKONFIGURUJ EKRAN ZGODY. Ekran zgody możesz skonfigurować na kilka 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 następnie dodać Użytkowników testowych, klikając Dodaj użytkowników, aby umożliwić im korzystanie z identyfikatora klienta OAuth 2.0.

      Więcej informacji o konfigurowaniu ekranu zgody OAuth

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

Gdy to zrobisz, zobaczysz identyfikator klienta OAuth 2.0 i tajny klucz klienta, które możesz pobrać w formacie JSON i zapisać do późniejszego użycia.

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ę 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. 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świetlać raporty o skuteczności reklam i zarobkach; Wyświetlanie identyfikatora wydawcy, strefy czasowej i kodu domyślnej waluty.

Wyślij pierwsze żądanie wygenerowania raportu, korzystając z przykładów w językach Java, PHP, Python lub curl.

Unieważnianie udostępnionych tokenów

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

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

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