Die Ads API-Clientbibliothek bietet verschiedene Konfigurationseinstellungen, mit denen Sie das Bibliotheksverhalten anpassen können.
Konfigurationsdatei
Sie können eine googleads.properties
-Datei angeben, die bei der Instanziierung des Clients verwendet werden soll.
Wenn Sie bei der Instanziierung 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 unter diesem Pfad nach der Datei.
Die einfachste Möglichkeit zum Generieren dieser Datei besteht darin, den googleads.properties
aus dem GitHub-Repository zu kopieren und so zu ändern, dass er Ihre Client-ID, Ihren Clientschlüssel und Ihr Aktualisierungstoken enthält.
Dynamische Konfiguration
Sie können die Konfiguration dynamisch bei der Instanziierung der Bibliothek oder sogar danach einrichten:
my $api_client = Google::Ads::GoogleAds::Client->new({
developer_token => "INSERT_DEVELOPER_TOKEN_HERE",
login_customer_id => "INSERT_LOGIN_CUSTOMER_ID_HERE"
});
Sie können die Konfiguration sogar nach der Instanziierung ändern:
$api_client->set_login_customer_id("INSERT_LOGIN_CUSTOMER_ID_HERE");
Sie können auch ein OAuth2ApplicationsHandler-Objekt aus API Client
abrufen und die Client-ID, den Clientschlüssel 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 Konfigurationseinstellungen über Umgebungsvariablen beim Instanziieren von Clients festlegen (siehe vollständige Liste).
Das Client-Modul bietet die configure_from_environment_variables
-Funktion zum Laden von Werten aus Umgebungsvariablen:
# 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 Konfigurationsattribute unterstützen die folgenden Felder:
In OAuth2ApplicationsHandler persistente Felder:
client_id
: Ihre OAuth2-Client-ID.client_secret
: Ihr OAuth2-Clientschlüsselrefresh_token
: Ihr OAuth2-Aktualisierungstoken.
Persistente Felder in API Client:
developer_token
: Ihr Entwicklertoken für den Zugriff auf die API.login_customer_id
: Weitere Informationen finden Sie in der Dokumentation zur Log-in-Kundennummer.proxy
: Die für die Internetverbindung verwendete Proxyserver-URL.