API торговой площадки

Обзор

API торговой площадки авторизованных покупателей — это набор ресурсов, которые покупатели могут использовать для программного управления следующим:

  • Переговоры с издателями
  • Аукционные пакеты
  • Клиентский доступ к пользовательскому интерфейсу торговой площадки авторизованных покупателей

В этом руководстве представлен API Marketplace и объясняется, как ресурсы API Marketplace сопоставляются с функциями Marketplace в пользовательском интерфейсе Авторизованных покупателей .

Участники торгов и покупатели

API Marketplace соответствует структуре API назначения ставок в реальном времени . Оба API используют bidders и buyers в качестве ресурсов корневого уровня для операций участников торгов и покупателей. Вы можете использовать одни и те же имена участников торгов и покупателей в путях к ресурсам для API ставок в реальном времени и торговой площадки.

Клиенты и пользователи клиентов

Вы можете использовать API Marketplace для создания клиентов и пользователей клиентов и управления ими, а также для программного предоставления агентствам или рекламодателям доступа к вкладке Marketplace в пользовательском интерфейсе Авторизованных покупателей.

Client представляет собой клиента, агентство или рекламодателя, связанного с вашей учетной записью Авторизованных покупателей.

ClientUser представляет конкретного человека, который имеет доступ к пользовательскому интерфейсу под Client . Пользователи клиента не могут получить доступ к API Marketplace. Пользователи клиента имеют ограниченный доступ к вкладке «Торговая площадка» вашего аккаунта. Разрешения пользователей клиента определяются role , указанной в их родительском Client .

Другие ресурсы в Marketplace API ссылаются на клиентов по имени, указанному в ресурсе Clients .

Дополнительную информацию о клиентах и ​​пользователях клиентов в пользовательском интерфейсе Торговой площадки авторизованных покупателей см. в следующих статьях Справочного центра:

Аукционные пакеты

Вы можете использовать API Marketplace для подписки и отмены подписки покупателей и клиентов на аукционные пакеты , а также для просмотра аукционных пакетов, на которые вы подписаны.

AuctionPackage аналогичен пакету таргетинга для инвентаря Marketplace. Например, аукционный пакет может быть нацелен на набор URL-адресов и идентификаторов мобильных приложений, которые соответствуют бизнес-интересам покупателя.

Вы не можете создавать новые аукционные пакеты с помощью API Marketplace. Пользовательский интерфейс торговой площадки авторизованных покупателей можно использовать для создания аукционных пакетов. API торговой площадки не содержит конкретной информации о таргетинге, связанной с пакетами аукционов.

Вы можете делиться аукционными пакетами с другими покупателями и клиентами, а также предоставлять вам доступ к аукционным пакетам, созданным Google или другими покупателями.

Дополнительную информацию см. в разделе Аукционные пакеты .

Профили издателей

Вы можете использовать API Marketplace для просмотра профилей издателей, с которыми вы можете вести переговоры.

PublisherProfile представляет издателя в API Marketplace. Другие ресурсы в Marketplace API относятся к издателям, имя которых указано в их PublisherProfile .

Профили издателей содержат ту же информацию, что и издатели на вкладке «Обнаружение» пользовательского интерфейса торговой площадки авторизованных покупателей.

Дополнительную информацию см. в разделе «Как найти издателей» .

Предложения и сделки

Вы можете использовать API Marketplace для заключения сделок с издателями. Вот несколько способов использования Marketplace API для управления сделками:

Предложения представляют собой последний статус переговоров по одной или нескольким сделкам между покупателем или клиентом и издателем и аналогичны вкладке «Переговоры» пользовательского интерфейса торговой площадки авторизованных покупателей.

Сделки представляют собой последние условия сделки, обсуждаемой в рамках данного предложения, и сопоставимы со списком сделок в пользовательском интерфейсе Торговой площадки авторизованных покупателей с пометкой ТЕКУЩИЕ ПЕРЕГОВОРЫ для данного предложения.

Завершенные сделки представляют собой сделки, которые завершили этап переговоров и готовы к выполнению. Сюда входят сделки, которые уже выполняются. Завершенные сделки аналогичны вкладке «Сделки» в пользовательском интерфейсе торговой площадки авторизованных покупателей.

В зависимости от типа сделки, о которой вы ведете переговоры, поведение разных ресурсов API Marketplace может различаться. Например, покупатели не могут инициировать переговоры по всем типам сделок. Чтобы узнать больше о реализации API Marketplace для переговоров, посетите следующие ресурсы:

Дополнительные сведения о переговорах в пользовательском интерфейсе Торговой площадки авторизованных покупателей см. в следующих статьях: