google-ads-googleads 2.0.0 → 2.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 62470f63d1da981ede9c67986dbd4b2fc78efcf236bc0540a1f673a12b52c224
-  data.tar.gz: 4a46da47d63f825e98030c88b51b3513393311ff3a1050eac62f0d86680b1cb6
+  metadata.gz: 164db641c982021a9c51f5b3bf9e18a65f8e7b973338bd392b003d00f5235cc7
+  data.tar.gz: f84eeceb7819e6751d8b897eb92423bf9145df1118971033a7794d687690f199
 SHA512:
-  metadata.gz: 75580c687c4c05c0a8e4de4feb771ab8b365e07f3cf355ffa3fdf7c4a9d6bdea14763a041c3a85aacb5d467f0b5ce249aa114af1e7768aa5764bf11a00466e95
-  data.tar.gz: ba392c6f51965d2a2ee97addde1be08348461be66ddede838abb1909a11d0a8e118463d7a8f0475ccbadc69669b02a7f0200036ca9acf6e3faa597e314c2f528
+  metadata.gz: 9896edaac0beb4a622c4d1c7df3df42ad58767770772b8365afa275f045667d5ae0f5c808f3248077560386e966bad0ee9bd58281b1e5af41079d2cc2ccae5e0
+  data.tar.gz: e26923a7bc61d68228b1de9ab79d679c50c8e4ed97d9b80bda4eb3eeebe41eb0620f2ca833a63eb96a77961e0fac6e14ac6569512a37b5192921511a2b2ce839

data/ChangeLog

@@ -1,3 +1,9 @@
+2.1.1:
+  - Fix "factories" implementation for Google's build system.
+
+2.1.0:
+  - Add "factories" impelmentation
+
 2.0.0:
   - Adding support for Google Ads API v1_2.
   - Removing support for Google Ads API v0.

data/README.md

@@ -113,7 +113,12 @@ To fetch a specific service, for example CampaignService:
 See the provided [examples][] for more detailed demonstrations of how to use the
 library.
 
+Once you're familiar with the [examples][], we also recommend familiarizing
+yourself with [factories][], which provides a set of high level convenience
+methods for working with the Google Ads API
+
 [examples]: https://github.com/googleads/google-ads-ruby/blob/master/examples
+[factories]: https://developers.google.com/google-ads/api/docs/client-libs/ruby/factories
 
 ## Logging
 

data/Rakefile

@@ -37,4 +37,9 @@ task :apply_patches do |t|
   apply_patches
 end
 
-task :build => [:apply_patches, :validate_protos]
+task :codegen do |t|
+  `./scripts/codegen.sh`
+end
+
+task :build => [:apply_patches, :codegen, :validate_protos]
+task :test => [:codegen]

data/google_ads_config.rb

@@ -1,15 +1,39 @@
 # This is an example configuration file for the Google Ads API Ruby client
 # library.
-# Please fill in the required fields and copy it to your home directory.
+# Copy it to your home directory and fill in all the required values.
 
 Google::Ads::GoogleAds::Config.new do |c|
-  # These fields are required to make any API call
+  # The developer token is required to authenticate that you are allowed to
+  # make API calls.
+  c.developer_token = 'INSERT_DEVELOPER_TOKEN_HERE'
+
+  # Authentication tells the API that you are allowed to make changes to the
+  # specific account you're trying to access.
+  # The default method of authentication is to use a refresh token, client id,
+  # and client secret to generate an access token.
   c.client_id = 'INSERT_CLIENT_ID_HERE'
   c.client_secret = 'INSERT_CLIENT_SECRET_HERE'
   c.refresh_token = 'INSERT_REFRESH_TOKEN_HERE'
-  c.developer_token = 'INSERT_DEVELOPER_TOKEN_HERE'
 
-  # These fields are required only in some circumstances
+  # Alternatively, you may specify your own custom authentication, which can be:
+  # A `Google::Auth::Credentials` uses a the properties of its represented
+  # keyfile for authenticating requests made by this client.
+  # A `String` will be treated as the path to the keyfile to be used for the
+  # construction of credentials for this client.
+  # A `Hash` will be treated as the contents of a keyfile to be used for the
+  # construction of credentials for this client.
+  # A `GRPC::Core::Channel` will be used to make calls through.
+  # A `GRPC::Core::ChannelCredentials` for the setting up the RPC client. The
+  # channel credentials should already be composed with a
+  # `GRPC::Core::CallCredentials` object.
+  # A `Proc` will be used as an updater_proc for the Grpc channel. The proc
+  # transforms the metadata for requests, generally, to give OAuth credentials.
+  # To use one of these methods, uncomment the following line and add some code
+  # to look up one of the authentication methods listed above. If set, the
+  # authentication field will override the client_id, client_secret, and
+  # refresh_token fields above.
+  # c.authentication = INSERT_AUTHENTICATION_METHOD_HERE
+
   # Required for manager accounts only: Specify the login customer ID used to
   # authenticate API calls. This will be the customer ID of the authenticated
   # manager account. If you need to use different values for this field, then
@@ -17,9 +41,8 @@ Google::Ads::GoogleAds::Config.new do |c|
   # value.
   # c.login_customer_id = 'INSERT_LOGIN_CUSTOMER_ID_HERE'
 
-  # Logging-related fields. If you want to specify your own custom logger, then
-  # call client.logger = your_logger, which will override all these options and
-  # use your custom logger instead, exactly as you configured it.
+  # Logging-related fields. You may also specify a logger after instantiation
+  # by using client.logger=.
 
   # By default, only log warnings or errors. You can change this to 'INFO' to
   # log all requests and responses from the server.
@@ -32,9 +55,8 @@ Google::Ads::GoogleAds::Config.new do |c|
   # or an open file.
   c.log_target = STDOUT
 
-  # Instead of specifying logging through level and target, you can also
-  # pass a logger directly (for e.g. passing Rails.logger in a
-  # config/initializer). The passed logger will override log_level and
-  # log_target
+  # Instead of specifying logging through level and target, you can also pass a
+  # logger directly (e.g. passing Rails.logger in a config/initializer). The
+  # passed logger will override log_level and log_target.
   # c.logger = Logger.new(STDOUT)
 end

data/lib/google/ads/google_ads/config.rb

@@ -23,6 +23,8 @@ module Google
         attr_accessor :refresh_token
         attr_accessor :client_id
         attr_accessor :client_secret
+        attr_accessor :authentication
+
         attr_accessor :developer_token
         attr_accessor :login_customer_id
 
@@ -34,12 +36,15 @@ module Google
           @refresh_token = nil
           @client_id = nil
           @client_secret = nil
+          @authentication = nil
+
           @developer_token = nil
           @login_customer_id = nil
 
           @log_level = nil
           @log_target = nil
           @logger = nil
+
           yield self if block_given?
         end