Google Ads Developer Blog: adsense_host

Ads Developer Blog

The official blog for information about the Google Ads, Google Ad Manager, Google Mobile Ads SDKs for AdMob and IMA SDKs, and other Google Advertising Platform developer tools.

Reminder to migrate to the AdMob API

Friday, April 30, 2021

Starting on October 12, 2021, developers will no longer be able to retrieve AdMob data from the AdSense Management API v1.4. Please start to migrate to the AdMob API which is generally available. Where can I get my AdMob data? After October 12th, 2021, using the AdMob API will be the only way you can access your AdMob data programmatically. The AdMob API helps app developers retrieve:

metrics that are consistent with the AdMob UI definitions and calculations

mediation reports that are not available through the AdSense API

What do I need to do? Start migrating from the AdSense API to the AdMob API as soon as possible. If you do not complete the migration by October 12th, 2021, you will lose access to AdMob data through the AdSense API, which may impact your ability to make data-driven business decisions. Follow the instructions in the migration guide to migrate your API workflow. Review these additional resources to support your migration:

Get started with the AdMob API - Follow this guide to learn how to generate credentials and make your first request using the AdMob API.

Reference documentation - Find detailed information on each REST method and its specific parameters.

Client Library Samples - Check out code samples on how to make requests in Java, PHP and Python.

Feel free to reach out to us via the AdMob API forum if you have questions or feedback regarding the AdMob API.

- Amira Badreldin, AdMob API team

Google

Labels: admob , admob_api , admob_api_v1 , adsense , adsense_api , adsense_host_api , adsense_management_api , sunset

Using advanced date ranges in AdSense APIs

Friday, December 21, 2012

In the AdSense Management API and AdSense Host API, you can let us manage date calculations for you. Apart from the standard YYYY-MM-DD format, all date fields accept the following special keywords:

today
startOfMonth
startOfYear

With these keywords you can define useful date ranges such as the following:

	Start date	End date
This month’s performance so far	`startOfMonth`	`today`
This year’s performance so far	`startOfYear`	`today`

But here is the really useful part: there is a handy feature that you can use to calculate relative dates by adding or subtracting days, weeks, months, or years:

	Start date	End date
Last 7 days’ performance	`today-6d`	`today`
Last month’s performance	`startOfMonth-1m`	`startOfMonth-1d`
Previous six months	`startOfMonth-6m`	`startOfMonth-1d`

You can use up to two operations per date. Let’s say we need to compare last month with the same period last year. We would need two requests like these two requests with these start and end dates:

	Start date	End date
Last month’s performance	`startOfMonth-1m`	`startOfMonth-1d`
Same month last year	`startOfMonth-1m-1y`	`startOfMonth-1d-1y`

If you want to try these out, we recommend using the APIs explorer. You’ll find it at the bottom of each method documentation page:

generate method for Reports on AdSense Management API v1.2
generate method for Reports on AdSense Host API v4.1

If you have any questions about this post or the AdSense APIs in general, visit the AdSense API Forum. You can also follow our Google Ads Developers G+ page for ad-related updates.

- Jose Alcérreca, AdSense API Team

Google

Labels: adsense_api , adsense_host_api , adsense_management_api

Announcing v4.1 of the AdSense Host API

Thursday, September 13, 2012

We’re happy to announce the release of v4.1 of the AdSense Host API. Don’t let the numbering fool you, this is a major update that provides a ton of new functionality!

The new version is intended as a full replacement of AdSense Host API v3 for ContentAds hosts, with a few extra features. Changes from v4 include added support for:

Account creation and association with a new publisher signup flow
Managing URL and custom channels on the host
Retrieving publisher ad clients
Creating and managing new publisher ad units, and retrieving ad code for them
Running publisher-side reports

With this new release, we're also announcing the sunset of version 3 of the Host API, to take place on January 1, 2013. Over the next few weeks, we will be getting in touch with existing hosts and helping them get started with the migration.

If you’re not an AdSense host yet and are interested in joining the program, take a look at our introduction page to find out more about the requirements and how it works.

Let us know if you have any questions!