Marketplace API'ye geçiş

API'yi etkinleştirme

Diğer Authorized Buyers'a benzer API'leri kullanmak için Şu tarihten önce Marketplace API: kullanabilirsiniz. Marketplace API'yi aşağıdaki adımları uygulayarak etkinleştirebilirsiniz:

  1. Google API Konsolu Etkin API'ler sayfasına gidin. öğrenin. Önce gibi diğer Authorized Buyers API'lerine erişmek için kullandığınız Ad Exchange Alıcısı II veya Gerçek Zamanlı Teklif Verme API'si.
  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.
  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 kimlik bilgileriyle Marketplace API'ye erişebilirsiniz. proje yöneticisinin sorumluluğundadır.

OAuth 2.0 kimlik bilgilerinizi güncelleme

Ad Exchange Alıcı II API kapsamıyla mevcut OAuth 2.0 iş akışlarının Pazar Yeri API kapsamını kullanacak şekilde değiştirildi:

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

Hizmet Hesabı OAuth 2.0'ı kullanmanızı öneririz. akışla ilgilidir. Desteklenen tüm OAuth 2.0 akışları yeni API'yi belirtmelidir kapsamını genişletip Google'dan Marketplace API'ye erişebilecek bir jeton isteme.

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

Müşteriler

Ad Exchange Alıcı II API'sini kullanıyorsanız accounts.clients Marketplace API'lerine geçiş yapabilir ve buyers.clients gösterir.

Kaynak yöntemleri

Ad Exchange Alıcı II API'si Pazar Yeri API'si
accounts.clients.create buyers.clients.create
accounts.clients.get buyers.clients.get
accounts.clients.list buyers.clients.list

Bu yöntem artık şunları destekliyor: liste filtreleri hakkında daha fazla bilgi edinin.

accounts.clients.update buyers.clients.patch

Bu yöntem artık updateMask parametresinden yararlanın.

Kaynak alanları

Ad Exchange Alıcı II API'si Pazar Yeri API'si
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ı Sayısı

Pazar Yeri API'si, Ad Exchange Alıcı II API'sinin işlevselliğini accounts.clients.invitations ve accounts.clients.users tek bir çatı altında buyers.clients.users gösterir.

Kaynak yöntemleri

Ad Exchange Alıcı II API'si Pazar Yeri API'si
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 ayarı INVITED olarak ayarlanmış kullanıcılar değeri, accounts.clients.invitations.list.

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. Önerilerimiz: kullandığınız Silmek için buyers.clients.users.delete tercih edilen değişikliklerle yeniden oluşturun.

Kaynak alanları

Ad Exchange Alıcı II API'si Pazar Yeri API'si
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ğ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 müşteri adına clientAccountId.
ClientUser.status ClientUser.state
ClientUser.email ClientUser.email

Ürünler

Bu kaynak ve işlevi, Marketplace API'de kullanılamıyor.

PublisherProfiles

Ad Exchange Alıcı II API'sini kullanıyorsanız accounts.publisherProfiles Marketplace API'lerine geçiş yapabilir ve buyers.publisherProfiles gösterir.

Kaynak yöntemleri

Ad Exchange Alıcı II API'si Pazar Yeri API'si
accounts.publisherProfiles.get buyers.publisherProfiles.get
accounts.publisherProfiles.list buyers.publisherProfiles.list

Bu yöntem artık şunları destekliyor: liste filtreleri hakkında daha fazla bilgi edinin.

Kaynak alanları

Ad Exchange Alıcı II API'si Pazar Yeri API'si
PublisherProfile.publisherProfileId PublisherProfile.name

publisherProfileId, yayıncı profili kaynağıdır Kimlik.
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 FinalizedProposals

Ad Exchange Alıcı II API'sini kullanıyorsanız accounts.proposals Marketplace API'lerine geçiş yapabilir ve buyers.proposals gösterir. Anlaşmalar, tekliflerden buyers.proposals.deals alt kaynağı olabilir. Kesinleşmiş teklifler artık API'de gösterilmez. Bu da daha ayrıntılı bir şekilde kontrol etmenizi sağlamak için buyers.finalizedDeals gösterir.

Kaynak yöntemleri

Ad Exchange Alıcı II API'si Pazar Yeri API'si
accounts.proposals.accept buyers.proposals.accept

