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, quindi la libreria potrebbe funzionare correttamente su molte altre piattaforme. Tuttavia, non abbiamo testato ufficialmente la compatibilità e quindi 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. Anche se puoi forzare l'utilizzo di Grpc.Core impostando UseGrpcCore su true, tieni presente che Grpc.Core è deprecato e destinato solo alla manutenzione legacy. Per saperne di più, consulta la guida all'utilizzo di base.
Fai la tua prima chiamata API
Per utilizzare l'API Google Ads, devi eseguire diversi passaggi per accedere 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 GoogleAdsClient con le impostazioni di configurazione e recupera un
client di servizio per effettuare chiamate API:
GoogleAdsClient client = new GoogleAdsClient();
GoogleAdsServiceClient googleAdsService =
client.GetService(Services.V25.GoogleAdsService);
Consulta la guida all'utilizzo di base per scoprire di più su come utilizzare la libreria client .NET.
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 web e desktop), 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 Autorizzazione e autenticazione.
Configurazione e logging
La libreria client .NET supporta più opzioni di configurazione
e registrazione utilizzando oggetti runtime, file App.config, file di configurazione JSON o variabili di ambiente. Se devi modificare
il comportamento di logging della libreria client, consulta la
guida all'intercettore gRPC personalizzato.
Utilità
La libreria client .NET include classi di utilità per migliorare l'usabilità dell'API, inclusi 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:
Ottimizzare le prestazioni dell'applicazione
Consulta la guida all'ottimizzazione del rendimento per suggerimenti su come ottimizzare le prestazioni della tua applicazione.