Adaptery

Interfejs AdMob API umożliwia wyświetlanie listy adapterów pośrednictwa w sposób zautomatyzowany. Więcej informacji znajdziesz w artykule accounts.adSources.adapters.list. Adaptery zawierają szczegółowe informacje o konfiguracjach adapterów innych firm.

Przykłady

Po utworzeniu danych uwierzytelniających 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 z zakresu.

Oto zakres danych protokołu OAuth 2.0:

Zakres Znaczenie
https://www.googleapis.com/auth/admob.monetization Wyświetlanie, tworzenie i edytowanie ustawień generowania przychodów w AdMob
https://www.googleapis.com/auth/admob.readonly Zobacz wszystkie dane 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.

curl (wiersz poleceń)

Żądania z wykorzystaniem curl

  1. Prześlij plik z tajnymi kluczami klienta i wygeneruj dane uwierzytelniające.

    Gdy wykonasz ten krok po raz pierwszy, w przeglądarce pojawi się prośba o autoryzację. Zanim zaakceptujesz, zaloguj się na konto Google z dostępem do interfejsu AdMob API. Aplikacja będzie mieć uprawnienia do uzyskiwania dostępu do danych w imieniu konta, na które użytkownik jest aktualnie zalogowany.

    Do uwierzytelniania i autoryzacji zalecamy użycie narzędzia oauth2l, czyli prostego narzędzia wiersza poleceń do pracy z protokołem Google OAuth 2.0. Zainstaluj oauth2l i uruchom poniższe polecenie, zastępując path_to_credentials_json ścieżką do pliku credentials.json pobranego przy rejestrowaniu aplikacji internetowej. Podczas pierwszego uruchomienia polecenie przeprowadzi Cię przez proces autoryzacji OAuth 2.0. Kolejne uruchomienia odświeżą token automatycznie.

    oauth2l header --json path_to_credentials_json --scope admob.readonly
    
  2. Wyświetl listę adapterów.

    Aby uzyskać informacje o adapterze AdMob, zastąp pub-XXXXXXXXXXXXXXXX swoim identyfikatorem wydawcy. Zobacz, jak znaleźć identyfikator wydawcy.

    Zastąp SSSSSSSSSSSSSSSSSSSS identyfikatorem źródła reklam dla interesujących Cię adapterów.

    Aby uzyskać listę adapterów, użyj następującego polecenia:

    curl --http1.0 -X GET https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adSources/SSSSSSSSSSSSSSSSSSSS/adapters \
     -H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"
    

    Przykładowa odpowiedź w przypadku źródła reklam w sieci AdMob o identyfikatorze 5450213213286189855:

    {
     "adapters": [
      {
         "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/1",
         "adapterId": "1",
         "title": "AdMob Network Android SDK",
         "platform": "ANDROID",
         "formats": ["BANNER", "INTERSTITIAL",
           "REWARDED", "NATIVE", "REWARDED_INTERSTITIAL", "APP_OPEN"],
         "adapterConfigMetadata": [{
           "adapterConfigMetadataId": "118",
           "adapterConfigMetadataLabel": "Ad unit ID"
         }]
      },
      {
         "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/2",
         "adapterId": "2",
         "title": "AdMob Network iOS SDK",
         "platform": "ANDROID",
         "formats": ["BANNER", "INTERSTITIAL",
           "REWARDED", "NATIVE", "REWARDED_INTERSTITIAL", "APP_OPEN"],
         "adapterConfigMetadata": [{
           "adapterConfigMetadataId": "119",
           "adapterConfigMetadataLabel": "Ad unit ID"
         }]
      }]
    }