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:
- 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.
- + API'LERİ VE HİZMETLERİ ETKİNLEŞTİR bağlantısını tıklayın.
- Arama kutusuna "Authorized Buyers Pazar Yeri API'si" yazın ve Enter tuşuna basın.
- Arama sonuçlarında Authorized Buyers Pazar Yeri API'sini seçin.
- Marketplace API'yi etkinleştirmek için ETKİNLEŞTİR düğmesini tıklayın.
- 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 |
Kaynak alanları
Ad Exchange Alıcı II API'sı | Marketplace API'sı |
---|---|
Client.clientAccountId |
Client.name
|
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 |
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
|
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 |
ClientUser.userId |
ClientUser.name
|
ClientUser.clientAccountId |
Bu alan artık müşteri kullanıcılar için mevcut değil. Bunun yerine, üst istemcinin adındaki |
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
|
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 |
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 |
accounts.finalizedProposals.list |
Belirli bir alıcı hesabıyla ilgili kesinleşmiş anlaşmaları görmek için
|
accounts.finalizedProposals.pause |
Belirli bir alıcı hesabında kesinleşmiş anlaşmaları tek tek duraklatmak için
|
accounts.finalizedProposals.resume |
Belirli bir alıcı hesabında kesinleşmiş anlaşmaları tek tek devam ettirmek için
|
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
|
Proposal.updateTime |
Proposal.updateTime |
Proposal.proposalRevision |
|
Proposal.deals.dealId |
Deal.name
|
Proposal.deals.proposalId |
Deal.name
|
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 |
|
Proposal.deals.dealTerms.nonGuaranteedFixedPriceTerms |
|
Proposal.deals.dealTerms.NonGuaranteedAuctionTerms |
|
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 |
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 |
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 |
Proposal.originatorRole |
Proposal.originatorRole |
Proposal.seller.accountId |
Proposal.publisherProfile
Satıcıyı tanımlamak için yayıncı profili adını kullanın. |
Proposal.seller.subAccountId |
Proposal.publisherProfile
Satıcıyı tanımlamak için yayıncı profili adını kullanın. |
Proposal.buyer.accountId |
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 |
Proposal.billedBuyer.accountId |
Proposal.billedBuyer
Bu artık, Real-time Bidding API'nin |
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 |
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 |