An introduction to the new way of handling locations in Google AdWords. This is a brief explanation of the upcoming change that will integrate AdWords with Google My Business.

1. “Google My
Business” API
Managing your locations at scale

2. Agenda
● Introduction
● Google My Business (GMB)
● The GMB API
● GMB locations in AdWords

3. Introduction

4. Introduction
Why talk about GMB during AdWords workshops?

5. Why Talk About GMB?
Your locations
You
I want locations
extensions!
AdWords API
Maps API
I want my address /
my business showing
up in Maps!
I want my address
showing up in Search!
Search API
I want a Google+
presence for my
business! G+ API

6. Introduction / cont.Client changed address

7. Location Management in GMBL
● Locations exist once in reality, they should
also exist only once in our system
● Central repository: GMB Locations

8. Consequences for Developers
What does this mean for you?
● Use GMB (API) for creating locations
● Migrate locations from AdWords
(feeds / manual location extensions)
to GMB

9. Google My Business

10. Google My Business
Manage business presence across Google*
● Search
● Maps
● Google+
● AdWords
(location
extensions)
* Not available in some countries

11. GMB Locations
How to create business locations?
● Manual Creation
● Bulk Upload
● New: GMB API

12. GMB Locations / cont.
www.google.com/local/manage

13. Location Verification
Locations have to be verified for Search,
Maps, Google+
● Postcard
● Phone (limited)
● Instant verification (Webmaster Tools)
● Bulk verification (chains)
https://support.google.com/business/answer/2911778

14. Location Verification / cont.
Manual
Creation
Bulk
Upload
GMB
API
No verification necessary for AdWords!
GMB Locations (unverified) GMB Locations (verified)
Verification
(Postcard / Phone /
Instant / Bulk)

15. The GMB API

16. Goals
Enable Ads location extensions to source location information
from Google My Business instead of a feed
2014 - Upgraded Location Extensions
Enable developers to programmatically create and
manage business location information on Google
2015 - GMB API
Move all locations to Google My Business
2016 - Sunset of Manual LEs in AdWords

17. API Capabilities
● RESTful API, resources as JSON
● Client Libraries for Java, C#, PHP
● Create, Read, Update and Delete locations*
○ Name, Address, Phone
○ Categories, Hours, Website URL
○ Service area
○ Store code, Labels
* Delete only for un-verified locations

18. Get Access
● Fill out form @ goo.gl/o87cwB
(condition: currently more than 50 manual location
extensions)
● Once approved, check out
developers.google.com/my-business

19. Get Started
● Create a Google My Business account
www.google.com/local/manage

20. Get Started / cont.
● Create a project on Developers Console
console.developers.google.com
○ APIs & Auth → Enable GMB API

21. Get Started / cont.
● Add new OAuth 2.0 client ID

22. Get Started / cont.
● Submit project ID
(form link in GMB API welcome email)

23. Working with the
GMB API

24. Testing It Out
developers.google.com/oauthplayground
● Dev Console: Web Application, Authorize playground redirect URL
● Settings → Use own credentials → Enter Client ID
● Scope: https://www.googleapis.com/auth/plus.business.manage
● Request URI: https://mybusiness.googleapis.com/v1/accounts

25. Testing It Out - Set Credentials
● Settings → Use own credentials → Enter Client ID

26. Testing It Out - Authorize APIs
● Scope: https://www.googleapis.com/auth/plus.business.manage

27. Testing It Out - Retrieve accounts
● Request URI: https://mybusiness.googleapis.com/v1/accounts

28. Testing It Out - Retrieve locations
● Request URI: https://mybusiness.googleapis.com/v1/accounts/{id}
/locations

29. Let’s talk code

30. 1. Initialize GMB
// Initialize GMB.
Mybusiness gmb = new Mybusiness.Builder(httpTransport,
jsonFactory, credential)
.setApplicationName(APPLICATION_NAME)
.build();
// Get list of GMB accounts.
Mybusiness.Accounts.List listAccounts = gmb.accounts().list();
ListAccountsResponse response = listAccounts.execute();
List<Account> accounts = response.getAccounts();
// Select account to work with.
Account account = selectAccount(accounts);
Your implementation

31. 2. Create Location
// Create the location.
Location location = new Location();
// Set location properties.
location.setLocationName("My Company");
location.setWebsiteUrl("https://www.example.com");
...

