Video Catalog

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 v17

Find out about the changes introduced in Google Ads API v17.

Release of v16

Find out about the changes introduced in Google Ads API v16.

Authentication & Authorization

Introduction

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.

Best Practices

In this video, we cover some best practices for working with authentication and authorization.

Performance Max

Introduction

An introduction to Performance Max campaigns with the Google Ads API.

Assets

How to work with assets in Performance Max campaigns.

Campaign Budget & Campaign

How to create a campaign budget and campaign for Performance Max.

Retail

Performance Max campaigns for online sales with a product feed.

Asset Groups

How to create asset groups for Performance Max campaigns.

Listing Group Filters

How to set up listing group filters with Performance Max retail campaigns.

Asset Group Assets

How to link assets to asset groups in Performance Max campaigns.

Campaign Conversion Goals

How to add campaign conversion goals to Performance Max campaigns.

Enhanced Conversions for Web

Introduction to Enhanced Conversions for Web

What enhanced conversions for web are, why they're useful, and what prerequisites you need to implement before you can upload your enhanced conversions for web to the Google Ads API.

Enhanced Conversions for Web Usage Flow

High level usage flow for enhanced conversions for web in the Google Ads API.

Enhanced Conversions for Web Code Example

Code example for enhanced conversions for web in the Google Ads API, with requirements and best practices highlighted.

Enhanced Conversions for Leads

Introduction to Enhanced Conversions for Leads

What enhanced conversions for leads are, why they're useful, and what prerequisites you need to implement before you can upload your enhanced conversions for leads to the Google Ads API.

Enhanced Conversions for Leads Usage Flow

Learn about the high-level usage flow for enhanced conversions for leads in the Google Ads API.

Enhanced Conversions for Leads Code Example

Code example for enhanced conversions for leads in the Google Ads API, with requirements and best practices highlighted.

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.

GAQL Query Validation: SELECT Requirement

In 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 Validation

In this episode, we'll explain validation rules in GAQL as it relates to including date ranges in a query.

GAQL Filtering Conditions

Adding 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 Queries

In 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

Introduction

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.

Authorization with REST

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.

SearchStream & Search

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

The Basics

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.

Change Status

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

Overview

A 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 Score

A presentation of all the technical details for a smooth integration with the Optimization Score using the Google Ads API.

Deep Dive: Recommendations

A presentation of all the technical details for a smooth integration when retrieving recommendations using the Google Ads API.

Recommendations: Take Actions

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.

Error Handling & Testing

Follow along as we discuss how to handle errors and test recommendations when developing your applications with the Google Ads API.

Best Practices

We summarize many of the best practices from previous episodes and introduce some new integration considerations.

Smart Bidding

Overview & Getting Started

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

Introduction

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.

Creating and Monitoring Custom Metrics

In 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 Testing

This video gives an introduction to the Google Ads test account and its alternatives.

Testing in Practice

This 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 Practices

This video walks through some best practices for testing your integration.

Migration Workshop 2021

Welcome

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.

What's New

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.

Credentials & Account Access

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.

Flexible Reporting

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.

The Ultimate GAQL Workshop

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.

A Simple Model for Mutates

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.

Best Practices

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.

Creating a Migration Plan

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.

Migration Panel

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.

Trivia

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.

Event Closing

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.