La bibliothèque cliente .NET est hébergée sur GitHub et distribuée sous forme de package NuGet. Elle 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 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. Bien que vous puissiez forcer l'utilisation de Grpc.Core en définissant UseGrpcCore sur true, notez que Grpc.Core est obsolète et destiné uniquement à la maintenance héritée. Pour en savoir plus, consultez le
guide d'utilisation de base.
Effectuez votre premier appel d'API
Pour utiliser l'API Google Ads, vous devez suivre plusieurs étapes pour y accéder et configurer vos comptes Google Ads. Suivez le guide de démarrage rapide, qui vous explique 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.V26.GoogleAdsService);
Pour en savoir plus sur l'utilisation de la bibliothèque cliente .NET, consultez le guide d'utilisation de base pour en savoir plus sur l'utilisation de la.
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 Web et de bureau), 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 d'autorisation et d'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,
JSON de configuration ou de variables d'environnement. Si vous devez modifier
le comportement de journalisation de la bibliothèque cliente, consultez le
guide de l'intercepteur gRPC personnalisé.
Utilitaires
La bibliothèque cliente .NET inclut des classes utilitaires pour améliorer la convivialité de l'API, y compris des assistants de mise en ligne de médias et de vidéos (UploadVideo dans v27.2.0 et versions ultérieures).
Pour en savoir plus, consultez les guides suivants :
Ajuster les performances de votre application
Pour obtenir des recommandations sur l'ajustement des performances de votre application, consultez le guide d'optimisation des performances pour savoir comment affiner les performances de votre application.