Cómo habilitar la API
Al igual que con las API de otros Authorized Buyers, debes habilitar la API de Marketplace para poder usarla. Sigue estos pasos para habilitar la API de Marketplace:
- Ve a la página de APIs habilitadas de la Consola de APIs de Google. Selecciona el proyecto que usas para acceder a otras APIs de Authorized Buyers, como Ad Exchange Buyer II o la API de Real-time Bidding.
- Haga clic en el vínculo + HABILITAR API Y SERVICIOS.
- En el cuadro de búsqueda, escribe "Authorized Buyers Marketplace API" y presiona Intro.
- En los resultados de la búsqueda, selecciona API de Authorized Buyers Marketplace.
- Haz clic en el botón HABILITAR para habilitar la API de Marketplace.
- Ahora deberías poder acceder a la API de Marketplace con las credenciales creadas 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 del comprador de Ad Exchange II deben modificarse para usar el alcance de la API de Marketplace:
https://www.googleapis.com/auth/authorized-buyers-marketplace
Recomendamos usar el flujo de OAuth de cuenta de servicio 2.0 para acceder a la API. Todos los flujos de OAuth 2.0 admitidos deben especificar el alcance de la API nuevo para solicitar un token de Google que pueda acceder a la API de Marketplace.
Cómo asignar recursos de la API del Comprador II de Ad Exchange a la API de Marketplace
Clientes
Si usas el recurso accounts.clients
de la API de Ad Exchange Buyer II, puedes migrar al recurso buyers.clients
de la API de Marketplace.
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 |
Campos de recursos
API de Ad Exchange Buyer II | API de Marketplace |
---|---|
Client.clientAccountId |
Client.name
|
Client.role |
Client.role |
Client.status |
Client.state |
Client.clientName |
Client.displayName |
Client.visibleToSeller |
Client.sellerVisible |
Client.entityType |
Este campo se retiró. |
Client.entityId |
Este campo se retiró. |
Client.entityName |
Este campo se retiró. |
Client.partnerClientId |
Client.partnerClientId |
Invitaciones y usuarios
La API de Marketplace combina la funcionalidad de los recursos accounts.clients.invitations
y accounts.clients.users
de la API del Comprador II de Ad Exchange en un solo recurso buyers.clients.users
.
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 su |
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 del cliente con la API. Te recomendamos que uses
|
Campos de recursos
API de Ad Exchange Buyer II | API de Marketplace |
---|---|
ClientUserInvitation.invitationId |
Este campo se retiró. |
ClientUserInvitation.email |
ClientUser.email |
ClientUserInvitation.clientAccountId |
Este campo ya no existe para los usuarios del cliente. En su lugar, consulta |
ClientUser.userId |
ClientUser.name
El |
ClientUser.clientAccountId |
Este campo ya no existe para los usuarios del cliente. En su lugar, consulta |
ClientUser.status |
ClientUser.state |
ClientUser.email |
ClientUser.email |
Productos
Este recurso y sus funciones no están disponibles en la API de Marketplace.
PublisherProfiles
Si usas el recurso accounts.publisherProfiles
de la API de Ad Exchange Buyer II, puedes migrar al recurso buyers.publisherProfiles
de la API de Marketplace.
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
El |
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 |
Este campo se retiró. |
PublisherProfile.googlePlusUrl |
Este campo se retiró. |
PublisherProfile.overview |
PublisherProfile.overview |
PublisherProfile.buyerPitchStatement |
PublisherProfile.pitchStatement |
PublisherProfile.topHeadlines |
PublisherProfile.topHeadlines |
PublisherProfile.audienceDescription |
PublisherProfile.audienceDescription |
PublisherProfile.isParent |
PublisherProfile.isParent |
Propuestas y propuestas finalizadas
Si usas el recurso accounts.proposals
de la API de Ad Exchange Buyer II, puedes migrar al recurso buyers.proposals
de la API de Marketplace. Los acuerdos se separaron de las propuestas en el subrecurso buyers.proposals.deals
. Las propuestas finalizadas ya no se representan en la API, lo que te brinda un control más detallado de los acuerdos finalizados con el recurso buyers.finalizedDeals
.
Métodos de recursos
API de Ad Exchange Buyer II | API de Marketplace |
---|---|
accounts.proposals.accept |
buyers.proposals.accept
Solo llama a |
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
Ten en cuenta que la propuesta ya no contendrá información sobre los acuerdos. |
accounts.proposals.list |
buyers.proposals.list
Ten en cuenta que las propuestas que se muestran ya no contendrán información sobre los acuerdos. Si usas el filtrado de listas, ten en cuenta que la API de Marketplace solo admite la sintaxis de filtro de lista. |
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 |
accounts.finalizedProposals.list |
Usa
|
accounts.finalizedProposals.pause |
Usa
|
accounts.finalizedProposals.resume |
Usa
|
Campos de recursos
Los recursos proposals
y finalizedProposals
comparten la misma representación de Proposal
y tienen pasos de migración similares.
API de Ad Exchange Buyer II | API de Marketplace |
---|---|
Proposal.proposalId |
Proposal.name
|
Proposal.updateTime |
Proposal.updateTime |
Proposal.proposalRevision |
|
Proposal.deals.dealId |
Deal.name
El |
Proposal.deals.proposalId |
Deal.name
|
Proposal.deals.createTime |
Deal.createTime |
Proposal.deals.updateTime |
Deal.updateTime |
Proposal.deals.createProductId |
Este campo se retiró. |
Proposal.deals.createProductRevision |
Este campo se retiró. |
Proposal.deals.displayName |
Deal.displayName |
Proposal.deals.buyerPrivateData.referenceId |
Este campo se retiró; ahora solo está expuesto a nivel de la propuesta. |
Proposal.deals.dealTerms.description |
Deal.description |
Proposal.deals.dealTerms.brandingType |
Este campo se retiró. |
Proposal.deals.dealTerms.estimatedGrossSpend |
Deal.estimatedGrossSpend |
Proposal.deals.dealTerms.estimatedImpressionsPerDay |
Este campo se retiró. |
Proposal.deals.dealTerms.sellerTimeZone |
Deal.sellerTimeZone |
Proposal.deals.dealTerms.guaranteedFixedPriceTerms |
Ten en cuenta que, si bien |
Proposal.deals.dealTerms.nonGuaranteedFixedPriceTerms |
Ten en cuenta que, si bien |
Proposal.deals.dealTerms.NonGuaranteedAuctionTerms |
Ten en cuenta que, si bien |
Proposal.deals.webPropertyCode |
Este campo se retiró. |
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 con una clave para determinar la categoría de segmentación. Sin embargo, las categorías para las que se puede segmentar se pueden encontrar en |
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 |
Este campo se retiró. |
Proposal.deals.syndicationProduct |
Este campo se retiró. |
Proposal.deals.creativePreApprovalPolicy |
Deal.creativeRequirements.creativePreApprovalPolicy |
Proposal.deals.creativeSafeFrameCompatibility |
Deal.creativeRequirements.creativeSafeFrameCompatibility
|
Proposal.deals.dealServingMetadata |
Puedes encontrar información similar en el campo |
Proposal.deals.programmaticCreativeSource |
Deal.creativeRequirements.programmaticCreativeSource |
Proposal.deals.deliveryControl |
Deal.deliveryControl
Se agregaron detalles adicionales sobre cómo se agregaron las ofertas. |
Proposal.deals.isSetupComplete |
FinalizedDeal.readyToServe
Ahora solo puedes indicar que un acuerdo está listo para entregarse si está finalizado. Usa el método |
Proposal.originatorRole |
Proposal.originatorRole |
Proposal.seller.accountId |
Proposal.publisherProfile
Usa el nombre del perfil del publicador para identificar al vendedor. Puedes ver los perfiles de publicador con el recurso |
Proposal.seller.subAccountId |
Proposal.publisherProfile
Usa el nombre del perfil del publicador para identificar al vendedor. Puedes ver los perfiles de publicador con el recurso |
Proposal.buyer.accountId |
El campo que se use dependerá del tipo de cuenta del comprador que negocia. Estos son los nombres de los recursos |
Proposal.billedBuyer.accountId |
Proposal.billedBuyer
Ahora, este es un nombre de recurso que hace referencia a la cuenta de un comprador, tal como se representa en el 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 |
Este campo se retiró. |
Proposal.isSetupComplete |
FinalizedDeal.readyToServe
Ahora se accede de forma más detallada con |
Proposal.lastUpdaterOrCommentorRole |
Proposal.lastUpdaterOrCommentorRole |
Proposal.notes.proposalRevision |
Este campo se retiró. |
Proposal.notes.noteId |
Este campo se retiró. |
Proposal.notes.createTime |
Proposal.notes.createTime |
Proposal.notes.creatorRole |
Proposal.notes.creatorRole |
Proposal.notes.note |
Proposal.notes.note |
Proposal.termsAndConditions |
Proposal.termsAndConditions |