Watching videos can be a great way to get started with Google Ads API, and we have included several popular video series below.
Subscribe to the Google Ads Developers YouTube channel to stay up to date with the latest workshops, release notes, best practices, new feature integrations, code walkthroughs, and video tutorials.
API Version Highlights
Find out about the exciting new features available in the Google Ads API v10.
Find out about the exciting new features available in the Google Ads API v9.
Migration Workshop 2021
Welcome to the Google Ads API Migration workshop. In this session, we’ll share everything you need to know about the event, including what you should expect to get out of the workshops, an overview of the various sessions, how to ask questions and get support, and key resources you’ll need to get the most out of the workshop.
The Google Ads API offers a variety of new features, modern technologies, paradigms, and developer tools. In this session, we’ll highlight many of the exciting changes between the AdWords API and the Google Ads API and walk through several new features that are offered exclusively in the Google Ads API.
Migrating from Feed-based to Asset-based Extensions
As a new feature in the Google Ads API, asset-based extensions offer many improvements over, and will soon replace, feed-based extensions in the Google Ads API. Follow along with your client library of choice as we demonstrate how to migrate feed-based extensions to asset-based extensions.
Follow along as we illustrate several key concepts related to credentials and account access in the Google Ads API with the Google Ads Doctor (oauthdoctor). In this interactive session, you’ll learn how to get started with the Google Ads API and troubleshoot issues along the way.
Reporting and data retrieval in the Google Ads API follows an entirely new paradigm as compared with the AdWords API. In this session, you’ll learn the fundamentals of reporting and data retrieval, as well as the new Google Ads Query Language (or GAQL). We will cover several key concepts and walk through a variety of GAQL queries to demonstrate the power and flexibility of reporting with the Google Ads API.
Building on the Flexible Reporting session, the Ultimate GAQL Workshop will take a deep dive into the details and nuances of the Google Ads Query Language (GAQL). Follow along with this interactive session as we demonstrate how to use the GoogleAdsField service to retrieve field metadata, the Google Ads Query Builder to construct queries, and the Google Ads Query Validator to validate queries. This session will cover several key concepts and developer tools to help you become a reporting power user.
The Google Ads API offers a simple model for performing mutate operations. In this session, we’ll cover the fundamentals of mutating data with the Google Ads API, the various types of mutate methods, and a number of new features in the Google Ads API. We’ll also walk through several examples to demonstrate how mutates work in the context of real-world use cases.
In this interactive session, we'll build upon the concepts of the previous sessions to migrate an entire application from the AdWords API to the Google Ads API. Follow along with your client library of choice as we perform a micro-migration that demonstrates both reporting and mutating functionality and shows how these features work together.
In this session, we’ll walk through best practices to optimize performance, streamline developer workflows, and get the most out of the Google Ads API.
Migrating an entire application from the AdWords API to the Google Ads API can be a major undertaking. With a focus on planning and DevOps, this session will discuss key considerations and decisions to contemplate in preparing for and completing your migration. This session is designed to help you create a plan that will ease your migration process and even turn it into an opportunity to improve upon your existing AdWords API integration.
In this session, you’ll have the opportunity to hear from and get to know the team behind the Google Ads API. With panel participants including the tech leads for the Google Ads API and Google Ads API Developer Relations team, you’ll learn about key decisions in designing an entirely new API, how we think about the Google Ads API, and much more.
We've covered a lot of important information in this workshop. Before the event comes to a close, join us for some fun in this interactive trivia session. See how you stack up against the Google Ads Developer Relations team in answering trivial questions about the Google Ads API.
Thank you for tuning into the Google Ads API Migration workshop. Join us for this closing session as we recap what we’ve learned and discuss next steps.
Authentication & Authorization
An introduction to authentication & authorization in the Google Ads API.
Web Flow with the OAuth Playground
A demo of Google Ads API credentials setup for web applications, using the OAuth Playground.
Desktop Flow with the REST API
In this episode, we’ll demystify OAuth with the Google Ads API and demonstrate how you can complete the entire OAuth process and make an API request using the Desktop App flow with the REST API in under 20 seconds. We’ll also share some useful scripts to quickly generate access tokens and perform searchStream requests.
In this video, we cover some best practices for working with authentication and authorization.
GAQL
Intro to Reporting & the Google Ads Query Language
An introduction to reporting with the Google Ads API.
GAQL Query Structure & Grammar
As a primer to using the Google Ads Query Language, or GAQL, this episode will cover the basic query structure, syntax, and grammar you need to know in order to begin writing queries to perform reporting requests using the Google Ads API.
Segmentation in the Google Ads Query Language
In the Google Ads Query Language, segmenting a reporting query can serve numerous purposes including data selection and providing implicit GROUP BY functionality. In this episode we’ll describe the effects of adding segments to your GAQL queries.
GoogleAdsRow and the Google Ads Query Language
GoogleAdsRow is the struct returned from reporting requests in the Google Ads API. In this episode, we’ll discuss what a GoogleAdsRow is and how the values contained in a GoogleAdsRow struct are determined by a Google Ads Query Language query.
GetKeywordStats Coding Example
This video walks through the process of writing the GetKeywordStats example.
GoogleAdsFieldService and the Google Ads Query Language - Retrieving Field Metadata
The GoogleAdsFieldService is a powerful resource for discovering field metadata to construct Google Ads Query Language strings. In this episode, we’ll demonstrate how to get started with the GoogleAdsFieldService, determine available resources to use in the FROM clause of a GAQL query, and fetch the fields that are available to use in a GAQL query based on the resource you choose to insert into a query’s FROM clause. In future episodes, we will further demonstrate how to use the GoogleAdsField service to become a GAQL power user.
The GoogleAdsFieldService - Fields and Clauses in the Google Ads Query Language
Building on the “GoogleAdsFieldService and the Google Ads Query Language - Retrieving Field Metadata" video, this episode will demonstrate how to use the GoogleAdsFieldService to determine which available fields, segments, and metrics can be used in which clauses of a GAQL query string. Follow along as we demonstrate how to use the SELECTABLE, SORTABLE, and FILTERABLE keywords to programmatically generate reporting queries.
GAQL Query Validation: Field Compatibility
In this episode, we’ll explore field compatibility in the Google Ads Query Language and explain why certain segments, metrics, and resources can or cannot be present in the same GAQL query. This episode builds upon prior episodes in the GAQL playlist to demonstrate how to use the GoogleAdsFieldService to determine which fields are selectable with each other. We’ll then flip our attention to the Google Ads Query Builder, an interactive, browser-based tool in the Google Ads API documentation site, and explain how to use this tool to easily determine field compatibility and build GAQL queries.
REST API
In this video, we’ll provide an introduction to using the REST interface of the Google Ads API. Topics include: transport choices of REST versus gRPC, necessary credentials, API design including resource naming hierarchy, and using cURL with the Google Ads API.
In this video, we’ll get an overview of authorization with REST. We’ll then see how to generate an access token with REST and use that access token to authenticate to the Google Ads REST API.
In this video, we’ll look at the differences between the SearchStream and Search methods, and walk through a demo of using each of these methods over REST.
Best Practices
Retrieving Information Efficiently
How to retrieve information efficiently using the Google Ads API. Covers the differences between SearchStream, Search and Get including practical advice on when to use each method. The video also explains how the API caches results and how you can retrieve rows in reverse.
Mutating Information Efficiently
In episode 2 of the Google Ads API Best Practices Series, we discuss how to mutate information efficiently using the Google Ads API. This video contrasts per service mutates versus the GoogleAdsService, grouping and ungrouping operations, and how to ensure there are no orphaned entities.
Advanced Information Retrieval
In episode 3 of the Google Ads API Best Practices Series, we discuss advanced techniques in retrieving information such as using optimal WHERE clauses and filtering unneeded data that can bloat responses. We also contrast the AdWords API means of retrieving information.
Account Change History
Explore the two major parts of the Change History feature in the Google Ads API. Learn about what you need to consider before using Change Status and Change Event.
Explore the Change Status feature in the Google Ads API. Learn about how page through status changes to examine your account's history.
Optimization Score & Recommendations
A high-level presentation of all the main concepts of Optimization Score and Recommendations for a smooth integration using the Google Ads API.
A presentation of all the technical details for a smooth integration with the Optimization Score using the Google Ads API.
A presentation of all the technical details for a smooth integration when retrieving recommendations using the Google Ads API.
A presentation of all the technical details for a smooth integration when taking actions based on recommendations using the Google Ads API.
Recommendations: Apply Parameters
Follow along as we demonstrate how to apply recommendations using the Google Ads API.
Recommendations: Take Actions In Bulk
Follow along as we demonstrate how to take actions on recommendations in bulk using the Google Ads API and discuss common pitfalls and errors.
Follow along as we discuss how to handle errors and test recommendations when developing your applications with the Google Ads API.
We summarize many of the best practices from previous episodes and introduce some new integration considerations.
Smart Bidding
An introduction to Smart Bidding, including an overview of what Smart Bidding is and why it’s important, as well as a brief example of how to set up a basic Smart Bidding strategy.
MaximizeConversions & MaximizeConversionValue
An overview of two key Smart Bidding Strategy types, MaximizeConversions and MaximizeConversionValue, and the different ways that they can be applied to campaigns.
Logging & Monitoring
In this introductory video, we discuss some of the benefits and considerations around implementing logging and monitoring for your Google Ads API integration.
Logging & Monitoring in the Cloud
In this video, we bring our foundational understanding of logging and monitoring to new heights to see what a cloud-based solution could look like for your Google Ads API integration.
Sending Client Logs to Google Cloud
In this episode, we log some custom data to Google Cloud Logging. We walk through a Python example which uses a custom gRPC interceptor to extract request and response data, as well as some metadata like success status and elapsed time, into custom logs. We then send those logs to the cloud using the Google Cloud Logging API.