Biblioteka klienta .NET

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

Biblioteka obsługuje te platformy .NET:

  • .NET Framework 4.7.2 lub nowszy (net472)
  • .NET Standard 2.1 (netstandard2.1)
  • .NET 8.0 (net8.0)

Standard .NET 2.1 jest zgodny z kilkoma innymi wersjami i implementacjami .NET, więc biblioteka może działać na wielu innych platformach. Nie przetestowaliśmy jednak oficjalnie zgodności i 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 korzysta z Grpc.Core. Możesz wymusić używanie Grpc.Core, ustawiając UseGrpcCore na true, ale pamiętaj, że Grpc.Core jest wycofany i przeznaczony tylko do starszych wersji. Więcej informacji znajdziesz w podstawowym przewodniku po usłudze.

Instalacja

Zainstaluj pakiet NuGet Google.Ads.GoogleAds w projekcie za pomocą narzędzia wiersza poleceń dotnet:

dotnet add package Google.Ads.GoogleAds

Aby wczytać ustawienia konfiguracji z appsettings.json, App.config lub zmiennych środowiskowych, zainstaluj też pakiet Google.Ads.GoogleAds.Extensions:

dotnet add package Google.Ads.GoogleAds.Extensions

Wykonaj pierwsze wywołanie interfejsu API

Aby korzystać z interfejsu Google Ads API, musisz wykonać kilka czynności, które pozwolą Ci uzyskać dostęp do interfejsu API i skonfigurować konta Google Ads. Skorzystaj z krótkiego przewodnika, który przeprowadzi Cię przez wszystkie ważne kroki, w tym konfigurowanie kont Google Ads.

Podstawowe użycie

Zainicjuj GoogleAdsConfig i GoogleAdsClient za pomocą ustawień konfiguracji, pobierz GoogleAdsServiceClient i prześlij strumieniowo wiersze kampanii za pomocą 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}");
}

Więcej informacji o korzystaniu z biblioteki klienta .NET znajdziesz w podstawowym przewodniku.

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 komputerowych i 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 appsettings.json lub niestandardowych plików JSON, zmiennych środowiskowych lub plików App.config. Jeśli chcesz zmodyfikować sposób logowania biblioteki klienta, zapoznaj się z przewodnikiem po niestandardowych przechwytywaczach gRPC.

Narzędzia

Biblioteka klienta .NET zawiera klasy narzędzi, które zwiększają użyteczność interfejsu API, w tym funkcje pomocnicze do 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

Zapoznaj się z przewodnikiem po dostrajaniu wydajności, aby dowiedzieć się, jak dostosować wydajność aplikacji.