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 Webanwendungsabläufe

Wenn Sie den Desktop- oder Web-Anwendungsablauf verwenden, werden folgende Schlüssel 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

Der SearchAds360Client und sein Builder unterstützen die Kombination verschiedener Konfigurationsstrategien. Sie können beispielsweise mit dem folgenden Snippet eine Attributdatei verwenden, um die Anmeldedaten der Instanz und für andere Attribute zu konfigurieren.

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

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

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

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