.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는 지원 중단되었으며 기존 유지관리용으로만 사용해야 합니다. 자세한 내용은 기본 사용 가이드를 참고하세요.
첫 번째 API 호출하기
Google Ads API를 사용하려면 API에 액세스하고 Google Ads 계정을 구성하는 여러 단계를 실행해야 합니다. Google Ads 계정 설정 등 중요한 단계를 모두 안내하는 빠른 시작 가이드를 따르세요.
기본 사용법
구성 설정으로 GoogleAdsClient를 초기화하고 서비스 클라이언트를 검색하여 API를 호출합니다.
GoogleAdsClient client = new GoogleAdsClient();
GoogleAdsServiceClient googleAdsService =
client.GetService(Services.V25.GoogleAdsService);
.NET 클라이언트 라이브러리 사용 방법에 관한 자세한 내용은 기본 사용 가이드를 참고하세요.
승인 및 인증
.NET 클라이언트 라이브러리는 OAuth 2.0 사용자 사용자 인증 정보 (데스크톱 및 웹 애플리케이션용), 서비스 계정, 애플리케이션 기본 사용자 인증 정보 (v24.1.0 이상), 수동 사용자 인증 정보 삽입 (v27.0.0 이상)을 비롯한 다양한 인증 및 승인 방법을 지원합니다. 자세한 내용은 승인 및 인증 가이드를 참고하세요.
구성 및 로깅
.NET 클라이언트 라이브러리는 런타임 객체, App.config 파일, JSON 구성 파일 또는 환경 변수를 사용하여 여러 구성 및 로깅 옵션을 지원합니다. 클라이언트 라이브러리의 로깅 동작을 수정해야 하는 경우 커스텀 gRPC 인터셉터 가이드를 참고하세요.
유틸리티
.NET 클라이언트 라이브러리에는 미디어 및 동영상 업로드 도우미 (v27.2.0 이상에서 UploadVideo)를 비롯하여 API 사용성을 개선하는 유틸리티 클래스가 포함되어 있습니다.
자세한 내용은 다음 가이드를 참조하세요.
애플리케이션 성능 미세 조정
애플리케이션 성능을 미세 조정하는 방법에 관한 권장사항은 성능 조정 가이드를 참고하세요.