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();

Dann 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 nach der Datei unter diesem Dateipfad.

Am einfachsten ist es, die Datei googleads.properties aus dem GitHub-Repository zu kopieren und so zu ändern, dass sie Ihre Client-ID, Ihren Client-Secret und Ihr Aktualisierungstoken enthält.

Dynamische Konfiguration

Sie können die Konfiguration dynamisch beim Instanziieren der Bibliothek oder auch 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, 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");

Konfigurationsumgebungsvariablen

Einige Konfigurationseinstellungen können beim Instanziieren von Clients über Umgebungsvariablen festgelegt werden (vollständige Liste).

Das Clientmodul bietet die Funktion configure_from_environment_variables 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 Konfigurationseigenschaften unterstützen die folgenden Felder:

Felder, die in OAuth2ApplicationsHandler gespeichert werden:

  • client_id: Ihre OAuth2-Client-ID.
  • client_secret: Ihr OAuth2-Clientschlüssel.
  • refresh_token: Ihr OAuth2-Aktualisierungstoken.

Felder, die im API-Client gespeichert werden:

  • developer_token: Ihr Entwicklertoken für den Zugriff auf die API.
  • login_customer_id: Weitere Informationen finden Sie in der Dokumentation zur Anmelde-Kundennummer.
  • proxy: Die Proxyserver-URL, die für die Internetverbindung verwendet wird.