Die .NET-Clientbibliothek wird auf GitHub gehostet und als NuGet-Paket verteilt. Sie bietet mehrere Funktionen, die Ihnen die Verwendung der API erleichtern, darunter die einfachere Verwaltung von Anmeldedaten und die Erstellung von Google Ads API-Serviceclients.
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. Daher funktioniert die Bibliothek möglicherweise auch auf vielen anderen Plattformen. Wir haben die Kompatibilität jedoch nicht offiziell getestet und unterstützen diese Plattformen daher nicht offiziell. Weitere Informationen finden Sie in der .NET Standard 2.1-Dokumentation.
Die Google Ads API .NET-Bibliothek verwendet Grpc.Net.Client als Standardtransportschicht 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 veraltet ist und nur für die Wartung älterer Systeme vorgesehen ist. Weitere Informationen finden Sie im
Leitfaden zur grundlegenden Nutzung.
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, die Sie durch alle wichtigen Schritte führt, einschließlich der Einrichtung Ihrer Google Ads-Konten.
Grundlegende Nutzung
Initialisieren Sie GoogleAdsClient mit Ihren Konfigurationseinstellungen und rufen Sie einen Serviceclient ab, um API-Aufrufe zu tätigen:
GoogleAdsClient client = new GoogleAdsClient();
GoogleAdsServiceClient googleAdsService =
client.GetService(Services.V26.GoogleAdsService);
Weitere Informationen zur Verwendung der .NET-Clientbibliothek finden Sie im Leitfaden zur grundlegenden Nutzung.
Autorisierung und Authentifizierung
Die .NET-Clientbibliothek unterstützt mehrere Ansätze für die 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 die manuelle Anmeldedateninjektion (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, App.config-Dateien,
JSON-Konfigurationsdateien oder Umgebungsvariablen. Wenn Sie
das Loggingverhalten der Clientbibliothek ändern müssen, lesen Sie den
Leitfaden zu benutzerdefinierten gRPC-Interzeptoren.
Dienstprogramme
Die .NET-Clientbibliothek enthält Dienstprogrammklassen, um die API-Nutzung zu verbessern, einschließlich Helfer für das Hochladen von Medien und Videos (UploadVideo in v27.2.0 und höher).
Weitere Informationen finden Sie in den folgenden Leitfäden:
Anwendungsleistung optimieren
Im Leitfaden zur Leistungsoptimierung finden Sie Empfehlungen zur Optimierung der Leistung Ihrer Anwendung.