النقل إلى Marketplace API

تفعيل واجهة برمجة التطبيقات

مثلما يتم ذلك مع "الشراة المعتمَدون" الآخرون لواجهات برمجة التطبيقات، عليك تمكين Marketplace API قبل يمكنك استخدامها. يمكنك تفعيل Marketplace API باتّباع الخطوات التالية:

  1. انتقل إلى واجهات برمجة التطبيقات التي تم تفعيلها في وحدة التحكم في واجهة Google API . اختَر مشروع تستخدمه للوصول إلى واجهات برمجة تطبيقات "الشراة المعتمَدون" الأخرى، مثل مشتري Ad Exchange II أو واجهة برمجة تطبيقات عروض الأسعار في الوقت الفعلي:
  2. انقر على الرابط + تفعيل واجهات برمجة التطبيقات والخدمات.
  3. في مربّع البحث، اكتب Authorized Buys Marketplace API"، واضغط على الزر. Enter.
  4. في نتائج البحث، انقر على Authorized المشترون Marketplace API.
  5. انقر على الزر تفعيل لتفعيل Marketplace API.
  6. من المفترض أن تتمكّن الآن من الوصول إلى Marketplace API باستخدام بيانات الاعتماد. تم إنشاؤه ضمن هذا المشروع.

تعديل بيانات اعتماد OAuth 2.0

يجب أن تكون عمليات سير عمل OAuth 2.0 الحالية مع نطاق واجهة برمجة التطبيقات Ad Exchange Partner II تم التغيير لاستخدام نطاق واجهة برمجة تطبيقات Marketplace:

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

ننصح باستخدام بروتوكول OAuth 2.0 لحساب الخدمة. الوصول إلى واجهة برمجة التطبيقات. يجب أن تحدّد جميع مسارات OAuth 2.0 المتوافقة واجهة برمجة التطبيقات الجديدة. نطاق لطلب رمز مميز من Google يمكنه الوصول إلى واجهة برمجة تطبيقات Marketplace.

ربط موارد واجهة برمجة تطبيقات Ad Exchange Partner II بواجهة برمجة تطبيقات Marketplace

العملاء

في حال استخدام واجهات برمجة التطبيقات accounts.clients المصدر، يمكنك الترحيل إلى واجهة برمجة تطبيقات buyers.clients المصدر.

طرق الموارد

واجهة برمجة التطبيقات لمشتري Ad Exchange II واجهة برمجة تطبيقات Marketplace
accounts.clients.create buyers.clients.create
accounts.clients.get buyers.clients.get
accounts.clients.list buyers.clients.list

يمكن الآن استخدام هذه الطريقة فلاتر القوائم.

accounts.clients.update buyers.clients.patch

وتتيح هذه الطريقة الآن إجراء تحديثات جزئية باستخدام مَعلمة updateMask.

حقول الموارد

واجهة برمجة التطبيقات لمشتري Ad Exchange II واجهة برمجة تطبيقات Marketplace
Client.clientAccountId Client.name

clientAccountId هو معرِّف مورد العميل.
Client.role Client.role
Client.status Client.state
Client.clientName Client.displayName
Client.visibleToSeller Client.sellerVisible
Client.entityType

تم إيقاف هذا الحقل.
Client.entityId

تم إيقاف هذا الحقل.
Client.entityName

تم إيقاف هذا الحقل.
Client.partnerClientId Client.partnerClientId

دعوات المستخدمون

تجمع واجهة برمجة التطبيقات Marketplace بين وظائف واجهة برمجة تطبيقات Ad Exchange Partner II accounts.clients.invitations وaccounts.clients.users الموارد في مؤسسة buyers.clients.users المصدر.

طرق الموارد

واجهة برمجة التطبيقات لمشتري Ad Exchange II واجهة برمجة تطبيقات 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

المستخدمون الذين ضبطوا state على "INVITED" فقط مماثلة لتلك التي تم إرجاعها بواسطة accounts.clients.invitations.list

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

لم يعُد بإمكانك تصحيح بيانات مستخدِمي العملاء باستخدام واجهة برمجة التطبيقات. ننصحك بما يلي: التي تستخدمها buyers.clients.users.delete لحذف المستخدم العميل وإعادة إنشائه مع التغييرات المفضلة.

حقول الموارد

واجهة برمجة التطبيقات لمشتري Ad Exchange II واجهة برمجة تطبيقات Marketplace
ClientUserInvitation.invitationId

تم إيقاف هذا الحقل.
ClientUserInvitation.email ClientUser.email
ClientUserInvitation.clientAccountId

لم يعد هذا الحقل متوفرًا للمستخدمين العميلين. بدلاً من ذلك، يمكنك عرض clientAccountId باسم العميل الرئيسي.
ClientUser.userId ClientUser.name

userId هو رقم التعريف لمورد المستخدم.
ClientUser.clientAccountId

لم يعد هذا الحقل متوفرًا للمستخدمين العميلين. بدلاً من ذلك، يمكنك عرض clientAccountId باسم العميل الرئيسي.
ClientUser.status ClientUser.state
ClientUser.email ClientUser.email

المنتجات

