google-adwords-api 0.19.1 → 0.20.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (447) hide show
  1. checksums.yaml +4 -4
  2. data/COPYING +0 -0
  3. data/ChangeLog +4 -0
  4. data/README.md +3 -3
  5. data/adwords_api.yml +0 -0
  6. data/examples/v201603/campaign_management/add_draft.rb +0 -0
  7. data/examples/v201603/campaign_management/add_trial.rb +0 -0
  8. data/examples/v201603/campaign_management/graduate_trial.rb +0 -0
  9. data/examples/v201605/advanced_operations/add_responsive_display_ad.rb +8 -4
  10. data/examples/v201605/campaign_management/add_draft.rb +0 -0
  11. data/examples/v201605/campaign_management/add_trial.rb +0 -0
  12. data/examples/v201605/campaign_management/graduate_trial.rb +0 -0
  13. data/lib/adwords_api.rb +0 -0
  14. data/lib/adwords_api/api_config.rb +0 -86
  15. data/lib/adwords_api/batch_job_utils.rb +0 -3
  16. data/lib/adwords_api/credential_handler.rb +0 -0
  17. data/lib/adwords_api/errors.rb +0 -0
  18. data/lib/adwords_api/incremental_upload_helper.rb +0 -0
  19. data/lib/adwords_api/report_header_handler.rb +0 -0
  20. data/lib/adwords_api/report_stream.rb +0 -0
  21. data/lib/adwords_api/report_utils.rb +0 -0
  22. data/lib/adwords_api/utils.rb +0 -0
  23. data/lib/adwords_api/utils_reporter.rb +0 -0
  24. data/lib/adwords_api/v201601/account_label_service.rb +0 -0
  25. data/lib/adwords_api/v201601/account_label_service_registry.rb +0 -0
  26. data/lib/adwords_api/v201601/ad_customizer_feed_service.rb +0 -0
  27. data/lib/adwords_api/v201601/ad_customizer_feed_service_registry.rb +0 -0
  28. data/lib/adwords_api/v201601/ad_group_ad_service.rb +0 -0
  29. data/lib/adwords_api/v201601/ad_group_ad_service_registry.rb +0 -0
  30. data/lib/adwords_api/v201601/ad_group_bid_modifier_service.rb +0 -0
  31. data/lib/adwords_api/v201601/ad_group_bid_modifier_service_registry.rb +0 -0
  32. data/lib/adwords_api/v201601/ad_group_criterion_service.rb +0 -0
  33. data/lib/adwords_api/v201601/ad_group_criterion_service_registry.rb +0 -0
  34. data/lib/adwords_api/v201601/ad_group_extension_setting_service.rb +0 -0
  35. data/lib/adwords_api/v201601/ad_group_extension_setting_service_registry.rb +0 -0
  36. data/lib/adwords_api/v201601/ad_group_feed_service.rb +0 -0
  37. data/lib/adwords_api/v201601/ad_group_feed_service_registry.rb +0 -0
  38. data/lib/adwords_api/v201601/ad_group_service.rb +0 -0
  39. data/lib/adwords_api/v201601/ad_group_service_registry.rb +0 -0
  40. data/lib/adwords_api/v201601/ad_param_service.rb +0 -0
  41. data/lib/adwords_api/v201601/ad_param_service_registry.rb +0 -0
  42. data/lib/adwords_api/v201601/adwords_user_list_service.rb +0 -0
  43. data/lib/adwords_api/v201601/adwords_user_list_service_registry.rb +0 -0
  44. data/lib/adwords_api/v201601/batch_job_service.rb +0 -0
  45. data/lib/adwords_api/v201601/batch_job_service_registry.rb +0 -0
  46. data/lib/adwords_api/v201601/bidding_strategy_service.rb +0 -0
  47. data/lib/adwords_api/v201601/bidding_strategy_service_registry.rb +0 -0
  48. data/lib/adwords_api/v201601/budget_order_service.rb +0 -0
  49. data/lib/adwords_api/v201601/budget_order_service_registry.rb +0 -0
  50. data/lib/adwords_api/v201601/budget_service.rb +0 -0
  51. data/lib/adwords_api/v201601/budget_service_registry.rb +0 -0
  52. data/lib/adwords_api/v201601/campaign_criterion_service.rb +0 -0
  53. data/lib/adwords_api/v201601/campaign_criterion_service_registry.rb +0 -0
  54. data/lib/adwords_api/v201601/campaign_extension_setting_service.rb +0 -0
  55. data/lib/adwords_api/v201601/campaign_extension_setting_service_registry.rb +0 -0
  56. data/lib/adwords_api/v201601/campaign_feed_service.rb +0 -0
  57. data/lib/adwords_api/v201601/campaign_feed_service_registry.rb +0 -0
  58. data/lib/adwords_api/v201601/campaign_service.rb +0 -0
  59. data/lib/adwords_api/v201601/campaign_service_registry.rb +0 -0
  60. data/lib/adwords_api/v201601/campaign_shared_set_service.rb +0 -0
  61. data/lib/adwords_api/v201601/campaign_shared_set_service_registry.rb +0 -0
  62. data/lib/adwords_api/v201601/constant_data_service.rb +0 -0
  63. data/lib/adwords_api/v201601/constant_data_service_registry.rb +0 -0
  64. data/lib/adwords_api/v201601/conversion_tracker_service.rb +0 -0
  65. data/lib/adwords_api/v201601/conversion_tracker_service_registry.rb +0 -0
  66. data/lib/adwords_api/v201601/customer_extension_setting_service.rb +0 -0
  67. data/lib/adwords_api/v201601/customer_extension_setting_service_registry.rb +0 -0
  68. data/lib/adwords_api/v201601/customer_feed_service.rb +0 -0
  69. data/lib/adwords_api/v201601/customer_feed_service_registry.rb +0 -0
  70. data/lib/adwords_api/v201601/customer_service.rb +0 -0
  71. data/lib/adwords_api/v201601/customer_service_registry.rb +0 -0
  72. data/lib/adwords_api/v201601/customer_sync_service.rb +0 -0
  73. data/lib/adwords_api/v201601/customer_sync_service_registry.rb +0 -0
  74. data/lib/adwords_api/v201601/data_service.rb +0 -0
  75. data/lib/adwords_api/v201601/data_service_registry.rb +0 -0
  76. data/lib/adwords_api/v201601/experiment_service.rb +0 -0
  77. data/lib/adwords_api/v201601/experiment_service_registry.rb +0 -0
  78. data/lib/adwords_api/v201601/feed_item_service.rb +0 -0
  79. data/lib/adwords_api/v201601/feed_item_service_registry.rb +0 -0
  80. data/lib/adwords_api/v201601/feed_mapping_service.rb +0 -0
  81. data/lib/adwords_api/v201601/feed_mapping_service_registry.rb +0 -0
  82. data/lib/adwords_api/v201601/feed_service.rb +0 -0
  83. data/lib/adwords_api/v201601/feed_service_registry.rb +0 -0
  84. data/lib/adwords_api/v201601/label_service.rb +0 -0
  85. data/lib/adwords_api/v201601/label_service_registry.rb +0 -0
  86. data/lib/adwords_api/v201601/location_criterion_service.rb +0 -0
  87. data/lib/adwords_api/v201601/location_criterion_service_registry.rb +0 -0
  88. data/lib/adwords_api/v201601/managed_customer_service.rb +0 -0
  89. data/lib/adwords_api/v201601/managed_customer_service_registry.rb +0 -0
  90. data/lib/adwords_api/v201601/media_service.rb +0 -0
  91. data/lib/adwords_api/v201601/media_service_registry.rb +0 -0
  92. data/lib/adwords_api/v201601/mutate_job_service.rb +0 -0
  93. data/lib/adwords_api/v201601/mutate_job_service_registry.rb +0 -0
  94. data/lib/adwords_api/v201601/offline_conversion_feed_service.rb +0 -0
  95. data/lib/adwords_api/v201601/offline_conversion_feed_service_registry.rb +0 -0
  96. data/lib/adwords_api/v201601/report_definition_service.rb +0 -0
  97. data/lib/adwords_api/v201601/report_definition_service_registry.rb +0 -0
  98. data/lib/adwords_api/v201601/shared_criterion_service.rb +0 -0
  99. data/lib/adwords_api/v201601/shared_criterion_service_registry.rb +0 -0
  100. data/lib/adwords_api/v201601/shared_set_service.rb +0 -0
  101. data/lib/adwords_api/v201601/shared_set_service_registry.rb +0 -0
  102. data/lib/adwords_api/v201601/targeting_idea_service.rb +0 -0
  103. data/lib/adwords_api/v201601/targeting_idea_service_registry.rb +0 -0
  104. data/lib/adwords_api/v201601/traffic_estimator_service.rb +0 -0
  105. data/lib/adwords_api/v201601/traffic_estimator_service_registry.rb +0 -0
  106. data/lib/adwords_api/v201603/account_label_service.rb +0 -0
  107. data/lib/adwords_api/v201603/account_label_service_registry.rb +0 -0
  108. data/lib/adwords_api/v201603/ad_customizer_feed_service.rb +0 -0
  109. data/lib/adwords_api/v201603/ad_customizer_feed_service_registry.rb +0 -0
  110. data/lib/adwords_api/v201603/ad_group_ad_service.rb +0 -0
  111. data/lib/adwords_api/v201603/ad_group_ad_service_registry.rb +0 -0
  112. data/lib/adwords_api/v201603/ad_group_bid_modifier_service.rb +0 -0
  113. data/lib/adwords_api/v201603/ad_group_bid_modifier_service_registry.rb +0 -0
  114. data/lib/adwords_api/v201603/ad_group_criterion_service.rb +0 -0
  115. data/lib/adwords_api/v201603/ad_group_criterion_service_registry.rb +0 -0
  116. data/lib/adwords_api/v201603/ad_group_extension_setting_service.rb +0 -0
  117. data/lib/adwords_api/v201603/ad_group_extension_setting_service_registry.rb +0 -0
  118. data/lib/adwords_api/v201603/ad_group_feed_service.rb +0 -0
  119. data/lib/adwords_api/v201603/ad_group_feed_service_registry.rb +0 -0
  120. data/lib/adwords_api/v201603/ad_group_service.rb +0 -0
  121. data/lib/adwords_api/v201603/ad_group_service_registry.rb +0 -0
  122. data/lib/adwords_api/v201603/ad_param_service.rb +0 -0
  123. data/lib/adwords_api/v201603/ad_param_service_registry.rb +0 -0
  124. data/lib/adwords_api/v201603/adwords_user_list_service.rb +0 -0
  125. data/lib/adwords_api/v201603/adwords_user_list_service_registry.rb +0 -0
  126. data/lib/adwords_api/v201603/batch_job_service.rb +0 -0
  127. data/lib/adwords_api/v201603/batch_job_service_registry.rb +0 -0
  128. data/lib/adwords_api/v201603/bidding_strategy_service.rb +0 -0
  129. data/lib/adwords_api/v201603/bidding_strategy_service_registry.rb +0 -0
  130. data/lib/adwords_api/v201603/budget_order_service.rb +0 -0
  131. data/lib/adwords_api/v201603/budget_order_service_registry.rb +0 -0
  132. data/lib/adwords_api/v201603/budget_service.rb +0 -0
  133. data/lib/adwords_api/v201603/budget_service_registry.rb +0 -0
  134. data/lib/adwords_api/v201603/campaign_criterion_service.rb +0 -0
  135. data/lib/adwords_api/v201603/campaign_criterion_service_registry.rb +0 -0
  136. data/lib/adwords_api/v201603/campaign_extension_setting_service.rb +0 -0
  137. data/lib/adwords_api/v201603/campaign_extension_setting_service_registry.rb +0 -0
  138. data/lib/adwords_api/v201603/campaign_feed_service.rb +0 -0
  139. data/lib/adwords_api/v201603/campaign_feed_service_registry.rb +0 -0
  140. data/lib/adwords_api/v201603/campaign_service.rb +0 -0
  141. data/lib/adwords_api/v201603/campaign_service_registry.rb +0 -0
  142. data/lib/adwords_api/v201603/campaign_shared_set_service.rb +0 -0
  143. data/lib/adwords_api/v201603/campaign_shared_set_service_registry.rb +0 -0
  144. data/lib/adwords_api/v201603/constant_data_service.rb +0 -0
  145. data/lib/adwords_api/v201603/constant_data_service_registry.rb +0 -0
  146. data/lib/adwords_api/v201603/conversion_tracker_service.rb +0 -0
  147. data/lib/adwords_api/v201603/conversion_tracker_service_registry.rb +0 -0
  148. data/lib/adwords_api/v201603/customer_extension_setting_service.rb +0 -0
  149. data/lib/adwords_api/v201603/customer_extension_setting_service_registry.rb +0 -0
  150. data/lib/adwords_api/v201603/customer_feed_service.rb +0 -0
  151. data/lib/adwords_api/v201603/customer_feed_service_registry.rb +0 -0
  152. data/lib/adwords_api/v201603/customer_service.rb +0 -0
  153. data/lib/adwords_api/v201603/customer_service_registry.rb +0 -0
  154. data/lib/adwords_api/v201603/customer_sync_service.rb +0 -0
  155. data/lib/adwords_api/v201603/customer_sync_service_registry.rb +0 -0
  156. data/lib/adwords_api/v201603/data_service.rb +0 -0
  157. data/lib/adwords_api/v201603/data_service_registry.rb +0 -0
  158. data/lib/adwords_api/v201603/draft_async_error_service.rb +0 -0
  159. data/lib/adwords_api/v201603/draft_async_error_service_registry.rb +0 -0
  160. data/lib/adwords_api/v201603/draft_service.rb +0 -0
  161. data/lib/adwords_api/v201603/draft_service_registry.rb +0 -0
  162. data/lib/adwords_api/v201603/experiment_service.rb +0 -0
  163. data/lib/adwords_api/v201603/experiment_service_registry.rb +0 -0
  164. data/lib/adwords_api/v201603/feed_item_service.rb +0 -0
  165. data/lib/adwords_api/v201603/feed_item_service_registry.rb +0 -0
  166. data/lib/adwords_api/v201603/feed_mapping_service.rb +0 -0
  167. data/lib/adwords_api/v201603/feed_mapping_service_registry.rb +0 -0
  168. data/lib/adwords_api/v201603/feed_service.rb +0 -0
  169. data/lib/adwords_api/v201603/feed_service_registry.rb +0 -0
  170. data/lib/adwords_api/v201603/label_service.rb +0 -0
  171. data/lib/adwords_api/v201603/label_service_registry.rb +0 -0
  172. data/lib/adwords_api/v201603/location_criterion_service.rb +0 -0
  173. data/lib/adwords_api/v201603/location_criterion_service_registry.rb +0 -0
  174. data/lib/adwords_api/v201603/managed_customer_service.rb +0 -0
  175. data/lib/adwords_api/v201603/managed_customer_service_registry.rb +0 -0
  176. data/lib/adwords_api/v201603/media_service.rb +0 -0
  177. data/lib/adwords_api/v201603/media_service_registry.rb +0 -0
  178. data/lib/adwords_api/v201603/offline_conversion_feed_service.rb +0 -0
  179. data/lib/adwords_api/v201603/offline_conversion_feed_service_registry.rb +0 -0
  180. data/lib/adwords_api/v201603/report_definition_service.rb +0 -0
  181. data/lib/adwords_api/v201603/report_definition_service_registry.rb +0 -0
  182. data/lib/adwords_api/v201603/shared_criterion_service.rb +0 -0
  183. data/lib/adwords_api/v201603/shared_criterion_service_registry.rb +0 -0
  184. data/lib/adwords_api/v201603/shared_set_service.rb +0 -0
  185. data/lib/adwords_api/v201603/shared_set_service_registry.rb +0 -0
  186. data/lib/adwords_api/v201603/targeting_idea_service.rb +0 -0
  187. data/lib/adwords_api/v201603/targeting_idea_service_registry.rb +0 -0
  188. data/lib/adwords_api/v201603/traffic_estimator_service.rb +0 -0
  189. data/lib/adwords_api/v201603/traffic_estimator_service_registry.rb +0 -0
  190. data/lib/adwords_api/v201603/trial_async_error_service.rb +0 -0
  191. data/lib/adwords_api/v201603/trial_async_error_service_registry.rb +0 -0
  192. data/lib/adwords_api/v201603/trial_service.rb +0 -0
  193. data/lib/adwords_api/v201603/trial_service_registry.rb +0 -0
  194. data/lib/adwords_api/v201605/account_label_service.rb +0 -0
  195. data/lib/adwords_api/v201605/account_label_service_registry.rb +0 -0
  196. data/lib/adwords_api/v201605/ad_customizer_feed_service.rb +0 -0
  197. data/lib/adwords_api/v201605/ad_customizer_feed_service_registry.rb +0 -0
  198. data/lib/adwords_api/v201605/ad_group_ad_service.rb +0 -0
  199. data/lib/adwords_api/v201605/ad_group_ad_service_registry.rb +0 -0
  200. data/lib/adwords_api/v201605/ad_group_bid_modifier_service.rb +0 -0
  201. data/lib/adwords_api/v201605/ad_group_bid_modifier_service_registry.rb +0 -0
  202. data/lib/adwords_api/v201605/ad_group_criterion_service.rb +0 -0
  203. data/lib/adwords_api/v201605/ad_group_criterion_service_registry.rb +0 -0
  204. data/lib/adwords_api/v201605/ad_group_extension_setting_service.rb +0 -0
  205. data/lib/adwords_api/v201605/ad_group_extension_setting_service_registry.rb +0 -0
  206. data/lib/adwords_api/v201605/ad_group_feed_service.rb +0 -0
  207. data/lib/adwords_api/v201605/ad_group_feed_service_registry.rb +0 -0
  208. data/lib/adwords_api/v201605/ad_group_service.rb +0 -0
  209. data/lib/adwords_api/v201605/ad_group_service_registry.rb +0 -0
  210. data/lib/adwords_api/v201605/ad_param_service.rb +0 -0
  211. data/lib/adwords_api/v201605/ad_param_service_registry.rb +0 -0
  212. data/lib/adwords_api/v201605/adwords_user_list_service.rb +0 -0
  213. data/lib/adwords_api/v201605/adwords_user_list_service_registry.rb +0 -0
  214. data/lib/adwords_api/v201605/batch_job_service.rb +0 -0
  215. data/lib/adwords_api/v201605/batch_job_service_registry.rb +0 -0
  216. data/lib/adwords_api/v201605/bidding_strategy_service.rb +0 -0
  217. data/lib/adwords_api/v201605/bidding_strategy_service_registry.rb +0 -0
  218. data/lib/adwords_api/v201605/budget_order_service.rb +0 -0
  219. data/lib/adwords_api/v201605/budget_order_service_registry.rb +0 -0
  220. data/lib/adwords_api/v201605/budget_service.rb +0 -0
  221. data/lib/adwords_api/v201605/budget_service_registry.rb +0 -0
  222. data/lib/adwords_api/v201605/campaign_criterion_service.rb +0 -0
  223. data/lib/adwords_api/v201605/campaign_criterion_service_registry.rb +0 -0
  224. data/lib/adwords_api/v201605/campaign_extension_setting_service.rb +0 -0
  225. data/lib/adwords_api/v201605/campaign_extension_setting_service_registry.rb +0 -0
  226. data/lib/adwords_api/v201605/campaign_feed_service.rb +0 -0
  227. data/lib/adwords_api/v201605/campaign_feed_service_registry.rb +0 -0
  228. data/lib/adwords_api/v201605/campaign_service.rb +0 -0
  229. data/lib/adwords_api/v201605/campaign_service_registry.rb +0 -0
  230. data/lib/adwords_api/v201605/campaign_shared_set_service.rb +0 -0
  231. data/lib/adwords_api/v201605/campaign_shared_set_service_registry.rb +0 -0
  232. data/lib/adwords_api/v201605/constant_data_service.rb +0 -0
  233. data/lib/adwords_api/v201605/constant_data_service_registry.rb +0 -0
  234. data/lib/adwords_api/v201605/conversion_tracker_service.rb +0 -0
  235. data/lib/adwords_api/v201605/conversion_tracker_service_registry.rb +0 -0
  236. data/lib/adwords_api/v201605/customer_extension_setting_service.rb +0 -0
  237. data/lib/adwords_api/v201605/customer_extension_setting_service_registry.rb +0 -0
  238. data/lib/adwords_api/v201605/customer_feed_service.rb +0 -0
  239. data/lib/adwords_api/v201605/customer_feed_service_registry.rb +0 -0
  240. data/lib/adwords_api/v201605/customer_service.rb +0 -0
  241. data/lib/adwords_api/v201605/customer_service_registry.rb +0 -0
  242. data/lib/adwords_api/v201605/customer_sync_service.rb +0 -0
  243. data/lib/adwords_api/v201605/customer_sync_service_registry.rb +0 -0
  244. data/lib/adwords_api/v201605/data_service.rb +0 -0
  245. data/lib/adwords_api/v201605/data_service_registry.rb +0 -0
  246. data/lib/adwords_api/v201605/draft_async_error_service.rb +0 -0
  247. data/lib/adwords_api/v201605/draft_async_error_service_registry.rb +0 -0
  248. data/lib/adwords_api/v201605/draft_service.rb +0 -0
  249. data/lib/adwords_api/v201605/draft_service_registry.rb +0 -0
  250. data/lib/adwords_api/v201605/experiment_service.rb +0 -0
  251. data/lib/adwords_api/v201605/experiment_service_registry.rb +0 -0
  252. data/lib/adwords_api/v201605/feed_item_service.rb +0 -0
  253. data/lib/adwords_api/v201605/feed_item_service_registry.rb +0 -0
  254. data/lib/adwords_api/v201605/feed_mapping_service.rb +0 -0
  255. data/lib/adwords_api/v201605/feed_mapping_service_registry.rb +0 -0
  256. data/lib/adwords_api/v201605/feed_service.rb +0 -0
  257. data/lib/adwords_api/v201605/feed_service_registry.rb +0 -0
  258. data/lib/adwords_api/v201605/label_service.rb +0 -0
  259. data/lib/adwords_api/v201605/label_service_registry.rb +0 -0
  260. data/lib/adwords_api/v201605/location_criterion_service.rb +0 -0
  261. data/lib/adwords_api/v201605/location_criterion_service_registry.rb +0 -0
  262. data/lib/adwords_api/v201605/managed_customer_service.rb +0 -0
  263. data/lib/adwords_api/v201605/managed_customer_service_registry.rb +0 -0
  264. data/lib/adwords_api/v201605/media_service.rb +0 -0
  265. data/lib/adwords_api/v201605/media_service_registry.rb +0 -0
  266. data/lib/adwords_api/v201605/offline_conversion_feed_service.rb +0 -0
  267. data/lib/adwords_api/v201605/offline_conversion_feed_service_registry.rb +0 -0
  268. data/lib/adwords_api/v201605/report_definition_service.rb +0 -0
  269. data/lib/adwords_api/v201605/report_definition_service_registry.rb +0 -0
  270. data/lib/adwords_api/v201605/shared_criterion_service.rb +0 -0
  271. data/lib/adwords_api/v201605/shared_criterion_service_registry.rb +0 -0
  272. data/lib/adwords_api/v201605/shared_set_service.rb +0 -0
  273. data/lib/adwords_api/v201605/shared_set_service_registry.rb +0 -0
  274. data/lib/adwords_api/v201605/targeting_idea_service.rb +0 -0
  275. data/lib/adwords_api/v201605/targeting_idea_service_registry.rb +0 -0
  276. data/lib/adwords_api/v201605/traffic_estimator_service.rb +0 -0
  277. data/lib/adwords_api/v201605/traffic_estimator_service_registry.rb +0 -0
  278. data/lib/adwords_api/v201605/trial_async_error_service.rb +0 -0
  279. data/lib/adwords_api/v201605/trial_async_error_service_registry.rb +0 -0
  280. data/lib/adwords_api/v201605/trial_service.rb +0 -0
  281. data/lib/adwords_api/v201605/trial_service_registry.rb +0 -0
  282. data/lib/adwords_api/version.rb +1 -1
  283. data/test/adwords_api/test_batch_job_utils.rb +2 -2
  284. data/test/adwords_api/test_report_stream.rb +0 -0
  285. data/test/templates/v201605/basic_operations_get_campaigns.def +1 -1
  286. data/test/templates/v201605/misc_use_oauth2_jwt.def +1 -1
  287. metadata +4 -164
  288. data/examples/v201509/account_management/create_account.rb +0 -88
  289. data/examples/v201509/account_management/get_account_changes.rb +0 -139
  290. data/examples/v201509/account_management/get_account_hierarchy.rb +0 -94
  291. data/examples/v201509/advanced_operations/add_ad_customizers.rb +0 -184
  292. data/examples/v201509/advanced_operations/add_ad_group_bid_modifier.rb +0 -101
  293. data/examples/v201509/advanced_operations/add_click_to_download_ad.rb +0 -133
  294. data/examples/v201509/advanced_operations/add_complete_campaigns_using_batch_job.rb +0 -356
  295. data/examples/v201509/advanced_operations/add_html5_ad.rb +0 -137
  296. data/examples/v201509/advanced_operations/add_text_ad_with_upgraded_urls.rb +0 -134
  297. data/examples/v201509/advanced_operations/create_and_attach_shared_keyword_set.rb +0 -141
  298. data/examples/v201509/advanced_operations/find_and_remove_criteria_from_shared_set.rb +0 -174
  299. data/examples/v201509/advanced_operations/get_ad_group_bid_modifiers.rb +0 -102
  300. data/examples/v201509/advanced_operations/use_shared_bidding_strategy.rb +0 -147
  301. data/examples/v201509/basic_operations/add_ad_groups.rb +0 -142
  302. data/examples/v201509/basic_operations/add_campaigns.rb +0 -139
  303. data/examples/v201509/basic_operations/add_keywords.rb +0 -114
  304. data/examples/v201509/basic_operations/add_text_ads.rb +0 -109
  305. data/examples/v201509/basic_operations/get_ad_groups.rb +0 -102
  306. data/examples/v201509/basic_operations/get_campaigns.rb +0 -97
  307. data/examples/v201509/basic_operations/get_campaigns_with_awql.rb +0 -89
  308. data/examples/v201509/basic_operations/get_keywords.rb +0 -109
  309. data/examples/v201509/basic_operations/get_text_ads.rb +0 -110
  310. data/examples/v201509/basic_operations/pause_ad.rb +0 -88
  311. data/examples/v201509/basic_operations/remove_ad.rb +0 -89
  312. data/examples/v201509/basic_operations/remove_ad_group.rb +0 -85
  313. data/examples/v201509/basic_operations/remove_campaign.rb +0 -87
  314. data/examples/v201509/basic_operations/remove_keyword.rb +0 -94
  315. data/examples/v201509/basic_operations/update_ad_group.rb +0 -85
  316. data/examples/v201509/basic_operations/update_campaign.rb +0 -86
  317. data/examples/v201509/basic_operations/update_keyword.rb +0 -106
  318. data/examples/v201509/campaign_management/add_campaign_labels.rb +0 -82
  319. data/examples/v201509/campaign_management/add_experiment.rb +0 -162
  320. data/examples/v201509/campaign_management/add_keywords_in_bulk.rb +0 -153
  321. data/examples/v201509/campaign_management/add_keywords_using_incremental_batch_job.rb +0 -179
  322. data/examples/v201509/campaign_management/get_all_disapproved_ads.rb +0 -97
  323. data/examples/v201509/campaign_management/get_all_disapproved_ads_with_awql.rb +0 -89
  324. data/examples/v201509/campaign_management/get_campaigns_by_label.rb +0 -108
  325. data/examples/v201509/campaign_management/promote_experiment.rb +0 -81
  326. data/examples/v201509/campaign_management/set_ad_parameters.rb +0 -118
  327. data/examples/v201509/campaign_management/set_criterion_bid_modifier.rb +0 -104
  328. data/examples/v201509/campaign_management/validate_text_ad.rb +0 -110
  329. data/examples/v201509/error_handling/handle_partial_failures.rb +0 -130
  330. data/examples/v201509/error_handling/handle_policy_violation_error.rb +0 -141
  331. data/examples/v201509/extensions/add_google_my_business_location_extensions.rb +0 -193
  332. data/examples/v201509/extensions/add_site_links.rb +0 -164
  333. data/examples/v201509/extensions/add_site_links_using_feeds.rb +0 -281
  334. data/examples/v201509/migration/migrate_to_extension_settings.rb +0 -386
  335. data/examples/v201509/migration/upgrade_ad_url.rb +0 -93
  336. data/examples/v201509/misc/get_all_images_and_videos.rb +0 -104
  337. data/examples/v201509/misc/setup_oauth2.rb +0 -84
  338. data/examples/v201509/misc/upload_image.rb +0 -93
  339. data/examples/v201509/misc/upload_media_bundle.rb +0 -90
  340. data/examples/v201509/misc/use_oauth2_jwt.rb +0 -93
  341. data/examples/v201509/misc/use_runtime_config.rb +0 -92
  342. data/examples/v201509/optimization/estimate_keyword_traffic.rb +0 -146
  343. data/examples/v201509/optimization/get_keyword_bid_simulations.rb +0 -95
  344. data/examples/v201509/optimization/get_keyword_ideas.rb +0 -126
  345. data/examples/v201509/remarketing/add_audience.rb +0 -118
  346. data/examples/v201509/remarketing/add_conversion_tracker.rb +0 -98
  347. data/examples/v201509/remarketing/add_crm_based_user_list.rb +0 -119
  348. data/examples/v201509/remarketing/add_rule_based_user_lists.rb +0 -167
  349. data/examples/v201509/remarketing/upload_offline_conversions.rb +0 -98
  350. data/examples/v201509/reporting/download_criteria_report.rb +0 -92
  351. data/examples/v201509/reporting/download_criteria_report_with_awql.rb +0 -93
  352. data/examples/v201509/reporting/get_report_fields.rb +0 -75
  353. data/examples/v201509/reporting/parallel_report_download.rb +0 -164
  354. data/examples/v201509/reporting/stream_criteria_report_results.rb +0 -97
  355. data/examples/v201509/shopping_campaigns/add_product_partition_tree.rb +0 -267
  356. data/examples/v201509/shopping_campaigns/add_product_scope.rb +0 -129
  357. data/examples/v201509/shopping_campaigns/add_shopping_campaign.rb +0 -129
  358. data/examples/v201509/shopping_campaigns/get_product_category_taxonomy.rb +0 -115
  359. data/examples/v201509/targeting/add_campaign_targeting_criteria.rb +0 -180
  360. data/examples/v201509/targeting/add_demographic_targeting_criteria.rb +0 -112
  361. data/examples/v201509/targeting/get_campaign_targeting_criteria.rb +0 -106
  362. data/examples/v201509/targeting/get_targetable_languages_and_carriers.rb +0 -89
  363. data/examples/v201509/targeting/lookup_location.rb +0 -108
  364. data/lib/adwords_api/v201509/account_label_service.rb +0 -46
  365. data/lib/adwords_api/v201509/account_label_service_registry.rb +0 -46
  366. data/lib/adwords_api/v201509/ad_customizer_feed_service.rb +0 -46
  367. data/lib/adwords_api/v201509/ad_customizer_feed_service_registry.rb +0 -46
  368. data/lib/adwords_api/v201509/ad_group_ad_service.rb +0 -70
  369. data/lib/adwords_api/v201509/ad_group_ad_service_registry.rb +0 -46
  370. data/lib/adwords_api/v201509/ad_group_bid_modifier_service.rb +0 -54
  371. data/lib/adwords_api/v201509/ad_group_bid_modifier_service_registry.rb +0 -46
  372. data/lib/adwords_api/v201509/ad_group_criterion_service.rb +0 -62
  373. data/lib/adwords_api/v201509/ad_group_criterion_service_registry.rb +0 -46
  374. data/lib/adwords_api/v201509/ad_group_extension_setting_service.rb +0 -54
  375. data/lib/adwords_api/v201509/ad_group_extension_setting_service_registry.rb +0 -46
  376. data/lib/adwords_api/v201509/ad_group_feed_service.rb +0 -54
  377. data/lib/adwords_api/v201509/ad_group_feed_service_registry.rb +0 -46
  378. data/lib/adwords_api/v201509/ad_group_service.rb +0 -62
  379. data/lib/adwords_api/v201509/ad_group_service_registry.rb +0 -46
  380. data/lib/adwords_api/v201509/ad_param_service.rb +0 -46
  381. data/lib/adwords_api/v201509/ad_param_service_registry.rb +0 -46
  382. data/lib/adwords_api/v201509/adwords_user_list_service.rb +0 -54
  383. data/lib/adwords_api/v201509/adwords_user_list_service_registry.rb +0 -46
  384. data/lib/adwords_api/v201509/batch_job_service.rb +0 -54
  385. data/lib/adwords_api/v201509/batch_job_service_registry.rb +0 -46
  386. data/lib/adwords_api/v201509/bidding_strategy_service.rb +0 -54
  387. data/lib/adwords_api/v201509/bidding_strategy_service_registry.rb +0 -46
  388. data/lib/adwords_api/v201509/budget_order_service.rb +0 -54
  389. data/lib/adwords_api/v201509/budget_order_service_registry.rb +0 -46
  390. data/lib/adwords_api/v201509/budget_service.rb +0 -54
  391. data/lib/adwords_api/v201509/budget_service_registry.rb +0 -46
  392. data/lib/adwords_api/v201509/campaign_criterion_service.rb +0 -54
  393. data/lib/adwords_api/v201509/campaign_criterion_service_registry.rb +0 -46
  394. data/lib/adwords_api/v201509/campaign_extension_setting_service.rb +0 -54
  395. data/lib/adwords_api/v201509/campaign_extension_setting_service_registry.rb +0 -46
  396. data/lib/adwords_api/v201509/campaign_feed_service.rb +0 -54
  397. data/lib/adwords_api/v201509/campaign_feed_service_registry.rb +0 -46
  398. data/lib/adwords_api/v201509/campaign_service.rb +0 -62
  399. data/lib/adwords_api/v201509/campaign_service_registry.rb +0 -46
  400. data/lib/adwords_api/v201509/campaign_shared_set_service.rb +0 -54
  401. data/lib/adwords_api/v201509/campaign_shared_set_service_registry.rb +0 -46
  402. data/lib/adwords_api/v201509/constant_data_service.rb +0 -102
  403. data/lib/adwords_api/v201509/constant_data_service_registry.rb +0 -46
  404. data/lib/adwords_api/v201509/conversion_tracker_service.rb +0 -54
  405. data/lib/adwords_api/v201509/conversion_tracker_service_registry.rb +0 -46
  406. data/lib/adwords_api/v201509/customer_extension_setting_service.rb +0 -54
  407. data/lib/adwords_api/v201509/customer_extension_setting_service_registry.rb +0 -46
  408. data/lib/adwords_api/v201509/customer_feed_service.rb +0 -54
  409. data/lib/adwords_api/v201509/customer_feed_service_registry.rb +0 -46
  410. data/lib/adwords_api/v201509/customer_service.rb +0 -46
  411. data/lib/adwords_api/v201509/customer_service_registry.rb +0 -46
  412. data/lib/adwords_api/v201509/customer_sync_service.rb +0 -38
  413. data/lib/adwords_api/v201509/customer_sync_service_registry.rb +0 -47
  414. data/lib/adwords_api/v201509/data_service.rb +0 -78
  415. data/lib/adwords_api/v201509/data_service_registry.rb +0 -46
  416. data/lib/adwords_api/v201509/experiment_service.rb +0 -46
  417. data/lib/adwords_api/v201509/experiment_service_registry.rb +0 -46
  418. data/lib/adwords_api/v201509/feed_item_service.rb +0 -54
  419. data/lib/adwords_api/v201509/feed_item_service_registry.rb +0 -46
  420. data/lib/adwords_api/v201509/feed_mapping_service.rb +0 -54
  421. data/lib/adwords_api/v201509/feed_mapping_service_registry.rb +0 -46
  422. data/lib/adwords_api/v201509/feed_service.rb +0 -54
  423. data/lib/adwords_api/v201509/feed_service_registry.rb +0 -46
  424. data/lib/adwords_api/v201509/label_service.rb +0 -54
  425. data/lib/adwords_api/v201509/label_service_registry.rb +0 -46
  426. data/lib/adwords_api/v201509/location_criterion_service.rb +0 -46
  427. data/lib/adwords_api/v201509/location_criterion_service_registry.rb +0 -46
  428. data/lib/adwords_api/v201509/managed_customer_service.rb +0 -78
  429. data/lib/adwords_api/v201509/managed_customer_service_registry.rb +0 -46
  430. data/lib/adwords_api/v201509/media_service.rb +0 -54
  431. data/lib/adwords_api/v201509/media_service_registry.rb +0 -46
  432. data/lib/adwords_api/v201509/mutate_job_service.rb +0 -54
  433. data/lib/adwords_api/v201509/mutate_job_service_registry.rb +0 -46
  434. data/lib/adwords_api/v201509/offline_conversion_feed_service.rb +0 -38
  435. data/lib/adwords_api/v201509/offline_conversion_feed_service_registry.rb +0 -46
  436. data/lib/adwords_api/v201509/report_definition_service.rb +0 -38
  437. data/lib/adwords_api/v201509/report_definition_service_registry.rb +0 -46
  438. data/lib/adwords_api/v201509/shared_criterion_service.rb +0 -54
  439. data/lib/adwords_api/v201509/shared_criterion_service_registry.rb +0 -46
  440. data/lib/adwords_api/v201509/shared_set_service.rb +0 -54
  441. data/lib/adwords_api/v201509/shared_set_service_registry.rb +0 -46
  442. data/lib/adwords_api/v201509/targeting_idea_service.rb +0 -38
  443. data/lib/adwords_api/v201509/targeting_idea_service_registry.rb +0 -46
  444. data/lib/adwords_api/v201509/traffic_estimator_service.rb +0 -38
  445. data/lib/adwords_api/v201509/traffic_estimator_service_registry.rb +0 -46
  446. data/test/templates/v201509/basic_operations_get_campaigns.def +0 -116
  447. data/test/templates/v201509/misc_use_oauth2_jwt.def +0 -131