buyers.proposals.accept öğesini yalnızca teklifin durumu BUYER_ACCEPTANCE_REQUESTED olduğunda ç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 bilgi içermeyeceğini unutmayın bazı fırsatlardan bahsedeceğiz. Liste filtrelemeyi kullanıyorsanız yalnızca Marketplace API'sinin desteklenir liste filtresi söz dizimi'ni kullanı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 parametresinden yararlanın.
accounts.finalizedProposals.list

kullan Kesinleşmiş anlaşmaları görmek için buyers.finalizedDeals.list belirleyecek olan kişi odur. Artık kesinleşmiş anlaşmalar alınabilir ile teklif veren düzeyinde bidders.finalizedDeals.list değerleridir.
accounts.finalizedProposals.pause

kullan Tek tek duraklatmak için buyers.finalizedDeals.pause belirli bir alıcı hesabı için kesinleşmiş anlaşmalardır.
accounts.finalizedProposals.resume

kullan Bireysel erişimi devam ettirmek için buyers.finalizedDeals.resume belirli bir alıcı hesabı için kesinleşmiş anlaşmalardır.

Kaynak alanları

proposals ve finalizedProposals kaynakları aynı Proposal öğesini paylaşıyor ve benzer taşıma adımlarına sahiptir.

Ad Exchange Alıcı II API'si Pazar Yeri API'si
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 kaynak 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ıldı; artık yalnızca teklifte gösteriliyor. seviyesinde olmalıdır.
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 özelliğinin bir yinelenen bir alana hiçbir zaman tek bir girişle doldurulmamıştır. Farklı Pazar Yeri API'sinin programmaticGuaranteedTerms.fixedPrice eşdeğerdir.
Proposal.deals.dealTerms.nonGuaranteedFixedPriceTerms

Deal.preferredDealTerms

nonGuaranteedFixedPriceTerms.fixedPrices metriğinin bir alan tekrarlanırsa hiçbir zaman tek bir girişle doldurulmamıştır. Sonuç olarak, Marketplace API'sinin preferredDealTerms.fixedPrice eşdeğerdir.
Proposal.deals.dealTerms.NonGuaranteedAuctionTerms

Deal.privateAuctionTerms

Lütfen nonGuaranteedAuctionTerms.reservePricesPerBuyer bir yinelenen bir alana hiçbir zaman tek bir girişle doldurulmamıştır. Farklı Pazar Yeri API'sinin privateAuctionTerms.floorPrice 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

Artık hedeflemeyi anahtar kullanarak yapılandıramazsınız. hedefleme kategorisini belirleme; ancak başka kategorilerde de Deal.targeting bölgesinde bulunabilir. Örneğin, Ad Exchange Alıcısı II'den alınan GOOG_CREATIVE_SIZE anahtarının değeri: Marketplace API'leri Deal.targeting.inventorySizeTargeting.
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ı boş bırakılamaz.
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 bir anlaşmanın yayınlanmaya hazır olduğunu yalnızca gerekir. buyers.finalizedDeals.setReadyToServe kullanın yöntemini kullanabilirsiniz. yayına hazır olur.
Proposal.originatorRole Proposal.originatorRole
Proposal.seller.accountId Proposal.publisherProfile

Satıcıyı tanımlamak için yayıncı profili adını kullanın. Şunları görüntüleyebilirsiniz: buyers.publisherProfiles içeren yayıncı profilleri gösterir.
Proposal.seller.subAccountId Proposal.publisherProfile

Satıcıyı tanımlamak için yayıncı profili adını kullanın. Şunları görüntüleyebilirsiniz: buyers.publisherProfiles içeren yayıncı profilleri gösterir.
Proposal.buyer.accountId

Proposal.buyer veya Proposal.client.

Kullanılan alan, görüşmenin hesap türüne bağlıdır belirleyecek olan kişidir. Bunlar, Gerçek Zamanlı Teklif Verme API'sinin kaynak adlarıdır buyers kaynağı veya Marketplace API'si Sırasıyla buyers.clients kaynak.
Proposal.billedBuyer.accountId Proposal.billedBuyer

Bu artık bir alıcı hesabını Real-time Bidding API'nin buyers bölümünde temsil edilir gösterir.
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şildi.

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