Konfiguracja

Konfigurowanie odbywa się przy użyciu klasy Config. Możesz uzyskać dostęp do tych zajęć w wielu takie jak zapisanie pliku konfiguracji, określenie wartości podczas tworzenia, wczytywaniu wartości ze zmiennych środowiskowych.

Plik konfiguracji

Jako google_ads_config.rb plik używany przy tworzeniu instancji klienta.

Jeśli nie używasz żadnych argumentów podczas tworzenia instancji:

client = Google::Ads::GoogleAds::GoogleAdsClient.new

biblioteka przeszuka lokalizację wskazanej w parametrze Zmienna środowiskowa GOOGLE_ADS_CONFIGURATION_FILE_PATH. Jeśli ta zmienna to nie zostanie ustawiona, biblioteka poszuka pliku w katalogu HOME.

Możesz też podać ścieżkę:

client = Google::Ads::GoogleAds::GoogleAdsClient.new("path/to/file.rb")

W takim przypadku klient odszuka plik w podanej ścieżce.

Najłatwiejszym sposobem wygenerowania tego pliku jest skopiowanie pliku google_ads_config.rb z do repozytorium GitHub i zmodyfikować je, tak aby zawierało token odświeżania, identyfikator klienta i tajny klucz klienta.

Konfiguracja dynamiczna

Konfigurację możesz skonfigurować dynamicznie podczas tworzenia instancji biblioteki, a nawet później:

client = Google::Ads::GoogleAds::GoogleAdsClient.new do |config|
  config.client_id = 'INSERT_CLIENT_ID_HERE'
  # ... more configuration
end

Możesz nawet zmodyfikować konfigurację po utworzeniu instancji:

client.configure do |config|
  config.login_customer_id = 'INSERT_LOGIN_CUSTOMER_ID_HERE'
  # ... more configuration
end

Pola konfiguracji

Obiekt Config obsługuje poniższe pola.

Pola ogólne:

  • refresh_token: token odświeżania OAuth.
  • client_id: identyfikator klienta OAuth.
  • client_secret: tajny klucz klienta OAuth.
  • developer_token: token programisty pozwalający na dostęp do interfejsu API.
  • login_customer_id: Zobacz login-customer-id.

Pola logowania. Szczegółowe informacje znajdziesz w przewodniku dotyczącym logowania.

  • log_level: minimalny poziom komunikatów, które mają być rejestrowane. Przykład: określenie 'DEBUG' spowoduje, że zostaną wyświetlone wszystkie komunikaty logu i określenie Reguła 'INFO' wykluczy wiadomości z funkcji DEBUG, ale wyświetli wszystkie pozostałe.
  • log_target: miejsce, w którym chcesz się zalogować, np. STDERR.
  • logger: określ własny niestandardowy rejestrator. Określenie tej opcji spowoduje zastąpienie obu log_level i log_target.

Zmienne środowiskowe

Bibliotekę klienta możesz skonfigurować za pomocą zmiennych środowiskowych. Nie ładowane domyślnie i wymaga dodatkowego wywołania po utworzeniu instancji klienta. Zobacz pełną listę zmiennych środowiskowych popierane przez wszystkich języki.

Aby wczytać zmienne środowiskowe do Config, wywołaj load_environment_config:

client = Google::Ads::GoogleAds::GoogleAdsClient.new
client.load_environment_config

Przy każdym wywołaniu bieżący stan zmiennych środowiskowych będzie zastąpić wszystko, co znajduje się już w Config. W związku z tym możesz mieć na przykład domyślną konfigurację, ale zastąpić konkretne za pomocą zmiennych środowiskowych lub można całkowicie skonfigurować zmiennych środowiskowych.

Oprócz zmiennych środowiskowych obsługiwanych przez wszystkie biblioteki pakiet Ruby ma dwie dodatkowe zmienne:

  • GOOGLE_ADS_RUBY_LOG_LEVEL: jak log_level powyżej.
  • GOOGLE_ADS_RUBY_HTTP_PROXY: określ serwer proxy HTTP.