Se usó la API de Cloud Translation para traducir esta página.

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:

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.
Haz clic en el vínculo + HABILITAR APIS Y SERVICIOS.
En el cuadro de búsqueda, escribe "API de Authorized Buyers Marketplace" 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 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`