Marketplace API'ye geçiş

API'yi etkinleştirme

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

  1. Google API Konsolu Etkin API'ler sayfasına gidin. Ad Exchange Alıcı 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 Marketplace API" yazın ve Enter tuşuna basın.
  4. Arama sonuçlarında Authorized Buyers Marketplace API'yi seçin.
  5. Marketplace API'yi etkinleştirmek için ETKİNLEŞTİR düğmesini tıklayın.
  6. Artık bu proje kapsamında oluşturulan kimlik bilgileriyle Marketplace API'ye erişebilirsiniz.

OAuth 2.0 kimlik bilgilerinizi güncelleme

Ad Exchange Alıcı 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. Desteklenen tüm OAuth 2.0 akışları, Google'dan Marketplace API'ye erişebilen bir jeton istemek için yeni API kapsamını belirtmelidir.

Ad Exchange Alıcı II API kaynaklarını Pazar Yeri API'si ile eşleme

Müşteriler

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

Kaynak yöntemleri

Ad Exchange Buyer II API Marketplace API
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 destekliyor.

accounts.clients.update buyers.clients.patch

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

Kaynak alanları

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

clientAccountId, istemci kaynak 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ılmıştır.
Client.entityId

Bu alan kullanımdan kaldırılmıştır.
Client.entityName

Bu alan kullanımdan kaldırılmıştır.
Client.partnerClientId Client.partnerClientId

Davetiyeler ve Kullanıcılar

Marketplace API, Ad Exchange Alıcı II API'sinin 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 Buyer II API Marketplace API
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ılarla 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 API ile istemci kullanıcılarına yamalar uygulayamazsınız. İstemci kullanıcıyı silmek ve tercih edilen değişikliklerle yeniden oluşturmak için buyers.clients.users.delete aracını kullanmanızı öneririz.

Kaynak alanları

Ad Exchange Buyer II API Marketplace API
ClientUserInvitation.invitationId

Bu alan kullanımdan kaldırılmıştır.
ClientUserInvitation.email ClientUser.email
ClientUserInvitation.clientAccountId

Bu alan artık müşteri kullanıcılar için mevcut değildir. Bunun yerine, üst müşteri adına clientAccountId
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ğildir. 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şlevleri Marketplace API'de kullanılamaz.

PublisherProfiles

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

Kaynak yöntemleri

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

Bu yöntem artık liste filtrelerini desteklemektedir.

Kaynak alanları

Ad Exchange Buyer II API Marketplace API
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ılmıştır.
PublisherProfile.googlePlusUrl

Bu alan kullanımdan kaldırılmıştır.
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 Alıcı II API'sinin accounts.proposals kaynağını kullanıyorsanız Marketplace API'nin buyers.proposals kaynağına geçiş yapabilirsiniz. Fırsatlar, tekliflerden ayrılarak buyers.proposals.deals alt kaynağına taşındı. Kesinleşen teklifler artık API'de temsil edilmez. Bu sayede, buyers.finalizedDeals kaynağını kullanarak kesinleşen anlaşmalar üzerinde daha ayrıntılı kontrol sahibi olabilirsiniz.

Kaynak yöntemleri

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

Yalnızca teklifin durumu BUYER_ACCEPTANCE_REQUESTED olduğunda buyers.proposals.accept işlevini çağırı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şmalarla ilgili bilgi içermeyeceğini unutmayın. Liste filtrelemeyi 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ına ait kesinleşmiş anlaşmaları görmek için buyers.finalizedDeals.list özelliğini kullanın. Artık bidders.finalizedDeals.list ile teklif veren seviyesinde kesinleşmiş anlaşmaları almak mümkün.
accounts.finalizedProposals.pause

Belirli bir alıcı hesabı için tamamlanmış anlaşmaları tek tek duraklatmak isterseniz buyers.finalizedDeals.pause simgesini kullanın.
accounts.finalizedProposals.resume

Belirli bir alıcı hesabına ait 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 Buyer II API Marketplace API
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 kaynak kimliğidir.
Proposal.deals.proposalId Deal.name

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

Bu alan kullanımdan kaldırılmıştır.
Proposal.deals.createProductRevision

Bu alan kullanımdan kaldırılmıştır.
Proposal.deals.displayName Deal.displayName
Proposal.deals.buyerPrivateData.referenceId

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

Bu alan kullanımdan kaldırılmıştır.
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 doldurulmamıştır. Sonuç olarak, Pazar Yeri API'sinin programmaticGuaranteedTerms.fixedPrice değeri eşdeğerdir.
Proposal.deals.dealTerms.nonGuaranteedFixedPriceTerms

Deal.preferredDealTerms

nonGuaranteedFixedPriceTerms.fixedPrices'ün tekrarlanan bir alan olmasına rağmen hiçbir zaman tek bir girişten fazlasıyla doldurulmadığını unutmayın. Sonuç olarak, Marketplace API'sinin preferredDealTerms.fixedPrice değeri eşdeğerdir.
Proposal.deals.dealTerms.NonGuaranteedAuctionTerms

Deal.privateAuctionTerms

nonGuaranteedAuctionTerms.reservePricesPerBuyer'ün tekrarlanan bir alan olmasına rağmen hiçbir zaman tek bir girişten fazlasıyla doldurulmadığını unutmayın. Sonuç olarak, Pazar Yeri API'sinin privateAuctionTerms.floorPrice değeri eşdeğerdir.
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

Hedefleme kategorisini belirlemek için anahtar kullanarak hedeflemeyi yapılandırmak artık mümkün değildir. Ancak hedeflenebilecek kategoriler Deal.targeting'te bulunabilir. Örneğin, Ad Exchange Alıcı II'deki GOOG_CREATIVE_SIZE anahtarı, Pazar Yeri API'sinin Deal.targeting.inventorySizeTargeting anahtarını ifade eder.
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ılmıştır.
Proposal.deals.syndicationProduct

Bu alan kullanımdan kaldırılmıştır.
Proposal.deals.creativePreApprovalPolicy Deal.creativeRequirements.creativePreApprovalPolicy
Proposal.deals.creativeSafeFrameCompatibility Deal.creativeRequirements.creativeSafeFrameCompatibility
Proposal.deals.dealServingMetadata

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

Fırsatların nasıl yerleştirileceğiyle ilgili ek ayrıntılar eklendi.
Proposal.deals.isSetupComplete FinalizedDeal.readyToServe

Artık yalnızca kesinleştiyse bir anlaşmanın yayınlanmaya hazır olduğunu belirtebilirsiniz. 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ğıyla 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ıdır. Bunlar sırasıyla GZT API buyers kaynağının veya Pazar Yeri API buyers.clients kaynağının kaynak adlarıdır.
Proposal.billedBuyer.accountId Proposal.billedBuyer

Bu, artık Gerçek Zamanlı Teklif Verme API'sinin buyers kaynağında temsil edildiği şekliyle bir alıcı hesabına atıfta bulunan 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ı bir şekilde erişilebilir.

Proposal.lastUpdaterOrCommentorRole Proposal.lastUpdaterOrCommentorRole
Proposal.notes.proposalRevision

Bu alan kullanımdan kaldırılmıştır.
Proposal.notes.noteId

Bu alan kullanımdan kaldırılmıştır.
Proposal.notes.createTime Proposal.notes.createTime
Proposal.notes.creatorRole Proposal.notes.creatorRole
Proposal.notes.note Proposal.notes.note
Proposal.termsAndConditions Proposal.termsAndConditions