لا يتوفّر هذا المورد ووظائفه في Marketplace API.

PublisherProfiles

في حال استخدام واجهات برمجة التطبيقات accounts.publisherProfiles المصدر، يمكنك الترحيل إلى واجهة برمجة تطبيقات buyers.publisherProfiles المصدر.

طرق الموارد

واجهة برمجة التطبيقات لمشتري Ad Exchange II واجهة برمجة تطبيقات Marketplace
accounts.publisherProfiles.get buyers.publisherProfiles.get
accounts.publisherProfiles.list buyers.publisherProfiles.list

يمكن الآن استخدام هذه الطريقة فلاتر القوائم.

حقول الموارد

واجهة برمجة التطبيقات لمشتري Ad Exchange II واجهة برمجة تطبيقات Marketplace
PublisherProfile.publisherProfileId PublisherProfile.name

publisherProfileId هو مورد الملف الشخصي للناشر رقم التعريف
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

تم إيقاف هذا الحقل.
PublisherProfile.googlePlusUrl

تم إيقاف هذا الحقل.
PublisherProfile.overview PublisherProfile.overview
PublisherProfile.buyerPitchStatement PublisherProfile.pitchStatement
PublisherProfile.topHeadlines PublisherProfile.topHeadlines
PublisherProfile.audienceDescription PublisherProfile.audienceDescription
PublisherProfile.isParent PublisherProfile.isParent

الاقتراحات FinalizedProposals

في حال استخدام واجهات برمجة التطبيقات accounts.proposals المصدر، يمكنك الترحيل إلى واجهة برمجة تطبيقات buyers.proposals المصدر. تم فصل الصفقات عن المقترحات في buyers.proposals.deals مورد فرعي جديد. لم تعد العروض النهائية ممثلة في واجهة برمجة التطبيقات، ما يوفر إمكانية التحكم الدقيق في الصفقات النهائية مع buyers.finalizedDeals المصدر.

طرق الموارد

واجهة برمجة التطبيقات لمشتري Ad Exchange II واجهة برمجة تطبيقات Marketplace
accounts.proposals.accept buyers.proposals.accept

لا تطلب buyers.proposals.accept إلا عندما تكون حالة الاقتراح هي 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

يُرجى العِلم أنّ العرض لن يحتوي على معلومات حول الصفقات بعد الآن.

accounts.proposals.list buyers.proposals.list

لاحظ أن العروض المعروضة لن تحتوي بعد الآن على معلومات عن الصفقات. في حال استخدام فلترة القوائم، يُرجى ملاحظة أنّ Marketplace API فقط يتوافق مع بنية فلتر القوائم.
accounts.proposals.pause buyers.finalizedDeals.pause
accounts.proposals.resume buyers.finalizedDeals.resume
accounts.proposals.update buyers.proposals.patch

وتتيح هذه الطريقة الآن إجراء تحديثات جزئية باستخدام مَعلمة updateMask.
accounts.finalizedProposals.list

استخدام buyers.finalizedDeals.list للاطّلاع على الصفقات النهائية لحساب مشترٍ معيّن. أصبح من الممكن الآن استرداد الصفقات النهائية على مستوى مقدِّم عرض السعر مع bidders.finalizedDeals.list
accounts.finalizedProposals.pause

استخدام buyers.finalizedDeals.pause لإيقاف التجربة الفردية مؤقتًا الصفقات النهائية لحساب مشترٍ معين.
accounts.finalizedProposals.resume

استخدام buyers.finalizedDeals.resume لاستئناف العمل الفردي الصفقات النهائية لحساب مشترٍ معين.

حقول الموارد

يتشارك موارد proposals وfinalizedProposals نفس Proposal. التمثيل ولها خطوات ترحيل مماثلة.

واجهة برمجة التطبيقات لمشتري Ad Exchange II واجهة برمجة تطبيقات Marketplace
Proposal.proposalId Proposal.name

proposalId هو رقم تعريف مورد الاقتراح.
Proposal.updateTime Proposal.updateTime
Proposal.proposalRevision

Proposal.proposalRevision و Deal.proposalRevision
Proposal.deals.dealId Deal.name

تمثّل السمة dealId رقم تعريف مورد الصفقة.
Proposal.deals.proposalId Deal.name

proposalId هو رقم تعريف مورد الاقتراح الرئيسي.
Proposal.deals.createTime Deal.createTime
Proposal.deals.updateTime Deal.updateTime
Proposal.deals.createProductId

تم إيقاف هذا الحقل.
Proposal.deals.createProductRevision

تم إيقاف هذا الحقل.
Proposal.deals.displayName Deal.displayName
Proposal.deals.buyerPrivateData.referenceId

تم إيقاف هذا الحقل. إلا أنه يتم عرضه الآن فقط عند المستوى.
Proposal.deals.dealTerms.description Deal.description
Proposal.deals.dealTerms.brandingType

تم إيقاف هذا الحقل.
Proposal.deals.dealTerms.estimatedGrossSpend Deal.estimatedGrossSpend
Proposal.deals.dealTerms.estimatedImpressionsPerDay

