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 simple 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 de .NET. La bibliothèque peut donc fonctionner correctement sur de nombreuses autres plates-formes. Cependant, nous n'avons pas officiellement testé la compatibilité et, par conséquent, nous ne prenons 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 remplacement par 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 n'est destiné qu'à la maintenance des anciens systèmes. Pour en savoir plus, consultez le guide d'utilisation de base.
Installation
Installez le package NuGet Google.Ads.GoogleAds dans votre projet à l'aide de l'outil de ligne de commande dotnet :
dotnet add package Google.Ads.GoogleAds
Pour charger les paramètres de configuration à partir de appsettings.json, App.config ou de variables d'environnement, installez également le package Google.Ads.GoogleAds.Extensions :
dotnet add package Google.Ads.GoogleAds.Extensions
Effectuer votre premier appel d'API
Pour utiliser l'API Google Ads, vous devez suivre plusieurs étapes afin d'accéder à l'API et de 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 GoogleAdsConfig et GoogleAdsClient avec vos paramètres de configuration, récupérez GoogleAdsServiceClient et diffusez les lignes de la campagne avec 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}");
}
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 accepte plusieurs options de configuration et de journalisation à l'aide d'objets d'exécution, de fichiers appsettings.json ou JSON personnalisés, de variables d'environnement ou de fichiers App.config. Si vous devez modifier le comportement de journalisation de la bibliothèque cliente, consultez le guide sur l'intercepteur gRPC personnalisé.
Utilitaires
La bibliothèque cliente .NET inclut des classes d'utilitaires pour améliorer la facilité d'utilisation de l'API, y compris des assistants d'importation de contenus multimédias et de vidéos (UploadVideo dans v27.2.0 et versions ultérieures).
Pour en savoir plus, consultez les guides suivants :
Affiner les performances de votre application
Consultez le guide d'optimisation des performances pour obtenir des recommandations sur la façon d'ajuster les performances de votre application.