API de Marketplace

Descripción general

La API de Authorized Buyers Marketplace es un conjunto de recursos que los compradores pueden usar para administrar lo siguiente de manera programática:

  • Negociaciones con los publicadores
  • Paquetes de subasta
  • Acceso de los clientes a la IU de Marketplace de Authorized Buyers

En esta guía, se presenta la API de Marketplace y se explica cómo se asignan los recursos de la API de Marketplace a las funciones de Marketplace en la IU de Authorized Buyers.

Ofertantes y compradores

La API de Marketplace es coherente con la estructura de la API de Ofertas en tiempo real. Ambas APIs usan bidders y buyers como recursos a nivel raíz para las operaciones del ofertante y el comprador. Puedes usar los mismos nombres de ofertante y comprador en las rutas de acceso de los recursos para las APIs de Ofertas en tiempo real y de Marketplace.

Clientes y usuarios del cliente

Puedes usar la API de Marketplace para crear y administrar clientes y usuarios clientes, y otorgar de manera programática a las agencias o los anunciantes acceso a tu pestaña de Marketplace en la IU de Authorized Buyers.

Un Client representa a un cliente, una agencia o un anunciante asociados con tu cuenta de Authorized Buyers.

Un ClientUser representa a una persona específica que tiene acceso a la IU en un Client. Los usuarios cliente no pueden acceder a la API de Marketplace. Los usuarios de clientes tienen acceso limitado a la pestaña Marketplace de tu cuenta. Los permisos del usuario del cliente se determinan según el role especificado en su Client superior.

Otros recursos de la API de Marketplace hacen referencia a los clientes por el nombre especificado en el recurso Clients.

Para obtener más información sobre los clientes y sus usuarios en la IU de Marketplace de Authorized Buyers, consulta los siguientes artículos del Centro de ayuda:

Paquetes de subasta

Puedes usar la API de Marketplace para suscribir y anular la suscripción de compradores y clientes a los paquetes de subasta y para ver los paquetes de subasta a los que te suscribiste.

Un AuctionPackage es similar a un paquete de segmentación para el inventario de Marketplace. Por ejemplo, un paquete de subasta podría orientarse a un conjunto de URLs y de IDs de aplicaciones para dispositivos móviles que sean relevantes para los intereses comerciales de un comprador.

No puedes crear nuevos paquetes de subasta con la API de Marketplace. Puedes usar la IU de Marketplace de Authorized Buyers para crear paquetes de subasta. La API de Marketplace no incluye información de segmentación específica asociada con los paquetes de subasta.

Puedes compartir paquetes de subasta con otros compradores y clientes, y puedes compartir paquetes de subasta creados por Google o por otros compradores.

Consulta Paquetes de subasta para obtener más información.

Perfiles de publicador

Puedes usar la API de Marketplace para ver los perfiles de los publicadores con los que puedes negociar.

Un PublisherProfile representa a un publicador en la API de Marketplace. Otros recursos de la API de Marketplace se refieren a los publicadores con el nombre especificado en su PublisherProfile.

Los perfiles de publicador tienen información similar a la de los publicadores en la pestaña Descubrimiento de la IU de Marketplace de Authorized Buyers.

Consulta Cómo descubrir publicadores para obtener más información.

Propuestas y acuerdos

Puedes usar la API de Marketplace para negociar acuerdos con los publicadores. Estas son algunas de las formas en que puedes usar la API de Marketplace para administrar acuerdos:

Las propuestas representan el estado de negociación más reciente de uno o más acuerdos entre un comprador o cliente y un publicador, y son similares a la pestaña Negotiations de la IU de Authorized Buyers Marketplace.

Los acuerdos representan los términos más recientes de un acuerdo que se negocia según una propuesta determinada y se pueden comparar con la lista de acuerdos de la IU de Marketplace de Authorized Buyers etiquetada como NEGOTIACIÓN ACTUAL para una propuesta determinada.

Los acuerdos finalizados representan acuerdos que completaron la fase de negociación y están listos para entregarse. Esto incluye los acuerdos que ya se están publicando. Los acuerdos finalizados son similares a la pestaña Acuerdos de la IU de Marketplace de Authorized Buyers.

Según el tipo de acuerdo que estés negociando, el comportamiento puede variar entre los recursos de la API de Marketplace. Por ejemplo, los compradores no pueden iniciar las negociaciones para todos los tipos de acuerdos. Para obtener más información sobre la implementación de la API de Marketplace para las negociaciones, consulta los siguientes recursos:

Para obtener más información sobre las negociaciones en la IU de Marketplace de Authorized Buyers, consulta los siguientes vínculos: