Marketplace API'ye geçiş

API'yi etkinleştirme

Diğer Authorized Buyers API'lerine benzer şekilde, Marketplace API'yi kullanmadan önce etkinleştirmeniz gerekir. Marketplace API'yi aşağıdaki adımları uygulayarak etkinleştirebilirsiniz:

  1. Google API Console Etkinleştirilmiş API'ler sayfasına gidin. Ad Exchange Buyer II veya Gerçek Zamanlı Teklif Verme API'si gibi diğer Authorized Buyers API'lerine erişmek için kullandığınız projeyi seçin.
  2. + API'LERİ VE HİZMETLERİ ETKİNLEŞTİR bağlantısını tıklayın.
  3. Arama kutusuna "Authorized Buyers Pazar Yeri API'si" yazın ve Enter tuşuna basın.
  4. Arama sonuçlarında Authorized Buyers Pazar Yeri API'sini seçin.
  5. Marketplace API'yi etkinleştirmek için ETKİNLEŞTİR düğmesini tıklayın.
  6. Artık bu proje altında oluşturulan kimlik bilgileriyle Marketplace API'ye erişebilirsiniz.

OAuth 2.0 kimlik bilgilerinizi güncelleme

Ad Exchange Buyer II API kapsamına sahip mevcut OAuth 2.0 iş akışlarının, Marketplace API kapsamını kullanacak şekilde değiştirilmesi gerekir:

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

API'ye erişmek için Hizmet Hesabı OAuth 2.0 akışını kullanmanızı öneririz. Google'dan Marketplace API'ye erişebilecek bir jeton istemek için desteklenen tüm OAuth 2.0 akışları, yeni API kapsamını belirtmelidir.

Ad Exchange Buyer II API kaynaklarını Marketplace API'si ile eşleme

Müşteriler

Ad Exchange Buyer II API'sinin accounts.clients kaynağını kullanırsanız Marketplace API'nin buyers.clients kaynağına geçebilirsiniz.

Kaynak yöntemleri

Ad Exchange Alıcı II API'sı Marketplace API'sı
accounts.clients.create buyers.clients.create
accounts.clients.get buyers.clients.get
accounts.clients.list buyers.clients.list

Bu yöntem artık liste filtrelerini desteklemektedir.

accounts.clients.update buyers.clients.patch

Bu yöntem artık updateMask parametresiyle kısmi güncellemeleri desteklemektedir.

Kaynak alanları

Ad Exchange Alıcı II API'sı Marketplace API'sı
Client.clientAccountId Client.name

clientAccountId, istemci kaynağı kimliğidir.
Client.role Client.role
Client.status Client.state
Client.clientName Client.displayName
Client.visibleToSeller Client.sellerVisible
Client.entityType

Bu alan kullanımdan kaldırıldı.
Client.entityId

Bu alan kullanımdan kaldırıldı.
Client.entityName

Bu alan kullanımdan kaldırıldı.
Client.partnerClientId Client.partnerClientId

Davetiyeler ve Kullanıcılar

Marketplace API, Ad Exchange Buyer II API accounts.clients.invitations ve accounts.clients.users kaynaklarının işlevlerini tek bir buyers.clients.users kaynakta birleştirir.

Kaynak yöntemleri

Ad Exchange Alıcı II API'sı Marketplace API'sı
accounts.clients.invitations.create buyers.clients.users.create
accounts.clients.invitations.get buyers.clients.users.get
accounts.clients.invitations.list buyers.clients.users.list

Yalnızca state özelliği INVITED olarak ayarlanmış kullanıcılar, accounts.clients.invitations.list tarafından döndürülen kullanıcılara eşdeğer olur.

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

Artık istemci kullanıcılara API ile yama uygulayamazsınız. İstemci kullanıcısını silmek ve tercih edilen değişikliklerle yeniden oluşturmak için buyers.clients.users.delete kullanmanızı öneririz.

Kaynak alanları

Ad Exchange Alıcı II API'sı Marketplace API'sı
ClientUserInvitation.invitationId

Bu alan kullanımdan kaldırıldı.
ClientUserInvitation.email ClientUser.email
ClientUserInvitation.clientAccountId

Bu alan artık müşteri kullanıcılar için mevcut değil. Bunun yerine, üst istemcinin adındaki clientAccountId öğesini görüntüleyin.
ClientUser.userId ClientUser.name

userId, kullanıcı kaynağı kimliğidir.
ClientUser.clientAccountId

Bu alan artık müşteri kullanıcılar için mevcut değil. Bunun yerine, üst istemcinin adındaki clientAccountId öğesini görüntüleyin.
ClientUser.status ClientUser.state
ClientUser.email ClientUser.email

Ürünler

Bu kaynak ve işlevi, Marketplace API'sinde mevcut değildir.

PublisherProfiles

Ad Exchange Buyer II API'sinin accounts.publisherProfiles kaynağını kullanırsanız Marketplace API'nin buyers.publisherProfiles kaynağına geçebilirsiniz.

Kaynak yöntemleri

Ad Exchange Alıcı II API'sı Marketplace API'sı
accounts.publisherProfiles.get buyers.publisherProfiles.get
accounts.publisherProfiles.list buyers.publisherProfiles.list

Bu yöntem artık liste filtrelerini desteklemektedir.

Kaynak alanları

Ad Exchange Alıcı II API'sı Marketplace API'sı
PublisherProfile.publisherProfileId PublisherProfile.name

publisherProfileId, yayıncı profili kaynak kimliğidir.
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

Bu alan kullanımdan kaldırıldı.
PublisherProfile.googlePlusUrl

Bu alan kullanımdan kaldırıldı.
PublisherProfile.overview PublisherProfile.overview
PublisherProfile.buyerPitchStatement PublisherProfile.pitchStatement
PublisherProfile.topHeadlines PublisherProfile.topHeadlines
PublisherProfile.audienceDescription PublisherProfile.audienceDescription
PublisherProfile.isParent PublisherProfile.isParent

Teklifler ve Kesinleşmiş Teklifler

Ad Exchange Buyer II API'sinin accounts.proposals kaynağını kullanırsanız Marketplace API'nin buyers.proposals kaynağına geçebilirsiniz. Anlaşmalar, tekliflerden buyers.proposals.deals alt kaynağına ayrıldı. Kesinleşmiş teklifler artık API'de temsil edilmez. Bu sayede, buyers.finalizedDeals kaynağı ile kesinleşmiş anlaşmalar üzerinde daha ayrıntılı bir kontrole sahip olabilirsiniz.

Kaynak yöntemleri

Ad Exchange Alıcı II API'sı Marketplace API'sı
accounts.proposals.accept buyers.proposals.accept

Yalnızca teklifin durumu BUYER_ACCEPTANCE_REQUESTED olduğunda buyers.proposals.accept çağrısı yapın.
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

Teklifin artık anlaşmalar hakkında bilgi içermeyeceğini unutmayın.

accounts.proposals.list buyers.proposals.list

Döndürülen tekliflerin artık anlaşmalar hakkında bilgi içermeyeceğini unutmayın. Liste filtreleme kullanıyorsanız Marketplace API'nin yalnızca liste filtresi söz dizimini desteklediğini unutmayın.
accounts.proposals.pause buyers.finalizedDeals.pause
accounts.proposals.resume buyers.finalizedDeals.resume
accounts.proposals.update buyers.proposals.patch

Bu yöntem artık updateMask parametresiyle kısmi güncellemeleri desteklemektedir.
accounts.finalizedProposals.list

Belirli bir alıcı hesabıyla ilgili kesinleşmiş anlaşmaları görmek için buyers.finalizedDeals.list değerini kullanın. Kesinleşmiş anlaşmalar artık bidders.finalizedDeals.list ile teklif veren düzeyinde alınabilir.
accounts.finalizedProposals.pause

Belirli bir alıcı hesabında kesinleşmiş anlaşmaları tek tek duraklatmak için buyers.finalizedDeals.pause özelliğini kullanın.
accounts.finalizedProposals.resume

Belirli bir alıcı hesabında kesinleşmiş anlaşmaları tek tek devam ettirmek için buyers.finalizedDeals.resume özelliğini kullanın.

Kaynak alanları

proposals ve finalizedProposals kaynakları aynı Proposal temsilini paylaşır ve benzer taşıma adımlarına sahiptir.

Ad Exchange Alıcı II API'sı Marketplace API'sı
Proposal.proposalId Proposal.name

proposalId, teklif kaynak kimliğidir.
Proposal.updateTime Proposal.updateTime
Proposal.proposalRevision

Proposal.proposalRevision ve Deal.proposalRevision
Proposal.deals.dealId Deal.name

dealId, anlaşma kaynağı kimliğidir.
Proposal.deals.proposalId Deal.name

proposalId, üst teklif kaynağının kimliğidir.
Proposal.deals.createTime Deal.createTime
Proposal.deals.updateTime Deal.updateTime
Proposal.deals.createProductId

Bu alan kullanımdan kaldırıldı.
Proposal.deals.createProductRevision

Bu alan kullanımdan kaldırıldı.
Proposal.deals.displayName Deal.displayName
Proposal.deals.buyerPrivateData.referenceId

Bu alan kullanımdan kaldırılmıştır. Şu anda yalnızca teklif düzeyinde gösterilmektedir.
Proposal.deals.dealTerms.description Deal.description
Proposal.deals.dealTerms.brandingType

Bu alan kullanımdan kaldırıldı.
Proposal.deals.dealTerms.estimatedGrossSpend Deal.estimatedGrossSpend
Proposal.deals.dealTerms.estimatedImpressionsPerDay

