Skip to content

Commit 0e120f4

Browse files
BenRKarlBenRKarl
authored
Changes for release v1_0. (#42)
1 parent 65449c6 commit 0e120f4

File tree

1,309 files changed

+153136
-199
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

1,309 files changed

+153136
-199
lines changed

‎ChangeLog‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,9 @@
1+
* 1.0.0:
2+
- Google Ads v1_0 release.
3+
- Move examples out of v0 directory.
4+
- Add dismiss_recommendations example.
5+
- Add get_hotel_ads_performance example.
6+
17
* 0.7.0:
28
- Google Ads v0_7 release.
39
- Address inconsistent exception handling in Exception and Logging

‎README.rst‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -70,6 +70,24 @@ retrieve the corresponding service client instance:
7070
7171
google_ads_service = client.get_service('GoogleAdsService')
7272
73+
API versioning
74+
################################
75+
With the release of Google Ads API v1_0 it's now possible to specify an API
76+
version when getting services and types. The ``get_service`` and ``get_type``
77+
client methods accept a second named parameter, ``version`` that refers to a
78+
valid API version. For example, to request an instance of the
79+
``GoogleAdsService`` that uses Google Ads API version ``v0`` use the
80+
following:
81+
82+
.. code-block:: python
83+
84+
google_ads_service = client.get_service('GoogleAdsService', version='v0')
85+
86+
The currently available list of versions is:
87+
88+
* ``'v0'``
89+
* ``'v1'``
90+
7391
Enabling and Configuring logging
7492
################################
7593
The library uses Python's built in logging framework. You can specify your

examples/v0/__init__.py renamed to examples/account_management/__init__.py

File renamed without changes.

examples/v0/account_management/create_customer.py renamed to examples/account_management/create_customer.py

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -30,8 +30,8 @@
3030

3131

3232
def main(client, manager_customer_id):
33-
customer_service = client.get_service('CustomerService')
34-
customer = client.get_type('Customer')
33+
customer_service = client.get_service('CustomerService', version='v1')
34+
customer = client.get_type('Customer', version='v1')
3535
today = datetime.today().strftime('%Y%m%d %H:%M:%S')
3636
customer.descriptive_name.value = ('Account created with '
3737
'CustomerService on %s' % today)

examples/v0/account_management/get_accessible_customers.py renamed to examples/account_management/get_accessible_customers.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@
2727

2828

2929
def main(client):
30-
customer_service = client.get_service('CustomerService')
30+
customer_service = client.get_service('CustomerService', version='v1')
3131

3232
try:
3333
accessible_customers = customer_service.list_accessible_customers()

examples/v0/account_management/get_account_changes.py renamed to examples/account_management/get_account_changes.py

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,7 @@ def resource_name_for_resource_type(resource_type, row):
5858

5959

6060
def main(client, customer_id):
61-
ads_service = client.get_service('GoogleAdsService')
61+
ads_service = client.get_service('GoogleAdsService', version='v1')
6262
query = ('SELECT change_status.resource_name, '
6363
'change_status.last_change_date_time, '
6464
'change_status.resource_type, '
@@ -75,10 +75,10 @@ def main(client, customer_id):
7575
response = ads_service.search(customer_id, query=query,
7676
page_size=ADS_PAGE_SIZE)
7777

78-
resource_type_enum = (client.get_type('ChangeStatusResourceTypeEnum')
79-
.ChangeStatusResourceType)
80-
change_status_operation_enum = (client.get_type('ChangeStatusOperationEnum')
81-
.ChangeStatusOperation)
78+
resource_type_enum = (client.get_type(
79+
'ChangeStatusResourceTypeEnum', version='v1').ChangeStatusResourceType)
80+
change_status_operation_enum = (client.get_type(
81+
'ChangeStatusOperationEnum', version='v1').ChangeStatusOperation)
8282

8383
try:
8484
for row in response:

examples/v0/account_management/get_account_information.py renamed to examples/account_management/get_account_information.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@
2626

2727

2828
def main(client, customer_id):
29-
customer_service = client.get_service('CustomerService')
29+
customer_service = client.get_service('CustomerService', version='v1')
3030

3131
resource_name = customer_service.customer_path(customer_id)
3232

examples/v0/account_management/__init__.py renamed to examples/advanced_operations/__init__.py

File renamed without changes.

examples/v0/advanced_operations/add_ad_group_bid_modifiers.py renamed to examples/advanced_operations/add_ad_group_bid_modifiers.py

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -26,8 +26,9 @@
2626

2727

2828
def main(client, customer_id, ad_group_id, bid_modifier_value):
29-
ad_group_service = client.get_service('AdGroupService')
30-
ad_group_bm_service = client.get_service('AdGroupBidModifierService')
29+
ad_group_service = client.get_service('AdGroupService', version='v1')
30+
ad_group_bm_service = client.get_service('AdGroupBidModifierService',
31+
version='v1')
3132

3233
# Create ad group bid modifier for mobile devices with the specified ad
3334
# group ID and bid modifier value.
@@ -43,7 +44,8 @@ def main(client, customer_id, ad_group_id, bid_modifier_value):
4344
ad_group_bid_modifier.bid_modifier.value = bid_modifier_value
4445

4546
# Sets the device.
46-
ad_group_bid_modifier.device.type = client.get_type('DeviceEnum').MOBILE
47+
ad_group_bid_modifier.device.type = client.get_type('DeviceEnum',
48+
version='v1').MOBILE
4749

4850
# Add the ad group bid modifier.
4951
try:

examples/v0/advanced_operations/add_expanded_text_ad_with_upgraded_urls.py renamed to examples/advanced_operations/add_expanded_text_ad_with_upgraded_urls.py

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -23,15 +23,16 @@
2323

2424

2525
def main(client, customer_id, ad_group_id):
26-
ad_group_ad_service = client.get_service('AdGroupAdService')
27-
ad_group_service = client.get_service('AdGroupService')
26+
ad_group_ad_service = client.get_service('AdGroupAdService', version='v1')
27+
ad_group_service = client.get_service('AdGroupService', version='v1')
2828

2929
# Create ad group ad.
30-
ad_group_ad_operation = client.get_type('AdGroupAdOperation')
30+
ad_group_ad_operation = client.get_type('AdGroupAdOperation', version='v1')
3131
ad_group_ad = ad_group_ad_operation.create
3232
ad_group_ad.ad_group.value = ad_group_service.ad_group_path(
3333
customer_id, ad_group_id)
34-
ad_group_ad.status = client.get_type('AdGroupAdStatusEnum').PAUSED
34+
ad_group_ad.status = client.get_type('AdGroupAdStatusEnum',
35+
version='v1').PAUSED
3536

3637
# Set expanded text ad info
3738
final_url = ad_group_ad.ad.final_urls.add()

0 commit comments

Comments
 (0)