سير عمل واجهة برمجة التطبيقات
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
الحصول على قائمة بحِزم المزادات
استدعاء LIST API يتيح الفلترة حسب external_deal_id
إنشاء حزمة مزاد جديدة
- يجب أن يكون external_deal_id فريدًا. اتّصِل بالدالة LIST مع external_deal_id لمعرفة ما إذا كان قد تم استخدام المعرّف من قبل.
- اتّصِل بالدالة Create API. سيتم تعيين اسم فريد، ويمكن استخدامه للحصول على الحزمة التي تم إنشاؤها.
- استدعِ الدالة Get API للاطّلاع على تفاصيل "حزمة المزاد" التي تم إنشاؤها.
- يمكنك اختياريًا تحميل شعار للحزمة التي تم إنشاؤها.
تعديل حزمة المزاد
- إذا لم تخزِّن اسم "حزمة المزاد" التي تم إنشاؤها، استخدِم فلتر LIST API حسب external_deal_id للحصول على "حزمة المزاد" التي تريد تعديلها.
- عدِّل الحقول استنادًا إلى النتائج من LIST API.
- استدعِ Patch API لتعديل حزمة المزاد. يجب توفير "updateMask"، وهو يشير إلى الحقول التي تريد تطبيق التعديل عليها. لا يمكن ضبط سوى الحقول المسموح بتعديلها في updateMask.
عملية الإصدار التجريبي
الفرق الوحيد بين الإصدار التجريبي والإصدار المتاح للجميع هو أنّه خلال الإصدار التجريبي، يجب ضبط حالة "حِزم عروض الأسعار" التي تم إنشاؤها على DISCOVERY_OBJECT_STATUS_PAUSED، ولا يمكن تعديل الحالة. لا تظهر الحِزم التي تم إيقافها مؤقتًا في واجهة مستخدم "مساحة العرض والفيديو 360". يهدف ذلك إلى توفير طريقة لجهات التبادل لاختبار عملية دمج واجهة برمجة التطبيقات بدون عرض حِزم الاختبار.
من الشائع إنشاء جميع الحِزم "الحقيقية" في الإصدار التجريبي على أنّها PAUSED ثم "تفعيلها" بعد إتاحتها للجميع.
الحصة
2,000 حزمة نشطة لكلّ شبكة تبادل
2,000 حزمة متوقّفة مؤقتًا لكلّ شبكة تبادل
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-10-08 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-10-08 (حسب التوقيت العالمي المتفَّق عليه)"],[],["Auction package management involves listing, creating, and updating. To list packages, use the LIST API, filtering by `external_deal_id`. Creation requires a unique `external_deal_id` and uses the Create API; retrieve package details with the Get API. Updating involves using the LIST API to retrieve the package, modifying fields, and using the Patch API with an `updateMask`. During beta, created packages must be \"PAUSED\" and cannot have their status changed. Each exchange has a quota of 1000 active and 1000 paused packages.\n"]]