.NET 클라이언트 라이브러리

.NET 클라이언트 라이브러리는 GitHub에서 호스팅되며 NuGet 패키지로 배포됩니다. 사용자 인증 정보 관리 및 Google Ads API 서비스 클라이언트 생성 등 API를 사용하는 데 도움이 되는 여러 기능을 제공합니다.

라이브러리는 다음 .NET 프레임워크를 지원합니다.

  • .NET Framework 4.7.2 이상 (net472)
  • .NET Standard 2.1 (netstandard2.1)
  • .NET 8.0 (net8.0)

.NET Standard 2.1은 다른 여러 .NET 버전 및 구현과 호환되므로 라이브러리가 다른 여러 플랫폼에서 제대로 작동할 수 있습니다. 하지만 호환성을 공식적으로 테스트하지 않았으므로 이러한 플랫폼을 공식적으로 지원하지 않습니다. 자세한 내용은 .NET Standard 2.1 문서를 참조하세요.

Google Ads API .NET 라이브러리는 Grpc.Net.Client를 기본 전송 계층으로 사용하며, 지원되지 않는 플랫폼에서는 Grpc.Core로 대체됩니다. UseGrpcCore를 true로 설정하여 Grpc.Core를 강제로 사용할 수 있지만 Grpc.Core는 지원 중단되었으며 기존 유지보수용으로만 사용됩니다. 자세한 내용은 기본 사용 가이드를 참고하세요.

설치

dotnet 명령줄 도구를 사용하여 프로젝트에 Google.Ads.GoogleAds NuGet 패키지를 설치합니다.

dotnet add package Google.Ads.GoogleAds

appsettings.json, App.config 또는 환경 변수에서 구성 설정을 로드하려면 Google.Ads.GoogleAds.Extensions 패키지도 설치합니다.

dotnet add package Google.Ads.GoogleAds.Extensions

첫 번째 API 호출하기

Google Ads API를 사용하려면 몇 가지 단계를 수행하여 API에 액세스하고 Google Ads 계정을 구성해야 합니다. Google Ads 계정 설정을 비롯한 모든 중요한 단계를 안내하는 빠른 시작 가이드를 따르세요.

기본 사용법

구성 설정으로 GoogleAdsConfig 및 GoogleAdsClient를 초기화하고, GoogleAdsServiceClient를 가져오고, 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}");
}

.NET 클라이언트 라이브러리를 사용하는 방법에 관한 자세한 내용은 기본 사용 가이드를 참고하세요.

승인 및 인증

.NET 클라이언트 라이브러리는 OAuth 2.0 사용자 인증 정보 (데스크톱 및 웹 애플리케이션용), 서비스 계정, 애플리케이션 기본 사용자 인증 정보 (v24.1.0 이상), 수동 사용자 인증 정보 삽입 (v27.0.0 이상)을 포함하여 인증 및 승인에 대한 여러 접근 방식을 지원합니다. 자세한 내용은 승인 및 인증 가이드를 참고하세요.

구성 및 로깅

.NET 클라이언트 라이브러리는 런타임 객체, appsettings.json 또는 커스텀 JSON 파일, 환경 변수, App.config 파일을 사용하여 여러 구성 및 로깅 옵션을 지원합니다. 클라이언트 라이브러리의 로깅 동작을 수정해야 하는 경우 커스텀 gRPC 인터셉터 가이드를 참고하세요.

유틸리티

.NET 클라이언트 라이브러리에는 미디어 및 동영상 업로드 도우미 (v27.2.0 이상에서 UploadVideo)를 비롯한 API 사용성을 개선하는 유틸리티 클래스가 포함되어 있습니다. 자세한 내용은 다음 가이드를 참조하세요.

애플리케이션 성능 미세 조정

애플리케이션 성능을 미세 조정하는 방법에 대한 권장사항은 성능 조정 가이드를 참조하세요.