@@ -1,137 +0,0 @@
1
- #!/usr/bin/env ruby
2
- # Encoding: utf-8
3
- #
4
- # Copyright:: Copyright 2015, Google Inc. All Rights Reserved.
5
- #
6
- # License:: Licensed under the Apache License, Version 2.0 (the "License");
7
- # you may not use this file except in compliance with the License.
8
- # You may obtain a copy of the License at
9
- #
10
- # http://www.apache.org/licenses/LICENSE-2.0
11
- #
12
- # Unless required by applicable law or agreed to in writing, software
13
- # distributed under the License is distributed on an "AS IS" BASIS,
14
- # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
15
- # implied.
16
- # See the License for the specific language governing permissions and
17
- # limitations under the License.
18
- #
19
- # This code example adds an HTML5 ad to a given ad group.
20
- # To get ad groups, run basic_operations/get_ad_groups.rb.
21
-
22
- require 'adwords_api'
23
- require 'base64'
24
-
25
- def add_html5_ad(ad_group_id)
26
- # AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
27
- # when called without parameters.
28
- adwords = AdwordsApi::Api.new
29
-
30
- # To enable logging of SOAP requests, set the log_level value to 'DEBUG' in
31
- # the configuration file or provide your own logger:
32
- # adwords.logger = Logger.new('adwords_xml.log')
33
-
34
- ad_group_ad_srv = adwords.service(:AdGroupAdService, API_VERSION)
35
-
36
- # The HTML5 zip file contains all the HTML, CSS, and images needed for the
37
- # HTML5 ad. For help on creating an HTML5 zip file, check out Google Web
38
- # Designer (https://www.google.com/webdesigner).
39
- html5_url = 'http://goo.gl/9Y7qI2'
40
- html5_data = AdsCommon::Http.get(html5_url, adwords.config)
41
- base64_html5_data = Base64.encode64(html5_data)
42
-
43
- # Create a media bundle containing the zip file with all the HTML5
44
- # components.
45
- media_bundle = {
46
- :xsi_type => 'MediaBundle',
47
- :data => base64_html5_data,
48
- :entry_point => 'carousel/index.html',
49
- :type => 'MEDIA_BUNDLE'
50
- }
51
-
52
- # Create the template elements for the ad. You can refer to
53
- # https://developers.google.com/adwords/api/docs/appendix/templateads
54
- # for the list of available template fields.
55
- ad_data = {
56
- :unique_name => 'adData',
57
- :fields => [
58
- {
59
- :name => 'Custom_layout',
60
- :field_media => media_bundle,
61
- :type => 'MEDIA_BUNDLE'
62
- },
63
- {
64
- :name => 'layout',
65
- :field_text => 'Custom',
66
- :type => 'ENUM'
67
- }
68
- ]
69
- }
70
-
71
- html5_ad = {
72
- :xsi_type => 'TemplateAd',
73
- :name => 'Ad for HTML5',
74
- :template_id => 419,
75
- :final_urls => ['http://example.com/html5'],
76
- :display_url => 'www.example.com/html5',
77
- :dimensions => {
78
- :width => 300,
79
- :height => 250
80
- },
81
- :template_elements => [ad_data]
82
- }
83
-
84
- ad_group_ad = {
85
- :ad_group_id => ad_group_id,
86
- :ad => html5_ad,
87
- :status => 'PAUSED'
88
- }
89
-
90
- operation = {
91
- :operator => 'ADD',
92
- :operand => ad_group_ad
93
- }
94
-
95
- response = ad_group_ad_srv.mutate([operation])
96
- if response and !response.empty?
97
- response[:value].each do |ad_group_ad|
98
- puts "New HTML5 ad with ID %d and display url '%s' was added." %
99
- [ad_group_ad[:ad][:id], ad_group_ad[:ad][:display_url]]
100
- end
101
- else
102
- puts "No HTML5 ads were added."
103
- end
104
- end
105
-
106
- if __FILE__ == $0
107
- API_VERSION = :v201509
108
-
109
- begin
110
- # Ad group ID to add text ads to.
111
- ad_group_id = 'INSERT_AD_GROUP_ID_HERE'.to_i
112
- add_html5_ad(ad_group_id)
113
-
114
- # Authorization error.
115
- rescue AdsCommon::Errors::OAuth2VerificationRequired => e
116
- puts "Authorization credentials are not valid. Edit adwords_api.yml for " +
117
- "OAuth2 client ID and secret and run misc/setup_oauth2.rb example " +
118
- "to retrieve and store OAuth2 tokens."
119
- puts "See this wiki page for more details:\n\n " +
120
- 'https://github.com/googleads/google-api-ads-ruby/wiki/OAuth2'
121
-
122
- # HTTP errors.
123
- rescue AdsCommon::Errors::HttpError => e
124
- puts "HTTP Error: %s" % e
125
-
126
- # API errors.
127
- rescue AdwordsApi::Errors::ApiException => e
128
- puts "Message: %s" % e.message
129
- puts 'Errors:'
130
- e.errors.each_with_index do |error, index|
131
- puts "\tError [%d]:" % (index + 1)
132
- error.each do |field, value|
133
- puts "\t\t%s: %s" % [field, value]
134
- end
135
- end
136
- end
137
- end
@@ -1,134 +0,0 @@
1
- #!/usr/bin/env ruby
2
- # Encoding: utf-8
3
- #
4
- # Copyright:: Copyright 2014, Google Inc. All Rights Reserved.
5
- #
6
- # License:: Licensed under the Apache License, Version 2.0 (the "License");
7
- # you may not use this file except in compliance with the License.
8
- # You may obtain a copy of the License at
9
- #
10
- # http://www.apache.org/licenses/LICENSE-2.0
11
- #
12
- # Unless required by applicable law or agreed to in writing, software
13
- # distributed under the License is distributed on an "AS IS" BASIS,
14
- # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
15
- # implied.
16
- # See the License for the specific language governing permissions and
17
- # limitations under the License.
18
- #
19
- # This code example adds a text ad that uses advanced features of upgraded
20
- # URLs.
21
-
22
- require 'adwords_api'
23
-
24
- def add_text_ad_with_upgraded_urls(ad_group_id)
25
- # AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
26
- # when called without parameters.
27
- adwords = AdwordsApi::Api.new
28
-
29
- # To enable logging of SOAP requests, set the log_level value to 'DEBUG' in
30
- # the configuration file or provide your own logger:
31
- # adwords.logger = Logger.new('adwords_xml.log')
32
-
33
- ad_group_ad_srv = adwords.service(:AdGroupAdService, API_VERSION)
34
-
35
- # Since your tracking URL will have two custom parameters, provide their
36
- # values too. This can be provided at campaign, ad group, ad, criterion, or
37
- # feed item levels.
38
- season_parameter = {
39
- :key => 'season',
40
- :value => 'christmas'
41
- }
42
-
43
- promo_code_parameter = {
44
- :key => 'promocode',
45
- :value => 'NYC123'
46
- }
47
-
48
- tracking_url_parameters = {
49
- :parameters => [season_parameter, promo_code_parameter]
50
- }
51
-
52
- text_ad = {
53
- :xsi_type => 'TextAd',
54
- :headline => 'Luxury Cruise to Mars',
55
- :description1 => 'Visit the Red Planet in style.',
56
- :description2 => 'Low-gravity fun for everyone!',
57
- :display_url => 'www.example.com',
58
- # Specify a tracking URL for 3rd party tracking provider. You may specify
59
- # one at customer, campaign, ad group, ad, criterion, or feed item levels.
60
- :tracking_url_template => 'http://tracker.example.com/' +
61
- '?season={_season}&promocode={_promocode}&u={lpurl}',
62
- :url_custom_parameters => tracking_url_parameters,
63
- # Specify a list of final URLs. This field cannot be set if :url field
64
- # is set. This may be specified at ad, criterion, and feed item levels.
65
- :final_urls => [
66
- 'http://www.example.com/cruise/space/',
67
- 'http://www.example.com/locations/mars/'
68
- ],
69
- # Specify a list of final mobile URLs. This field cannot be set if :url
70
- # field is set. This may be specificed at ad, criterion, and
71
- # feed item levels.
72
- :final_mobile_urls => [
73
- 'http://mobile.example.com/cruise/space/',
74
- 'http://mobile.example.com/locations/mars/'
75
- ]
76
- }
77
-
78
- operation = {
79
- :operator => 'ADD',
80
- :operand => {:ad_group_id => ad_group_id, :ad => text_ad}
81
- }
82
-
83
- # Add ads.
84
- response = ad_group_ad_srv.mutate([operation])
85
- if response and response[:value]
86
- response[:value].each do |ad|
87
- text_ad = ad[:ad]
88
- puts "Ad with ID %d and displayUrl '%s' was added." %
89
- [text_ad[:id], text_ad[:display_url]]
90
- puts "\tFinal URLs: %s" % [text_ad[:final_urls].join(', ')]
91
- puts "\tFinal Mobile URLs: %s" % [text_ad[:final_mobile_urls].join(', ')]
92
- puts "\tTracking URL template: %s" % [text_ad[:tracking_url_template]]
93
- custom_parameters =
94
- text_ad[:url_custom_parameters][:parameters].map do |custom_parameter|
95
- "%s=%s" % [custom_parameter[:key], custom_parameter[:value]]
96
- end
97
- puts "\tCustom parameters: %s" % [custom_parameters.join(', ')]
98
- end
99
- else
100
- raise StandardError, 'No ads were added.'
101
- end
102
- end
103
-
104
- if __FILE__ == $0
105
- API_VERSION = :v201509
106
-
107
- begin
108
- ad_group_id = 'INSERT_AD_GROUP_ID_HERE'.to_i
109
- add_text_ad_with_upgraded_urls(ad_group_id)
110
-
111
- # Authorization error.
112
- rescue AdsCommon::Errors::OAuth2VerificationRequired => e
113
- puts "Authorization credentials are not valid. Edit adwords_api.yml for " +
114
- "OAuth2 client ID and secret and run misc/setup_oauth2.rb example " +
115
- "to retrieve and store OAuth2 tokens."
116
- puts "See this wiki page for more details:\n\n " +
117
- 'https://github.com/googleads/google-api-ads-ruby/wiki/OAuth2'
118
-
119
- # HTTP errors.
120
- rescue AdsCommon::Errors::HttpError => e
121
- puts "HTTP Error: %s" % e
122
-
123
- # API errors.
124
- rescue AdwordsApi::Errors::ApiException => e
125
- puts "Message: %s" % e.message
126
- puts 'Errors:'
127
- e.errors.each_with_index do |error, index|
128
- puts "\tError [%d]:" % (index + 1)
129
- error.each do |field, value|
130
- puts "\t\t%s: %s" % [field, value]
131
- end
132
- end
133
- end
134
- end
@@ -1,141 +0,0 @@
1
- #!/usr/bin/env ruby
2
- # Encoding: utf-8
3
- #
4
- # Copyright:: Copyright 2015, Google Inc. All Rights Reserved.
5
- #
6
- # License:: Licensed under the Apache License, Version 2.0 (the "License");
7
- # you may not use this file except in compliance with the License.
8
- # You may obtain a copy of the License at
9
- #
10
- # http://www.apache.org/licenses/LICENSE-2.0
11
- #
12
- # Unless required by applicable law or agreed to in writing, software
13
- # distributed under the License is distributed on an "AS IS" BASIS,
14
- # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
15
- # implied.
16
- # See the License for the specific language governing permissions and
17
- # limitations under the License.
18
- #
19
- # This example creates a shared list of negative broad match keywords, it then
20
- # attaches them to a campaign.
21
-
22
- require 'adwords_api'
23
- require 'date'
24
-
25
- def create_and_attach_shared_keyword_set(campaign_id)
26
- # AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
27
- # when called without parameters.
28
- adwords = AdwordsApi::Api.new
29
-
30
- # To enable logging of SOAP requests, set the log_level value to 'DEBUG' in
31
- # the configuration file or provide your own logger:
32
- # adwords.logger = Logger.new('adwords_xml.log')
33
-
34
- shared_set_srv = adwords.service(:SharedSetService, API_VERSION)
35
- shared_criterion_srv = adwords.service(:SharedCriterionService, API_VERSION)
36
- campaign_shared_set_srv =
37
- adwords.service(:CampaignSharedSetService, API_VERSION)
38
-
39
- # Keywords to create a shared set of.
40
- keywords = ['mars cruise', 'mars hotels']
41
-
42
- # Create shared negative keyword set.
43
- shared_set = {
44
- :name => 'API Negative keyword list - %d' % (Time.new.to_f * 1000).to_i,
45
- :type => 'NEGATIVE_KEYWORDS'
46
- }
47
-
48
- # Add shared set.
49
- response = shared_set_srv.mutate([
50
- {:operator => 'ADD', :operand => shared_set}
51
- ])
52
-
53
- if response and response[:value]
54
- shared_set = response[:value].first
55
- shared_set_id = shared_set[:shared_set_id]
56
- puts "Shared set with ID %d and name '%s' was successfully added." %
57
- [shared_set_id, shared_set[:name]]
58
- else
59
- raise StandardError, 'No shared set was added'
60
- end
61
-
62
- # Add negative keywords to shared set.
63
- shared_criteria = keywords.map do |keyword|
64
- {
65
- :criterion => {
66
- :xsi_type => 'Keyword',
67
- :text => keyword,
68
- :match_type => 'BROAD'
69
- },
70
- :negative => true,
71
- :shared_set_id => shared_set_id
72
- }
73
- end
74
-
75
- operations = shared_criteria.map do |criterion|
76
- {:operator => 'ADD', :operand => criterion}
77
- end
78
-
79
- response = shared_criterion_srv.mutate(operations)
80
- if response and response[:value]
81
- response[:value].each do |shared_criterion|
82
- puts "Added shared criterion ID %d '%s' to shared set with ID %d." %
83
- [shared_criterion[:criterion][:id],
84
- shared_criterion[:criterion][:text],
85
- shared_criterion[:shared_set_id]]
86
- end
87
- else
88
- raise StandardError, 'No shared keyword was added'
89
- end
90
-
91
- # Attach the articles to the campaign.
92
- campaign_set = {
93
- :campaign_id => campaign_id,
94
- :shared_set_id => shared_set_id
95
- }
96
-
97
- response = campaign_shared_set_srv.mutate([
98
- {:operator => 'ADD', :operand => campaign_set}
99
- ])
100
- if response and response[:value]
101
- campaign_shared_set = response[:value].first
102
- puts 'Shared set ID %d was attached to campaign ID %d' %
103
- [campaign_shared_set[:shared_set_id], campaign_shared_set[:campaign_id]]
104
- else
105
- raise StandardError, 'No campaign shared set was added'
106
- end
107
- end
108
-
109
- if __FILE__ == $0
110
- API_VERSION = :v201509
111
-
112
- begin
113
- # Campaign ID to attach shared keyword set to.
114
- campaign_id = 'INSERT_CAMPAIGN_ID_HERE'.to_i
115
-
116
- create_and_attach_shared_keyword_set(campaign_id)
117
-
118
- # Authorization error.
119
- rescue AdsCommon::Errors::OAuth2VerificationRequired => e
120
- puts "Authorization credentials are not valid. Edit adwords_api.yml for " +
121
- "OAuth2 client ID and secret and run misc/setup_oauth2.rb example " +
122
- "to retrieve and store OAuth2 tokens."
123
- puts "See this wiki page for more details:\n\n " +
124
- 'https://github.com/googleads/google-api-ads-ruby/wiki/OAuth2'
125
-
126
- # HTTP errors.
127
- rescue AdsCommon::Errors::HttpError => e
128
- puts "HTTP Error: %s" % e
129
-
130
- # API errors.
131
- rescue AdwordsApi::Errors::ApiException => e
132
- puts "Message: %s" % e.message
133
- puts 'Errors:'
134
- e.errors.each_with_index do |error, index|
135
- puts "\tError [%d]:" % (index + 1)
136
- error.each do |field, value|
137
- puts "\t\t%s: %s" % [field, value]
138
- end
139
- end
140
- end
141
- end
@@ -1,174 +0,0 @@
1
- #!/usr/bin/env ruby
2
- # Encoding: utf-8
3
- #
4
- # Copyright:: Copyright 2015, Google Inc. All Rights Reserved.
5
- #
6
- # License:: Licensed under the Apache License, Version 2.0 (the "License");
7
- # you may not use this file except in compliance with the License.
8
- # You may obtain a copy of the License at
9
- #
10
- # http://www.apache.org/licenses/LICENSE-2.0
11
- #
12
- # Unless required by applicable law or agreed to in writing, software
13
- # distributed under the License is distributed on an "AS IS" BASIS,
14
- # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
15
- # implied.
16
- # See the License for the specific language governing permissions and
17
- # limitations under the License.
18
- #
19
- # This example demonstrates how to find shared sets, shared set criterions and
20
- # how to remove them.
21
-
22
- require 'adwords_api'
23
-
24
- def find_and_remove_criteria_from_shared_set(campaign_id)
25
- # AdwordsApi::Api will read a config file from ENV['HOME']/adwords_api.yml
26
- # when called without parameters.
27
- adwords = AdwordsApi::Api.new
28
-
29
- # To enable logging of SOAP requests, set the log_level value to 'DEBUG' in
30
- # the configuration file or provide your own logger:
31
- # adwords.logger = Logger.new('adwords_xml.log')
32
-
33
- campaign_shared_set_srv =
34
- adwords.service(:CampaignSharedSetService, API_VERSION)
35
- shared_criterion_srv = adwords.service(:SharedCriterionService, API_VERSION)
36
-
37
- shared_set_ids = []
38
- criterion_ids = []
39
-
40
- # First, retrieve all shared sets associated with the campaign.
41
-
42
- # Create selector for shared sets to:
43
- # - filter by campaign ID,
44
- # - filter by shared set type.
45
- selector = {
46
- :fields => ['SharedSetId', 'CampaignId', 'SharedSetName', 'SharedSetType',
47
- 'Status'],
48
- :predicates => [
49
- {:field => 'CampaignId', :operator => 'EQUALS', :values => [campaign_id]},
50
- {:field => 'SharedSetType', :operator => 'IN', :values =>
51
- ['NEGATIVE_KEYWORDS', 'NEGATIVE_PLACEMENTS']}
52
- ],
53
- :paging => {
54
- :start_index => 0,
55
- :number_results => PAGE_SIZE
56
- }
57
- }
58
-
59
- # Set initial values.
60
- offset, page = 0, {}
61
-
62
- begin
63
- page = campaign_shared_set_srv.get(selector)
64
- if page[:entries]
65
- page[:entries].each do |shared_set|
66
- puts "Campaign shared set ID %d and name '%s'" %
67
- [shared_set[:shared_set_id], shared_set[:shared_set_name]]
68
- shared_set_ids << shared_set[:shared_set_id]
69
- end
70
- # Increment values to request the next page.
71
- offset += PAGE_SIZE
72
- selector[:paging][:start_index] = offset
73
- end
74
- end while page[:total_num_entries] > offset
75
-
76
- # Next, Retrieve criterion IDs for all found shared sets.
77
- selector = {
78
- :fields => ['SharedSetId', 'Id', 'KeywordText', 'KeywordMatchType',
79
- 'PlacementUrl'],
80
- :predicates => [
81
- {:field => 'SharedSetId', :operator => 'IN', :values => shared_set_ids}
82
- ],
83
- :paging => {
84
- :start_index => 0,
85
- :number_results => PAGE_SIZE
86
- }
87
- }
88
-
89
- # Set initial values.
90
- offset, page = 0, {}
91
-
92
- begin
93
- page = shared_criterion_srv.get(selector)
94
- if page[:entries]
95
- page[:entries].each do |shared_criterion|
96
- if shared_criterion[:criterion][:type] == 'KEYWORD'
97
- puts "Shared negative keyword with ID %d and text '%s' was found." %
98
- [shared_criterion[:criterion][:id],
99
- shared_criterion[:criterion][:text]]
100
- elsif shared_criterion[:criterion][:type] == 'PLACEMENT'
101
- puts "Shared negative placement with ID %d and url '%s' was found." %
102
- [shared_criterion[:criterion][:id],
103
- shared_criterion[:criterion][:url]]
104
- else
105
- puts 'Shared criterion with ID %d was found.' %
106
- [shared_criterion[:criterion][:id]]
107
- end
108
- criterion_ids << {
109
- :shared_set_id => shared_criterion[:shared_set_id],
110
- :criterion_id => shared_criterion[:criterion][:id]
111
- }
112
- end
113
- # Increment values to request the next page.
114
- offset += PAGE_SIZE
115
- selector[:paging][:start_index] = offset
116
- end
117
- end while page[:total_num_entries] > offset
118
-
119
- # Finally, remove the criteria.
120
- operations = criterion_ids.map do |criterion|
121
- {
122
- :operator => 'REMOVE',
123
- :operand => {
124
- :criterion => {:id => criterion[:criterion_id]},
125
- :shared_set_id => criterion[:shared_set_id]
126
- }
127
- }
128
- end
129
-
130
- response = shared_criterion_srv.mutate(operations)
131
- if response and response[:value]
132
- response[:value].each do |criterion|
133
- puts "Criterion ID %d was successfully removed from shared set ID %d." %
134
- [criterion[:criterion][:id], criterion[:shared_set_id]]
135
- end
136
- else
137
- puts 'No shared criteria were removed.'
138
- end
139
- end
140
-
141
- if __FILE__ == $0
142
- API_VERSION = :v201509
143
- PAGE_SIZE = 500
144
-
145
- begin
146
- # ID of a campaign to remove shared criteria from.
147
- campaign_id = 'INSERT_CAMPAIGN_ID_HERE'.to_i
148
-
149
- find_and_remove_criteria_from_shared_set(campaign_id)
150
-
151
- # Authorization error.
152
- rescue AdsCommon::Errors::OAuth2VerificationRequired => e
153
- puts "Authorization credentials are not valid. Edit adwords_api.yml for " +
154
- "OAuth2 client ID and secret and run misc/setup_oauth2.rb example " +
155
- "to retrieve and store OAuth2 tokens."
156
- puts "See this wiki page for more details:\n\n " +
157
- 'https://github.com/googleads/google-api-ads-ruby/wiki/OAuth2'
158
-
159
- # HTTP errors.
160
- rescue AdsCommon::Errors::HttpError => e
161
- puts "HTTP Error: %s" % e
162
-
163
- # API errors.
164
- rescue AdwordsApi::Errors::ApiException => e
165
- puts "Message: %s" % e.message
166
- puts 'Errors:'
167
- e.errors.each_with_index do |error, index|
168
- puts "\tError [%d]:" % (index + 1)
169
- error.each do |field, value|
170
- puts "\t\t%s: %s" % [field, value]
171
- end
172
- end
173
- end
174
- end