Обзор
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 для переговоров, посетите следующие ресурсы:
Дополнительные сведения о переговорах в пользовательском интерфейсе Торговой площадки авторизованных покупателей см. в следующих статьях: