How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Google AdMob API v1beta

The beta channel of the AdMob API and the only one with a write surface. Nineteen operations adding ad source and adapter discovery, ad unit mappings (single and batch create), app and ad unit creation, mediation group create/list/patch, mediation A/B experiment create and stop, and campaign reporting. Converted from Google's first-party Discovery Document (revision 20260731) — 19 operations, 50 schemas.

Google AdMob API v1beta is one of 2 APIs that Google AdMob publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 JSON Schema definition.

Tagged areas include Account, Application, Ad Units, adUnitMappings, and adSources. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, a JSON-LD context, and 1 JSON Schema.

This API exposes 19 operations across 15 paths, organized into 11 resource areas, and defines 50 schemas. It is described by OpenAPI 3.1.0, at version v1beta.

Requests are made against a single base URL, https://admob.googleapis.com.

19 operations 15 paths 50 schemas 8 GET1 PATCH10 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
v1beta
Base URL
https://admob.googleapis.com
Authentication
OAuth 2.0
Contact
Terms of Service
Resource Areas
11

Authentication & Security 1

Google AdMob API v1beta declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (GoogleOAuth2) using the authorizationCode flow, exposing 2 scopes. By default, every request must be authenticated.

  • GoogleOAuth2 — Google OAuth 2.0 user authorization. AdMob does not support service accounts.

Paths & Operations 19

Across 15 paths, the API surfaces 19 operations — 8 GET, 1 PATCH, 10 POST. They span 11 resource areas, including accounts, campaignReport, mediationGroups, mediationAbExperiments, mediationReport, apps, adUnitMappings, networkReport, and 3 more. Each is listed below with its method, path, parameters, and response codes.

accounts 2
GET
/v1beta/accounts/{accountsId}
Gets information about the specified AdMob publisher account.
accounts_get 1 param → 200400401403429500
GET
/v1beta/accounts
Lists the AdMob publisher account that was most recently signed in to from the AdMob UI
accounts_list 2 params → 200400401403429500
campaignReport 1
POST
/v1beta/accounts/{accountsId}/campaignReport:generate
Generates Campaign Report based on provided specifications.
accounts_campaignReport_generate 1 param body → 200400401403429500
mediationGroups 3
GET
/v1beta/accounts/{accountsId}/mediationGroups
List mediation groups under the specified AdMob account
accounts_mediationGroups_list 4 params → 200400401403429500
POST
/v1beta/accounts/{accountsId}/mediationGroups
Create a mediation group under the specific AdMob account
accounts_mediationGroups_create 1 param body → 200400401403429500
PATCH
/v1beta/accounts/{accountsId}/mediationGroups/{mediationGroupsId}
Update the specified mediation group under the specified AdMob account
accounts_mediationGroups_patch 3 params body → 200400401403429500
mediationAbExperiments 2
POST
/v1beta/accounts/{accountsId}/mediationGroups/{mediationGroupsId}/mediationAbExperiments
Create an A/B testing experiment for a specified AdMob account and a mediation group
accounts_mediationGroups_mediationAbExperiments_create 2 params body → 200400401403429500
POST
/v1beta/accounts/{accountsId}/mediationGroups/{mediationGroupsId}/mediationAbExperiments:stop
Stop the mediation A/B experiment and choose a variant
accounts_mediationGroups_mediationAbExperiments_stop 2 params body → 200400401403429500
mediationReport 1
POST
/v1beta/accounts/{accountsId}/mediationReport:generate
Generates an AdMob Mediation report based on the provided report specification
accounts_mediationReport_generate 1 param body → 200400401403429500
apps 2
POST
/v1beta/accounts/{accountsId}/apps
Creates an app under the specified AdMob account
accounts_apps_create 1 param body → 200400401403429500
GET
/v1beta/accounts/{accountsId}/apps
List the apps under the specified AdMob account.
accounts_apps_list 3 params → 200400401403429500
adUnitMappings 3
POST
/v1beta/accounts/{accountsId}/adUnitMappings:batchCreate
Batch create the ad unit mappings under the specific AdMob account
accounts_adUnitMappings_batchCreate 1 param body → 200400401403429500
POST
/v1beta/accounts/{accountsId}/adUnits/{adUnitsId}/adUnitMappings
Create an ad unit mapping under the specific AdMob account and ad unit
accounts_adUnits_adUnitMappings_create 2 params body → 200400401403429500
GET
/v1beta/accounts/{accountsId}/adUnits/{adUnitsId}/adUnitMappings
List ad unit mappings under the specified AdMob account and ad unit
accounts_adUnits_adUnitMappings_list 5 params → 200400401403429500
networkReport 1
POST
/v1beta/accounts/{accountsId}/networkReport:generate
Generates an AdMob Network report based on the provided report specification
accounts_networkReport_generate 1 param body → 200400401403429500
adUnits 2
POST
/v1beta/accounts/{accountsId}/adUnits
Creates an ad unit under the specified AdMob account
accounts_adUnits_create 1 param body → 200400401403429500
GET
/v1beta/accounts/{accountsId}/adUnits
List the ad units under the specified AdMob account.
accounts_adUnits_list 3 params → 200400401403429500
adSources 1
GET
/v1beta/accounts/{accountsId}/adSources
List the ad sources.
accounts_adSources_list 3 params → 200400401403429500
adapters 1
GET
/v1beta/accounts/{accountsId}/adSources/{adSourcesId}/adapters
List the adapters of the ad source.
accounts_adSources_adapters_list 4 params → 200400401403429500

Schemas 50

The contract defines 50 schemas that model the data the API accepts and returns. The most detailed are MediationAbExperiment (11 properties), NetworkReportSpec (8 properties), MediationGroupMediationGroupLine (8 properties), MediationReportSpec (8 properties). Each schema is shown below with its type and property counts.

BatchCreateAdUnitMappingsResponse
object
Response containing a batch of created ad unit mappings.
1 property
Date
object
Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is…
3 properties
LocalizationSettings
object
Localization settings for reports, such as currency and language. It affects how metrics are calculated.
2 properties
BatchCreateAdUnitMappingsRequest
object
Request to create a batch of ad unit mappings under the specific AdMob account.
1 property
MediationReportSpec
object
The specification for generating an AdMob Mediation report. For example, the specification to get observed ECPM sliced by ad source and app for the 'US' and 'C…
8 properties
MediationGroupMediationGroupLine
object
Settings for an ad network used by a mediation group.
8 properties
GenerateNetworkReportRequest
object
Request to generate an AdMob Network report.
1 property
MediationAbExperiment
object
The mediation A/B experiment.
11 properties
GenerateMediationReportResponse
object
The streaming response for the AdMob Mediation report where the first response contains the report header, then a stream of row responses, and finally a footer…
3 properties
ListAppsResponse
object
Response for the apps list request.
2 properties
AdUnit
object
Describes an AdMob ad unit.
7 properties
AppLinkedAppInfo
object
Information from the app store if the app is linked to an app store.
3 properties
ListMediationGroupsResponse
object
Response for the mediation groups list request.
2 properties
MediationAbExperimentExperimentMediationLine
object
The mediation group line for the experiment. It will be used for serving during the run of the experiment.
1 property
ListPublisherAccountsResponse
object
Response for the publisher account list request.
2 properties
GenerateNetworkReportResponse
object
The streaming response for the AdMob Network report where the first response contains the report header, then a stream of row responses, and finally a footer a…
3 properties
App
object
Describes an AdMob app for a specific platform (For example: Android or iOS).
6 properties
Adapter
object
Describes adapters supported by each mediation ad source. Adapters correspond to a specific SDK implementation of the ad source, and are each associated with a…
6 properties
NetworkReportSpecDimensionFilter
object
Describes which report rows to match based on their dimension values.
2 properties
CreateAdUnitMappingRequest
object
Request to create an ad unit mapping under the specific AdMob account and ad unit.
2 properties
NetworkReportSpec
object
The specification for generating an AdMob Network report. For example, the specification to get clicks and estimated earnings for only the 'US' and 'CN' countr…
8 properties
ReportRow
object
A row of the returning report.
2 properties
ReportRowDimensionValue
object
Representation of a dimension value.
2 properties
ReportFooter
object
Groups data available after report generation, for example, warnings and row counts. Always sent as the last message in the stream response.
2 properties
GenerateCampaignReportResponse
object
Campaign Report API response.
1 property
AdapterAdapterConfigMetadata
object
Configuration metadata associated with this adapter. They are used to define the adunitconfigurations associated with AdUnitMappings for the this adapter.
3 properties
AdSource
object
Definition of a mediation ad source.
3 properties
ListAdSourcesResponse
object
Response for the ListAdSourcesRequest.
2 properties
ReportRowMetricValue
object
Representation of a metric value.
3 properties
CampaignReportSpec
object
The specification for generating a Campaign report. For example, the specification to get IMPRESSIONS and CLICKS sliced by CAMPAIGNID can look like the followi…
4 properties
NetworkReportSpecSortCondition
object
Sorting direction to be applied on a dimension or a metric.
3 properties
MediationGroup
object
Describes an AdMob Mediation group.
7 properties
MediationReportSpecDimensionFilter
object
Describes which report rows to match based on their dimension values.
2 properties
AdUnitMapping
object
Settings to map an AdMob ad unit to a 3rd party ad unit.
5 properties
MediationGroupTargeting
object
Set of criteria targeted by this mediation group. For example, a mediation group can target specific ad unit IDs, platform, format and geo location.
6 properties
ReportHeader
object
Groups data helps to treat the generated report. Always sent as a first message in the stream response.
3 properties
DateRange
object
Specification of a single date range. Both dates are inclusive.
2 properties
ListAdUnitsResponse
object
Response for the ad units list request.
2 properties
PublisherAccount
object
A publisher account contains information relevant to the use of this API, such as the time zone used for the reports.
4 properties
GenerateMediationReportRequest
object
Request to generate an AdMob Mediation report.
1 property
ReportWarning
object
Warnings associated with generation of the report.
2 properties
StopMediationAbExperimentRequest
object
Request to end the mediation A/B experiment and choose a winning variant.
1 property
AdUnitRewardSettings
object
Settings for a rewarded ad unit.
2 properties
ListAdaptersResponse
object
Response for the ListAdaptersRequest.
2 properties
GenerateCampaignReportRequest
object
Request to generate campaign report.
1 property
StringList
object
List of string values.
1 property
MediationReportSpecSortCondition
object
Sorting direction to be applied on a dimension or a metric.
3 properties
AppManualAppInfo
object
Information provided for manual apps which are not linked to an application store (Example: Google Play, App Store).
1 property
ListAdUnitMappingsResponse
object
Response for the ListAdUnitMappingsRequest.
2 properties
GoogleRpcStatus
object
Canonical Google API error envelope (google.rpc.Status), returned inside an error wrapper.
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

google-admob-api-v1beta-openapi.yml Raw ↑

Other APIs Google AdMob publishes across the network.

Google AdMob API v1
Where this information came from

This is an independent, third-party profile of Google AdMob API v1beta, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.