API de Migrate to Marketplace

Habilita la API

Similar a otros compradores de Authorized Buyers las APIs, debes habilitar la API de Marketplace antes de puedes usarlo. Puedes habilitar la API de Marketplace siguiendo estos pasos:

  1. Ve a las APIs habilitadas de la Consola de APIs de Google. . Selecciona el proyecto que usas para acceder a otras APIs de Authorized Buyers, como las siguientes: Ad Exchange Buyer II o API de Real-time Bidding.
  2. Haz clic en el vínculo + HABILITAR APIS Y SERVICIOS.
  3. En el cuadro de búsqueda, escribe "API de Authorized Buyers Marketplace" y presiona Intro.
  4. En los resultados de la búsqueda, selecciona API de Authorized Buyers Marketplace.
  5. Haz clic en el botón HABILITAR para habilitar la API de Marketplace.
  6. Ahora deberías poder acceder a la API de Marketplace con las credenciales creada en este proyecto.

Actualiza tus credenciales de OAuth 2.0

Los flujos de trabajo existentes de OAuth 2.0 con el alcance de la API de Ad Exchange Buyer II deben se modificó para usar el permiso de la API de Marketplace:

https://www.googleapis.com/auth/authorized-buyers-marketplace

Recomendamos utilizar la cuenta de servicio de OAuth 2.0 para acceder a la API. Todos los flujos de OAuth 2.0 admitidos deben especificar la API nueva permiso para solicitar un token de Google que pueda acceder a la API de Marketplace.

Asignación de recursos de la API de Ad Exchange Buyer II a la API de Marketplace

Clientes

Si usa las APIs de Ad Exchange Buyer II accounts.clients recurso, puedes migrar a las APIs de Marketplace buyers.clients recurso.

Métodos de recursos

API de Ad Exchange Buyer II API de Marketplace
accounts.clients.create buyers.clients.create
accounts.clients.get buyers.clients.get
accounts.clients.list buyers.clients.list

Este método ahora admite filtros de lista.

accounts.clients.update buyers.clients.patch

Este método ahora admite actualizaciones parciales con el Parámetro updateMask.

Campos de recursos

API de Ad Exchange Buyer II API de Marketplace
Client.clientAccountId Client.name

El clientAccountId es el ID del recurso del cliente.
Client.role Client.role
Client.status Client.state
Client.clientName Client.displayName
Client.visibleToSeller Client.sellerVisible
Client.entityType

Se desactivó este campo.
Client.entityId

Se desactivó este campo.
Client.entityName

Se desactivó este campo.
Client.partnerClientId Client.partnerClientId

Invitaciones y Usuarios

La API de Marketplace combina la funcionalidad de la API de Ad Exchange Buyer II accounts.clients.invitations y accounts.clients.users recursos en una sola buyers.clients.users recurso.

Métodos de recursos

API de Ad Exchange Buyer II API de Marketplace
accounts.clients.invitations.create buyers.clients.users.create
accounts.clients.invitations.get buyers.clients.users.get
accounts.clients.invitations.list buyers.clients.users.list

Solo los usuarios con la opción state configurada en INVITED serán equivalentes a los devueltos por accounts.clients.invitations.list

accounts.clients.users.get buyers.clients.users.get
accounts.clients.users.list buyers.clients.users.list
accounts.clients.users.update

Ya no puedes aplicar parches a los usuarios cliente con la API. Recomendaciones que usas buyers.clients.users.delete para borrar y volver a crearla con los cambios preferidos.

Campos de recursos

API de Ad Exchange Buyer II API de Marketplace
ClientUserInvitation.invitationId

Se desactivó este campo.
ClientUserInvitation.email ClientUser.email
ClientUserInvitation.clientAccountId

Este campo ya no existe para los usuarios del cliente. En su lugar, consulta el clientAccountId en el nombre del cliente superior
ClientUser.userId ClientUser.name

userId es el ID del recurso del usuario.
ClientUser.clientAccountId

Este campo ya no existe para los usuarios del cliente. En su lugar, consulta el clientAccountId en el nombre del cliente superior
ClientUser.status ClientUser.state
ClientUser.email ClientUser.email

Productos

Este recurso y su funcionalidad no están disponibles en la API de Marketplace.

PublisherProfiles

Si usa las APIs de Ad Exchange Buyer II accounts.publisherProfiles recurso, puedes migrar a las APIs de Marketplace buyers.publisherProfiles recurso.

Métodos de recursos

API de Ad Exchange Buyer II API de Marketplace
accounts.publisherProfiles.get buyers.publisherProfiles.get
accounts.publisherProfiles.list buyers.publisherProfiles.list

Este método ahora admite filtros de lista.

Campos de recursos

API de Ad Exchange Buyer II API de Marketplace
PublisherProfile.publisherProfileId PublisherProfile.name

