Esta página foi traduzida pela API Cloud Translation.

Migrar para a API Marketplace

Ativar a API

Assim como outras APIs do Authorized Buyers, é necessário ativar a API Marketplace para poder usá-la. É possível ativar a API Marketplace seguindo estas etapas:

Acesse a página APIs ativadas do Console de APIs do Google. Selecione o projeto usado para acessar outras APIs do Authorized Buyers, como Ad Exchange Buyer II ou API Real-time Bidding.
Clique no link + ATIVAR APIS E SERVIÇOS.
Na caixa de pesquisa, digite API Marketplace do Authorized Buyers e pressione Enter.
Nos resultados da pesquisa, selecione API Authorized Buyers Marketplace.
Clique no botão ENABLE para ativar a API Marketplace.
Agora você pode acessar a API Marketplace com as credenciais criadas neste projeto.

Atualizar suas credenciais do OAuth 2.0

Os fluxos de trabalho atuais do OAuth 2.0 com o escopo da API Ad Exchange Buyer II precisam ser alterados para usar o escopo da API Marketplace:

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

Recomendamos usar o fluxo do OAuth 2.0 da conta de serviço para acessar a API. Todos os fluxos do OAuth 2.0 compatíveis precisam especificar o novo escopo da API para solicitar um token do Google que possa acessar a API Marketplace.

Como mapear recursos da API de comprador II do Ad Exchange para a API do Marketplace

Clientes

Se você usa o recurso accounts.clients da API Ad Exchange Buyer II, pode migrar para o recurso buyers.clients da API Marketplace.

Métodos de recursos

API Ad Exchange Buyer II	API Marketplace
`accounts.clients.create`	`buyers.clients.create`
`accounts.clients.get`	`buyers.clients.get`
`accounts.clients.list`	`buyers.clients.list` Esse método agora oferece suporte a filtros de lista.
`accounts.clients.update`	`buyers.clients.patch` Esse método agora oferece suporte a atualizações parciais com o parâmetro `updateMask`.

Campos de recursos

API Ad Exchange Buyer II	API Marketplace
`Client.clientAccountId`	`Client.name` O `clientAccountId` é o ID do recurso do cliente.
`Client.role`	`Client.role`
`Client.status`	`Client.state`
`Client.clientName`	`Client.displayName`
`Client.visibleToSeller`	`Client.sellerVisible`
`Client.entityType`	Este campo foi descontinuado.
`Client.entityId`	Este campo foi descontinuado.
`Client.entityName`	Este campo foi desativado.
`Client.partnerClientId`	`Client.partnerClientId`

Convites e usuários

A API Marketplace combina a funcionalidade dos recursos accounts.clients.invitations e accounts.clients.users da API Ad Exchange Buyer II em um único recurso buyers.clients.users.

Métodos de recursos

API Ad Exchange Buyer II	API 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` Somente os usuários com o `state` definido como `INVITED` serão equivalentes aos retornados 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`	Não é mais possível corrigir usuários de cliente com a API. Recomendamos que você use `buyers.clients.users.delete` para excluir o usuário do cliente e recriar com as mudanças preferidas.

Campos de recursos

API Ad Exchange Buyer II	API Marketplace
`ClientUserInvitation.invitationId`	Este campo foi desativado.
`ClientUserInvitation.email`	`ClientUser.email`
`ClientUserInvitation.clientAccountId`	Esse campo não existe mais para usuários de cliente. Em vez disso, confira o `clientAccountId` no nome do cliente pai.
`ClientUser.userId`	`ClientUser.name` O `userId` é o ID do recurso do usuário.
`ClientUser.clientAccountId`	Este campo não existe mais para usuários clientes. Em vez disso, confira o `clientAccountId` no nome do cliente pai.
`ClientUser.status`	`ClientUser.state`
`ClientUser.email`	`ClientUser.email`

Produtos

Esse recurso e a respectiva funcionalidade não estão disponíveis na API Marketplace.

PublisherProfiles

Se você usa o recurso accounts.publisherProfiles da API Ad Exchange Buyer II, pode migrar para o recurso buyers.publisherProfiles da API Marketplace.

Métodos de recursos

API Ad Exchange Buyer II	API Marketplace
`accounts.publisherProfiles.get`	`buyers.publisherProfiles.get`
`accounts.publisherProfiles.list`	`buyers.publisherProfiles.list` Esse método agora oferece suporte a filtros de lista.