تم إيقاف هذا الحقل.
Proposal.deals.dealTerms.sellerTimeZone Deal.sellerTimeZone
Proposal.deals.dealTerms.guaranteedFixedPriceTerms

Deal.programmaticGuaranteedTerms

لاحظ أنه في حين أن guaranteedFixedPriceTerms.fixedPrices بشكل متكرر، لم يتم ملؤها أبدًا بأكثر من إدخال واحد. بالنسبة ونتيجة لذلك، فإن واجهة برمجة تطبيقات Marketplace programmaticGuaranteedTerms.fixedPrice مكافئ.
Proposal.deals.dealTerms.nonGuaranteedFixedPriceTerms

Deal.preferredDealTerms

لاحظ أنه في حين أن nonGuaranteedFixedPriceTerms.fixedPrices لحقل متكرر، فلن يتم ملؤها أبدًا بأكثر من إدخال واحد. ونتيجة لذلك، تتضمن واجهة برمجة تطبيقات Marketplace preferredDealTerms.fixedPrice مكافئ.
Proposal.deals.dealTerms.NonGuaranteedAuctionTerms

Deal.privateAuctionTerms

لاحظ أنه في حين أن nonGuaranteedAuctionTerms.reservePricesPerBuyer هو بشكل متكرر، لم يتم ملؤها أبدًا بأكثر من إدخال واحد. بالنسبة ونتيجة لذلك، فإن واجهة برمجة تطبيقات Marketplace privateAuctionTerms.floorPrice مكافئ.
Proposal.deals.webPropertyCode

تم إيقاف هذا الحقل.
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

لم يعد من الممكن ضبط الاستهداف باستخدام مفتاح تحديد فئة الاستهداف ومع ذلك، الفئات التي يمكن يمكن العثور عليها في Deal.targeting. على سبيل المثال، المفتاح GOOG_CREATIVE_SIZE من مشتري Ad Exchange II إلى Marketplace API's Deal.targeting.inventorySizeTargeting
Proposal.deals.targeting Deal.targeting

تمت إضافة فئات معايير استهداف إضافية.
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

تم إيقاف هذا الحقل.
Proposal.deals.syndicationProduct

تم إيقاف هذا الحقل.
Proposal.deals.creativePreApprovalPolicy Deal.creativeRequirements.creativePreApprovalPolicy
Proposal.deals.creativeSafeFrameCompatibility Deal.creativeRequirements.creativeSafeFrameCompatibility
Proposal.deals.dealServingMetadata

يمكن العثور على معلومات مماثلة في الحقل "FinalizedDeal.dealPausingInfo".
Proposal.deals.programmaticCreativeSource Deal.creativeRequirements.programmaticCreativeSource
Proposal.deals.deliveryControl Deal.deliveryControl

تمّت إضافة تفاصيل إضافية حول كيفية إجراء الصفقات.
Proposal.deals.isSetupComplete FinalizedDeal.readyToServe

يمكنك الآن الإشارة إلى أنّ الصفقة جاهزة للعرض فقط إذا كانت الانتهاء منه. استخدام buyers.finalizedDeals.setReadyToServe للإشارة إلى أن صفقة "الضمان الآلي" النهائية هي وجاهزة للعرض.
Proposal.originatorRole Proposal.originatorRole
Proposal.seller.accountId Proposal.publisherProfile

استخدِم اسم الملف الشخصي للناشر لتحديد هوية البائع. يمكنك الاطّلاع على: الملفات الشخصية للناشرين المرتبطة بـ buyers.publisherProfiles المصدر.
Proposal.seller.subAccountId Proposal.publisherProfile

استخدِم اسم الملف الشخصي للناشر لتحديد هوية البائع. يمكنك الاطّلاع على: الملفات الشخصية للناشرين المرتبطة بـ buyers.publisherProfiles المصدر.
Proposal.buyer.accountId

Proposal.buyer أو Proposal.client

سيعتمد الحقل المستخدَم على نوع حساب التفاوض المشتري. هذه أسماء موارد لواجهة برمجة تطبيقات عروض الأسعار في الوقت الفعلي مورد واحد (buyers) أو Marketplace API مورد واحد (buyers.clients) على التوالي.
Proposal.billedBuyer.accountId Proposal.billedBuyer

هذا الآن اسم مورد يشير إلى حساب مشترٍ باعتباره ممثلة في buyers في واجهة برمجة تطبيقات "عرض الأسعار في الوقت الفعلي" المصدر.
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

تم إيقاف هذا الحقل.
Proposal.isSetupComplete FinalizedDeal.readyToServe

يمكنك الآن الوصول إلى البيانات بدقة أكبر باستخدام buyers.finalizedDeals.

Proposal.lastUpdaterOrCommentorRole Proposal.lastUpdaterOrCommentorRole
Proposal.notes.proposalRevision

تم إيقاف هذا الحقل.
Proposal.notes.noteId

تم إيقاف هذا الحقل.
Proposal.notes.createTime Proposal.notes.createTime
Proposal.notes.creatorRole Proposal.notes.creatorRole
Proposal.notes.note Proposal.notes.note
Proposal.termsAndConditions Proposal.termsAndConditions