Die .NET-Clientbibliothek wird auf GitHub gehostet und als NuGet-Paket verteilt. Sie bietet mehrere Funktionen, die die Verwendung der API erleichtern, darunter eine einfachere Verwaltung von Anmeldedaten und die Erstellung von Google Ads API-Dienstclients.
Die Bibliothek unterstützt die folgenden .NET-Frameworks:
- .NET Framework 4.7.2 und höher (
net472) - .NET Standard 2.1 (
netstandard2.1) - .NET 8.0 (
net8.0)
.NET Standard 2.1 ist mit mehreren anderen .NET-Versionen und ‑Implementierungen kompatibel, sodass die Bibliothek auf vielen anderen Plattformen funktionieren kann. Wir haben die Kompatibilität jedoch nicht offiziell getestet und unterstützen diese Plattformen daher nicht offiziell. Weitere Informationen finden Sie in der Dokumentation zu.NET Standard 2.1.
Die .NET-Bibliothek der Google Ads API verwendet Grpc.Net.Client als Standard-Transportschicht und greift auf nicht unterstützten Plattformen auf Grpc.Core zurück. Sie können die Verwendung von Grpc.Core erzwingen, indem Sie UseGrpcCore auf true setzen. Beachten Sie jedoch, dass Grpc.Core verworfen wurde und nur für die Legacy-Wartung vorgesehen ist. Weitere Informationen finden Sie im Leitfaden zur grundlegenden Nutzung.
Installation
Installieren Sie das Google.Ads.GoogleAds-NuGet-Paket in Ihrem Projekt mit dem dotnet-Befehlszeilentool:
dotnet add package Google.Ads.GoogleAds
Wenn Sie Konfigurationseinstellungen aus appsettings.json, App.config oder Umgebungsvariablen laden möchten, installieren Sie auch das Paket Google.Ads.GoogleAds.Extensions:
dotnet add package Google.Ads.GoogleAds.Extensions
Der erste API-Aufruf
Wenn Sie die Google Ads API verwenden möchten, müssen Sie mehrere Schritte ausführen, um Zugriff auf die API zu erhalten und Ihre Google Ads-Konten zu konfigurieren. Folgen Sie der Kurzanleitung, in der alle wichtigen Schritte beschrieben werden, einschließlich der Einrichtung Ihrer Google Ads-Konten.
Grundlegende Nutzung
Initialisieren Sie GoogleAdsConfig und GoogleAdsClient mit Ihren Konfigurationseinstellungen, rufen Sie GoogleAdsServiceClient ab und streamen Sie Kampagnenzeilen mit SearchStream:
using System;
using Google.Ads.Gax.Config;
using Google.Ads.GoogleAds.Config;
using Google.Ads.GoogleAds.Lib;
using Google.Ads.GoogleAds.V26.Errors;
using Google.Ads.GoogleAds.V26.Services;
GoogleAdsConfig config = new GoogleAdsConfig()
{
OAuth2Mode = OAuth2Flow.APPLICATION,
OAuth2ClientId = "INSERT_CLIENT_ID.apps.googleusercontent.com",
OAuth2ClientSecret = "INSERT_CLIENT_SECRET",
OAuth2RefreshToken = "INSERT_REFRESH_TOKEN",
LoginCustomerId = "INSERT_LOGIN_CUSTOMER_ID_HERE"
};
GoogleAdsClient client = new GoogleAdsClient(config);
GoogleAdsServiceClient googleAdsService =
client.GetService(Services.V26.GoogleAdsService);
string customerId = "INSERT_CUSTOMER_ID_HERE";
string query =
"SELECT campaign.id, campaign.name FROM campaign ORDER BY campaign.id";
try
{
googleAdsService.SearchStream(
customerId,
query,
delegate (SearchGoogleAdsStreamResponse response)
{
foreach (GoogleAdsRow row in response.Results)
{
Console.WriteLine(
$"Campaign ID {row.Campaign.Id}: {row.Campaign.Name}");
}
});
}
catch (GoogleAdsException ex)
{
Console.WriteLine($"Request ID {ex.RequestId} failed: {ex.Message}");
}
Weitere Informationen zur Verwendung der .NET-Clientbibliothek finden Sie im Leitfaden zur grundlegenden Verwendung.
Autorisierung und Authentifizierung
Die .NET-Clientbibliothek unterstützt mehrere Ansätze zur Authentifizierung und Autorisierung, darunter OAuth 2.0-Nutzeranmeldedaten (für Desktop- und Webanwendungen), Dienstkonten, Standardanmeldedaten für Anwendungen (v24.1.0 und höher) und manuelle Injektion von Anmeldedaten (v27.0.0 und höher). Weitere Informationen finden Sie im Leitfaden zur Autorisierung und Authentifizierung.
Konfiguration und Logging
Die .NET-Clientbibliothek unterstützt mehrere Konfigurations- und Logging-Optionen mit Laufzeitobjekten, appsettings.json- oder benutzerdefinierten JSON-Dateien, Umgebungsvariablen oder App.config-Dateien. Wenn Sie das Logging-Verhalten der Clientbibliothek ändern müssen, lesen Sie den Leitfaden zu benutzerdefinierten gRPC-Interceptors.
Dienstprogramme
Die .NET-Clientbibliothek enthält Hilfsklassen zur Verbesserung der API-Nutzerfreundlichkeit, einschließlich Hilfsprogrammen für den Medien- und Video-Upload (UploadVideo in v27.2.0 und höher).
Weitere Informationen finden Sie in den folgenden Leitfäden:
Anwendungsleistung optimieren
Empfehlungen zur Feinabstimmung der Leistung Ihrer Anwendung finden Sie im Leitfaden zur Leistungsoptimierung.