java translate Download - java translate Source Code Download

java translate

شفرة المصدر الأخرى

v2.3.5

تنزيل

عميل ترجمة Google Cloud لـ Java

عميل Java Idiomatic للترجمة السحابية.

وثائق المنتج
وثائق مكتبة العميل

؟ في أكتوبر 2022 ، انتقلت هذه المكتبة إلى Google-Cloud-Java/Java-Translate. سيتم أرشفة هذا المستودع في المستقبل. ستظهر الإصدارات المستقبلية في المستودع الجديد (https://github.com/googleapis/google-cloud-java/release). تظل إحداثيات Artifact Maven ( com.google.cloud:google-cloud-translate ) كما هي.

Quickstart

إذا كنت تستخدم Maven مع BOM ، فأضف هذا إلى ملف pom.xml الخاص بك:

< dependencyManagement >
  < dependencies >
    < dependency >
      < groupId >com.google.cloud</ groupId >
      < artifactId >libraries-bom</ artifactId >
      < version >26.1.3</ version >
      < type >pom</ type >
      < scope >import</ scope >
    </ dependency >
  </ dependencies >
</ dependencyManagement >

< dependencies >
  < dependency >
    < groupId >com.google.cloud</ groupId >
    < artifactId >google-cloud-translate</ artifactId >
  </ dependency >
</ dependencies >

إذا كنت تستخدم Maven بدون BOM ، فأضف هذا إلى تبعياتك:

< dependency >
  < groupId >com.google.cloud</ groupId >
  < artifactId >google-cloud-translate</ artifactId >
  < version >2.3.5</ version >
</ dependency >

إذا كنت تستخدم Gradle 5.x أو لاحقًا ، أضف هذا إلى تبعياتك:

implementation platform( ' com.google.cloud:libraries-bom:26.1.4 ' )

implementation ' com.google.cloud:google-cloud-translate '

إذا كنت تستخدم Gradle بدون BOM ، فأضف هذا إلى تبعياتك:

implementation ' com.google.cloud:google-cloud-translate:2.6.0 '

إذا كنت تستخدم SBT ، أضف هذا إلى تبعياتك:

libraryDependencies + = " com.google.cloud " % " google-cloud-translate " % " 2.6.0 "

المصادقة

راجع قسم المصادقة في ReadMe الدليل الأساسي.

إذن

يجب منح نطاقات API لإجراء تطبيقات العميل نطاقات التفويض المطلوبة لواجهة برمجة تطبيقات الترجمة السحابية المطلوبة ، ويجب أن يكون للمدير المصادق عليه دور (أدوات) IAM المطلوبة للوصول إلى موارد GCP باستخدام مكالمات API للترجمة السحابية.

ابدء

المتطلبات الأساسية

ستحتاج إلى مشروع وحدة تحكم Google Cloud Platform مع تمكين API Cloud Translation. ستحتاج إلى تمكين الفواتير لاستخدام ترجمة Google Cloud. اتبع هذه التعليمات لإعداد مشروعك. ستحتاج أيضًا إلى إعداد بيئة التطوير المحلية عن طريق تثبيت Google Cloud SDK وتشغيل الأوامر التالية في سطر الأوامر: gcloud auth login و gcloud config set project [YOUR PROJECT ID] .

التثبيت والإعداد

ستحتاج إلى الحصول على مكتبة google-cloud-translate . راجع قسم QuickStart لإضافة google-cloud-translate كاعتماد في التعليمات البرمجية الخاصة بك.

حول الترجمة السحابية

يمكن للترجمة السحابية ترجمة النص ديناميكيًا بين آلاف أزواج اللغة. تتيح الترجمة للمواقع الإلكترونية والبرامج دمجًا برمجيًا مع خدمة الترجمة.

راجع مستندات مكتبة عميل العميل Cloud Translation لمعرفة كيفية استخدام مكتبة عميل الترجمة السحابية هذه.

مثال التطبيق

TranslateExample هي واجهة سطر أوامر بسيطة توفر بعض وظائف ترجمة Google.

إنشاء كائن خدمة معتمد

لتقديم طلبات مصادقة على ترجمة Google ، يجب عليك إنشاء كائن خدمة يحتوي على بيانات اعتماد أو استخدام مفتاح API. أبسط طريقة للمصادقة هي استخدام بيانات الاعتماد الافتراضية للتطبيق. يتم استنتاج بيانات الاعتماد هذه تلقائيًا من بيئتك ، لذلك تحتاج فقط إلى الكود التالي لإنشاء كائن الخدمة الخاص بك:

 import com . google . cloud . translate . Translate ;
import com . google . cloud . translate . TranslateOptions ;

Translate translate = TranslateOptions . getDefaultInstance (). getService ();

لاحظ أنه يمكن استخدام هذا الرمز أيضًا مع مفتاح API. بشكل افتراضي ، يتم البحث عن مفتاح API في متغير بيئة GOOGLE_API_KEY . بمجرد تعيين مفتاح API ، يمكنك إجراء مكالمات API من خلال استدعاء الأساليب في خدمة الترجمة التي تم إنشاؤها عبر TranslateOptions.getDefaultInstance().getService() .

يمكنك أيضًا تعيين مفتاح API بشكل صريح على النحو التالي:

 Translate translate = TranslateOptions . newBuilder (). setApiKey ( "myKey" ). build (). getService ();

الكشف عن اللغة

مع ترجمة Google ، يمكنك اكتشاف لغة بعض النصوص. ستوفر لك الخدمة رمز اللغة المكتشفة ومستوى من الثقة.

أضف الاستيراد التالي في الجزء العلوي من ملفك:

 import com . google . cloud . translate . Detection ;

ثم اختر عينة نصية:

 final String mysteriousText = "Hola Mundo" ;

ثم أضف الكود التالي للكشف عن لغة النص:

 Detection detection = translate . detect ( mysteriousText );
String detectedLanguage = detection . getLanguage ();

ترجمة النص

تتيح لك الترجمة Google ترجمة بعض النصوص. عند ترجمة نص واحد أو أكثر ، يمكنك إما توفير لغة المصدر أو السماح للخدمة باكتشافها لك.

أضف الواردات التالية في الجزء العلوي من ملفك:

 import com . google . cloud . translate . Translate . TranslateOption ;
import com . google . cloud . translate . Translation ;

ثم أضف الكود التالي لترجمة النص ، وتحديد اللغة التي تم اكتشافها مسبقًا ( detectedLanguage ) كلغة المصدر والإنجليزية كلغة مستهدفة (توفير لغة المصدر اختيارية ، إذا لم يتم تحديدها ، فسيحاول الخدمة اكتشافها تلقائيًا) :

 Translation translation = translate . translate (
    mysteriousText ,
    TranslateOption . sourceLanguage ( detectedLanguage ),
    TranslateOption . targetLanguage ( "en" ));

رمز المصدر الكامل

في DetectLanguageAndTranslate.java قمنا بتجميع جميع الكود الموضح أعلاه في برنامج واحد. يفترض البرنامج أن إما بيانات الاعتماد الافتراضية للتطبيق أو مفتاح API صالح متاح.

عينات

العينات في samples/ الدليل.

عينة	رمز المصدر	جربه
عينة QuickStart	رمز المصدر
ترجمة النص مع مسرد ونموذج	رمز المصدر
دفعة ترجمة وثيقة	رمز المصدر
ترجمة المستند	رمز المصدر

استكشاف الأخطاء وإصلاحها

للحصول على المساعدة ، اتبع الإرشادات الواردة في مستند استكشاف الأخطاء وإصلاحها المشتركة.

ينقل

تستخدم الترجمة السحابية كلاً من GRPC و HTTP/JSON لطبقة النقل.

دعم إصدارات Java

مطلوب Java 8 أو أعلى لاستخدام هذا العميل.

مكتبات عملاء Java من Google ، ومكتبات عملاء Google Cloud ومكتبات Google Cloud API ، اتبع Oracle Java SE Support Map (انظر قسم إصدارات منتجات Oracle Java SE).

للتنمية الجديدة

بشكل عام ، يحدث تطوير الميزات الجديدة بدعم من أدنى إصدار Java LTS الذي يغطيه دعم Oracle Premier (والذي يستمر عادةً 5 سنوات من التوفر العام الأولي). إذا تم تغيير الحد الأدنى المطلوب JVM لمكتبة معينة ، فهو مصحوب بإصدار Semver الرئيسي.

Java 11 و (في سبتمبر 2021) Java 17 هي أفضل الخيارات للتطوير الجديد.

الحفاظ على أنظمة الإنتاج الحالية

تختبر Google مكتبات عملائها مع جميع إصدارات LTS الحالية التي يغطيها دعم Oracle الموسع (الذي يستمر عادة 8 سنوات من التوفر العام الأولي).

الدعم القديم

تدعم مكتبات عملاء Google الإصدارات القديمة من Java Runtimes مع مكتبات مستقرة طويلة الأجل لا تتلقى تحديثات الميزات على أساس الجهود لأنه قد لا يكون من الممكن خلفية جميع التصحيحات.

توفر Google تحديثات على أساس أفضل الجهود للتطبيقات التي تستمر في استخدام Java 7 ، على الرغم من أن التطبيقات قد تحتاج إلى الترقية إلى الإصدارات الحالية من المكتبة التي تدعم JVM.

أين يمكن العثور على معلومات محددة

يتم تحديد أحدث الإصدارات وإصدارات Java المدعومة على مستودع GitHub الفردي github.com/GoogleAPIs/java-SERVICENAME وعلى Google-Cloud-Java.

الإصدار

هذه المكتبة تتبع النسخة الدلالية.

المساهمة

المساهمات في هذه المكتبة هي دائما موضع ترحيب ومشجع للغاية.

انظر المساهمة لمزيد من المعلومات كيفية البدء.

يرجى ملاحظة أن هذا المشروع يتم إصداره باستخدام مدونة سلوك المساهم. من خلال المشاركة في هذا المشروع ، فإنك توافق على الالتزام بشروطه. انظر مدونة السلوك لمزيد من المعلومات.