تفعيل واجهة برمجة التطبيقات
على غرار واجهات برمجة التطبيقات الأخرى الخاصة بالشراة المعتمَدين، يجب تفعيل Marketplace API لكي تتمكّن من استخدامه. يمكنك تفعيل Marketplace API من خلال تنفيذ الخطوات التالية:
- انتقِل إلى صفحة واجهات برمجة التطبيقات التي تم تفعيلها من خلال وحدة تحكُّم Google API. اختَر المشروع الذي تستخدمه للوصول إلى واجهات برمجة تطبيقات "الشراة المعتمَدون" الأخرى، مثل Ad Exchange Buyer II أو Real-time Bidding API.
- انقر على الرابط + تفعيل واجهات برمجة التطبيقات والخدمات.
- في مربّع البحث، اكتب "Authorized Buyers Marketplace API"، واضغط على Enter.
- في نتائج البحث، اختر الشراة المعتمَدون Marketplace API.
- انقر على الزر تفعيل لتفعيل واجهة برمجة تطبيقات Marketplace.
- من المفترض أن تكون قادرًا الآن على الوصول إلى واجهة برمجة تطبيقات Marketplace باستخدام بيانات الاعتماد التي تم إنشاؤها ضمن هذا المشروع.
تعديل بيانات اعتماد OAuth 2.0
يجب تغيير سير عمل OAuth 2.0 الحالي مع نطاق واجهة برمجة التطبيقات Ad Exchange Buyer II لاستخدام نطاق واجهة برمجة تطبيقات Marketplace:
https://www.googleapis.com/auth/authorized-buyers-marketplace
ننصحك باستخدام مسار OAuth 2.0 لحساب الخدمة للوصول إلى واجهة برمجة التطبيقات. على جميع مسارات OAuth 2.0 المتوافقة تحديد نطاق واجهة برمجة التطبيقات الجديد لطلب رمز مميّز من Google يمكنه الوصول إلى Marketplace API.
ربط موارد واجهة برمجة التطبيقات Ad Exchange Buyer II بواجهة برمجة تطبيقات Marketplace
العملاء
إذا كنت تستخدم مورد Ad Exchange Buyer II API
accounts.clients
،
يمكنك نقل البيانات إلى مرجع
buyers.clients
في Marketplace API.
طرق الموارد
واجهة برمجة التطبيقات للمشتري II في Ad Exchange | واجهة برمجة تطبيقات 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
تتيح هذه الطريقة الآن إجراء تعديلات جزئية باستخدام المَعلمة |
حقول الموارد
واجهة برمجة التطبيقات للمشتري II في Ad Exchange | واجهة برمجة تطبيقات Marketplace |
---|---|
Client.clientAccountId |
Client.name
|
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 Buyer II API من
accounts.clients.invitations
وaccounts.clients.users
في مورد واحد
buyers.clients.users
.
طرق الموارد
واجهة برمجة التطبيقات للمشتري II في Ad Exchange | واجهة برمجة تطبيقات 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
وسيكون المستخدمون الذين تم ضبط سمة |
accounts.clients.users.get |
buyers.clients.users.get |
accounts.clients.users.list |
buyers.clients.users.list
|
accounts.clients.users.update |
لم يعُد بإمكانك تصحيح بيانات مستخدمي العملاء باستخدام واجهة برمجة التطبيقات. وننصحك
باستخدام
|
حقول الموارد
واجهة برمجة التطبيقات للمشتري II في Ad Exchange | واجهة برمجة تطبيقات Marketplace |
---|---|
ClientUserInvitation.invitationId |
تم إيقاف هذا الحقل نهائيًا. |
ClientUserInvitation.email |
ClientUser.email |
ClientUserInvitation.clientAccountId |
لم يعُد هذا الحقل متوفّرًا للمستخدمين العملاء. وبدلاً من ذلك، يمكنك عرض
|
ClientUser.userId |
ClientUser.name
|
ClientUser.clientAccountId |
لم يعُد هذا الحقل متوفّرًا للمستخدمين العملاء. وبدلاً من ذلك، يمكنك عرض
|
ClientUser.status |
ClientUser.state |
ClientUser.email |
ClientUser.email |
المنتجات
هذا المورد ووظائفه غير متوفرين في Marketplace API.
PublisherProfiles
إذا كنت تستخدم مورد Ad Exchange Buyer II API
accounts.publisherProfiles
،
يمكنك نقل البيانات إلى مرجع
buyers.publisherProfiles
في Marketplace API.
طرق الموارد
واجهة برمجة التطبيقات للمشتري II في Ad Exchange | واجهة برمجة تطبيقات Marketplace |
---|---|
accounts.publisherProfiles.get |
buyers.publisherProfiles.get |
accounts.publisherProfiles.list |
buyers.publisherProfiles.list
تتوافق هذه الطريقة الآن مع فلاتر القوائم. |
حقول الموارد
واجهة برمجة التطبيقات للمشتري II في Ad Exchange | واجهة برمجة تطبيقات Marketplace |
---|---|
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 |
تم إيقاف هذا الحقل نهائيًا. |
PublisherProfile.googlePlusUrl |
تم إيقاف هذا الحقل نهائيًا. |
PublisherProfile.overview |
PublisherProfile.overview |
PublisherProfile.buyerPitchStatement |
PublisherProfile.pitchStatement |
PublisherProfile.topHeadlines |
PublisherProfile.topHeadlines |
PublisherProfile.audienceDescription |
PublisherProfile.audienceDescription |
PublisherProfile.isParent |
PublisherProfile.isParent |
الاقتراحات والمقترحات النهائية
إذا كنت تستخدم مورد Ad Exchange Buyer II API
accounts.proposals
،
يمكنك نقل البيانات إلى مرجع
buyers.proposals
في Marketplace API. تم فصل الصفقات عن العروض في المرجع الفرعي
buyers.proposals.deals
. لم تعُد الاقتراحات النهائية ممثَّلة في واجهة برمجة التطبيقات، ما يمنحك
إمكانية تحكُّم أكثر دقة في الصفقات النهائية باستخدام
مورد
buyers.finalizedDeals
.
طرق الموارد
واجهة برمجة التطبيقات للمشتري II في Ad Exchange | واجهة برمجة تطبيقات Marketplace |
---|---|
accounts.proposals.accept |
buyers.proposals.accept
عدم طلب الرقم |
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
تتيح هذه الطريقة الآن إجراء تعديلات جزئية باستخدام المَعلمة |
accounts.finalizedProposals.list |
استخدِم
|
accounts.finalizedProposals.pause |
استخدِم
|
accounts.finalizedProposals.resume |
استخدِم
|
حقول الموارد
يتشارك الموردان proposals
وfinalizedProposals
تمثيل Proposal
نفسه، ولهما خطوات نقل بيانات مشابهة.
واجهة برمجة التطبيقات للمشتري II في Ad Exchange | واجهة برمجة تطبيقات Marketplace |
---|---|
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 |
تم إيقاف هذا الحقل نهائيًا. |
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 |
يُرجى العِلم أنّ |
Proposal.deals.dealTerms.nonGuaranteedFixedPriceTerms |
يُرجى العِلم أنّ |
Proposal.deals.dealTerms.NonGuaranteedAuctionTerms |
يُرجى العِلم أنّ |
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
لم يعد من الممكن ضبط الاستهداف باستخدام مفتاح لتحديد فئة الاستهداف، ولكن يمكن العثور على الفئات التي يمكن استهدافها في |
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 |
يمكن العثور على معلومات مماثلة في الحقل
|
Proposal.deals.programmaticCreativeSource |
Deal.creativeRequirements.programmaticCreativeSource |
Proposal.deals.deliveryControl |
Deal.deliveryControl
تمت إضافة تفاصيل إضافية عن كيفية إجراء الصفقات. |
Proposal.deals.isSetupComplete |
FinalizedDeal.readyToServe
يمكنك الآن الإشارة فقط إلى أنّ الصفقة جاهزة للعرض فقط في حال إكمالها. استخدِم طريقة |
Proposal.originatorRole |
Proposal.originatorRole |
Proposal.seller.accountId |
Proposal.publisherProfile
استخدِم اسم الملف الشخصي للناشر لتحديد البائع. يمكنك عرض
الملفات الشخصية للناشرين باستخدام المورد |
Proposal.seller.subAccountId |
Proposal.publisherProfile
استخدِم اسم الملف الشخصي للناشر لتحديد البائع. يمكنك عرض
الملفات الشخصية للناشرين باستخدام المورد |
Proposal.buyer.accountId |
وسيعتمد الحقل المستخدَم على نوع حساب المشتري المتفاوض بشأنه. هذه هي أسماء موارد لمورد |
Proposal.billedBuyer.accountId |
Proposal.billedBuyer
أصبح هذا الآن اسم مورد يشير إلى حساب المشتري كما هو موضح في مورد |
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
تم الوصول الآن بشكل أكثر دقة من خلال |
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 |