La libreria client .NET è ospitata su GitHub e viene distribuita come pacchetto NuGet. Offre diverse funzionalità per aiutarti a utilizzare l'API, tra cui una gestione più semplice delle credenziali e la creazione di client di servizio dell'API Google Ads.
La libreria supporta i seguenti framework .NET:
- .NET Framework 4.7.2 e versioni successive (
net472) - .NET Standard 2.1 (
netstandard2.1) - .NET 8.0 (
net8.0)
.NET Standard 2.1 è compatibile con diverse altre versioni e implementazioni di .NET, pertanto la libreria potrebbe funzionare correttamente su molte altre piattaforme. Tuttavia, non abbiamo testato ufficialmente la compatibilità e pertanto non supportiamo ufficialmente queste piattaforme. Per saperne di più, consulta la documentazione di.NET Standard 2.1.
La libreria .NET dell'API Google Ads utilizza Grpc.Net.Client come livello di trasporto predefinito, con un fallback a Grpc.Core sulle piattaforme non supportate. Sebbene tu possa forzare l'utilizzo di Grpc.Core impostando UseGrpcCore su true, tieni presente che Grpc.Core è deprecato ed è destinato solo alla manutenzione legacy. Per saperne di più, consulta la guida all'utilizzo di base.
Installazione
Installa il pacchetto NuGet Google.Ads.GoogleAds nel tuo progetto utilizzando lo strumento a riga di comando dotnet:
dotnet add package Google.Ads.GoogleAds
Per caricare le impostazioni di configurazione da appsettings.json, App.config o dalle variabili di ambiente, installa anche il pacchetto Google.Ads.GoogleAds.Extensions:
dotnet add package Google.Ads.GoogleAds.Extensions
Fai la tua prima chiamata API
Per utilizzare l'API Google Ads, devi eseguire diversi passaggi per ottenere l'accesso all'API e configurare i tuoi account Google Ads. Segui la guida rapida, che ti illustra tutti i passaggi importanti, inclusa la configurazione degli account Google Ads.
Utilizzo di base
Inizializza GoogleAdsConfig e GoogleAdsClient con le impostazioni di configurazione, recupera GoogleAdsServiceClient e trasmetti in streaming le righe della campagna con 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}");
}
Per saperne di più su come utilizzare la libreria client .NET, consulta la guida all'utilizzo di base.
Autorizzazione e autenticazione
La libreria client .NET supporta diversi approcci all'autenticazione e
all'autorizzazione, tra cui le credenziali utente OAuth 2.0 (per applicazioni desktop e web), i service account, le credenziali predefinite dell'applicazione (v24.1.0 e versioni successive) e l'inserimento manuale delle credenziali (v27.0.0 e versioni successive). Per saperne di più, consulta la guida all'autorizzazione e all'autenticazione.
Configurazione e logging
La libreria client .NET supporta più opzioni di configurazione e logging utilizzando oggetti di runtime, appsettings.json o file JSON personalizzati, variabili di ambiente o file App.config. Se devi modificare il comportamento di logging della libreria client, consulta la guida all'intercettatore gRPC personalizzato.
Utilità
La libreria client .NET include classi di utilità per migliorare l'usabilità dell'API, tra cui helper per il caricamento di contenuti multimediali e video (UploadVideo in v27.2.0 e versioni successive).
Per saperne di più, consulta le seguenti guide:
Ottimizza le prestazioni delle applicazioni
Consulta la guida all'ottimizzazione delle prestazioni per suggerimenti su come ottimizzare le prestazioni della tua applicazione.