AdMob API

  • The AdMob API provides programmatic access to information about your AdMob account.

  • You can use the API to retrieve details about your account, ad sources, ad units, apps, mediation groups, and generate various reports.

  • The API uses REST resources and offers methods for operations like listing, getting, creating, updating, and generating reports.

  • Client libraries are recommended for calling the service, but you can also use your own libraries with provided service endpoint and discovery documents.

The AdMob API allows publishers to programmatically get information about their AdMob account.

Service: admob.googleapis.com

To call this service, we recommend that you use the Google-provided client libraries. If your application needs to use your own libraries to call this service, use the following information when you make the API requests.

Discovery document

A Discovery Document is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery documents:

Service endpoint

A service endpoint is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:

  • https://admob.googleapis.com

REST Resource: v1beta.accounts

Methods
get GET /v1beta/{name=accounts/*}
Gets information about the specified AdMob publisher account.
list GET /v1beta/accounts
Lists the AdMob publisher account that was most recently signed in to from the AdMob UI.

REST Resource: v1beta.accounts.adSources

Methods
list GET /v1beta/{parent=accounts/*}/adSources
List the ad sources.

REST Resource: v1beta.accounts.adSources.adapters

Methods
list GET /v1beta/{parent=accounts/*/adSources/*}/adapters
List the adapters of the ad source.

REST Resource: v1beta.accounts.adUnitMappings

Methods
batchCreate POST /v1beta/{parent=accounts/*}/adUnitMappings:batchCreate
Batch create the ad unit mappings under the specific AdMob account.

REST Resource: v1beta.accounts.adUnits

Methods
create POST /v1beta/{parent=accounts/*}/adUnits
Creates an ad unit under the specified AdMob account.
list GET /v1beta/{parent=accounts/*}/adUnits
List the ad units under the specified AdMob account.

REST Resource: v1beta.accounts.adUnits.adUnitMappings

Methods
create POST /v1beta/{parent=accounts/*/adUnits/*}/adUnitMappings
Create an ad unit mapping under the specific AdMob account and ad unit.
list GET /v1beta/{parent=accounts/*/adUnits/*}/adUnitMappings
List ad unit mappings under the specified AdMob account and ad unit.

REST Resource: v1beta.accounts.apps

Methods
create POST /v1beta/{parent=accounts/*}/apps
Creates an app under the specified AdMob account.
list GET /v1beta/{parent=accounts/*}/apps
List the apps under the specified AdMob account.

REST Resource: v1beta.accounts.campaignReport

Methods
generate POST /v1beta/{parent=accounts/*}/campaignReport:generate
Generates Campaign Report based on provided specifications.

REST Resource: v1beta.accounts.mediationGroups

Methods
create POST /v1beta/{parent=accounts/*}/mediationGroups
Create a mediation group under the specific AdMob account.
list GET /v1beta/{parent=accounts/*}/mediationGroups
List mediation groups under the specified AdMob account.
patch PATCH /v1beta/{mediationGroup.name=accounts/*/mediationGroups/*}
Update the specified mediation group under the specified AdMob account.

REST Resource: v1beta.accounts.mediationGroups.mediationAbExperiments

Methods
create POST /v1beta/{parent=accounts/*/mediationGroups/*}/mediationAbExperiments
Create an A/B testing experiment for a specified AdMob account and a mediation group.
stop POST /v1beta/{name=accounts/*/mediationGroups/*/mediationAbExperiments}:stop
Stop the mediation A/B experiment and choose a variant.

REST Resource: v1beta.accounts.mediationReport

Methods
generate POST /v1beta/{parent=accounts/*}/mediationReport:generate
Generates an AdMob Mediation report based on the provided report specification.

REST Resource: v1beta.accounts.networkReport

Methods
generate POST /v1beta/{parent=accounts/*}/networkReport:generate
Generates an AdMob Network report based on the provided report specification.

REST Resource: v1.accounts

Methods
get GET /v1/{name=accounts/*}
Gets information about the specified AdMob publisher account.
list GET /v1/accounts
Lists the AdMob publisher account that was most recently signed in to from the AdMob UI.

REST Resource: v1.accounts.adUnits

Methods
list GET /v1/{parent=accounts/*}/adUnits
List the ad units under the specified AdMob account.

REST Resource: v1.accounts.apps

Methods
list GET /v1/{parent=accounts/*}/apps
List the apps under the specified AdMob account.

REST Resource: v1.accounts.mediationReport

Methods
generate POST /v1/{parent=accounts/*}/mediationReport:generate
Generates an AdMob Mediation report based on the provided report specification.

REST Resource: v1.accounts.networkReport

Methods
generate POST /v1/{parent=accounts/*}/networkReport:generate
Generates an AdMob Network report based on the provided report specification.