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
Release of v14Find out about the changes introduced in Google Ads API v14.
Release of v13Find out about the changes introduced in Google Ads API v13.
Release of v12Find out about the exciting new features available in the Google Ads API v12.
Authentication & Authorization
IntroductionAn introduction to authentication & authorization in the Google Ads API.
Web Flow with the OAuth PlaygroundA demo of Google Ads API credentials setup for web applications, using the OAuth Playground.
Desktop Flow with the REST APIIn 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.
Best PracticesIn this video, we cover some best practices for working with authentication and authorization.
Performance Max
IntroductionAn introduction to Performance Max campaigns with the Google Ads API.
AssetsHow to work with assets in Performance Max campaigns.
Campaign Budget & CampaignHow to create a campaign budget and campaign for Performance Max.
RetailPerformance Max campaigns for online sales with a product feed.
Asset GroupsHow to create asset groups for Performance Max campaigns.
Listing Group FiltersHow to set up listing group filters with Performance Max retail campaigns.
Asset Group AssetsHow to link assets to asset groups in Performance Max campaigns.
Campaign Conversion GoalsHow to add campaign conversion goals to Performance Max campaigns.
GAQL
Intro to Reporting & the Google Ads Query LanguageAn introduction to reporting with the Google Ads API.
GAQL Query Structure & GrammarAs 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 LanguageIn 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 LanguageGoogleAdsRow 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 ExampleThis video walks through the process of writing the GetKeywordStats example.
GoogleAdsFieldService and the Google Ads Query Language - Retrieving Field MetadataThe 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 LanguageBuilding 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 CompatibilityIn 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.
GAQL Query Validation: SELECT RequirementIn this episode, we'll explain validation rules in GAQL as it relates to adding certain fields to the WHERE and ORDER BY clauses, which must first be added to the SELECT clause.
GAQL Query Validation: Date Range ValidationIn this episode, we'll explain validation rules in GAQL as it relates to including date ranges in a query.
GAQL Filtering ConditionsAdding filtering conditions to the WHERE clause of a GAQL query is an effective way to narrow a result set. In this episode, we'll discuss the components of a filtering condition and walk through a couple of examples using the Google Ads Query Builder.
Validating GAQL QueriesIn the final episode in our series about the GAQL, we review what we've learned throughout the series by fixing several erroneous queries with the Google Ads Query Validator.
REST API
IntroductionIn 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.
Authorization with RESTIn 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.
SearchStream & SearchIn 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 EfficientlyHow 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 EfficientlyIn 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 RetrievalIn 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
The BasicsExplore 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.
Change StatusExplore 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
OverviewA high-level presentation of all the main concepts of Optimization Score and Recommendations for a smooth integration using the Google Ads API.
Deep Dive: Optimization ScoreA presentation of all the technical details for a smooth integration with the Optimization Score using the Google Ads API.
Deep Dive: RecommendationsA presentation of all the technical details for a smooth integration when retrieving recommendations using the Google Ads API.
Recommendations: Take ActionsA presentation of all the technical details for a smooth integration when taking actions based on recommendations using the Google Ads API.
Recommendations: Apply ParametersFollow along as we demonstrate how to apply recommendations using the Google Ads API.
Recommendations: Take Actions In BulkFollow along as we demonstrate how to take actions on recommendations in bulk using the Google Ads API and discuss common pitfalls and errors.
Error Handling & TestingFollow along as we discuss how to handle errors and test recommendations when developing your applications with the Google Ads API.
Best PracticesWe summarize many of the best practices from previous episodes and introduce some new integration considerations.
Smart Bidding
Overview & Getting StartedAn 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 & MaximizeConversionValueAn overview of two key Smart Bidding Strategy types, MaximizeConversions and MaximizeConversionValue, and the different ways that they can be applied to campaigns.
Logging & Monitoring
IntroductionIn 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 CloudIn 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 CloudIn 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.
Creating and Monitoring Custom MetricsIn this episode, we build custom metrics on top of our logs in Google Cloud Logging, and set up a dashboard to monitor our new metrics. We also see how you can use Google Cloud Monitoring to set up alerts to notify you when your metrics aren't where you want them to be.
Integration Testing
Introduction to TestingThis video gives an introduction to the Google Ads test account and its alternatives.
Testing in PracticeThis video walks through some examples of testing in practice. Specifically, we create a test manager and client account, configure our API credentials to send requests to the test client account, create a campaign in our test account, and finally query our test account to list its campaigns.
Testing Best PracticesThis video walks through some best practices for testing your integration.
Migration Workshop 2021
WelcomeWelcome 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.
What's NewThe 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 ExtensionsAs 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.
Credentials & Account AccessFollow 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.
Flexible ReportingReporting 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.
The Ultimate GAQL WorkshopBuilding 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.
A Simple Model for MutatesThe 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.
Best PracticesIn this session, we'll walk through best practices to optimize performance, streamline developer workflows, and get the most out of the Google Ads API.
Creating a Migration PlanMigrating 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.
Migration PanelIn 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.
TriviaWe'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.
Event ClosingThank 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.