Die .NET-Clientbibliothek wird auf GitHub gehostet und als NuGet-Paket verteilt. Sie bietet mehrere Funktionen, die Ihnen die Verwendung der API erleichtern, z. B. die einfache 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. Die Bibliothek funktioniert daher möglicherweise 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 Dokumentation zu.NET Standard 2.1.
In der Google Ads API-Bibliothek für .NET wird Grpc.Net.Client als Standard-Transportschicht verwendet. Auf nicht unterstützten Plattformen wird auf Grpc.Core zurückgegriffen. Sie können die Verwendung von Grpc.Core erzwingen, indem Sie UseGrpcCore auf true setzen. Beachten Sie jedoch, dass Grpc.Core eingestellt ist und nur für die Wartung von Legacy-Anwendungen vorgesehen ist. Weitere Informationen finden Sie im Leitfaden zur grundlegenden Verwendung.
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 GoogleAdsClient mit Ihren Konfigurationseinstellungen und rufen Sie einen Dienstclient ab, um API-Aufrufe auszuführen:
GoogleAdsClient client = new GoogleAdsClient();
GoogleAdsServiceClient googleAdsService =
client.GetService(Services.V25.GoogleAdsService);
Weitere Informationen zur Verwendung der .NET-Clientbibliothek finden Sie im Leitfaden zur grundlegenden Verwendung.
Autorisierung und Authentifizierung
Die .NET-Clientbibliothek unterstützt mehrere Authentifizierungs- und Autorisierungsmethoden, darunter OAuth 2.0-Nutzeranmeldedaten (für Desktop- und Webanwendungen), Dienstkonten, Standardanmeldedaten für Anwendungen (v24.1.0 und höher) und die manuelle Einfügung 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, die mit Laufzeitobjekten, App.config-Dateien, JSON-Konfigurationsdateien oder Umgebungsvariablen konfiguriert werden können. Wenn Sie das Logging-Verhalten der Clientbibliothek ändern müssen, lesen Sie den Leitfaden für benutzerdefinierte gRPC-Interceptor.
Dienstprogramme
Die .NET-Clientbibliothek enthält Hilfsklassen zur Verbesserung der API-Nutzerfreundlichkeit, einschließlich Helfer für Media- und Video-Uploads (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.