Konfiguracja protokołu OAuth

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.