publisherProfileId es el recurso del perfil del editor. ID.
PublisherProfile.seller.accountId PublisherProfile.seller.accountId
PublisherProfile.seller.subAccountId PublisherProfile.seller.subAccountId
PublisherProfile.displayName PublisherProfile.displayName
PublisherProfile.domains PublisherProfile.domains
PublisherProfile.mobileApps PublisherProfile.mobileApps
PublisherProfile.logoUrl PublisherProfile.logoUrl
PublisherProfile.directDealsContact PublisherProfile.directDealsContact
PublisherProfile.programmaticDealsContact PublisherProfile.programmaticDealsContact
PublisherProfile.mediaKitUrl PublisherProfile.mediaKitUrl
PublisherProfile.samplePageUrl PublisherProfile.samplePageUrl
PublisherProfile.rateCardUrl

Se desactivó este campo.
PublisherProfile.googlePlusUrl

Se desactivó este campo.
PublisherProfile.overview PublisherProfile.overview
PublisherProfile.buyerPitchStatement PublisherProfile.pitchStatement
PublisherProfile.topHeadlines PublisherProfile.topHeadlines
PublisherProfile.audienceDescription PublisherProfile.audienceDescription
PublisherProfile.isParent PublisherProfile.isParent

Propuestas y FinalizedProposals

Si usa las APIs de Ad Exchange Buyer II accounts.proposals recurso, puedes migrar a las APIs de Marketplace buyers.proposals recurso. Los acuerdos se separaron de las propuestas en la buyers.proposals.deals subrecurso. Las propuestas finalizadas ya no están representadas en la API y proporcionan un control más detallado de los acuerdos finalizados con las buyers.finalizedDeals recurso.

Métodos de recursos

API de Ad Exchange Buyer II API de Marketplace
accounts.proposals.accept buyers.proposals.accept

Solo llama a buyers.proposals.accept cuando el estado de la propuesta sea BUYER_ACCEPTANCE_REQUESTED.
accounts.proposals.addNote buyers.proposals.addNote
accounts.proposals.cancelNegotiation buyers.proposals.cancelNegotiation
accounts.proposals.completeSetup buyers.finalizedDeals.setReadyToServe
accounts.proposals.create buyers.proposals.sendRfp
accounts.proposals.get buyers.proposals.get

Tenga en cuenta que la propuesta ya no contendrá información sobre los acuerdos.

accounts.proposals.list buyers.proposals.list

Tenga en cuenta que las propuestas devueltas ya no contendrán información sobre las ofertas. Si usas el filtrado de listas, ten en cuenta que solo la API de Marketplace admite Sintaxis del filtro de listas
accounts.proposals.pause buyers.finalizedDeals.pause
accounts.proposals.resume buyers.finalizedDeals.resume
accounts.proposals.update buyers.proposals.patch

Este método ahora admite actualizaciones parciales con el Parámetro updateMask.
accounts.finalizedProposals.list

Utilizar buyers.finalizedDeals.list para ver los acuerdos finalizados para una cuenta del comprador determinada. Ahora es posible recuperar los acuerdos finalizados a nivel del ofertante con bidders.finalizedDeals.list
accounts.finalizedProposals.pause

Utilizar buyers.finalizedDeals.pause para detener la campaña de forma individual acuerdos finalizados para una cuenta de comprador determinada.
accounts.finalizedProposals.resume

Utilizar buyers.finalizedDeals.resume para reanudar la opción individual acuerdos finalizados para una cuenta de comprador determinada.

Campos de recursos

Los recursos proposals y finalizedProposals comparten el mismo Proposal y tienen pasos de migración similares.

API de Ad Exchange Buyer II API de Marketplace
Proposal.proposalId Proposal.name

El proposalId es el ID del recurso de la propuesta.
Proposal.updateTime Proposal.updateTime
Proposal.proposalRevision

Proposal.proposalRevision y Deal.proposalRevision
Proposal.deals.dealId Deal.name

dealId es el ID de recurso del acuerdo.
Proposal.deals.proposalId Deal.name

proposalId es el ID del recurso de la propuesta superior.
Proposal.deals.createTime Deal.createTime
Proposal.deals.updateTime Deal.updateTime
Proposal.deals.createProductId

Se desactivó este campo.
Proposal.deals.createProductRevision

Se desactivó este campo.
Proposal.deals.displayName Deal.displayName
Proposal.deals.buyerPrivateData.referenceId

Este campo se retiró; ahora solo se expone a la propuesta a nivel de organización.
Proposal.deals.dealTerms.description Deal.description
Proposal.deals.dealTerms.brandingType

Se desactivó este campo.
Proposal.deals.dealTerms.estimatedGrossSpend Deal.estimatedGrossSpend
Proposal.deals.dealTerms.estimatedImpressionsPerDay

Se desactivó este campo.
Proposal.deals.dealTerms.sellerTimeZone Deal.sellerTimeZone
Proposal.deals.dealTerms.guaranteedFixedPriceTerms

Deal.programmaticGuaranteedTerms

