Как направлять

На этой странице представлена ​​подробная информация о том, как выполнять распространенные задачи с помощью API.

Создание пользователей

UserService позволяет пользователю с правами администратора создавать пользователя непосредственно в своей сети. Любой разработчик может сделать это без предварительной регистрации нового пользователя. Например, если вы впервые пробуете API, вместо того, чтобы выполнять каждый вызов API в качестве администратора (по умолчанию для вашего адреса электронной почты), вы можете создать несколько пользователей с такими ролями, как продавец, трафик-менеджер или Рекламодатель для тестирования реальных рабочих процессов.

  1. Создайте несколько новых адресов Gmail, например my.name.salesperson@gmail.com . Альтернативно можно зарегистрировать существующий адрес, отличный от Gmail, в качестве новой учетной записи Google .
  2. Вызовите createUsers с этим новым адресом и выбранной Role .
  3. Вы можете пройти аутентификацию как новый пользователь, используя OAuth 2.0 для создания токена доступа.

Получение корневого AdUnit

Как самый верхний AdUnit , к которому вы можете добавлять дочерние узлы, так и разрешенная глубина вашей иерархии зависят от типа вашей учетной записи (Малый бизнес или Премиум). Самый верхний AdUnit , который поддерживает изменение своих дочерних узлов, называется эффективным корневым AdUnit .

Чтобы получить эффективный корень, вызовите NetworkService.getCurrentNetwork() и проверьте поле effectiveRootAdUnitId в возвращенном объекте Network .

Примечание. Различные типы учетных записей поддерживают разные шаблоны иерархии.

Запрос объекта

Вы ищете объекты по критериям поиска, используя метод get Objects ByStatement() доступный во многих службах, где Object — это определенный тип объекта. Этот метод принимает запрос PQL, который похож на запрос SQL тем, что позволяет указать поля для поиска (где имена полей сопоставляются со свойствами объекта), сортировать, ограничивать и смещать результаты поиска. См. Руководство по PQL , чтобы узнать больше о PQL, а также узнать, по каким полям объектов можно фильтровать.

Создание заказа

Чтобы создать заказ, просто создайте объект Order и задайте идентификаторы рекламодателя, продавца и трафик-менеджера соответствующим пользователям, присвойте уникальное имя и вызовите createOrders() . Результатом будет вновь созданный Order или ошибка.

Пример

См. пример Java-кода для создания заказа .

Создание позиции

Вот шаги для создания новой позиции:

  1. Создайте новый объект Order или используйте существующий.
  2. Создайте новый объект LineItem и задайте тип ротации, массив размеров объявления, даты начала и окончания и другие свойства.
  3. Создайте новый объект InventoryTargeting и укажите, какие объекты Placement или AdUnit следует выбрать в качестве таргетинга или исключить.
  4. Оберните объект InventoryTargeting внутри нового объекта Targeting и назначьте его свойству таргетинга LineItem .
  5. Вызовите метод службы lineitem createLineItems() с новым объектом и проверьте результат, чтобы узнать, был ли создан ваш объект.

Пример

См. пример Java-кода для создания позиции .

Создание креатива

Различные типы объявлений поддерживают разные компоненты: например, графическое объявление поддерживает один исходный файл изображения; Flash-объявление поддерживает два основных файла ресурсов: Flash-файл и файл резервного изображения на случай, если Flash-файл не может быть показан. Для объявлений, размещенных на сторонних сайтах, вы загружаете только фрагмент HTML, который ссылается на файл на стороннем сервере. Посмотрите свой конкретный подкласс Creative , чтобы узнать, какие ресурсы вам придется загрузить, чтобы создать свой креатив.

Пример

См. пример Java-кода для создания графического объявления .

Изменение существующего объекта

Чтобы изменить существующий объект, запросите свой объект, вызвав get Objects ByStatement() , обновите значения в возвращаемых объектах, а затем вызовите update Objects () .

Примечание. Обновленные объекты полностью заменят существующие объекты, поэтому, если вы не зададите значение свойства в отправляемом объекте, сохраненный объект получит значение по умолчанию для этого свойства, а не предыдущее значение.

Изменение статуса объекта

Статус объекта изменяется путем вызова метода perform Object Action() предоставляемого вашей службой. Этот метод принимает два параметра:

  • Экземпляр объекта действия, описывающий то, что вы хотите сделать. Например, служба заказов предоставляет несколько действий, включая ApproveOrders , PauseOrders и ArchiveOrders . Все объекты действий являются производными от базового класса действий, подходящего для вашей службы.
  • PQL-запрос, описывающий, какие объекты следует изменить. Вы можете изменить статус одного или нескольких объектов одновременно, указав соответствующий оператор PQL.

Создание тегов объявлений

Вы не можете создавать теги объявлений с помощью API; вместо этого вы должны использовать веб-сайт Google Ad Manager. Дополнительную информацию см. в разделе Справочного центра по тегам .

Больше примеров

Еще много примеров вы можете найти в примере кода нашей клиентской библиотеки на нескольких разных языках программирования. См. страницу «Клиентские библиотеки и примеры кода» для получения ссылки на примеры на вашем языке программирования.