Biblioteka klienta .NET

Biblioteka klienta .NET jest hostowana w GitHubie i rozpowszechniana jako pakiet NuGet. Oferuje ona kilka funkcji, które ułatwiają korzystanie z interfejsu API, w tym łatwiejsze zarządzanie danymi logowania i tworzenie klientów usług interfejsu Google Ads API.

Biblioteka obsługuje te platformy .NET:

  • .NET Framework 4.7.2 i nowsze (net472)
  • .NET Standard 2.1 (netstandard2.1)
  • .NET 8.0 (net8.0)

.NET Standard 2.1 jest zgodny z kilkoma innymi wersjami i implementacjami .NET, więc biblioteka może działać prawidłowo na wielu innych platformach. Nie przetestowaliśmy jednak oficjalnie zgodności, dlatego nie obsługujemy oficjalnie tych platform. Więcej informacji znajdziesz w dokumentacji.NET Standard 2.1.

Biblioteka .NET interfejsu Google Ads API używa Grpc.Net.Client jako domyślnej warstwy transportowej, a na nieobsługiwanych platformach przełącza się na Grpc.Core. Możesz wymusić użycie Grpc.Core, ustawiając UseGrpcCore na true, ale pamiętaj, że Grpc.Core jest przestarzały i przeznaczony tylko do obsługi starszych wersji. Więcej informacji znajdziesz w przewodniku po podstawowym użyciu.

Wykonaj pierwsze wywołanie interfejsu API

Aby korzystać z interfejsu Google Ads API, musisz wykonać kilka czynności, aby uzyskać dostęp do interfejsu API i skonfigurować konta Google Ads. Postępuj zgodnie z krótkim przewodnikiem (dla początkujących), który przeprowadzi Cię przez wszystkie ważne kroki, w tym konfigurację kont Google Ads.

Podstawowe użycie

Zainicjuj GoogleAdsClient za pomocą ustawień konfiguracji i pobierz klienta usługi, aby wykonywać wywołania interfejsu API:

GoogleAdsClient client = new GoogleAdsClient();
GoogleAdsServiceClient googleAdsService =
    client.GetService(Services.V26.GoogleAdsService);

Więcej informacji o korzystaniu z biblioteki klienta .NET znajdziesz w przewodniku po podstawowym użyciu.

Autoryzacja i uwierzytelnianie

Biblioteka klienta .NET obsługuje kilka metod uwierzytelniania i autoryzacji, w tym dane logowania użytkownika OAuth 2.0 (w przypadku aplikacji na komputery i aplikacji internetowych), konta usługi, domyślne uwierzytelnianie aplikacji (v24.1.0 i nowsze) oraz ręczne wstrzykiwanie danych logowania (v27.0.0 i nowsze). Więcej informacji znajdziesz w przewodniku po autoryzacji i uwierzytelnianiu.

Konfiguracja i logowanie

Biblioteka klienta .NET obsługuje wiele opcji konfiguracji i logowania za pomocą obiektów środowiska wykonawczego, plików App.config plików konfiguracyjnych JSON lub zmiennych środowiskowych. Jeśli chcesz zmodyfikować sposób logowania w bibliotece klienta, zapoznaj się z przewodnikiem po niestandardowym przechwytywaniu gRPC.

Narzędzia

Biblioteka klienta .NET zawiera klasy narzędziowe, które ułatwiają korzystanie z interfejsu API, w tym pomocników przesyłania multimediów i filmów (UploadVideo w wersji v27.2.0 i nowszych). Aby dowiedzieć się więcej, zapoznaj się z tymi przewodnikami:

Dostosowywanie wydajności aplikacji

Więcej informacji o dostosowywaniu wydajności aplikacji znajdziesz w przewodniku po dostrajaniu wydajności.