Konfiguration

Die Ads API-Clientbibliothek bietet mehrere Konfigurationseinstellungen, mit denen Sie das Verhalten der Bibliothek anpassen können.

Konfigurationsdatei

Sie können eine googleads.properties Datei angeben, die beim Instanziieren des Clients verwendet werden soll.

Wenn Sie beim Instanziieren keine Argumente verwenden:

my $api_client = Google::Ads::GoogleAds::Client->new();

sucht die Bibliothek im Verzeichnis HOME nach der Datei.

Alternativ können Sie einen Pfad angeben:

my $properties_file = "/path/to/googleads.properties";

my $api_client = Google::Ads::GoogleAds::Client->new({
  properties_file => $properties_file
});

In diesem Fall sucht der Client an diesem Pfad nach der Datei.

Am einfachsten erstellen Sie diese Datei, indem Sie die Datei googleads.properties aus dem GitHub-Repository kopieren und so ändern, dass sie Ihre Client-ID, Ihr Client-Secret und Ihr Aktualisierungstoken enthält.

Dynamische Konfiguration

Sie können die Konfiguration dynamisch einrichten, wenn Sie die Bibliothek instanziieren oder auch später:

my $api_client = Google::Ads::GoogleAds::Client->new({
  login_customer_id => "INSERT_LOGIN_CUSTOMER_ID_HERE"
});

Sie können die Konfiguration auch nach der Instanziierung ändern:

$api_client->set_login_customer_id("INSERT_LOGIN_CUSTOMER_ID_HERE");

Sie können auch ein OAuth2ApplicationsHandler Objekt vom API Client, und die Client-ID, das Client-Secret und das Aktualisierungstoken zur Laufzeit ändern:

my $oauth2_applications_handler = $api_client->get_oauth2_applications_handler();
$oauth2_applications_handler->set_client_id("INSERT_CLIENT_ID");
$oauth2_applications_handler->set_client_secret("INSERT_CLIENT_SECRET");
$oauth2_applications_handler->set_refresh_token("INSERT_REFRESH_TOKEN");

Umgebungsvariablen für die Konfiguration

Sie können einige der Konfigurationseinstellungen beim Instanziieren von Clients aus Umgebungsvariablen festlegen (siehe die vollständige Liste).

Das Clientmodul bietet die Funktion configure_from_environment_variables, mit der Werte aus Umgebungsvariablen geladen werden können:

# Get the Google Ads Client. By default, any credentials will be read from
# ~/googleads.properties, or, if set, from the file specified in the
# GOOGLE_ADS_CONFIGURATION_FILE_PATH environment variable.
my $api_client = Google::Ads::GoogleAds::Client->new();

# Load the configuration from any set environment variables.
$api_client->configure_from_environment_variables();

Felder für die Konfiguration

Die Konfigurationseigenschaften unterstützen die folgenden Felder:

In OAuth2ApplicationsHandler gespeicherte Felder:

  • client_id: Ihre OAuth2-Client-ID.
  • client_secret: Ihr OAuth2-Client-Secret.
  • refresh_token: Ihr OAuth2-Aktualisierungstoken.

Im API-Client gespeicherte Felder:

  • login_customer_id: Weitere Informationen finden Sie in der Dokumentation zu login-customer-id.
  • proxy: Die URL des Proxyservers, der für die Internetverbindung verwendet wird.