La bibliothèque cliente .NET est hébergée sur GitHub et distribuée sous forme de package NuGet. Il offre plusieurs fonctionnalités pour vous aider à utiliser l'API, y compris une gestion plus facile des identifiants et la création de clients de service de l'API Google Ads.
La bibliothèque est compatible avec les frameworks .NET suivants :
- .NET Framework 4.7.2 et versions ultérieures (
net472) - .NET Standard 2.1 (
netstandard2.1) - .NET 8.0 (
net8.0)
.NET Standard 2.1 est compatible avec plusieurs autres versions et implémentations .NET. La bibliothèque peut donc fonctionner correctement sur de nombreuses autres plates-formes. Toutefois, nous n'avons pas testé officiellement la compatibilité et nous ne prenons donc pas officiellement en charge ces plates-formes. Pour en savoir plus, consultez la documentation.NET Standard 2.1.
La bibliothèque .NET de l'API Google Ads utilise Grpc.Net.Client comme couche de transport par défaut, avec un retour à Grpc.Core sur les plates-formes non compatibles. Vous pouvez forcer l'utilisation de Grpc.Core en définissant UseGrpcCore sur true, mais notez que Grpc.Core est obsolète et n'est destiné qu'à la maintenance des anciennes versions. Pour en savoir plus, consultez le guide d'utilisation de base.
Effectuer votre premier appel d'API
Pour utiliser l'API Google Ads, vous devez effectuer plusieurs étapes pour y accéder et configurer vos comptes Google Ads. Suivez le guide de démarrage rapide, qui vous guide à travers toutes les étapes importantes, y compris la configuration de vos comptes Google Ads.
Utilisation de base
Initialisez GoogleAdsClient avec vos paramètres de configuration et récupérez un client de service pour effectuer des appels d'API :
GoogleAdsClient client = new GoogleAdsClient();
GoogleAdsServiceClient googleAdsService =
client.GetService(Services.V25.GoogleAdsService);
Consultez le guide d'utilisation de base pour en savoir plus sur l'utilisation de la bibliothèque cliente .NET.
Autorisation et authentification
La bibliothèque cliente .NET est compatible avec plusieurs approches d'authentification et d'autorisation, y compris les identifiants utilisateur OAuth 2.0 (pour les applications de bureau et Web), les comptes de service, les identifiants par défaut de l'application (v24.1.0 et versions ultérieures) et l'injection manuelle d'identifiants (v27.0.0 et versions ultérieures). Pour en savoir plus, consultez le guide sur l'autorisation et l'authentification.
Configuration et journalisation
La bibliothèque cliente .NET est compatible avec plusieurs options de configuration et de journalisation à l'aide d'objets d'exécution, de fichiers App.config, de fichiers de configuration JSON ou de variables d'environnement. Si vous devez modifier le comportement de journalisation de la bibliothèque cliente, consultez le guide sur les intercepteurs gRPC personnalisés.
Utilitaires
La bibliothèque cliente .NET inclut des classes utilitaires pour améliorer la facilité d'utilisation des API, y compris des assistants d'importation de contenus multimédias et vidéo (UploadVideo dans v27.2.0 et versions ultérieures).
Pour en savoir plus, consultez les guides suivants :
Ajuster les performances de votre application
Consultez le guide d'optimisation des performances pour obtenir des recommandations sur la façon d'affiner les performances de votre application.