Google Ads Developer Blog

Update your PAL integration for new limited ads behavior

Wednesday, December 10, 2025

The Programmatic Access Library (PAL) is updating user privacy and data usage settings, and requires implementation updates as these changes go live. This update introduces the following changes:

PAL reads Transparency & Consent Framework (TCF) data from the device to determine user consent for local storage.

Adds an optional forceLimitedAds property to manually enable limited ads.

Removes the functionality of the existing allowStorage property.

The following diagram shows the new behavior:

PAL is changing to this behavior in the following releases:

HTML5 v1.90.0, behavior change targeting March 10th, 2026

Android v23.0.0

iOS v3.0.0

tvOS v3.0.0

Starting in these versions, PAL uses Transparency & Consent Framework (TCF) data from the device to determine user consent for local storage. If the automatic TCF based determination is insufficient, your app can directly set the forceLimitedAds property. Setting the forceLimitedAds property to a true value enables limited ads.To keep the current behavior in your app, you might need to update your implementation. For details about the code changes, see the Limited ads and first party identifier settings guide for HTML5, Android, iOS, or tvOS.Follow the PAL HTML5 migration planTo prevent runtime errors, the HTML5 PAL SDK keeps the allowStorage property. The allowStorage property will be supported until March 10th, 2026. The PAL HTML5 SDK observes the following behavior:

What is changing?On March 10th, 2026, PAL SDK ignores the allowStorage property, and its value no longer influences limited ads behavior.To avoid breaking changes, do the following before March 10th, 2026:

Always set the allowStorage property to a true value.

Optionally, you can force limited ads regardless of the TCF determination by setting the forceLimitedAds property to a true value.

For more details about the code changes you need to make for PAL HTML5, see Limited ads and first party identifier settings.Give us your feedbackWe intend these changes to provide transparency on user consent and privacy preferences. If you have questions about this update, please reach out to us via the Google Advertising and Measurement Community Discord Server in the #developers channel under Google Ad Manager.

- Jackson Sui, Interactive Media Ads Developer Relations

Introducing the Google Ads API Developer Assistant v1.0: Interact with the API using Natural Language

Wednesday, December 10, 2025

Announcing the release of the Google Ads API Developer Assistant, a powerful extension for Gemini CLI designed to streamline your Google Ads API workflows. This tool allows you to interact with the Google Ads API using everyday language, making it easier than ever to get information, generate code, and even retrieve data directly in your terminal.
Whether you're new to the Google Ads API or a seasoned developer, this assistant can help you work more efficiently.What Can It Do?The Google Ads API Developer Assistant (v1.0) enhances the Gemini CLI with several key features:

Natural Language Q&A: Have questions about the Google Ads API? Just ask!

"What are the available campaign types?"
"Tell me about reporting for Performance Max campaigns."
"How do I filter by date in GAQL?"

Natural Language to Code Generation: Describe what data you need, and the assistant will generate the Google Ads Query Language (GAQL) and executable Python code using the google-ads-python client library as context so the code conforms to best practices.

"Show me campaigns with the most conversions in the last 30 days."
"Get all ad groups for customer '123-456-7890'."
"Find disapproved ads across all campaigns."
Generated code is automatically saved to the saved_code/ directory.

Direct API Execution: Run the generated Python scripts directly from the command line. The assistant will execute the read-only API calls and display the results, often formatted neatly as tables within your terminal.

CSV Export: Need to save your data? You can easily export the tabular results from API calls to a CSV file. Just ask:

"Save the results to a CSV file"
Files are saved in the saved_csv/ directory.

How Does It Work?This extension leverages the Gemini CLI's ability to use context from GEMINI.md files and settings within .gemini/settings.json. By configuring the assistant with paths to your local google-ads-python library clone and example directories, it provides relevant and accurate code generation.Getting StartedHere's what you need to get up and running:
Prerequisites:

Familiarity with Google Ads API concepts and authentication.

A Google Ads API developer token.

