Клиентская библиотека .NET размещена на GitHub и распространяется как пакет NuGet. Она предлагает ряд функций, которые упрощают работу с API, в том числе управление учетными данными и создание сервисных клиентов Google Ads 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. Вы можете принудительно использовать Grpc.Core, задав для UseGrpcCore значение true, но учтите, что Grpc.Core устарел и предназначен только для поддержки устаревших систем. Дополнительную информацию можно найти в руководстве по использованию.
Выполнение первого вызова API
Чтобы использовать Google Ads API, необходимо выполнить несколько шагов для получения доступа к API и настроить аккаунты Google Рекламы. Следуйте краткому руководству, в котором описаны все важные шаги, включая настройку аккаунтов Google Рекламы.
Как пользоваться отчетом
Инициализируйте GoogleAdsClient с помощью настроек конфигурации и получите клиент сервиса, чтобы выполнять вызовы API:
GoogleAdsClient client = new GoogleAdsClient();
GoogleAdsServiceClient googleAdsService =
client.GetService(Services.V26.GoogleAdsService);
Подробные сведения о том, как использовать клиентскую библиотеку .NET, можно найти в руководстве по началу работы.
Авторизация и аутентификация
Клиентская библиотека .NET поддерживает несколько способов аутентификации и авторизации, в том числе учетные данные пользователя OAuth 2.0 (для приложений для ПК и веб-приложений), сервисные аккаунты, учетные данные приложения по умолчанию (v24.1.0 и более поздние версии) и ручной ввод учетных данных (v27.0.0 и более поздние версии). Подробнее об авторизации и аутентификации…
Настройка и ведение журнала
Клиентская библиотека .NET поддерживает несколько вариантов конфигурации и ведения журналов с использованием объектов времени выполнения, файлов App.config, файлов конфигурации JSON или переменных среды. Если вам нужно изменить поведение клиентской библиотеки при ведении журнала, ознакомьтесь с руководством по использованию пользовательского перехватчика gRPC.
Утилиты
Клиентская библиотека .NET включает вспомогательные классы, которые упрощают работу с API, в том числе помощники по загрузке медиафайлов и видео (UploadVideo в v27.2.0 и более поздних версиях).
Дополнительную информацию можно найти в следующих руководствах:
Как повысить производительность приложения
Рекомендации по оптимизации производительности приложения приведены в руководстве по настройке производительности.