AdWords v201502 release.

Author: msaniscalchi

ChangeLog

@@ -1,3 +1,13 @@
+3.2.0 - 3/12/2015
+* Added support for v201502 of the AdWords Client Library.
+* Removed CampaignAdExtensionService (from v201502).
+* Added AccountLabelService (to v201502)
+* Added hard feed types examples, moved to new "extensions" examples.
+* Added example for shared sets.
+* Minor fixes to reporting examples.
+* Updated some existing samples for new API version.
+* DFP clients now require you to set an application name.
+
 3.1.1 - 2/25/2015
 * Added new example for migrating to Upgraded URLS.
 * Updated examples to reference final URLs.

examples/adwords/v201406/reporting/download_criteria_report_as_stream.py

@@ -62,7 +62,7 @@ def main(client):
 
   try:
     while True:
-      chunk = stream_data.read(adwords._CHUNK_SIZE)
+      chunk = stream_data.read(adwords.CHUNK_SIZE)
       if not chunk: break
       report_data.write(chunk.decode() if sys.version_info[0] == 3
                         and getattr(report_data, 'mode', 'w') == 'w' else chunk)

examples/adwords/v201406/reporting/download_criteria_report_as_stream_with_awql.py

@@ -63,7 +63,7 @@ def main(client):
 
   try:
     while True:
-      chunk = stream_data.read(adwords._CHUNK_SIZE)
+      chunk = stream_data.read(adwords.CHUNK_SIZE)
       if not chunk: break
       report_data.write(chunk.decode() if sys.version_info[0] == 3
                         and getattr(report_data, 'mode', 'w') == 'w' else chunk)

examples/adwords/v201409/account_management/create_account.py

@@ -16,7 +16,7 @@
 
 """This example illustrates how to create an account.
 
-Note by default this account will only be accessible via parent MCC.
+By default this account will only be accessible via parent MCC.
 
 The LoadFromStorage method is pulling credentials and properties from a
 "googleads.yaml" file. By default, it looks for this file in your home

examples/adwords/v201409/advanced_operations/update_site_links.py

@@ -0,0 +1,15 @@
+# Copyright 2015 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Extension examples."""

examples/adwords/v201409/extensions/__init__.py

@@ -45,6 +45,14 @@
 # "https://www.google.com/local/add".
 GMB_ACCESS_TOKEN = 'INSERT_GMB_OAUTH_ACCESS_TOKEN_HERE'
 
+# If the gmb_email_address above is for a GMB manager instead of
+# the GMB account owner, then set business_account_identifier to the
+# +Page ID of a location for which the manager has access. See the
+# location extensions guide at
+# https://developers.google.com/adwords/api/docs/guides/feed-services-locations
+# for details.
+BUSINESS_ACCOUNT_IDENTIFIER = None
+
 # The placeholder type for location extensions.
 # See the Placeholder reference page for a list of all the placeholder types
 # and fields:
@@ -56,18 +64,19 @@
 MAX_CUSTOMER_FEED_ADD_ATTEMPTS = 10
 
 
-def main(client, gmb_email_address, gmb_access_token):
+def main(client, gmb_email_address, gmb_access_token,
+         business_account_identifier=None):
   # Create a feed that will sync to the Google Places account specified by
   # gmb_email_address. Do not add FeedAttributes to this object,
   # as AdWords will add them automatically because this will be a
   # system generated feed.
   feed = {
-      'name': 'Places feed #%s' % uuid.uuid4(),
+      'name': 'GMB feed #%s' % uuid.uuid4(),
       'systemFeedGenerationData': {
           'xsi_type': 'PlacesLocationFeedData',
           'oAuthInfo': {
               'httpMethod': 'GET',
-              'httpRequestUrl': 'https://www.google.com/local/add',
+              'httpRequestUrl': 'https://www.googleapis.com/auth/adwords',
               'httpAuthorizationHeader': 'Bearer %s' % gmb_access_token
           },
           'emailAddress': gmb_email_address,
@@ -77,6 +86,12 @@ def main(client, gmb_email_address, gmb_access_token):
       'origin': 'ADWORDS'
   }
 
+  # Only include the business_account_identifier if it's specified.
+  if business_account_identifier:
+    feed['systemFeedGenerationData']['businessAccountIdentifier'] = (
+        business_account_identifier
+    )
+
   # Create an operation to add the feed.
   gmb_operations = [{
       'operator': 'ADD',
@@ -93,10 +108,11 @@ def main(client, gmb_email_address, gmb_access_token):
   customer_feed = {
       'feedId': added_feed['id'],
       'placeholderTypes': [PLACEHOLDER_LOCATION],
+      # Create a matching function that will always evaluate to True.
       'matchingFunction': {
           'operator': 'IDENTITY',
           'lhsOperand': {
-              'xsi_type': 'FunctionArgumentOperand',
+              'xsi_type': 'ConstantOperand',
               'type': 'BOOLEAN',
               'booleanValue': True
           }
@@ -123,6 +139,7 @@ def main(client, gmb_email_address, gmb_access_token):
       sleep_seconds = 2 ** i
       print ('Attempt %d to add the CustomerFeed was not successful.'
              'Waiting %d seconds before trying again.\n' % (i, sleep_seconds))
+
       time.sleep(sleep_seconds)
     i += 1
 
@@ -137,4 +154,5 @@ def main(client, gmb_email_address, gmb_access_token):
 if __name__ == '__main__':
   # Initialize client object.
   adwords_client = adwords.AdWordsClient.LoadFromStorage()
-  main(adwords_client, GMB_EMAIL_ADDRESS, GMB_ACCESS_TOKEN)
+  main(adwords_client, GMB_EMAIL_ADDRESS, GMB_ACCESS_TOKEN,
+       BUSINESS_ACCOUNT_IDENTIFIER)