Konfiguration der Java-Clientbibliothek

Die Bibliothek sucht in System.getProperty("user.home") + "/searchads360.properties" nach einer Konfigurationsdatei.

Das Format der Konfigurationsdatei entspricht dem einer Java-Properties-Datei mit Schlüssel/Wert-Paaren. Die unterstützten Schlüssel variieren je nach ausgewähltem Authentifizierungsablauf.

Unterstützte Schlüssel für Desktop- und Webanwendungsflüsse

Wenn du den Ablauf für Desktop- oder Webanwendungen verwendest, sind folgende Tasten unterstützt:

# Credential for accessing Google's OAuth servers.
# Provided by console.cloud.google.com.
api.searchads360.clientId=INSERT_CLIENT_ID_HERE

# Credential for accessing Google's OAuth servers.
# Provided by console.cloud.google.com.
api.searchads360.clientSecret=INSERT_CLIENT_SECRET_HERE

# Renewable OAuth credential associated with 1 or more Search Ads accounts.
api.searchads360.refreshToken=INSERT_REFRESH_TOKEN_HERE

# Required for manager accounts only: Specify the login customer ID used to
# authenticate API calls. This will be the customer ID of the authenticated
# manager account. You can also specify this later in code if your application
# uses multiple manager account + OAuth pairs.
#
# api.searchads360.loginCustomerId=INSERT_LOGIN_CUSTOMER_ID_HERE

Konfigurationsansätze kombinieren

Die SearchAds360Client und ihr Builder unterstützen die Kombination verschiedener Konfigurationsstrategien. Mit dem folgenden Snippet können Sie beispielsweise eine Eigenschaftendatei verwenden, um die Anmeldedaten der Instanz und andere Attribute zu konfigurieren.

SearchAds360Client searchAds360Client = SearchAds360Client.newBuilder()
    .fromPropertiesFile()
    .build();

Sie können weitere Änderungen zur Laufzeit mit den anderen Konfigurationsmethoden des Builders vornehmen, bevor Sie build() aufrufen.

Wenn Sie sich mit einem Verwaltungskonto authentifizieren, müssen Sie zusätzlich Folgendes angeben:

api.searchads360.loginCustomerId --> Manager account ID (with hyphens removed).