Konfiguracja

Konfiguracja odbywa się za pomocą klasy Config. Możesz uzyskać dostęp do tej klasy na kilka sposobów, np. pisząc plik konfiguracji, określając wartości podczas tworzenia lub wczytując wartości ze zmiennych środowiskowych.

Plik konfiguracji

Podczas tworzenia instancji klienta możesz określić plik google_ads_config.rb do użycia.

Jeśli podczas tworzenia instancji obiektu GoogleAdsClient nie użyjesz żadnych argumentów, biblioteka będzie szukać w lokalizacji określonej w zmiennej środowiskowej GOOGLE_ADS_CONFIGURATION_FILE_PATH. Jeśli ta zmienna nie jest ustawiona, biblioteka będzie szukać pliku w katalogu HOME.

Możesz też określić ścieżkę podczas tworzenia instancji obiektu GoogleAdsClient, jak pokazano poniżej. W takim przypadku klient będzie szukać pliku w tej ścieżce.

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

Najłatwiejszym sposobem na wygenerowanie tego pliku jest skopiowanie pliku google_ads_config.rb z repozytorium GitHub i zmodyfikowanie go tak, aby zawierał token odświeżania, identyfikator klienta i tajny klucz klienta.

Konfiguracja dynamiczna

Konfigurację możesz skonfigurować dynamicznie podczas tworzenia instancji biblioteki lub 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 te pola.

Pola ogólne:

Pola logowania. Więcej informacji znajdziesz w przewodniku po logowaniu.

  • log_level: minimalny poziom logowania wiadomości, które chcesz rejestrować. Na przykład, określenie 'DEBUG' spowoduje, że zobaczysz wszystkie komunikaty dziennika, a określenie 'INFO' spowoduje wykluczenie komunikatów DEBUG, ale wyświetlenie wszystkich innych komunikatów.
  • log_target: miejsce, w którym chcesz rejestrować, np. STDERR.
  • logger: określ własny niestandardowy rejestrator. Określenie tej opcji spowoduje zastąpienie zarówno log_level, jak i log_target.

Zmienne środowiskowe

Bibliotekę klienta możesz skonfigurować za pomocą zmiennych środowiskowych. Domyślnie nie są one wczytywane i wymagają dodatkowego wywołania po utworzeniu instancji klienta. Zobacz pełną listę zmiennych środowiskowych obsługiwanych przez wszystkie języki.

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

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

Za każdym razem, gdy ta funkcja jest wywoływana, bieżący stan zmiennych środowiskowych zastępuje wszystko, co jest już obecne w Config. Dzięki temu mechanizmowi możesz na przykład mieć domyślną konfigurację, ale zastępować określone wartości za pomocą zmiennych środowiskowych lub skonfigurować wszystko za pomocą zmiennych środowiskowych.

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

  • GOOGLE_ADS_RUBY_LOG_LEVEL: log_level, jak wyjaśniono wcześniej.
  • GOOGLE_ADS_RUBY_HTTP_PROXY: określ serwer proxy HTTP.