Adaptery

Interfejs AdMob API umożliwia wyświetlanie listy adapterów zapośredniczenia w sposób programowy. Więcej informacji znajdziesz w accounts.adSources.adapters.list. Adaptery zawierają 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 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.

curl (wiersz poleceń)

Zapytania 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, upewnij się, że korzystasz z konta Google, które ma dostęp do interfejsu AdMob API. Aplikacja będzie mieć uprawnienia do uzyskiwania dostępu do danych w imieniu konta, na którym jesteś obecnie zalogowany(-a).

    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 podane niżej polecenie, zastępując path_to_credentials_json ścieżką do pliku credentials.json, który pobierzesz podczas rejestrowania aplikacji Cloud. Podczas pierwszego uruchomienia polecenie przeprowadzi Cię przez proces autoryzacji OAuth 2.0. Kolejne uruchomienia odświeżają 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 identyfikatorem wydawcy. Aby dowiedzieć się, jak go znaleźć, kliknij tutaj.

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

    Aby uzyskać listę kart, użyj tego 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ź dla źródła reklamy sieci AdMob o identyfikatorze5450213213286189855:

    {
 "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"
     }]
  }]
}