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