googleads dotnet lib

Клиентская библиотека .NET SOAP API Google Ad Manager

В этом проекте размещена клиентская библиотека .NET для SOAP API Google Ad Manager.

Функции

• Распространяется через Nuget
• Классы-заглушки для всех поддерживаемых версий API и сервисов.
• Полезные утилиты
• Сообщения SOAP протоколируются для упрощения отладки.
• Автоматическая обработка заголовков SOAP
• Простое управление учетными данными, аутентификацией и информацией о сеансе.
• Документы доступны в формате HTML и XML.

Поддерживаемые платформы

• .NET Framework 4.5.2+
• .NET Standard 2.0 (ограниченная поддержка)

Объявления и обновления

Обновления и новости API и клиентских библиотек можно найти в нашем блоге разработчиков Google Рекламы: http://googleadsdeveloper.blogspot.com/.

Начиная

1. Установите свою библиотеку. Мы рекомендуем использовать следующий дистрибутив Nuget:

• Google.Dfp: клиентская библиотека DotNet API Менеджера рекламы

Дополнительную информацию о менеджере пакетов nuget можно узнать на сайте http://www.nuget.org. Чтобы узнать о других вариантах распространения, см. альтернативные варианты распространения ниже.

1. Настройте свои учетные данные OAuth2.

API Менеджера рекламы использует OAuth2 в качестве механизма аутентификации. Следуйте соответствующему руководству ниже в зависимости от вашего варианта использования.

Если вы получаете доступ к API, используя свои учетные данные...

• Использование учетных записей служб

Если вы получаете доступ к API от имени клиентов...

• Разработка веб-приложения

Альтернативные варианты распространения

Бинарное распределение

Бинарный дистрибутив библиотеки Ads API .NET состоит из предварительно скомпилированной версии библиотеки в виде сборки .NET, примеров кода для использования библиотеки и документации библиотеки. Если вас интересует только использование библиотеки, а не ее внутренностей, и вы не используете менеджер пакетов nuget в своей среде разработки, вам следует загрузить этот дистрибутив.

Содержимое этой раздачи следующее:

  
    lib
      - Precompiled assemblies.
      - Documentation xmls for the assemblies.
    examples
       Code examples, in C# and VB.NET (when available).
    README
    ChangeLog
    COPYING
    Visual Studio solution file

Чтобы запустить примеры кода:

• Откройте файл решения Visual Studio в корневой папке двоичного дистрибутива в Microsoft Visual Studio.
• Откройте App.config для проекта примеров и следуйте инструкциям в файле, чтобы ввести необходимые значения конфигурации.
• Сохраните и закройте App.config .
• Откройте диалоговое окно «Свойства» для проекта «Примеры» (щелкните правой кнопкой мыши проект «Примеры» по вашему выбору в обозревателе решений и выберите параметр «Свойства» в контекстном меню.).
• Перейдите на вкладку «Отладка» и введите параметры командной строки. Параметры командной строки имеют вид version.examplename . Например, v202308.GetCurrentNetwork – это параметр командной строки для запуска примера GetCurrentNetwork в версии v202308 API Менеджера рекламы.
• Скомпилируйте и запустите проект «Примеры».

Кроме того, каждый пример кода имеет метод main() , поэтому вы можете установить соответствующий пример кода в качестве объекта запуска (выберите вкладку «Приложение» в диалоговом окне «Свойства примеров» и выберите нужный класс из раскрывающегося списка «Объект запуска»).

Чтобы использовать библиотеку в новом проекте:

• Создайте новый проект Visual Studio по вашему выбору (например, приложение C# для Windows).
• Скопируйте папку lib из двоичного дистрибутива в папку вашего проекта. Добавьте ссылки на все сборки в этой папке вашего проекта.
• Добавьте ссылку на System.Web.Services в свой проект.
• Скопируйте examplesApp.config в каталог вашего проекта и добавьте его в свой проект.
• Отредактируйте необходимые ключи в App.config . Если ваше приложение имеет собственный App.config , вам необходимо объединить его содержимое с содержимым examplesApp.config .
• Позвоните в библиотеку, например:

 // Create an appropriate AdsUser instance.
AdManagerUser user = new AdManagerUser();

// Create the required service.
using (NetworkService networkService = user.GetService())
{
    // make calls to service class.
}

Вы можете обратиться к этой статье вики для получения более подробной информации.

Как включить ведение журнала

Подробности см. в https://github.com/googleads/googleads-dotnet-lib/wiki#logging.

Разнообразный

Вики

• https://github.com/googleads/googleads-dotnet-lib/wiki

Трекер проблем

• https://github.com/googleads/googleads-dotnet-lib/issues

Документация API:

• https://developers.google.com/ad-manager/api

Форум поддержки

• https://developers.google.com/doubleclick-publishers/community

Авторы

• https://github.com/AnashOommen
• https://github.com/ChristopherSeeley
• https://github.com/jimper