Adding Ad Exchange Seller REST API samples.
diff --git a/samples/adexchangeseller/README b/samples/adexchangeseller/README
new file mode 100644
index 0000000..c224a39
--- /dev/null
+++ b/samples/adexchangeseller/README
@@ -0,0 +1,5 @@
+A collection of command-line samples for the Ad Exchange Seller REST API.
+
+api: adexchangeseller
+keywords: cmdline
+author: Sérgio Gomes (sgomes@google.com)
diff --git a/samples/adexchangeseller/client_secrets.json b/samples/adexchangeseller/client_secrets.json
new file mode 100644
index 0000000..323ffd0
--- /dev/null
+++ b/samples/adexchangeseller/client_secrets.json
@@ -0,0 +1,9 @@
+{
+ "installed": {
+ "client_id": "[[INSERT CLIENT ID HERE]]",
+ "client_secret": "[[INSERT CLIENT SECRET HERE]]",
+ "redirect_uris": [],
+ "auth_uri": "https://accounts.google.com/o/oauth2/auth",
+ "token_uri": "https://accounts.google.com/o/oauth2/token"
+ }
+}
diff --git a/samples/adexchangeseller/generate_report.py b/samples/adexchangeseller/generate_report.py
new file mode 100644
index 0000000..5ab8708
--- /dev/null
+++ b/samples/adexchangeseller/generate_report.py
@@ -0,0 +1,85 @@
+#!/usr/bin/python
+#
+# Copyright 2013 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.
+
+"""Retrieves a saved report, or a report for the specified ad client.
+
+To get ad clients, run get_all_ad_clients.py.
+
+Tags: reports.generate
+"""
+
+__author__ = 'sgomes@google.com (Sérgio Gomes)'
+
+import argparse
+import sys
+
+from apiclient import sample_tools
+from oauth2client import client
+
+# Declare command-line flags.
+argparser = argparse.ArgumentParser(add_help=False)
+argparser.add_argument(
+ '--ad_client_id',
+ help='The ID of the ad client for which to generate a report')
+argparser.add_argument(
+ '--report_id',
+ help='The ID of the saved report to generate')
+
+
+def main(argv):
+ # Authenticate and construct service.
+ service, flags = sample_tools.init(
+ argv, 'adexchangeseller', 'v1.1', __doc__, __file__, parents=[argparser],
+ scope='https://www.googleapis.com/auth/adexchange.seller.readonly')
+
+ # Process flags and read their values.
+ ad_client_id = flags.ad_client_id
+ saved_report_id = flags.report_id
+
+ try:
+ # Retrieve report.
+ if saved_report_id:
+ result = service.reports().saved().generate(
+ savedReportId=saved_report_id).execute()
+ elif ad_client_id:
+ result = service.reports().generate(
+ startDate='2011-01-01', endDate='2011-08-31',
+ filter=['AD_CLIENT_ID==' + ad_client_id],
+ metric=['PAGE_VIEWS', 'AD_REQUESTS', 'AD_REQUESTS_COVERAGE',
+ 'CLICKS', 'AD_REQUESTS_CTR', 'COST_PER_CLICK',
+ 'AD_REQUESTS_RPM', 'EARNINGS'],
+ dimension=['DATE'],
+ sort=['+DATE']).execute()
+ else:
+ argparser.print_help()
+ sys.exit(1)
+ # Display headers.
+ for header in result['headers']:
+ print '%25s' % header['name'],
+ print
+
+ # Display results.
+ for row in result['rows']:
+ for column in row:
+ print '%25s' % column,
+ print
+
+ except client.AccessTokenRefreshError:
+ print ('The credentials have been revoked or expired, please re-run the '
+ 'application to re-authorize')
+
+if __name__ == '__main__':
+ main(sys.argv)
diff --git a/samples/adexchangeseller/generate_report_with_paging.py b/samples/adexchangeseller/generate_report_with_paging.py
new file mode 100644
index 0000000..738fc02
--- /dev/null
+++ b/samples/adexchangeseller/generate_report_with_paging.py
@@ -0,0 +1,99 @@
+#!/usr/bin/python
+#
+# Copyright 2013 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.
+
+"""This example retrieves a report for the specified ad client.
+
+Please only use pagination if your application requires it due to memory or
+storage constraints.
+If you need to retrieve more than 5000 rows, please check generate_report.py, as
+due to current limitations you will not be able to use paging for large reports.
+To get ad clients, run get_all_ad_clients.py.
+
+Tags: reports.generate
+"""
+
+__author__ = 'sgomes@google.com (Sérgio Gomes)'
+
+import argparse
+import sys
+
+from apiclient import sample_tools
+from oauth2client import client
+
+MAX_PAGE_SIZE = 50
+# This is the maximum number of obtainable rows for paged reports.
+ROW_LIMIT = 5000
+
+# Declare command-line flags.
+argparser = argparse.ArgumentParser(add_help=False)
+argparser.add_argument('ad_client_id',
+ help='The ID of the ad client for which to generate a report')
+
+
+def main(argv):
+ # Authenticate and construct service.
+ service, flags = sample_tools.init(
+ argv, 'adexchangeseller', 'v1.1', __doc__, __file__, parents=[argparser],
+ scope='https://www.googleapis.com/auth/adexchange.seller.readonly')
+
+ ad_client_id = flags.ad_client_id
+
+ try:
+ # Retrieve report in pages and display data as we receive it.
+ start_index = 0
+ rows_to_obtain = MAX_PAGE_SIZE
+ while True:
+ result = service.reports().generate(
+ startDate='2011-01-01', endDate='2011-08-31',
+ filter=['AD_CLIENT_ID==' + ad_client_id],
+ metric=['PAGE_VIEWS', 'AD_REQUESTS', 'AD_REQUESTS_COVERAGE',
+ 'CLICKS', 'AD_REQUESTS_CTR', 'COST_PER_CLICK',
+ 'AD_REQUESTS_RPM', 'EARNINGS'],
+ dimension=['DATE'],
+ sort=['+DATE'],
+ startIndex=start_index,
+ maxResults=rows_to_obtain).execute()
+
+ # If this is the first page, display the headers.
+ if start_index == 0:
+ for header in result['headers']:
+ print '%25s' % header['name'],
+ print
+
+ # Display results for this page.
+ for row in result['rows']:
+ for column in row:
+ print '%25s' % column,
+ print
+
+ start_index += len(result['rows'])
+
+ # Check to see if we're going to go above the limit and get as many
+ # results as we can.
+ if start_index + MAX_PAGE_SIZE > ROW_LIMIT:
+ rows_to_obtain = ROW_LIMIT - start_index
+ if rows_to_obtain <= 0:
+ break
+
+ if (start_index >= int(result['totalMatchedRows'])):
+ break
+
+ except client.AccessTokenRefreshError:
+ print ('The credentials have been revoked or expired, please re-run the '
+ 'application to re-authorize')
+
+if __name__ == '__main__':
+ main(sys.argv)
diff --git a/samples/adexchangeseller/get_all_ad_clients.py b/samples/adexchangeseller/get_all_ad_clients.py
new file mode 100644
index 0000000..fbee719
--- /dev/null
+++ b/samples/adexchangeseller/get_all_ad_clients.py
@@ -0,0 +1,59 @@
+#!/usr/bin/python
+#
+# Copyright 2013 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.
+
+"""This example gets all ad clients for the logged in user's account.
+
+Tags: adclients.list
+"""
+
+__author__ = 'sgomes@google.com (Sérgio Gomes)'
+
+import sys
+
+from apiclient import sample_tools
+from oauth2client import client
+
+MAX_PAGE_SIZE = 50
+
+
+def main(argv):
+ # Authenticate and construct service.
+ service, flags = sample_tools.init(
+ argv, 'adexchangeseller', 'v1.1', __doc__, __file__, parents=[],
+ scope='https://www.googleapis.com/auth/adexchange.seller.readonly')
+
+ try:
+ # Retrieve ad client list in pages and display data as we receive it.
+ request = service.adclients().list(maxResults=MAX_PAGE_SIZE)
+
+ while request is not None:
+ result = request.execute()
+ ad_clients = result['items']
+ for ad_client in ad_clients:
+ print ('Ad client for product "%s" with ID "%s" was found. '
+ % (ad_client['productCode'], ad_client['id']))
+
+ print ('\tSupports reporting: %s' %
+ (ad_client['supportsReporting'] and 'Yes' or 'No'))
+
+ request = service.adclients().list_next(request, result)
+
+ except client.AccessTokenRefreshError:
+ print ('The credentials have been revoked or expired, please re-run the '
+ 'application to re-authorize')
+
+if __name__ == '__main__':
+ main(sys.argv)
diff --git a/samples/adexchangeseller/get_all_ad_units.py b/samples/adexchangeseller/get_all_ad_units.py
new file mode 100644
index 0000000..c439e95
--- /dev/null
+++ b/samples/adexchangeseller/get_all_ad_units.py
@@ -0,0 +1,67 @@
+#!/usr/bin/python
+#
+# Copyright 2013 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.
+
+"""This example gets all ad units in an ad client.
+
+To get ad clients, run get_all_ad_clients.py.
+
+Tags: adunits.list
+"""
+
+__author__ = 'sgomes@google.com (Sérgio Gomes)'
+
+import argparse
+import sys
+
+from apiclient import sample_tools
+from oauth2client import client
+
+# Declare command-line flags.
+argparser = argparse.ArgumentParser(add_help=False)
+argparser.add_argument('ad_client_id',
+ help='The ID of the ad client for which to generate a report')
+
+MAX_PAGE_SIZE = 50
+
+
+def main(argv):
+ # Authenticate and construct service.
+ service, flags = sample_tools.init(
+ argv, 'adexchangeseller', 'v1.1', __doc__, __file__, parents=[argparser],
+ scope='https://www.googleapis.com/auth/adexchange.seller.readonly')
+
+ ad_client_id = flags.ad_client_id
+
+ try:
+ # Retrieve ad unit list in pages and display data as we receive it.
+ request = service.adunits().list(adClientId=ad_client_id,
+ maxResults=MAX_PAGE_SIZE)
+
+ while request is not None:
+ result = request.execute()
+ ad_units = result['items']
+ for ad_unit in ad_units:
+ print ('Ad unit with code "%s", name "%s" and status "%s" was found. ' %
+ (ad_unit['code'], ad_unit['name'], ad_unit['status']))
+
+ request = service.adunits().list_next(request, result)
+
+ except client.AccessTokenRefreshError:
+ print ('The credentials have been revoked or expired, please re-run the '
+ 'application to re-authorize')
+
+if __name__ == '__main__':
+ main(sys.argv)
diff --git a/samples/adexchangeseller/get_all_ad_units_for_custom_channel.py b/samples/adexchangeseller/get_all_ad_units_for_custom_channel.py
new file mode 100644
index 0000000..061c6d3
--- /dev/null
+++ b/samples/adexchangeseller/get_all_ad_units_for_custom_channel.py
@@ -0,0 +1,72 @@
+#!/usr/bin/python
+#
+# Copyright 2013 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.
+
+"""This example gets all ad units corresponding to a specified custom channel.
+
+To get custom channels, run get_all_custom_channels.py.
+
+Tags: customchannels.adunits.list
+"""
+
+__author__ = 'sgomes@google.com (Sérgio Gomes)'
+
+import argparse
+import sys
+
+from apiclient import sample_tools
+from oauth2client import client
+
+# Declare command-line flags.
+argparser = argparse.ArgumentParser(add_help=False)
+argparser.add_argument('ad_client_id',
+ help='The ID of the ad client with the specified custom channel')
+argparser.add_argument('custom_channel_id',
+ help='The ID of the custom channel for which to get ad units')
+
+MAX_PAGE_SIZE = 50
+
+
+def main(argv):
+ # Authenticate and construct service.
+ service, flags = sample_tools.init(
+ argv, 'adexchangeseller', 'v1.1', __doc__, __file__, parents=[argparser],
+ scope='https://www.googleapis.com/auth/adexchange.seller.readonly')
+
+ # Process flags and read their values.
+ ad_client_id = flags.ad_client_id
+ custom_channel_id = flags.custom_channel_id
+
+ try:
+ # Retrieve ad unit list in pages and display data as we receive it.
+ request = service.customchannels().adunits().list(
+ adClientId=ad_client_id, customChannelId=custom_channel_id,
+ maxResults=MAX_PAGE_SIZE)
+
+ while request is not None:
+ result = request.execute()
+ ad_units = result['items']
+ for ad_unit in ad_units:
+ print ('Ad unit with code "%s", name "%s" and status "%s" was found. ' %
+ (ad_unit['code'], ad_unit['name'], ad_unit['status']))
+
+ request = service.adunits().list_next(request, result)
+
+ except client.AccessTokenRefreshError:
+ print ('The credentials have been revoked or expired, please re-run the '
+ 'application to re-authorize')
+
+if __name__ == '__main__':
+ main(sys.argv)
diff --git a/samples/adexchangeseller/get_all_alerts.py b/samples/adexchangeseller/get_all_alerts.py
new file mode 100644
index 0000000..b1af2cf
--- /dev/null
+++ b/samples/adexchangeseller/get_all_alerts.py
@@ -0,0 +1,55 @@
+#!/usr/bin/python
+#
+# Copyright 2013 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.
+
+"""Gets all alerts available for the logged in user's account.
+
+Tags: alerts.list
+"""
+
+__author__ = 'sgomes@google.com (Sérgio Gomes)'
+
+import argparse
+import sys
+
+from apiclient import sample_tools
+from oauth2client import client
+
+
+def main(argv):
+ # Authenticate and construct service.
+ service, flags = sample_tools.init(
+ argv, 'adexchangeseller', 'v1.1', __doc__, __file__, parents=[],
+ scope='https://www.googleapis.com/auth/adexchange.seller.readonly')
+
+ try:
+ # Retrieve alerts list in pages and display data as we receive it.
+ request = service.alerts().list()
+
+ if request is not None:
+ result = request.execute()
+ if 'items' in result:
+ alerts = result['items']
+ for alert in alerts:
+ print ('Alert id "%s" with severity "%s" and type "%s" was found. '
+ % (alert['id'], alert['severity'], alert['type']))
+ else:
+ print 'No alerts found!'
+ except client.AccessTokenRefreshError:
+ print ('The credentials have been revoked or expired, please re-run the '
+ 'application to re-authorize')
+
+if __name__ == '__main__':
+ main(sys.argv)
diff --git a/samples/adexchangeseller/get_all_custom_channels.py b/samples/adexchangeseller/get_all_custom_channels.py
new file mode 100644
index 0000000..ec19581
--- /dev/null
+++ b/samples/adexchangeseller/get_all_custom_channels.py
@@ -0,0 +1,79 @@
+#!/usr/bin/python
+#
+# Copyright 2013 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.
+
+"""This example gets all custom channels in an ad client.
+
+To get ad clients, run get_all_ad_clients.py.
+
+Tags: customchannels.list
+"""
+
+__author__ = 'sgomes@google.com (Sérgio Gomes)'
+
+import argparse
+import sys
+
+from apiclient import sample_tools
+from oauth2client import client
+
+# Declare command-line flags.
+argparser = argparse.ArgumentParser(add_help=False)
+argparser.add_argument('ad_client_id',
+ help='The ad client ID for which to get custom channels')
+
+MAX_PAGE_SIZE = 50
+
+
+def main(argv):
+ # Authenticate and construct service.
+ service, flags = sample_tools.init(
+ argv, 'adexchangeseller', 'v1.1', __doc__, __file__, parents=[argparser],
+ scope='https://www.googleapis.com/auth/adexchange.seller.readonly')
+
+ ad_client_id = flags.ad_client_id
+
+ try:
+ # Retrieve custom channel list in pages and display data as we receive it.
+ request = service.customchannels().list(adClientId=ad_client_id,
+ maxResults=MAX_PAGE_SIZE)
+
+ while request is not None:
+ result = request.execute()
+ custom_channels = result['items']
+ for custom_channel in custom_channels:
+ print ('Custom channel with id "%s" and name "%s" was found. '
+ % (custom_channel['id'], custom_channel['name']))
+
+ if 'targetingInfo' in custom_channel:
+ print ' Targeting info:'
+ targeting_info = custom_channel['targetingInfo']
+ if 'adsAppearOn' in targeting_info:
+ print ' Ads appear on: %s' % targeting_info['adsAppearOn']
+ if 'location' in targeting_info:
+ print ' Location: %s' % targeting_info['location']
+ if 'description' in targeting_info:
+ print ' Description: %s' % targeting_info['description']
+ if 'siteLanguage' in targeting_info:
+ print ' Site language: %s' % targeting_info['siteLanguage']
+
+ request = service.customchannels().list_next(request, result)
+
+ except client.AccessTokenRefreshError:
+ print ('The credentials have been revoked or expired, please re-run the '
+ 'application to re-authorize')
+
+if __name__ == '__main__':
+ main(sys.argv)
diff --git a/samples/adexchangeseller/get_all_custom_channels_for_ad_unit.py b/samples/adexchangeseller/get_all_custom_channels_for_ad_unit.py
new file mode 100644
index 0000000..421c596
--- /dev/null
+++ b/samples/adexchangeseller/get_all_custom_channels_for_ad_unit.py
@@ -0,0 +1,87 @@
+#!/usr/bin/python
+#
+# Copyright 2013 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.
+
+"""This example gets all custom channels an ad unit has been added to.
+
+To get ad clients, run get_all_ad_clients.py. To get ad units, run
+get_all_ad_units.py.
+
+Tags: customchannels.list
+"""
+
+__author__ = 'sgomes@google.com (Sérgio Gomes)'
+
+import argparse
+import sys
+
+from apiclient import sample_tools
+from oauth2client import client
+
+# Declare command-line flags.
+argparser = argparse.ArgumentParser(add_help=False)
+argparser.add_argument(
+ 'ad_client_id',
+ help='The ID of the ad client with the specified ad unit')
+argparser.add_argument(
+ 'ad_unit_id',
+ help='The ID of the ad unit for which to get custom channels')
+
+MAX_PAGE_SIZE = 50
+
+
+def main(argv):
+ # Authenticate and construct service.
+ service, flags = sample_tools.init(
+ argv, 'adexchangeseller', 'v1.1', __doc__, __file__, parents=[argparser],
+ scope='https://www.googleapis.com/auth/adexchange.seller.readonly')
+
+ # Process flags and read their values.
+ ad_client_id = flags.ad_client_id
+ ad_unit_id = flags.ad_unit_id
+
+ try:
+ # Retrieve custom channel list in pages and display data as we receive it.
+ request = service.adunits().customchannels().list(
+ adClientId=ad_client_id, adUnitId=ad_unit_id,
+ maxResults=MAX_PAGE_SIZE)
+
+ while request is not None:
+ result = request.execute()
+ custom_channels = result['items']
+ for custom_channel in custom_channels:
+ print ('Custom channel with code "%s" and name "%s" was found. '
+ % (custom_channel['code'], custom_channel['name']))
+
+ if 'targetingInfo' in custom_channel:
+ print ' Targeting info:'
+ targeting_info = custom_channel['targetingInfo']
+ if 'adsAppearOn' in targeting_info:
+ print ' Ads appear on: %s' % targeting_info['adsAppearOn']
+ if 'location' in targeting_info:
+ print ' Location: %s' % targeting_info['location']
+ if 'description' in targeting_info:
+ print ' Description: %s' % targeting_info['description']
+ if 'siteLanguage' in targeting_info:
+ print ' Site language: %s' % targeting_info['siteLanguage']
+
+ request = service.customchannels().list_next(request, result)
+
+ except client.AccessTokenRefreshError:
+ print ('The credentials have been revoked or expired, please re-run the '
+ 'application to re-authorize')
+
+if __name__ == '__main__':
+ main(sys.argv)
diff --git a/samples/adexchangeseller/get_all_dimensions.py b/samples/adexchangeseller/get_all_dimensions.py
new file mode 100644
index 0000000..f4468d6
--- /dev/null
+++ b/samples/adexchangeseller/get_all_dimensions.py
@@ -0,0 +1,55 @@
+#!/usr/bin/python
+#
+# Copyright 2013 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.
+
+"""Gets all dimensions available for the logged in user's account.
+
+Tags: metadata.dimensions.list
+"""
+
+__author__ = 'sgomes@google.com (Sérgio Gomes)'
+
+import argparse
+import sys
+
+from apiclient import sample_tools
+from oauth2client import client
+
+
+def main(argv):
+ # Authenticate and construct service.
+ service, flags = sample_tools.init(
+ argv, 'adexchangeseller', 'v1.1', __doc__, __file__, parents=[],
+ scope='https://www.googleapis.com/auth/adexchange.seller.readonly')
+
+ try:
+ # Retrieve metrics list in pages and display data as we receive it.
+ request = service.metadata().dimensions().list()
+
+ if request is not None:
+ result = request.execute()
+ if 'items' in result:
+ dimensions = result['items']
+ for dimension in dimensions:
+ print ('Dimension id "%s" for product(s): [%s] was found. '
+ % (dimension['id'], ', '.join(dimension['supportedProducts'])))
+ else:
+ print 'No dimensions found!'
+ except client.AccessTokenRefreshError:
+ print ('The credentials have been revoked or expired, please re-run the '
+ 'application to re-authorize')
+
+if __name__ == '__main__':
+ main(sys.argv)
diff --git a/samples/adexchangeseller/get_all_metrics.py b/samples/adexchangeseller/get_all_metrics.py
new file mode 100644
index 0000000..e575724
--- /dev/null
+++ b/samples/adexchangeseller/get_all_metrics.py
@@ -0,0 +1,55 @@
+#!/usr/bin/python
+#
+# Copyright 2013 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.
+
+"""Gets all metrics available for the logged in user's account.
+
+Tags: metadata.metrics.list
+"""
+
+__author__ = 'sgomes@google.com (Sérgio Gomes)'
+
+import argparse
+import sys
+
+from apiclient import sample_tools
+from oauth2client import client
+
+
+def main(argv):
+ # Authenticate and construct service.
+ service, flags = sample_tools.init(
+ argv, 'adexchangeseller', 'v1.1', __doc__, __file__, parents=[],
+ scope='https://www.googleapis.com/auth/adexchange.seller.readonly')
+
+ try:
+ # Retrieve metrics list in pages and display data as we receive it.
+ request = service.metadata().metrics().list()
+
+ if request is not None:
+ result = request.execute()
+ if 'items' in result:
+ metrics = result['items']
+ for metric in metrics:
+ print ('Metric id "%s" for product(s): [%s] was found. '
+ % (metric['id'], ', '.join(metric['supportedProducts'])))
+ else:
+ print 'No metrics found!'
+ except client.AccessTokenRefreshError:
+ print ('The credentials have been revoked or expired, please re-run the '
+ 'application to re-authorize')
+
+if __name__ == '__main__':
+ main(sys.argv)
diff --git a/samples/adexchangeseller/get_all_preferred_deals.py b/samples/adexchangeseller/get_all_preferred_deals.py
new file mode 100644
index 0000000..8217d47
--- /dev/null
+++ b/samples/adexchangeseller/get_all_preferred_deals.py
@@ -0,0 +1,63 @@
+#!/usr/bin/python
+#
+# Copyright 2013 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.
+
+"""Gets all preferred deals for the logged in user's account.
+
+Tags: preferreddeals.list
+"""
+
+__author__ = 'sgomes@google.com (Sérgio Gomes)'
+
+import argparse
+import sys
+
+from apiclient import sample_tools
+from oauth2client import client
+
+
+def main(argv):
+ # Authenticate and construct service.
+ service, flags = sample_tools.init(
+ argv, 'adexchangeseller', 'v1.1', __doc__, __file__, parents=[],
+ scope='https://www.googleapis.com/auth/adexchange.seller.readonly')
+
+ try:
+ # Retrieve preferred deals list in pages and display data as we receive it.
+ request = service.preferreddeals().list()
+
+ if request is not None:
+ result = request.execute()
+ if 'items' in result:
+ deals = result['items']
+ for deal in deals:
+ output = 'Deal id "%s" ' % deal['id']
+
+ if 'advertiserName' in deal:
+ output += 'for advertiser "%s" ' % deal['advertiserName']
+
+ if 'buyerNetworkName' in deal:
+ output += 'on network "%s" ' % deal['buyerNetworkName']
+
+ output += 'was found.'
+ print(output)
+ else:
+ print 'No preferred deals found!'
+ except client.AccessTokenRefreshError:
+ print ('The credentials have been revoked or expired, please re-run the '
+ 'application to re-authorize')
+
+if __name__ == '__main__':
+ main(sys.argv)
diff --git a/samples/adexchangeseller/get_all_saved_reports.py b/samples/adexchangeseller/get_all_saved_reports.py
new file mode 100644
index 0000000..2a1b8f9
--- /dev/null
+++ b/samples/adexchangeseller/get_all_saved_reports.py
@@ -0,0 +1,57 @@
+#!/usr/bin/python
+#
+# Copyright 2013 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.
+
+"""This example gets all the saved reports for the logged
+in user's default account.
+
+Tags: savedreports.list
+"""
+
+__author__ = 'sgomes@google.com (Sérgio Gomes)'
+
+import sys
+
+from apiclient import sample_tools
+from oauth2client import client
+
+MAX_PAGE_SIZE = 50
+
+
+def main(argv):
+ # Authenticate and construct service.
+ service, flags = sample_tools.init(
+ argv, 'adexchangeseller', 'v1.1', __doc__, __file__, parents=[],
+ scope='https://www.googleapis.com/auth/adexchange.seller.readonly')
+
+ try:
+ # Retrieve ad client list in pages and display data as we receive it.
+ request = service.reports().saved().list(maxResults=MAX_PAGE_SIZE)
+
+ while request is not None:
+ result = request.execute()
+ saved_reports = result['items']
+ for saved_report in saved_reports:
+ print ('Saved report with ID "%s" and name "%s" was found.'
+ % (saved_report['id'], saved_report['name']))
+
+ request = service.reports().saved().list_next(request, result)
+
+ except client.AccessTokenRefreshError:
+ print ('The credentials have been revoked or expired, please re-run the '
+ 'application to re-authorize')
+
+if __name__ == '__main__':
+ main(sys.argv)
diff --git a/samples/adexchangeseller/get_all_url_channels.py b/samples/adexchangeseller/get_all_url_channels.py
new file mode 100644
index 0000000..e7fb5aa
--- /dev/null
+++ b/samples/adexchangeseller/get_all_url_channels.py
@@ -0,0 +1,68 @@
+#!/usr/bin/python
+#
+# Copyright 2013 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.
+
+"""This example gets all URL channels in an ad client.
+
+To get ad clients, run get_all_ad_clients.py.
+
+Tags: urlchannels.list
+"""
+
+__author__ = 'sgomes@google.com (Sérgio Gomes)'
+
+import argparse
+import sys
+
+from apiclient import sample_tools
+from oauth2client import client
+
+MAX_PAGE_SIZE = 50
+
+# Declare command-line flags.
+argparser = argparse.ArgumentParser(add_help=False)
+argparser.add_argument('ad_client_id',
+ help='The ad client ID for which to get URL channels')
+
+
+def main(argv):
+ # Authenticate and construct service.
+ service, flags = sample_tools.init(
+ argv, 'adexchangeseller', 'v1.1', __doc__, __file__, parents=[argparser],
+ scope='https://www.googleapis.com/auth/adexchange.seller.readonly')
+
+ ad_client_id = flags.ad_client_id
+
+ try:
+ # Retrieve URL channel list in pages and display data as we receive it.
+ request = service.urlchannels().list(adClientId=ad_client_id,
+ maxResults=MAX_PAGE_SIZE)
+
+ while request is not None:
+ result = request.execute()
+
+ url_channels = result['items']
+ for url_channel in url_channels:
+ print ('URL channel with URL pattern "%s" was found.'
+ % url_channel['urlPattern'])
+
+ request = service.customchannels().list_next(request, result)
+
+ except client.AccessTokenRefreshError:
+ print ('The credentials have been revoked or expired, please re-run the '
+ 'application to re-authorize')
+
+if __name__ == '__main__':
+ main(sys.argv)