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 ani hasła. Omówienie autoryzacji znajdziesz w sekcji Autoryzacja.

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

Wymagania wstępne

Określanie typu uwierzytelniania

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

Wybierz typ uwierzytelniania OAuth2 Jeśli…
Aplikacja na komputery
  • 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 na koncie API AdMob.
  • Chcesz łatwo generować wiele danych logowania do autoryzacji, aby na przykład zarządzać kontami innych firm.
  • Twoja 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. Otwórz Bibliotekę interfejsów API w Konsoli interfejsów API Google.
  2. Jeśli pojawi się prośba, wybierz projekt lub utwórz nowy. W Bibliotece interfejsów API znajdziesz wszystkie dostępne interfejsy API pogrupowane według rodziny produktów 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 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. Jeśli pojawi się taka prośba, włącz płatności.
  6. Jeśli pojawi się taka prośba, przeczytaj i zaakceptuj Warunki korzystania z interfejsu API.

Tworzenie danych logowania OAuth2

Poniższe instrukcje przeprowadzą Cię przez proces tworzenia identyfikatora klienta OAuth 2.0, którego będziesz używać w przypadku zainstalowanej aplikacji.

  1. Otwórz stronę Klienci.

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

    Jeśli nie masz jeszcze skonfigurowanego ekranu zgody OAuth dla tego projektu, 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 publikacji 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 znajdziesz w tym artykule.

  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świetlać wszystkie dane AdMob; Mogą to być informacje o koncie, ustawienia dotyczące zasobów reklamowych i mediacji, raporty i inne dane. 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. 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.