Bu alan kullanımdan kaldırıldı.
Proposal.deals.dealTerms.sellerTimeZone Deal.sellerTimeZone
Proposal.deals.dealTerms.guaranteedFixedPriceTerms

Deal.programmaticGuaranteedTerms

guaranteedFixedPriceTerms.fixedPrices yinelenen bir alan olsa da hiçbir zaman birden fazla girişle doldurulmadığını unutmayın. Sonuç olarak, Marketplace API'nin programmaticGuaranteedTerms.fixedPrice eşdeğeridir.
Proposal.deals.dealTerms.nonGuaranteedFixedPriceTerms

Deal.preferredDealTerms

nonGuaranteedFixedPriceTerms.fixedPrices yinelenen bir alan olsa da hiçbir zaman birden fazla girişle doldurulmadığını unutmayın. Sonuç olarak, Marketplace API'nin preferredDealTerms.fixedPrice eşdeğeridir.
Proposal.deals.dealTerms.NonGuaranteedAuctionTerms

Deal.privateAuctionTerms

nonGuaranteedAuctionTerms.reservePricesPerBuyer yinelenen bir alan olsa da hiçbir zaman birden fazla girişle doldurulmadığını unutmayın. Sonuç olarak, Marketplace API'nin privateAuctionTerms.floorPrice eşdeğeridir.
Proposal.deals.webPropertyCode

Bu alan kullanımdan kaldırıldı.
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

Artık hedefleme kategorisini belirlemek için anahtar kullanarak hedefleme yapılandırmak mümkün değildir. Ancak, hedeflenebilecek kategoriler Deal.targeting sayfasında bulunabilir. Örneğin, Ad Exchange Alıcı II'deki GOOG_CREATIVE_SIZE anahtarı, Pazar Yeri API'sinin Deal.targeting.inventorySizeTargeting anlamına gelir.
Proposal.deals.targeting Deal.targeting

Ek hedefleme ölçütü kategorileri eklendi.
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

Bu alan kullanımdan kaldırıldı.
Proposal.deals.syndicationProduct

Bu alan kullanımdan kaldırıldı.
Proposal.deals.creativePreApprovalPolicy Deal.creativeRequirements.creativePreApprovalPolicy
Proposal.deals.creativeSafeFrameCompatibility Deal.creativeRequirements.creativeSafeFrameCompatibility
Proposal.deals.dealServingMetadata

Benzer bilgileri FinalizedDeal.dealPausingInfo alanında bulabilirsiniz.
Proposal.deals.programmaticCreativeSource Deal.creativeRequirements.programmaticCreativeSource
Proposal.deals.deliveryControl Deal.deliveryControl

Anlaşmaların nasıl yapılacağıyla ilgili ek ayrıntılar eklendi.
Proposal.deals.isSetupComplete FinalizedDeal.readyToServe

Artık yalnızca kesinleşen bir anlaşmanın yayınlanmaya hazır olduğunu gösterebilirsiniz. Kesinleşmiş Programatik Garantili anlaşmanızın yayınlanmaya hazır olduğunu belirtmek için buyers.finalizedDeals.setReadyToServe yöntemini kullanın.
Proposal.originatorRole Proposal.originatorRole
Proposal.seller.accountId Proposal.publisherProfile

Satıcıyı tanımlamak için yayıncı profili adını kullanın. buyers.publisherProfiles kaynağını kullanarak yayıncı profillerini görüntüleyebilirsiniz.
Proposal.seller.subAccountId Proposal.publisherProfile

Satıcıyı tanımlamak için yayıncı profili adını kullanın. buyers.publisherProfiles kaynağını kullanarak yayıncı profillerini görüntüleyebilirsiniz.
Proposal.buyer.accountId

Proposal.buyer veya Proposal.client.

Kullanılan alan, pazarlık yapan alıcının hesap türüne bağlı olacaktır. Bunlar, sırasıyla Gerçek Zamanlı Teklif Verme API buyers kaynağının veya Marketplace API buyers.clients kaynağının kaynak adlarıdır.
Proposal.billedBuyer.accountId Proposal.billedBuyer

Bu artık, Real-time Bidding API'nin buyers kaynağında gösterildiği gibi alıcı hesabını belirten bir kaynak adıdır.
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

Bu alan kullanımdan kaldırıldı.
Proposal.isSetupComplete FinalizedDeal.readyToServe

Artık buyers.finalizedDeals ile daha ayrıntılı olarak erişilebilir.

Proposal.lastUpdaterOrCommentorRole Proposal.lastUpdaterOrCommentorRole
Proposal.notes.proposalRevision

Bu alan kullanımdan kaldırıldı.
Proposal.notes.noteId

Bu alan kullanımdan kaldırıldı.
Proposal.notes.createTime Proposal.notes.createTime
Proposal.notes.creatorRole Proposal.notes.creatorRole
Proposal.notes.note Proposal.notes.note
Proposal.termsAndConditions Proposal.termsAndConditions