تخطَّ إلى المحتوى
AR
الحصول على مفتاح API
تصفح الوثائق

مرجع API

Batch and bulk

اختر Batch للاستعلامات المستقلة ذات المدخلات المختلفة. واختر Bulk لملف معرّفات فيديو تحتاج جميعها إلى العملية نفسها.

في هذه الصفحة

اختر من خلال العمل الذي تحتاجه

الخيار يعتمد على شكل مدخلك وليس على عدد ثابت من البنود كلتا الموديتين تعملان في الخلفية لاستفسار واحد، إستخدم الوقت الحقيقي أو الأسينك مباشرة.

مهمتكالإختيار
البحث عن عدة مواضيع لإحاطة يوميةBatch: ولكل استفسار شروط البحث الخاصة به أو موقعه أو لغته.
نتائج اللجنة (Google) و(YouTube)Batch: خلط المصادر وجمع نتيجة منفصلة لكل استفسار.
تجديد البيانات الفوقية أو جمع النصوص لفيلم فيديوBulk: ملف واحد من أشرطة الفيديو ID، ومصدر واحد، وخيارات واحدة لكل شريط فيديو.
تسليم قائمة بالفيديو إلى دلو في نفس الشكلBulk: استخدم youtube_download مع إعدادات الوسائط المشتركة ووجهة التخزين.
استخدام مختلف مواقع النواتج لكل شريط فيديوBatch: ويمكن أن تختلف بارامترات الكم؛ Bulk تَطبّقُ مجموعة واحدة على الملفِ الكاملِ.

Batch: independent queries

أرسل كائن JSON يحتوي queries. لكل عنصر source وinput وparams خاصة به. استخدم Batch لبحوث Google أو YouTube أو المصادر المختلطة أو الفيديوهات التي تحتاج خيارات مختلفة.

مدخل Batch: مهمتان مختلفتان
{
  "queries": [
    {
      "source": "google_search",
      "query": "open source speech recognition",
      "params": {
        "num": 5
      }
    },
    {
      "source": "youtube_metadata",
      "video_id": "dQw4w9WgXcQ",
      "params": {}
    }
  ]
}

Bulk: عملية واحدة على ملف

تحميل UTF-8 ملف واحد YouTube فيديو ID لكل خط نختار مصدر واحد مدعم ومجموعة واحدة من الخيارات للملف بأكمله. وتقوم شركة Bulk بمسح الملف، وتقدم العمل في حدود القدرة الحسابية، وتسفر الطرود إلى أجزاء قابلة للتنزيل.

  1. اختيار البيانات الوصفية، والمحاضر، والاختفاءات، وتصنيف التراخيص، والتحميل. Bulk takes video IDs; use Batch for keyword searches.
  2. استخدام وظيفة منفصلة عندما يتغير المصدر أو الخيارات. فعلى سبيل المثال، تمثل البيانات الوصفية والمحاضرات للملف نفسه وظيفتين من وظائف Bulk.
  3. وللحمولات، يرجى توفير مخزن للجهات والمالكة، مع الحصول على إذن من شركة youtube_download. صفات النتائج تصف وسائل الإعلام المُسلّمة؛ الملفات الإعلامية مخزنة في دلوكم.
video-ids.txt
dQw4w9WgXcQ
jNQXAC9IVRw

نخطط كيف ستجمع النتائج

المسؤوليةBatchBulk
انقذ بعد تقديم الطلبكل زورق من طراز queries[].id مرتبط بمدخله الأصلي. ليس هناك وظيفة واحدة من وظائف Batch ID.وظيفة واحدة من طراز Bulk ID وملف المدخلات الذي لم يطرأ عليه تغيير.
إنجاز المساروينتهي كل عمل بصورة مستقلة؛ ولا يصف فشل واحد الدفعة بأكملها.وتكشف إحدى الوظائف عن عدد التقدم المحرز، وتُستكمل النتائج، وليس أن كل شريط فيديو قد نجح.
النواتجإحصل على كل نتيجة عمل مكتملة واحتفظ بمدخله إلىID رسم الخرائط.أحضري البيان وكل ضغط NDJSON جزء. انضموا للرقم القياسي video_idليس ترتيب الصف.
الاسترجاع بعد المقاطعةاقرأ الوظيفة المحفوظة IDs قبل النظر في الطلبات الجديدة.تحقق من الإنقاذ Bulk ID. حل pauseReason و استأنفي هذا العمل إذا تم إيقافه

القدرة على التحقق والتكاليف قبل البدء

تحققما الذي يجب حسابه
Batchخطتك maxBatchSize (ب) الحد من الاستفسارات عن كل طلب. :: تقسيم مجموعات أكبر إلى مجموعات أصغر، واحترام القدرة على العمل في انتظار انتهاء الخدمة.
Bulkحتى 2 GiB per ID ملف ويُقدَّم العمل تدريجياً في حدود قدرات الحساب المشترك؛ ويزيل الازدواج قبل تحميله.
الأرصدةالتجمّع ليس تهمة واحدة وتستعمل الكميات تسعير كل مصدر؛ وتُحمَّل الحمولات بحجم البيانات المُسلَّمة.
الوصولالمفتاح يجب أن يسمح لكل مصدر مطلوب تحقق من حدود الحساب النشط، التجربة ليست حساب كامل الأهلية.