Клиентская библиотека .NET размещена на GitHub и распространяется в виде пакета NuGet . Она предлагает ряд функций, которые помогут вам использовать API, включая упрощенное управление учетными данными и создание клиентов для сервиса Google Ads API.
Библиотека поддерживает следующие платформы .NET:
- .NET Framework 4.7.2 и более поздние версии (
net472) - .NET Стандарт 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 на неподдерживаемых платформах. Хотя вы можете принудительно использовать Grpc.Core , установив параметр UseGrpcCore в true , обратите внимание, что Grpc.Core устарел и предназначен только для поддержки устаревших систем. Подробнее см. в руководстве по базовому использованию .
Выполните свой первый вызов API.
Для использования API Google Ads необходимо выполнить несколько шагов, чтобы получить доступ к 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 включает в себя вспомогательные классы для повышения удобства использования API, в том числе вспомогательные классы для загрузки медиафайлов и видео ( UploadVideo в v27.2.0 и более поздних). Для получения дополнительной информации обратитесь к следующим руководствам:
Оптимизируйте производительность вашего приложения.
Для получения рекомендаций по оптимизации производительности вашего приложения обратитесь к руководству по настройке производительности .