Konfiguracja OAuth

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 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 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 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. Na stronie API Library znajdziesz listę wszystkich dostępnych interfejsów API pogrupowanych 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 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 Clients page.

  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 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 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ś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.