32. 2. Create Location / cont.
// Create an address.
Address address = new Address();
// Set address properties.
address.setAddressLines(Collections.singletonList(
"1600 Amphitheatre Pkwy"));
address.setPostalCode("94043");
address.setLocality("Mountain View");
...
location.setAddress(address);

33. 2. Create Location / cont.
// Create business hours.
BusinessHours businessHours = new BusinessHours();
// Set timings.
TimePeriod period = new TimePeriod();
period.setOpenDay("Monday"); period.setOpenTime("9:00");
period.setCloseDay("Monday"); period.setCloseTime("17:00");
businessHours.setPeriods(Collections.singletonList(period));
location.setBusinessHours(businessHours);

34. 3. Apply Labels
● Labels are optional
○ Can be used for organizing locations
○ Can be used for filtering in AdWords
○ Recommendation: Use AdWords CIDs (see later)
location.setLabels(Collections.singletonList(CID));

35. 4. Send Creation Request
CreateLocationRequest createLocationRequest =
new CreateLocationRequest();
createLocationRequest.setLocation(location);
createLocationRequest.setLanguageCode("en-AU");
Mybusiness.Accounts.Locations.Create createLocation =
gmb.accounts()
.locations()
.create(account.getName(),createLocationRequest);
Location createdLocation = createLocation.execute();

36. Summary
Summary
1. Initialize GMB
Mybusiness gmb = ...;
2. Create location, address, hours
Location location = new Location();
Address address = new Address();
BusinessHours hours = new BusinessHours();
3. Apply Labels
location.setLabels(Arrays.asList(CID));
4. Send Creation Request
CreateLocationRequest createLocationRequest = ...

37. GMB locations in
AdWords

38. GMB account
Previously...
GMB locations
AdWords account
Campaign B
Mapped locations
(campaign)
CampaignFeed /
Matching Function
Campaign A
Mapped locations (customer)
CustomerFeed /
Matching Function
AdWords locations
GMB UI AdWords API
( )

39. GMB account
Now: One Repository
GMB locations
AdWords account
Campaign B
Mapped locations
(campaign)
CampaignFeed /
Matching Function
Campaign A
Mapped locations (customer)
CustomerFeed /
Matching Function
Available locations
Feed /
setLabelFilters(...)
GMB API

40. CampaignFeed campaignFeed = new CampaignFeed();
campaignFeed.setMatchingFunction(...);
CustomerFeed customerFeed = new CustomerFeed();
customerFeed.setMatchingFunction(...);
Feed gmbFeed = new Feed();
gmbFeed.setSystemFeedGenerationData(...);
Let’s Talk Code
Main Steps
1. Create a new feed linked to your GMB account
2. Associate the feed to the customer
3. Associate the feed to specific ad groups / campaigns
“Link” level filter
IDENTITY(true)
Enables location
extensions
Campaign level filter

41. Best Practice for Resellers
● If ...
○ … your client already has a GMB account
○ … you want to work with verified locations
⇒ Ask your client to add you as a GMB manager
● Preserves client’s location ownership
● Locations access through manager account
● In PlacesLocationFeedData, use your credentials
but specify client GMB ID when syncing to AdWords

42. Best Practice for Resellers / cont.
● If you only need GMB for AdWords
location extensions
⇒ Use GMB repository account for all locations
○ Create MCC-level GMB account (=repository)
○ Label locations with CIDs
○ Filter locations / feeds based on label in AdWords

43. … In Code
GMB API location.setLabels(Arrays.asList(CID));
AdWords API fd = new PlacesLocationFeedData();
fd.setLabelFilters(new String[]{CID});
Account: 1
Account: 2
Account: 3
GMB account
1
1
2
2
3

44. Location Extension Migration
Oct 2015
● GMB API available to AdWords
API users (>50 locations)
● Manual location extensions
deprecated
● March 31, 2016
● Creation of manual location
extension sunsets
● GMB API v2
● General availability
Q2 2016
● Auto-migration of any
locations left in AdWords
https://developers.google.com/adwords/api/docs/sunset-dates

45. Resources
GMB API https://developers.google.com/my-business
Signup https://goo.gl/o87cwB
GMBL UI https://www.google.com/local/manage
Guide https://goo.gl/kadl59