Ten en cuenta que, si bien guaranteedFixedPriceTerms.fixedPrices es un repetido campo, nunca se propagó con más de una sola entrada. Como como resultado, las APIs de Marketplace programmaticGuaranteedTerms.fixedPrice es el equivalente.
Proposal.deals.dealTerms.nonGuaranteedFixedPriceTerms

Deal.preferredDealTerms

Ten en cuenta que, si bien nonGuaranteedFixedPriceTerms.fixedPrices es un campo repetido, nunca se propagó con más de una sola entrada. Como resultado, las APIs de Marketplace preferredDealTerms.fixedPrice es el equivalente.
Proposal.deals.dealTerms.NonGuaranteedAuctionTerms

Deal.privateAuctionTerms

Ten en cuenta que, si bien nonGuaranteedAuctionTerms.reservePricesPerBuyer es un repetido campo, nunca se propagó con más de una sola entrada. Como como resultado, las APIs de Marketplace privateAuctionTerms.floorPrice es el equivalente.
Proposal.deals.webPropertyCode

Se desactivó este campo.
Proposal.deals.sellerContacts Proposal.sellerContacts
Proposal.deals.availableStartTime Proposal.flightStartTime
Proposal.deals.availableEndTime Proposal.flightEndTime
Proposal.deals.description Proposal.description
Proposal.deals.targetingCriterion Deal.targeting

Ya no es posible configurar la segmentación usando una clave para determinar la categoría de segmentación; pero las categorías que podrían se pueden encontrar en Deal.targeting. Por ejemplo, el La clave GOOG_CREATIVE_SIZE del comprador de Ad Exchange II hace referencia a APIs de Marketplace Deal.targeting.inventorySizeTargeting
Proposal.deals.targeting Deal.targeting

Se agregaron categorías de criterios de segmentación adicionales.
Proposal.deals.creativeRestrictions.creativeFormat Deal.creativeRequirements.creativeFormat
Proposal.deals.creativeRestrictions.skippableAdType Deal.creativeRequirements.skippableAdType
Proposal.deals.creativeRestrictions.creativeSpecifications.creativeSize Deal.targeting.inventorySizeTargeting
Proposal.deals.externalDealId

Se desactivó este campo.
Proposal.deals.syndicationProduct

Se desactivó este campo.
Proposal.deals.creativePreApprovalPolicy Deal.creativeRequirements.creativePreApprovalPolicy
Proposal.deals.creativeSafeFrameCompatibility Deal.creativeRequirements.creativeSafeFrameCompatibility
Proposal.deals.dealServingMetadata

Puedes encontrar información similar en la FinalizedDeal.dealPausingInfo.
Proposal.deals.programmaticCreativeSource Deal.creativeRequirements.programmaticCreativeSource
Proposal.deals.deliveryControl Deal.deliveryControl

Se agregaron detalles adicionales sobre cómo se implementarán las ofertas.
Proposal.deals.isSetupComplete FinalizedDeal.readyToServe

Ahora solo puede indicar que un acuerdo está listo para publicarse si finalizado. Usa el buyers.finalizedDeals.setReadyToServe para indicar que tu acuerdo de Programática garantizada finalizado está listas para publicarse.
Proposal.originatorRole Proposal.originatorRole
Proposal.seller.accountId Proposal.publisherProfile

Usa el nombre de perfil del publicador para identificar al vendedor. Puedes ver perfiles de publicador con el buyers.publisherProfiles recurso.
Proposal.seller.subAccountId Proposal.publisherProfile

Usa el nombre de perfil del publicador para identificar al vendedor. Puedes ver perfiles de publicador con el buyers.publisherProfiles recurso.
Proposal.buyer.accountId

Proposal.buyer o Proposal.client.

El campo que se use dependerá del tipo de cuenta de la negociación. comprador. Estos son los nombres de recursos de una API de Real-time Bidding Recurso buyers o API de Marketplace buyers.clients recurso, respectivamente.
Proposal.billedBuyer.accountId Proposal.billedBuyer

Ahora es un nombre de recurso que hace referencia a una cuenta del comprador como se representa en la buyers de la API de Real-time Bidding recurso.
Proposal.displayName Proposal.displayName
Proposal.proposalState Proposal.state
Proposal.isRenegotiating Proposal.isRenegotiating
Proposal.buyerPrivateData Proposal.buyerPrivateData
Proposal.sellerContacts Proposal.sellerContacts
Proposal.buyerContacts Proposal.buyerContacts
Proposal.privateAuctionId

Se desactivó este campo.
Proposal.isSetupComplete FinalizedDeal.readyToServe

Ahora se accede de manera más detallada con buyers.finalizedDeals.

Proposal.lastUpdaterOrCommentorRole Proposal.lastUpdaterOrCommentorRole
Proposal.notes.proposalRevision

Se desactivó este campo.
Proposal.notes.noteId

Se desactivó este campo.
Proposal.notes.createTime Proposal.notes.createTime
Proposal.notes.creatorRole Proposal.notes.creatorRole
Proposal.notes.note Proposal.notes.note
Proposal.termsAndConditions Proposal.termsAndConditions