Konfiguration der Java-Clientbibliothek

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

Die Konfigurationsdatei hat das Format einer Java-Eigenschaftendatei mit Schlüssel/Wert-Paaren. Welche Schlüssel unterstützt werden, hängt vom ausgewählten Authentifizierungsvorgang ab.

Unterstützte Schlüssel für Desktop- und Webanwendungsabläufe

Wenn Sie den Ablauf für Desktop- oder Web-Anwendungen 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 eine Attributdatei verwenden, um die Anmeldedaten der Instanz und andere Attribute mit dem folgenden Snippet zu konfigurieren.

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

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

Wenn Sie sich als Verwaltungskonto authentifizieren, müssen Sie außerdem Folgendes angeben:

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