Die Google Ads API-Clientbibliothek bietet mehrere Konfigurationseinstellungen, mit denen Sie das Verhalten der Bibliothek anpassen können.
Mit App.config konfigurieren
Alle für Google Ads API
spezifischen Einstellungen werden im Knoten GoogleAdsApi
der Datei App.config
gespeichert. Eine typische App.config
-Konfiguration sieht so aus:
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<configSections>
<section name="GoogleAdsApi" type="System.Configuration.DictionarySectionHandler" />
</configSections>
<GoogleAdsApi>
<!-- Set the service timeout in milliseconds. -->
<add key="Timeout" value="2000" />
<!-- Proxy settings for library. -->
<add key="ProxyServer" value="http://localhost:8888"/>
<add key="ProxyUser" value=""/>
<add key="ProxyPassword" value=""/>
<add key="ProxyDomain" value=""/>
<!-- API-specific settings -->
<add key="DeveloperToken" value="******"/>
<!-- OAuth2 settings -->
<add key = "OAuth2Mode" value="APPLICATION"/>
<add key = "OAuth2ClientId" value = "******.apps.googleusercontent.com" />
<add key = "OAuth2ClientSecret" value = "******" />
<add key = "OAuth2RefreshToken" value = "******" />
</GoogleAdsApi>
<startup>
<supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5.2" />
</startup>
</configuration>
Separate App.config-Datei angeben
Wenn Sie Ihr App.config
nicht überladen möchten, können Sie die bibliothekenspezifische Konfiguration mit dem Attribut configSource
in eine eigene Konfigurationsdatei verschieben.
Schritt 1: configSource in Ihrer App.config angeben
Ändern Sie App.config
so:
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<configSections>
<section name="GoogleAdsApi" type="System.Configuration.DictionarySectionHandler"/>
</configSections>
<GoogleAdsApi configSource="GoogleAdsApi.config"/>
...
</configuration>
Schritt 2: Inhalt der Konfigurationsdatei angeben
Erstellen Sie jetzt eine weitere Konfigurationsdatei mit dem Namen, den Sie für configSource
angegeben haben, und verschieben Sie den Konfigurationsknoten aus App.config
in diese Datei:
<?xml version="1.0" encoding="utf-8" ?>
<GoogleAdsApi>
... More settings.
</GoogleAdsApi>
Schritt 3: Build-Regeln in csproj korrigieren
Fügen Sie schließlich eine neue Konfigurationsdatei in Ihr Projekt ein. Ändern Sie die Attribute dieser Datei zu Immer in Ausgabeordner kopieren.
Erstellen Sie nun Ihr Projekt und führen Sie es aus. Ihre Anwendung beginnt mit dem Abrufen von Werten aus der neuen Konfigurationsdatei.
Konfiguration mit einer benutzerdefinierten JSON-Datei
Sie können eine IConfigurationRoot
-Instanz verwenden, um die Clientbibliothek zu konfigurieren.
JSON-Datei erstellen
Erstellen Sie eine JSON-Datei mit dem Namen GoogleAdsApi.json
, die eine ähnliche Struktur wie die Datei App.config
hat.
{
"Timeout": "2000",
"ProxyServer": "http://localhost:8888",
"ProxyUser": "",
"ProxyPassword": "",
"ProxyDomain": "",
"DeveloperToken": "******",
"OAuth2Mode": "APPLICATION",
"OAuth2ClientId": "******.apps.googleusercontent.com",
"OAuth2ClientSecret": "******",
"OAuth2RefreshToken": "******",
}
Konfiguration laden
Laden Sie als Nächstes die JSON-Datei in einen IConfigurationRoot
.
ConfigurationBuilder builder = new ConfigurationBuilder()
.SetBasePath(Directory.GetCurrentDirectory())
.AddJsonFile("GoogleAdsApi.json");
IConfigurationRoot configRoot = builder.Build();
GoogleAdsConfig config = new GoogleAdsConfig(configRoot);
GoogleAdsClient client = new GoogleAdsClient(config);
Konfiguration mit settings.json
Der Prozess ähnelt dem Verwenden eines benutzerdefinierten JSON-Objekts, mit der Ausnahme, dass sich die Schlüssel in einem Abschnitt mit dem Namen GoogleAdsApi
befinden sollten:
{
"GoogleAdsApi":
{
"DeveloperToken": "******",
"OAuth2Mode": "APPLICATION",
"OAuth2ClientId": "******.apps.googleusercontent.com",
"OAuth2ClientSecret": "******",
"OAuth2RefreshToken": "******",
...
}
// More settings...
}
Als Nächstes können Sie die Instanz IConfiguration
auf Ihrer Seite verwenden:
IConfigurationSection section = Configuration.GetSection("GoogleAdsApi");
GoogleAdsConfig config = new GoogleAdsConfig(section);
GoogleAdsClient client = new GoogleAdsClient(config);
Bibliothek zur Laufzeit konfigurieren
Sie können GoogleAdsClient
auch zur Laufzeit initialisieren.
Beispiel 1: Konfiguration zur Laufzeit initialisieren
GoogleAdsConfig config = new GoogleAdsConfig()
{
DeveloperToken = "******",
OAuth2Mode = "APPLICATION",
OAuth2ClientId = "******.apps.googleusercontent.com",
OAuth2ClientSecret = "******",
OAuth2RefreshToken = "******"
};
GoogleAdsClient client = new GoogleAdsClient(config);
Beispiel 2: Aus App.config laden, aber Einstellung überschreiben
GoogleAdsClient client = new GoogleAdsClient(config);
client.Config.DeveloperToken = "******";
Konfiguration mit Umgebungsvariablen
Sie können GoogleAdsClient
auch mithilfe von Umgebungsvariablen initialisieren. Diese Einstellungen werden nicht automatisch übernommen. Sie sollten die Einstellungen auch aus den Umgebungsvariablen wie unten dargestellt laden.
GoogleAdsConfig config = new GoogleAdsConfig();
config.LoadFromEnvironmentVariables();
GoogleAdsClient client = new GoogleAdsClient(config);
Vollständige Liste der unterstützten Umgebungsvariablen
Felder für die Konfiguration
Im Folgenden finden Sie eine Liste der Einstellungen, die von der Google Ads .NET-Bibliothek unterstützt werden.
Verbindungseinstellungen
Timeout
: Verwenden Sie diesen Schlüssel, um das Zeitlimit des Dienstes in Millisekunden festzulegen. Der Standardwert wird basierend auf der Einstellungmethod_config/timeout
in googleads_grpc_service_config.json festgelegt. Legen Sie einen niedrigeren Wert fest, wenn Sie ein kürzeres Limit für die maximale Zeit für einen API-Aufruf erzwingen müssen. Sie können das Zeitlimit auf 2 Stunden oder mehr festlegen. Die API kann aber auch bei Anfragen mit extrem langer Ausführungszeit eine Zeitüberschreitung auslösen und der FehlerDEADLINE_EXCEEDED
zurückgegeben werden.ProxyServer
: Legen Sie dafür die HTTP-Proxyserver-URL fest, wenn Sie einen Proxy für die Verbindung mit dem Internet verwenden.ProxyUser
: Legen Sie hier den Nutzernamen fest, den Sie für die Authentifizierung beim Proxyserver benötigen. Lassen Sie dieses Feld leer, wenn kein Nutzername erforderlich ist.ProxyPassword
: Legen Sie hier das Passwort fürProxyUser
fest, wenn Sie einen Wert fürProxyUser
festlegen.ProxyDomain
: Legen Sie dies für die Domain fürProxyUser
fest, wenn Ihr Proxyserver eine festlegen muss.MaxReceiveMessageLengthInBytes
: Verwenden Sie diese Einstellung, um die maximale Größe der API-Antwort zu erhöhen, die die Clientbibliothek verarbeiten kann. Der Standardwert beträgt 64 MB.MaxMetadataSizeInBytes
: Verwenden Sie diese Einstellung, um die maximale Größe der API-Fehlerantwort zu erhöhen, die die Clientbibliothek verarbeiten kann. Der Standardwert ist 16 MB.
Passen Sie die Einstellungen
MaxReceiveMessageLengthInBytes
undMaxMetadataSizeInBytes
an, um bestimmteResourceExhausted
-Fehler zu beheben. Diese Einstellungen beheben Fehler im FormatStatus(StatusCode="ResourceExhausted",Detail="Received message larger than max (423184132 versus 67108864)"
.In diesem Beispiel ist der Fehler darauf zurückzuführen, dass die Nachrichtengröße (
423184132 bytes
) größer ist, als die Bibliothek (67108864 bytes
) verarbeiten kann. Erhöhen SieMaxReceiveMessageLengthInBytes
auf500000000
, um diesen Fehler zu vermeiden.Der Fehler weist auch darauf hin, dass Ihr Code ein deutlich großes Antwortobjekt verarbeitet hat, z. B. ein großes
SearchGoogleAdsResponse
. Dies kann sich auf die Leistung Ihres Codes auswirken, da .NET den Large Object Heap von .NET verwendet. Wenn dies zu Leistungsbeeinträchtigungen führt, sollten Sie sich überlegen, wie Sie Ihre API-Aufrufe umstrukturieren oder Teile Ihrer Anwendung neu gestalten können.
OAuth2-Einstellungen
Wenn Sie OAuth2 verwenden, um Aufrufe an die Google Ads API-Server zu autorisieren, sollten Sie die folgenden Konfigurationsschlüssel festlegen:
AuthorizationMethod
: Legen SieOAuth2
fest.OAuth2Mode
: Legen SieAPPLICATION
oderSERVICE_ACCOUNT
fest.OAuth2ClientId
: Legen Sie diesen Wert auf Ihre OAuth2-Client-ID fest.OAuth2ClientSecret
: Setzen Sie diesen Wert auf Ihren OAuth2-Clientschlüssel.OAuth2Scope
: Legen Sie diesen Wert auf verschiedene Bereiche fest, wenn Sie OAuth2-Tokens für mehrere APIs autorisieren möchten. Diese Einstellung ist optional.
Wenn Sie OAuth2Mode == APPLICATION
verwenden, müssen Sie die folgenden zusätzlichen Konfigurationsschlüssel festlegen.
OAuth2RefreshToken
: Legen Sie diesen Wert auf ein vorab generiertes OAuth2-Aktualisierungstoken fest, wenn Sie OAuth2-Tokens wiederverwenden möchten. Diese Einstellung ist optional.OAuth2RedirectUri
: Legen Sie diesen Wert auf die OAuth2-Weiterleitungs-URL fest. Diese Einstellung ist optional.
Weitere Informationen finden Sie in den folgenden Anleitungen:
Wenn Sie OAuth2Mode == SERVICE_ACCOUNT
verwenden, müssen Sie die folgenden zusätzlichen Konfigurationsschlüssel festlegen.
OAuth2PrnEmail
: Legen Sie für diesen Wert die E-Mail-Adresse des Kontos fest, das Sie imitieren.OAuth2SecretsJsonPath
: Legen Sie diesen Wert auf den Pfad zur OAuth2-JSON-Konfigurationsdatei fest.
Weitere Informationen finden Sie in der Anleitung OAuth-Dienstkontoablauf.
Transporteinstellungen
UseGrpcCore
: Legen Sie diese Einstellung auftrue
fest, um dieGrpc.Core
-Bibliothek als zugrunde liegende Transportebene zu verwenden. Weitere Informationen finden Sie im Supportleitfaden für gRPC.
Google Ads API-Einstellungen
Die folgenden Einstellungen gelten nur für die Google Ads API.
DeveloperToken
: Legen Sie hier Ihr Entwicklertoken fest.LoginCustomerId
: Dies ist die Kundennummer des autorisierten Kunden, der in der Anfrage ohne Bindestriche (-
) verwendet werden soll.LinkedCustomerId
: Dieser Header ist nur für Methoden erforderlich, die die Ressourcen einer Entität aktualisieren, wenn die Berechtigung über verknüpfte Konten in der Google Ads-UI erteilt wird (AccountLink
-Ressource in der Google Ads API). Legen Sie diesen Wert auf die Kundennummer des Datenanbieters fest, der die Ressourcen der angegebenen Kundennummer aktualisiert. Er sollte ohne Bindestriche (-
) festgelegt werden. Weitere Informationen zu verknüpften Konten