Campos de recursos

API Ad Exchange Buyer II	API Marketplace
`PublisherProfile.publisherProfileId`	`PublisherProfile.name` O `publisherProfileId` é o ID do recurso do perfil do editor.
`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 foi descontinuado.
`PublisherProfile.googlePlusUrl`	Este campo foi descontinuado.
`PublisherProfile.overview`	`PublisherProfile.overview`
`PublisherProfile.buyerPitchStatement`	`PublisherProfile.pitchStatement`
`PublisherProfile.topHeadlines`	`PublisherProfile.topHeadlines`
`PublisherProfile.audienceDescription`	`PublisherProfile.audienceDescription`
`PublisherProfile.isParent`	`PublisherProfile.isParent`

Propostas e propostas finalizadas

Se você usa o recurso accounts.proposals da API Ad Exchange Buyer II, pode migrar para o recurso buyers.proposals da API Marketplace. As ofertas foram separadas das propostas no subrecurso buyers.proposals.deals. As propostas finalizadas não são mais representadas na API, o que oferece um controle mais granular das transações finalizadas com o recurso buyers.finalizedDeals.

Métodos de recursos

API Ad Exchange Buyer II	API Marketplace
`accounts.proposals.accept`	`buyers.proposals.accept` Só chame `buyers.proposals.accept` quando o estado da proposta for `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` A proposta não vai mais conter informações sobre transações.
`accounts.proposals.list`	`buyers.proposals.list` As propostas retornadas não terão mais informações sobre as transações. Se você usa a filtragem de listas, observe que a API Marketplace oferece suporte apenas à sintaxe de filtro de lista.
`accounts.proposals.pause`	`buyers.finalizedDeals.pause`
`accounts.proposals.resume`	`buyers.finalizedDeals.resume`
`accounts.proposals.update`	`buyers.proposals.patch` Esse método agora oferece suporte a atualizações parciais com o parâmetro `updateMask`.
`accounts.finalizedProposals.list`	Use `buyers.finalizedDeals.list` para conferir as transações concluídas de uma determinada conta de comprador. Agora é possível recuperar transações finalizadas no nível do bidder com `bidders.finalizedDeals.list`.
`accounts.finalizedProposals.pause`	Use `buyers.finalizedDeals.pause` para pausar transações individuais concluídas de uma determinada conta de comprador.
`accounts.finalizedProposals.resume`	Use `buyers.finalizedDeals.resume` para retomar transações individuais concluídas de uma determinada conta de comprador.

Campos de recursos

Os recursos proposals e finalizedProposals compartilham a mesma representação de Proposal e têm etapas de migração semelhantes.

API Ad Exchange Buyer II	API Marketplace
`Proposal.proposalId`	`Proposal.name` O `proposalId` é o ID do recurso da proposta.
`Proposal.updateTime`	`Proposal.updateTime`
`Proposal.proposalRevision`	`Proposal.proposalRevision` e `Deal.proposalRevision`
`Proposal.deals.dealId`	`Deal.name` `dealId` é o ID do recurso da transação.
`Proposal.deals.proposalId`	`Deal.name` O `proposalId` é o ID do recurso de proposta pai.
`Proposal.deals.createTime`	`Deal.createTime`
`Proposal.deals.updateTime`	`Deal.updateTime`
`Proposal.deals.createProductId`	Este campo foi descontinuado.
`Proposal.deals.createProductRevision`	Este campo foi desativado.
`Proposal.deals.displayName`	`Deal.displayName`
`Proposal.deals.buyerPrivateData.referenceId`	Este campo foi desativado e agora só é exposto no nível da proposta.
`Proposal.deals.dealTerms.description`	`Deal.description`
`Proposal.deals.dealTerms.brandingType`	Este campo foi descontinuado.
`Proposal.deals.dealTerms.estimatedGrossSpend`	`Deal.estimatedGrossSpend`
`Proposal.deals.dealTerms.estimatedImpressionsPerDay`	Este campo foi descontinuado.
`Proposal.deals.dealTerms.sellerTimeZone`	`Deal.sellerTimeZone`
`Proposal.deals.dealTerms.guaranteedFixedPriceTerms`	`Deal.programmaticGuaranteedTerms` Embora `guaranteedFixedPriceTerms.fixedPrices` seja um campo repetido, ele nunca foi preenchido com mais de uma entrada. Como resultado, o `programmaticGuaranteedTerms.fixedPrice` da API Marketplace é equivalente.
`Proposal.deals.dealTerms.nonGuaranteedFixedPriceTerms`	`Deal.preferredDealTerms` Embora `nonGuaranteedFixedPriceTerms.fixedPrices` seja um campo repetido, ele nunca foi preenchido com mais de uma entrada. Como resultado, o `preferredDealTerms.fixedPrice` da API Marketplace é equivalente.
`Proposal.deals.dealTerms.NonGuaranteedAuctionTerms`	`Deal.privateAuctionTerms` Embora `nonGuaranteedAuctionTerms.reservePricesPerBuyer` seja um campo repetido, ele nunca foi preenchido com mais de uma entrada. Como resultado, o `privateAuctionTerms.floorPrice` da API Marketplace é equivalente.
`Proposal.deals.webPropertyCode`	Este campo foi desativado.
`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` Não é mais possível configurar a segmentação usando uma chave para determinar a categoria de segmentação. No entanto, as categorias que podem ser segmentadas podem ser encontradas em `Deal.targeting`. Por exemplo, a chave `GOOG_CREATIVE_SIZE` da API Ad Exchange Buyer II se refere à `Deal.targeting.inventorySizeTargeting` da API Marketplace.
`Proposal.deals.targeting`	`Deal.targeting` Adicionamos mais categorias de critérios de segmentação.
`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 foi descontinuado.
`Proposal.deals.syndicationProduct`	Este campo foi descontinuado.
`Proposal.deals.creativePreApprovalPolicy`	`Deal.creativeRequirements.creativePreApprovalPolicy`
`Proposal.deals.creativeSafeFrameCompatibility`	`Deal.creativeRequirements.creativeSafeFrameCompatibility`
`Proposal.deals.dealServingMetadata`	Informações semelhantes podem ser encontradas no campo `FinalizedDeal.dealPausingInfo`.
`Proposal.deals.programmaticCreativeSource`	`Deal.creativeRequirements.programmaticCreativeSource`
`Proposal.deals.deliveryControl`	`Deal.deliveryControl` Mais detalhes sobre como as ofertas foram adicionadas.
`Proposal.deals.isSetupComplete`	`FinalizedDeal.readyToServe` Agora só é possível sinalizar que uma transação está pronta para ser veiculada se ela estiver concluída. Use o método `buyers.finalizedDeals.setReadyToServe` para indicar que a transação programática garantida finalizada está pronta para veiculação.
`Proposal.originatorRole`	`Proposal.originatorRole`
`Proposal.seller.accountId`	`Proposal.publisherProfile` Use o nome do perfil do editor para identificar o vendedor. É possível conferir perfis de editores com o recurso `buyers.publisherProfiles`.
`Proposal.seller.subAccountId`	`Proposal.publisherProfile` Use o nome do perfil do editor para identificar o vendedor. É possível conferir perfis de editores com o recurso `buyers.publisherProfiles`.
`Proposal.buyer.accountId`	`Proposal.buyer` ou `Proposal.client`. O campo usado depende do tipo de conta do comprador negociador. Estes são os nomes de recursos de um recurso `buyers` da API Real-time Bidding ou de um recurso `buyers.clients` da API Marketplace, respectivamente.
`Proposal.billedBuyer.accountId`	`Proposal.billedBuyer` Agora é um nome de recurso que se refere a uma conta de comprador, conforme representado no recurso `buyers` da API de lances em tempo real.
`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 foi descontinuado.
`Proposal.isSetupComplete`	`FinalizedDeal.readyToServe` Agora acessado de forma mais granular com `buyers.finalizedDeals`.
`Proposal.lastUpdaterOrCommentorRole`	`Proposal.lastUpdaterOrCommentorRole`
`Proposal.notes.proposalRevision`	Este campo foi descontinuado.
`Proposal.notes.noteId`	Este campo foi descontinuado.
`Proposal.notes.createTime`	`Proposal.notes.createTime`
`Proposal.notes.creatorRole`	`Proposal.notes.creatorRole`
`Proposal.notes.note`	`Proposal.notes.note`
`Proposal.termsAndConditions`	`Proposal.termsAndConditions`