A configured google-ads.yaml credentials file in your home directory.

Python >= 3.10.

The Gemini CLI installed.

A local copy of the google-ads-python client library. (The setup script can clone this for you.)

Please refer to the README file in the GitHub repository for detailed setup instructions and examples.Where to Find ItThe Google Ads API Developer Assistant is available on GitHub.Community & SupportWe encourage you to try it out! Your feedback is valuable and can be provided in this survey. Join the discussion in the #ads-api-ai-tools channel of our Discord. Please use the GitHub Issues tab in the repository to report bugs, suggest features, or ask for support. Check out CONTRIBUTING.md for contribution guidelines.Happy Coding!
Bob Hancock, Google Ads API Team

The Data Manager API is Now Generally Available

Tuesday, December 9, 2025

The Data Manager API, a new solution for data ingestion across Google’s advertising platforms, is now generally available. This API is designed to streamline how advertisers, agencies, and data partners send and manage their first-party data, saving valuable time and resources while ensuring data is handled securely. Simplification The Data Manager API simplifies how you send data to audience lists and conversions used in your Google campaigns. Instead of building and maintaining multiple API integrations, you can now send data once and apply it to different Google ads solutions. For advertisers who prefer API connections, this provides a streamlined and scalable way to activate first-party data across multiple campaign types and platforms. Our vision is universal activation and measurement i.e. bring your data and activate/measure across Google campaigns, GMP campaigns and Google Analytics. At launch use cases include: /* CSS for the table */ .bordered-table { border-collapse: collapse; /* This is the key for a neat grid look */ width: 100%; /* Optional: Makes the table span the whole post area */ } .bordered-table th, .bordered-table td { border: 1px solid #333; /* Internal and external borders for all cells */ padding: 8px; /* Space between content and cell border */ text-align: left; } .bordered-table th { background-color: #f2f2f2; /* Optional: Shades the header row */ }

Audiences

Conversions

Populate audience lists for use in both Google Ads and Display & Video 360 (DV360), including the use of customer information, unique mobile device unique IDs, and Publisher Advertiser Identity Reconciliation (PAIR).

Send conversion events that take place off your website directly to Google Ads, including offline conversion import and conversions with consented customer information to supplement imported offline conversion data to improve accuracy and bidding performance

Security and Privacy at the Core The Data Manager API is also built with advanced, privacy-centric features. The API supports confidential matching for several use cases. This includes the option to encrypt data for audience and conversion events, allowing you to pass encrypted customer information (for example, an email address or phone number), which is processed in a trusted execution environment. This includes audience lists for Customer Match. In the coming months, the Data Manager API will expand support to include additional use cases across Google Ads, Google Analytics, Display & Video 360, Search Ads 360, and Campaign Manager 360. Get Started Today Unlock a more efficient, scalable, and secure way to manage your data. The Data Manager API is available to all developers now. Head over to the developer documentation to get started. If you have any questions or need help, check out the Data Manager API support page for options.

- Melissa Ng, Data Manager API Product Manager

Sunsetting Google Ads API, Google Ads Scripts, and Campaign Manager 360 API Developer Support Forums on Google Groups

Monday, December 1, 2025

To streamline our technical support channels, we will be sunsetting the following developer support forums on Google Groups:

Google Ads API

Google Ads Scripts

Campaign Manager 360 API

Effective January 28, 2026,

Support agents will no longer respond to new forum posts. Send your questions using the recommended support channels mentioned below.

If you reply to any existing forum threads with the support teams on or after this date, they will initiate a new email thread to continue your discussion.

We plan to disable the ability to create new forum posts at a later date in 2026, but the existing forum content will remain visible as a read-only archive for the time being, so you can still access past discussions and solutions. Where can I get technical support for these products? Our developer site and other documentation has been updated to the new preferred technical support channels. Moving forward, the best way to reach us for technical support for these products will be through our official support channels below:

Google Ads API: https://developers.google.com/google-ads/api/support/contact

Google Ads Scripts: https://developers.google.com/google-ads/scripts/docs/support/contact

Campaign Manager 360 API: Contact the Campaign Manager 360 support team for assistance.

As always, when submitting a support request, please provide all relevant details to help us expedite the resolution of your issues. This typically includes:

For Google Ads API: Always include the request-id found in the response logs, along with the complete request and response logs.

For Google Ads Scripts: Include the script name, Customer ID, and any relevant execution logs or error messages from the Google Ads UI.

For Campaign Manager 360 API: Provide relevant IDs (e.g., Profile ID, Account ID), the API method, and the full request and response logs if possible.

All Products:

A clear description of the issue
What you expected to happen
Steps to reproduce the issue
Relevant code snippets
Any error messages received

Providing comprehensive information upfront will help our team diagnose and assist you more effectively. The support page will guide you on the necessary information. If you’re looking for updates, events, or non-support focused conversation with Googlers or fellow members of the developer community on the products listed above, please join us on our “Google Advertising and Measurement Community” Discord server. We appreciate your understanding as we make this transition to better focus our support resources.

- Aalap Shastri, Google Ads API Team

Upcoming changes to targeting in Display & Video 360 API and Structured Data Files

Monday, November 24, 2025

Today, we’re deprecating Insertion Order and Campaign-level targeting management in Display & Video 360 API and Structured Data Files (SDFs) and announcing that they will sunset in February 2026. This change is a result of the removal of this targeting across the entirety of Display & Video 360. In place of this deprecated targeting, we recommend that you set targeting at the line item level using advertisers.lineItems.bulkEditAssignedTargetingOptions or a Line Item SDF. If you want to apply targeting across all line items under an advertiser, use advertiser-level targeting with advertisers.editAssignedTargetingOptions. This sunset will result in the following behavior after February 2026:

API requests to methods that retrieve or manage AssignedTargetingOption resources directly under Campaign or InsertionOrder resources will return a 404 error.

API requests to advertisers.lineItems.generateDefault will return a 404 error.

All targeting columns in Campaign and Insertion Order SDFs will be empty upon file download and must be empty upon file upload. Campaign or Insertion Order file entries with populated targeting columns will fail on upload.

For full details on these changes, see the Display & Video 360 API deprecation announcement. We will announce an exact date for the feature sunset in an upcoming blog post that will be published at least 30 days in advance. If you need help with these new features, please contact us using our Display & Video 360 API Technical support contact form.

- Trevor Mulchay, Display & Video 360 API Team

Announcing v202511 of the Google Ad Manager API

Wednesday, November 19, 2025

We're pleased to announce that v202511 of the Google Ad Manager API is available now. This release provides support for targeting Publisher Provided Signals using PublisherProvidedSignalsTargeting. You can also check the declaration status of Ad technology providers using ThirdPartyDataDeclarationStatus on Creatives, and read the verifiedExchangeAdvertiserdId on Companies. For the full list of changes, check the release notes. Contact us on the Ad Manager API forum with any API-related questions.

- Chris Seeley, Ad Manager API Team

Launching Structured Data Files v9.2

Monday, November 10, 2025

Today we’re announcing the general availability of Structured Data Files v9.2. All users can now use v9.2 when downloading and uploading SDFs in the Display & Video 360 UI and API. SDF v9.2 makes the following updates to files supporting Line Items and Ad Groups:

Adds additional audience targeting columns and product filtering options for YouTube and Demand Gen Line Items and Ad Groups.

Surfaces related videos for YouTube Line Items, and fixed bidding optimization and primary status for all Line Items.

Adds support for Video Sequence Line Items for a closed list of Display & Video 360 clients.

Full details on the changes between v9.1 and v9.2 can be found in the Structured Data Files release notes. If you are still using a deprecated SDF version, such as v7.1, v8, or v8.1, follow the instructions in the v9 migration guide to migrate to v9 before migrating to v9.2. If you need help with these new features, please contact us using our Display & Video 360 API Technical support contact form.