StartTranslation interface
الأساليب
| get(Document |
إرجاع قائمة بطلبات الدفعات المرسلة وحالة كل طلب. تحتوي هذه القائمة فقط على طلبات الدفعات المرسلة من قبل المستخدم (استنادا إلى المورد). إذا تجاوز عدد الطلبات حد الترحيل لدينا، يتم استخدام الترحيل من جانب الخادم. تشير الاستجابات المرقمة إلى نتيجة جزئية وتتضمن رمز متابعة في الاستجابة. يعني عدم وجود رمز مميز للمتابعة أنه لا تتوفر صفحات إضافية. يمكن استخدام معلمات الاستعلام $top $skip $maxpagesize لتحديد عدد من النتائج لإرجاعها وإزاحة للمجموعة. يشير $top إلى إجمالي عدد السجلات التي يريد المستخدم إرجاعها عبر جميع الصفحات. يشير $skip إلى عدد السجلات التي يجب تخطيها من قائمة الدفعات استنادا إلى طريقة الفرز المحددة. بشكل افتراضي، نقوم بالفرز حسب وقت البدء التنازلي. $maxpagesize هو الحد الأقصى للعناصر التي يتم إرجاعها في الصفحة. إذا تم طلب المزيد من العناصر عبر $top (أو لم يتم تحديد $top وكان هناك المزيد من العناصر التي سيتم إرجاعها)، فسيحتوي "@nextLink" على الارتباط بالصفحة التالية. يمكن استخدام معلمة الاستعلام $orderBy لفرز القائمة التي تم إرجاعها (على سبيل المثال "$orderBy=createdDateTimeUtc asc" أو "$orderBy=createdDateTimeUtc desc"). الفرز الافتراضي تنازلي بواسطة createdDateTimeUtc. يمكن استخدام بعض معلمات الاستعلام لتصفية القائمة التي تم إرجاعها (على سبيل المثال: "status=Succeeded,Cancelled") سيتم إرجاع العمليات الناجحة والملغاة فقط. يمكن استخدام createdDateTimeUtcStart و createdDateTimeUtcEnd معا أو بشكل منفصل لتحديد نطاق من التاريخ والوقت لتصفية القائمة التي تم إرجاعها حسب. معلمات استعلام التصفية المدعومة هي (الحالة، المعرفات، تم إنشاؤهاTimeUtcStart، createdDateTimeUtcEnd). يكرم الخادم القيم المحددة من قبل العميل. ومع ذلك، يجب أن يكون العملاء مستعدين للتعامل مع الاستجابات التي تحتوي على حجم صفحة مختلف أو تحتوي على رمز مميز للمتابعة. عند تضمين كل من $top $skip، يجب أن يطبق الخادم أولا $skip ثم $top على المجموعة. ملاحظة: إذا لم يتمكن الخادم من احترام $top و/أو $skip، فيجب على الخادم إرجاع خطأ إلى العميل لإعلامه بذلك بدلا من مجرد تجاهل خيارات الاستعلام. وهذا يقلل من مخاطر وضع العميل افتراضات حول البيانات التي تم إرجاعها. |
| post(Document |
استخدم واجهة برمجة التطبيقات هذه لإرسال طلب ترجمة مجمع (دفعي) إلى خدمة ترجمة المستندات. يمكن أن يحتوي كل طلب على مستندات متعددة ويجب أن يحتوي على حاوية مصدر ووجهة لكل مستند. يتم استخدام عامل تصفية البادئة واللاحقة (إذا تم توفيرها) لتصفية المجلدات. يتم تطبيق البادئة على مسار فرعي بعد اسم الحاوية. يمكن تضمين المسردات / ذاكرة الترجمة في الطلب ويتم تطبيقها بواسطة الخدمة عند ترجمة المستند. إذا كان المسرد غير صالح أو لا يمكن الوصول إليه أثناء الترجمة، تتم الإشارة إلى خطأ في حالة المستند. إذا كان هناك ملف بنفس الاسم موجود بالفعل في الوجهة، الكتابة فوقه. يجب أن يكون targetUrl لكل لغة مستهدفة فريدا. |
تفاصيل الأسلوب
get(DocumentTranslationGetTranslationsStatusParameters)
إرجاع قائمة بطلبات الدفعات المرسلة وحالة كل طلب. تحتوي هذه القائمة فقط على طلبات الدفعات المرسلة من قبل المستخدم (استنادا إلى المورد).
إذا تجاوز عدد الطلبات حد الترحيل لدينا، يتم استخدام الترحيل من جانب الخادم. تشير الاستجابات المرقمة إلى نتيجة جزئية وتتضمن رمز متابعة في الاستجابة. يعني عدم وجود رمز مميز للمتابعة أنه لا تتوفر صفحات إضافية.
يمكن استخدام معلمات الاستعلام $top $skip $maxpagesize لتحديد عدد من النتائج لإرجاعها وإزاحة للمجموعة.
يشير $top إلى إجمالي عدد السجلات التي يريد المستخدم إرجاعها عبر جميع الصفحات. يشير $skip إلى عدد السجلات التي يجب تخطيها من قائمة الدفعات استنادا إلى طريقة الفرز المحددة. بشكل افتراضي، نقوم بالفرز حسب وقت البدء التنازلي. $maxpagesize هو الحد الأقصى للعناصر التي يتم إرجاعها في الصفحة. إذا تم طلب المزيد من العناصر عبر $top (أو لم يتم تحديد $top وكان هناك المزيد من العناصر التي سيتم إرجاعها)، فسيحتوي "@nextLink" على الارتباط بالصفحة التالية.
يمكن استخدام معلمة الاستعلام $orderBy لفرز القائمة التي تم إرجاعها (على سبيل المثال "$orderBy=createdDateTimeUtc asc" أو "$orderBy=createdDateTimeUtc desc"). الفرز الافتراضي تنازلي بواسطة createdDateTimeUtc. يمكن استخدام بعض معلمات الاستعلام لتصفية القائمة التي تم إرجاعها (على سبيل المثال: "status=Succeeded,Cancelled") سيتم إرجاع العمليات الناجحة والملغاة فقط. يمكن استخدام createdDateTimeUtcStart و createdDateTimeUtcEnd معا أو بشكل منفصل لتحديد نطاق من التاريخ والوقت لتصفية القائمة التي تم إرجاعها حسب. معلمات استعلام التصفية المدعومة هي (الحالة، المعرفات، تم إنشاؤهاTimeUtcStart، createdDateTimeUtcEnd).
يكرم الخادم القيم المحددة من قبل العميل. ومع ذلك، يجب أن يكون العملاء مستعدين للتعامل مع الاستجابات التي تحتوي على حجم صفحة مختلف أو تحتوي على رمز مميز للمتابعة.
عند تضمين كل من $top $skip، يجب أن يطبق الخادم أولا $skip ثم $top على المجموعة. ملاحظة: إذا لم يتمكن الخادم من احترام $top و/أو $skip، فيجب على الخادم إرجاع خطأ إلى العميل لإعلامه بذلك بدلا من مجرد تجاهل خيارات الاستعلام. وهذا يقلل من مخاطر وضع العميل افتراضات حول البيانات التي تم إرجاعها.
function get(options?: DocumentTranslationGetTranslationsStatusParameters): StreamableMethod<DocumentTranslationGetTranslationsStatus200Response | DocumentTranslationGetTranslationsStatus400Response | DocumentTranslationGetTranslationsStatus401Response | DocumentTranslationGetTranslationsStatus429Response | DocumentTranslationGetTranslationsStatus500Response | DocumentTranslationGetTranslationsStatus503Response>المعلمات
المرتجعات
StreamableMethod<DocumentTranslationGetTranslationsStatus200Response | DocumentTranslationGetTranslationsStatus400Response | DocumentTranslationGetTranslationsStatus401Response | DocumentTranslationGetTranslationsStatus429Response | DocumentTranslationGetTranslationsStatus500Response | DocumentTranslationGetTranslationsStatus503Response>
post(DocumentTranslationStartTranslationParameters)
استخدم واجهة برمجة التطبيقات هذه لإرسال طلب ترجمة مجمع (دفعي) إلى خدمة ترجمة المستندات. يمكن أن يحتوي كل طلب على مستندات متعددة ويجب أن يحتوي على حاوية مصدر ووجهة لكل مستند.
يتم استخدام عامل تصفية البادئة واللاحقة (إذا تم توفيرها) لتصفية المجلدات. يتم تطبيق البادئة على مسار فرعي بعد اسم الحاوية.
يمكن تضمين المسردات / ذاكرة الترجمة في الطلب ويتم تطبيقها بواسطة الخدمة عند ترجمة المستند.
إذا كان المسرد غير صالح أو لا يمكن الوصول إليه أثناء الترجمة، تتم الإشارة إلى خطأ في حالة المستند. إذا كان هناك ملف بنفس الاسم موجود بالفعل في الوجهة، الكتابة فوقه. يجب أن يكون targetUrl لكل لغة مستهدفة فريدا.
function post(options: DocumentTranslationStartTranslationParameters): StreamableMethod<DocumentTranslationStartTranslation202Response | DocumentTranslationStartTranslation400Response | DocumentTranslationStartTranslation401Response | DocumentTranslationStartTranslation429Response | DocumentTranslationStartTranslation500Response | DocumentTranslationStartTranslation503Response>المعلمات
المرتجعات
StreamableMethod<DocumentTranslationStartTranslation202Response | DocumentTranslationStartTranslation400Response | DocumentTranslationStartTranslation401Response | DocumentTranslationStartTranslation429Response | DocumentTranslationStartTranslation500Response | DocumentTranslationStartTranslation503Response>
