# Batch and bulk

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

مرجع كانوني: https://flashdata.dev/ar/docs/reference/batch-and-bulk
Reviewed: 2026-11-05 by FlashData

<a id="choose"></a>

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

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

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

- [Realtime and async](https://flashdata.dev/ar/docs/reference/realtime-and-async/reference.md#choose)

<a id="batch"></a>

## Batch: independent queries

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

### مدخل Batch: مهمتان مختلفتان

```json
{
  "queries": [
    {
      "source": "google_search",
      "query": "open source speech recognition",
      "params": {
        "num": 5
      }
    },
    {
      "source": "youtube_metadata",
      "video_id": "dQw4w9WgXcQ",
      "params": {}
    }
  ]
}
```

- [أجري طلب من شركة Batch وجمع نتائجها](https://flashdata.dev/ar/docs/guides/async-batch/reference.md#batch)
- [بناء طلب من شركة Batch للحصول على مصدر](https://flashdata.dev/ar/docs/guides/async-batch/reference.md#customize)

<a id="bulk"></a>

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

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

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

### video-ids.txt

```text
dQw4w9WgXcQ
jNQXAC9IVRw
```

- [افتح Bulk API الملعب](https://flashdata.dev/ar/docs/reference/bulk-processing/reference.md#playground)
- [Bulk نقاط النهاية ومجالات الطلب](https://flashdata.dev/ar/docs/reference/bulk-processing/reference.md#endpoints)
- [إعداد ومراجعة مجموعة بيانات فيديو مع CLI](https://flashdata.dev/ar/docs/guides/bulk/reference.md)

<a id="batch-results"></a>

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

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

- [Batch](https://flashdata.dev/ar/docs/guides/async-batch/reference.md#batch-results)
- [Bulk manifest and parts](https://flashdata.dev/ar/docs/reference/bulk-processing/reference.md#downloadBulkJobManifest)
- [إنقاذ النتائج قبل الإنهاء](https://flashdata.dev/ar/docs/guides/save-results/reference.md)

<a id="limits"></a>

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

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

- [حدود الحساب](https://flashdata.dev/ar/docs/guides/usage-and-limits/reference.md)
- [الأرصدة الدائنة والتسعير](https://flashdata.dev/ar/docs/guides/credits-and-billing/reference.md)
