Release Notes

This page provides release notes for the AdSense Management API.

Version 2

This version introduces the following changes in order to remove deprecated functionality and to align the AdSense Management API with current Google API standards. Per the Google API versioning scheme, this version will be updated over time to include additional (backwards compatible) functionality rather than new functionality being released in separate minor versions.

2022-09-21

AdUnits

Added create and patch methods. Note that these methods can only be used by projects enabled for the AdSense for Platforms product.

CustomChannels

Added create, patch and update methods. Note that these methods can only be used by projects enabled for the AdSense for Platforms product.
Added the active field to the resource.

Accounts

Added the getAdBlockingRecoveryTag method.

2022-08-25

Reports

Added the HOSTED_AD_CLIENT_ID dimension, which allows host and platform publishers to break down metrics by their publisher's accounts (host publishers) and by sub-accounts (platform publishers).

2022-05-03

AdClient

Added get method.

Reports

Added getSaved method.

UrlChannels

Added get method.

2022-03-31

Account

Inactive accounts are now returned by the API, with a state field indicating the state of the account.

AdClient

Similar to the Account changes above, inactive ad clients are now returned by the API, with a state field indicating the state of the ad client.

2022-02-24

Payment

The resource name format has been extended to support separate resources for YouTube earnings. This change is prior to the phased rollout of the improved AdSense experience for YouTube creators, in which YouTube earnings will be separated into its own payments account. YouTube payment information will also be returned from the payments list method, once you have a dedicated payments account for YouTube earnings. YouTube earnings will have the following resource name format:
- accounts/{account}/payments/youtube-unpaid for unpaid (current) YouTube earnings.
- accounts/{account}/payments/youtube-yyyy-MM-dd for paid YouTube earnings.
Note: The resource names for AdSense earnings remain unchanged:
- accounts/{account}/payments/unpaid for unpaid (current) AdSense earnings.
- accounts/{account}/payments/yyyy-MM-dd for paid AdSense earnings.

2021-06-30

Report

Added dimensions AD_FORMAT_NAME and AD_FORMAT_CODE, indicating the way an ad is shown to the users on your site (in-page, vignette, etc). Note that v1.4 had (deprecated) dimensions with the same names but different members; the two dimensions added in v2 are distinct from those that were present in v1.4.

2021-04-19 (Initial release)

General

All deprecated methods in v1.4 have been removed. This includes resource methods that did not require an accountId. In v2, the accountId is specified in the parent field.
Per Google API standards, resources are now identified by a name field. For example, an AdClient’s name would look like accounts/{accountId}/adclients/{adClientId}. Additionally, in v1.4 the resource ID was used as a reporting dimension, but in v2 that value is now available through a reporting_dimension_id field on several resources.
The kind field has been removed from all resources.

Account

The name field has been changed to display_name.
The timezone field has been changed from a string to a google.type.TimeZone.
The creation_time field (type int64) has been changed to create_time (type google.protobuf.Timestamp).
Added a pending_tasks field which is a list of outstanding tasks that need to be completed as part of the sign-up process for a new account. For example, tasks could be related to your billing profile or phone verification.
The sub_accounts field has been removed. Similar functionality can be achieved in v2 with the listChildAccounts custom method. The full child account tree can be generated in v2 by calling listChildAccounts recursively.

AdClient

Removed the arc_opt_in field since it has already been removed from the AdSense UI.
The supports_reporting field is replaced with the reporting_dimension_id field, which represents the unique ID of the ad client as used in the AD_CLIENT_ID reporting dimension. If reporting_dimension_id is empty, then the AdClient doesn’t support reporting.

AdUnit

The status field has been renamed to state. Also, the ACTIVE state no longer indicates whether there has been activity on this ad unit in the last seven days. In v2, it means the ad unit has been activated by the user and can serve ads.
The code field has been removed. This value can still be found at the end of the name field (after the last forward slash).
The contentAdsSettings.backupOption field has been removed.
The type field has been restricted to the values TYPE_UNSPECIFIED, DISPLAY, FEED, ARTICLE, MATCHED_CONTENT, and LINK.
Other fields that have already been removed in the AdSense UI are also removed: custom_style, saved_style_id, mobile_content_ads_settings, feed_ads_settings.

Alert

The delete method has been removed.
The is_dismissible field has been removed.
The locale field has been renamed to language_code.

CustomChannel

The code field has been removed. This value can still be found at the end of the name field (after the last forward slash).
The targeting_info field has been removed since it has already been removed from the AdSense UI.

Payment

The payment_date field has been renamed to date and changed from type string to type google.type.Date.
The payment_amount field and the payment_amount_currency_code field have been combined into a single payment field (e.g., "¥1,235 JPY", "$1,234.57", "£87.65").

Report

With v2, the AdSense Management API reporting data now aligns with the AdSense UI. This means that AdMob and YouTube properties are no longer supported. Additionally, the API will only support report data going back 3 years.
The Metadata.dimensions resource and the Metadata.metrics resource have been removed.
New methods have been added to generate a CSV version of the report, replacing the query parameters in v1.4. Note: for compression, you can still use the HTTP header "Accept-Encoding: gzip".
Some fields have been changed on ad-hoc report generation.
- The account_id field has been renamed to account.
- The dimension field has been renamed to dimensions.
- The metric field has been renamed to metrics.
- The filter field has been renamed to filters.
- The sort field has been renamed to order_by.
- The locale field has been renamed to language_code.
- The currency field has been renamed to currency_code.
- You can now specify several common ranges with date_range (e.g., TODAY, YESTERDAY, MONTH_TO_DATE, YEAR_TO_DATE, LAST_7_DAYS, and LAST_30_DAYS), or you can specify a start_date and end_date by setting date_range to CUSTOM.
- The start_date and end_date fields have been changed from type string to type google.type.Date. Note: as a result, relative date keywords (e.g., "today-6d") are no longer supported.
- The boolean field use_timezone_reporting has been replaced with reporting_time_zone, which can have one of two values: ACCOUNT_TIME_ZONE or GOOGLE_TIME_ZONE (which means PST/PDT). The default in v2 is ACCOUNT_TIME_ZONE, which differs from the default in v1.4.
- The start_index field has been removed.
- The max_results field has been renamed to limit.
Some fields have been changed on saved report generation.
- Added date fields (date_range, start_date, end_date, reporting_time_zone).
- Added a currency_code field.
- The locale field has been renamed to language_code.
- The start_index field has been removed.
- The max_results field has been removed.

SavedAdStyle

SavedAdStyle has been removed since it has already been removed from the AdSense UI.

Site

Sites have been added to fetch data about websites you've added to your AdSense account.
The state field represents whether the site is any of the following states: REQUIRES_REVIEW, GETTING_READY, READY, NEEDS_ATTENTION.
The auto_ads_enabled field is a boolean that represents whether auto ads have been enabled on a particular site.