Biblioteka klienta .NET jest hostowana w GitHubie i dystrybuowana jako pakiet NuGet. Oferuje on kilka funkcji, które ułatwiają korzystanie z interfejsu API, w tym łatwiejsze zarządzanie danymi logowania i tworzenie klientów usługi 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 z tymi platformami, więc nie obsługujemy ich oficjalnie. 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 w przypadku nieobsługiwanych platform 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 wycofany i przeznaczony tylko do obsługi starszych wersji. Więcej informacji znajdziesz w podstawowym przewodniku po użytkowaniu.
Wykonywanie pierwszego wywołania interfejsu API
Aby korzystać z interfejsu Google Ads API, musisz wykonać kilka czynności, aby uzyskać do niego dostęp i skonfigurować konta Google Ads. Postępuj zgodnie z przewodnikiem szybkiego startu, 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.V25.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 wiele metod uwierzytelniania i autoryzacji, w tym dane logowania użytkownika OAuth 2.0 (w przypadku aplikacji na komputery i internetowych), konta usługi, domyślne dane logowania aplikacji (v24.1.0 i nowsze) oraz ręczne wstrzykiwanie danych logowania (v27.0.0 i nowsze). Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji i uwierzytelniania.
Konfiguracja i logowanie
Biblioteka klienta .NET obsługuje wiele opcji konfiguracji i rejestrowania za pomocą obiektów środowiska wykonawczego, plików App.config, plików konfiguracji JSON lub zmiennych środowiskowych. Jeśli chcesz zmodyfikować sposób rejestrowania zdarzeń przez bibliotekę klienta, zapoznaj się z przewodnikiem po niestandardowych przechwytujących gRPC.
Narzędzia
Biblioteka klienta .NET zawiera klasy narzędziowe, które zwiększają użyteczność interfejsu API, w tym pomocników przesyłania multimediów i filmów (UploadVideo w v27.2.0 i nowszych wersjach).
Aby dowiedzieć się więcej, zapoznaj się z tymi przewodnikami:
Dostosowywanie wydajności aplikacji
W przewodniku po dostrajaniu wydajności znajdziesz rekomendacje dotyczące dostrajania wydajności aplikacji.