Adapter

Mit der AdMob API können Vermittlungsadapter programmatisch aufgelistet werden. Weitere Informationen finden Sie unter accounts.adSources.adapters.list. Adapter enthalten Details zu den Konfigurationen von Drittanbieteradaptern.

Beispiele

Nachdem Sie OAuth 2.0-Anmeldedaten erstellt haben, können Sie die AdMob API verwenden. Zur Anforderung eines Zugriffs mit OAuth 2.0 benötigt Ihre Anwendung außerdem die Bereichsinformationen.

Im Folgenden finden Sie die Informationen zum OAuth 2.0-Bereich:

Umfang Bedeutung
https://www.googleapis.com/auth/admob.monetization AdMob-Monetarisierungseinstellungen abrufen, erstellen und bearbeiten
https://www.googleapis.com/auth/admob.readonly Alle AdMob-Daten ansehen Zu diesen Daten können Kontoinformationen, Inventar- und Vermittlungseinstellungen, Berichte sowie andere Daten zählen. Nicht enthalten sind sensible Daten wie Zahlungs- und Kampagnendetails.

Anfragen mit curl

  1. Laden Sie die Clientschlüsseldatei und generieren Sie Autorisierungs-Anmeldedaten.

    Wenn Sie diesen Schritt zum ersten Mal ausführen, werden Sie aufgefordert, eine Autorisierungsanfrage in Ihrem Browser zu akzeptieren. Bevor Sie die Anfrage akzeptieren, müssen Sie mit einem Google-Konto angemeldet sein, das Zugriff auf die AdMob API hat. Ihre App wird autorisiert, im Namen des Kontos, in dem Sie gerade angemeldet sind, auf Daten zuzugreifen.

    Für die Authentifizierung und Autorisierung empfehlen wir oauth2l, ein einfaches Befehlszeilentool für die Arbeit mit Google OAuth 2.0. Installieren Sie oauth2l und führen Sie den folgenden Befehl aus. Ersetzen Sie dabei path_to_credentials_json durch den Pfad zu einer credentials.json-Datei, die Sie beim Registrieren Ihrer Cloud-Anwendung herunterladen. Beim ersten Ausführen führt Sie der Befehl durch den OAuth 2.0-Autorisierungsvorgang. Bei nachfolgenden Ausführungen wird das Token automatisch aktualisiert.

    oauth2l header --json path_to_credentials_json --scope admob.readonly
    
  2. Listen Sie die Adapter auf.

    Ersetzen Sie pub-XXXXXXXXXXXXXXXX durch Ihre Publisher-ID, um Informationen zum AdMob-Adapter abzurufen. Informationen zum Ermitteln Ihrer Publisher-ID

    Ersetzen Sie SSSSSSSSSSSSSSSSSSSS durch die Anzeigenquellen-ID der gewünschten Adapter.

    Verwenden Sie den folgenden Befehl, um eine Liste der Adapter abzurufen:

    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)"
    

    Beispielantwort für die Anzeigenquelle „AdMob-Werbenetzwerk“ mit der ID 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"
         }]
      }]
    }