Aller au contenu principal
OrbiAds logo — infrastructure AdOps IA pour Google Ad Manager OrbiAds

Transition Guide: Google Ad Manager API
v202602 → v202605

Google ships a new GAM API version every quarter. Here's everything that changed between v202602 (February 2026) and v202605 (May 2026) — the version OrbiAds currently targets.

OA
OrbiAds Engineering
Updated May 29, 2026 · 6 min read

Why Is This Upgrade Required?

The Google Ad Manager API follows a quarterly release cycle with a strict end-of-life policy. Each version (formatted v20YYQQ) is only supported for roughly one year. After its sunset date, the version is shut down and all SOAP/REST requests fail immediately with a deprecation error.

The quarterly calendar is predictable: v202602 (Feb 2026), v202605 (May 2026), v202608 (Aug 2026), v202611 (Nov 2026). OrbiAds always targets the most recent stable version available at upgrade time — currently v202605.

Key Changes Introduced in v202602

  • Smart Banner fields removed: Legacy fields tied to deprecated Smart Banners on Creative and LineItem objects were deleted. Integrations must use Adaptive Banners and Fluid sizing.
  • New GA4 dimensions in ReportService: Visibility dimensions and GA4 auction metrics were added directly to the SOAP ReportService.
  • Stricter OAuth2 checks: Google now enforces tighter network-level permission scopes on mutating write requests.

What Changed Between v202602 and v202605

v202605 introduces significant changes, especially in the REST Reporting API. Here are the critical findings from our integration testing:

  • DELETE endpoint removed from REST Reporting API: There is no functional DELETE /v1/networks/{nc}/reports/{id} endpoint. Despite what some legacy SDKs document, the URL returns HTTP 404. Reports are now soft-deleted exclusively via a PATCH on the visibility: "HIDDEN" field.
  • Strict REST metrics catalogue: 75 SOAP-era metrics (TOTAL_*, AD_SERVER_ALL_REVENUE…) are rejected by the REST engine. The v202605 catalogue defines 68 valid metrics and 79 valid dimensions.
  • REST date range field names corrected: REST payloads now use "relative" (not "relativeDateRange") and "fixed" (not "fixedDateRange"). The filter field is "filters", not "dimensionFilters".
  • No email recipients API on reports: Adding email recipients to REST reports is not exposed via the API — it remains UI-only in the GAM interface.

For the full version-by-version changelog, see the official Google Ad Manager API Release Notes .

OrbiAds Compatibility — v202605

OrbiAds has already upgraded its entire infrastructure and MCP server to v202605. Our users don't have to change a single line of code to benefit from full compatibility with the latest API version.

Steps to Update Your Own Integrations

If you maintain custom scripts using the Python Googleads SDK, update the version string in each service call:

# Before (February 2026)
from googleads import ad_manager
client = ad_manager.AdManagerClient.LoadFromStorage()
line_item_service = client.GetService('LineItemService', version='v202602')

# After (May 2026 — current target)
from googleads import ad_manager
client = ad_manager.AdManagerClient.LoadFromStorage()
line_item_service = client.GetService('LineItemService', version='v202605')

Also update the SDK to pull the latest WSDL schemas:

pip install --upgrade googleads
← Volver a la Academia