الرئيسية › مفاتيح API › Google Cloud Translation
✓ تم التحقق مقابل الصفحات الرسمية لـ Google Cloud في 23 سبتمبر 2026. الشاشات والأسعار تتغير: إذا بدا شيء مختلفًا، فثق بما تعرضه لك Google.
مفتاح API من Google Cloud Translation هو رمز سري يتيح لـ TranslateRocket إرسال نص موقعك إلى الخدمة الاحترافية من Google Translate واستلام الترجمة؛ أول 500,000 حرف كل شهر مجانية، لكن Google تطلب بطاقة قبل أن تتمكن من البدء.
📖 كلمات ستصادفها
- مفتاح API: رمز سري طويل. من يملكه يمكنه استخدام الخدمة على نفقتك، لذا عامله كما تعامل كلمة المرور.
- Google Cloud console: موقع Google لخدماته السحابية المدفوعة، على console.cloud.google.com. إنه أكثر تقنيةً من الخدمات الأخرى في هذه الأدلة؛ الخطوات أدناه تبقيه بسيطًا.
- المشروع (Project): حاوية تستخدمها Google لتجميع خدمة ومفاتيحها وفاتورتها.
- حساب الفوترة (Billing account): حيث تُسجَّل بطاقتك. يحتاج Google Cloud إلى حساب فوترة حتى لو بقيت ضمن الحصة المجانية.
- الأحرف: تحتسب Google التكلفة بعدد الأحرف التي ترسلها، بما في ذلك المسافات.
ما تحتاجه قبل البدء
- حساب Google (يكفي عنوان Gmail).
- بطاقة دفع. تقول Google إنه يجب تفعيل الفوترة لاستخدام Cloud Translation. عند إنشاء حساب فوترة، قد تضع Google حجزًا مؤقتًا صغيرًا على البطاقة (بين $0 و$1) للتحقق منها؛ وهذا ليس تحصيلًا فعليًا. في بعض الدول تطلب Google أيضًا التحقق من حسابك المصرفي.
- حوالي 15 دقيقة.
خطوة بخطوة
أ. إنشاء مشروع
TranslateRocket.ب. تفعيل الفوترة
ج. تفعيل خدمة الترجمة
د. إنشاء المفتاح
احتفظ بالمفتاح في مكان آمن حتى تلصقه في ووردبريس (يُفضَّل استخدام مدير كلمات مرور). لا ترسله بالبريد الإلكتروني أو الدردشة.
كم تبلغ التكلفة
السعر الرسمي (صفحة أسعار Cloud Translation، إصدار "Basic"، وهو ما يستخدمه TranslateRocket؛ تم التحقق منه في 23 سبتمبر 2026):
| الاستخدام الشهري | السعر |
|---|---|
| أول 500,000 حرف شهريًا | مجاني (تطبّقها Google كرصيد شهري قدره $10؛ لا يُرحَّل إلى الشهر التالي) |
| من 500,000 إلى مليار حرف شهريًا | $20 لكل 1,000,000 حرف |
تحتسب Google كل حرف ترسله، بما في ذلك المسافات ووسوم HTML.
ما يعنيه ذلك لموقع صغير. مثالنا: موقع من 20 صفحة يحتوي كل منها على حوالي 600 كلمة (12,000 كلمة)، أي حوالي 75,000 حرف. نقرّب الرقم إلى 100,000 حرف مراعاةً لوسوم HTML والقوائم.
- لغة واحدة: حوالي 100,000 حرف. يقع هذا ضمن الحصة المجانية البالغة 500,000 شهريًا، لذا التكلفة $0.
- خمس لغات في الشهر نفسه: حوالي 500,000 حرف، لا تزال ضمن حدود الحصة المجانية تقريبًا.
- Above the free allowance, each extra language would cost about 100,000 × $20 / 1,000,000 = $2.
تُحتسب كل لغة بشكل منفصل. النص الذي سبق أن ترجمه TranslateRocket يُعاد استخدامه ولا يُرسل مجددًا.
السلامة (يُرجى القراءة)
Google Cloud لا توقف الإنفاق تلقائيًا ما لم تطلب منها ذلك. يُرجى القيام بكلا الأمرين التاليين.
1. ضع سقفًا يوميًا صارمًا على الأحرف (هذا هو ما يوقف الإنفاق فعليًا). تقول Google إن عدد الأحرف التي يمكنك إرسالها يوميًا غير محدود افتراضيًا، وأنه يمكنك خفض هذه الحصة للتحكم في التكاليف.
- افتح صفحة Quotas في Cloud console، وهي مُصفّاة مسبقًا على الترجمة: https://console.cloud.google.com/iam-admin/quotas?service=translate.googleapis.com (تأكد من أن مشروعك محدد).
- ابحث عن حصة Cloud Translation الخاصة بـعدد الأحرف المرسلة إلى النموذج العام لكل مشروع يوميًا (v2).
- عدّله وأدخل عدد الأحرف في اليوم.
كيفية اختيار الرقم: السقف هو في اليوم، لذا في شهر قد تصل إلى حوالي 30 ضعف هذا الرقم. على سبيل المثال، 100000 في اليوم يتيح لك ترجمة موقعنا المثال بلغة واحدة يوميًا؛ وفي أسوأ الحالات يسمح بحوالي 3,000,000 حرف شهريًا، أي حوالي $50 بعد الحصة المجانية البالغة 500,000. سقف قدره 15000 في اليوم يبقي حتى أسوأ شهر ضمن الحصة المجانية، لكن الترجمة ستستغرق عدة أيام. يمكنك رفعه أثناء الترجمة وخفضه بعد ذلك.
عند بلوغ السقف، تردّ Google بخطأ "Daily Limit Exceeded" حتى منتصف الليل بتوقيت المحيط الهادئ. قد تستغرق قيم الحصة الجديدة حتى 24 ساعة لتُطبَّق.
2. أضف تنبيه ميزانية (هذا يرسل رسائل بريد إلكتروني فقط).
- افتح القائمة ☰ ← Billing ← Budgets & alerts.
- أنشئ ميزانية لمشروعك، وحدد مبلغًا (مثلًا $5) وعتبات التنبيه، ثم انقر على Finish.
توضّح Google بجلاء: هذا النوع من الميزانيات لا يحدّ من الإنفاق؛ بل يكتفي بإرسال بريد إلكتروني. لهذا السبب تهم الخطوة 1.
3. اضبط حدًا داخل TranslateRocket أيضًا. في TranslateRocket → AI Translation، القسم Usage & limits، أدخل Daily character limit (على سبيل المثال 200000). عند بلوغ الحد، تتوقف الترجمة التلقائية حتى اليوم التالي. 0 تعني بلا حد.
4. لا تشارك المفتاح أبدًا. لا تضعه في رسائل بريد إلكتروني أو محادثات أو لقطات شاشة أو تذاكر دعم.
5. إذا اعتقدت أن المفتاح تسرّب، استبدله.
- توجّه إلى https://console.cloud.google.com/apis/credentials وانقر على اسم المفتاح.
- انقر على Rotate key، أعطِ المفتاح الجديد اسمًا وانقر على Create. انسخ المفتاح الجديد والصقه في TranslateRocket.
- عد إلى صفحة المفتاح الجديد، وفي قسم Previous key، انقر على Delete the previous key.
إذا حذفت مفتاحًا عن طريق الخطأ، تتيح لك Google استعادته خلال 30 يومًا (Restore deleted credentials في صفحة Credentials).
أين تلصقه في TranslateRocket
- في لوحة تحكم ووردبريس الخاصة بك، افتح TranslateRocket → AI Translation.
- في مربع Provider & keys، ابحث عن البطاقة المسماة Google Translate (وهذه هي خدمة Google Cloud Translation).
- الصق مفتاحك في حقل API key.
- في أعلى المربع، اضبط Active provider على Google Translate.
- انقر على Save AI settings في أسفل الصفحة.
لا يوجد لدى Google Translate "نموذج" لاختياره. تعليمات House style في الصفحة نفسها تعمل فقط مع نماذج الذكاء الاصطناعي (OpenAI وClaude وGemini)؛ تتجاهلها Google Translate.
إذا لم يعمل شيء ما
| ما تراه | ما يعنيه عادةً | ما يجب فعله |
|---|---|---|
| خطأ يفيد بأن المفتاح غير صالح (تختلف الصياغة الدقيقة) | تم نسخ المفتاح بشكل خاطئ، أو تم حذفه. | الصقه مجددًا بعناية، أو أنشئ مفتاحًا جديدًا (القسم د). |
| خطأ يفيد بأن الواجهة غير مفعّلة، أو أن الفوترة مطلوبة (تختلف الصياغة الدقيقة) | تم تخطي الخطوة ب أو ج، أو تم تنفيذها على مشروع مختلف. | تحقق من أن المشروع المحدد في أعلى الكونسول هو نفسه الذي يحتوي على المفتاح، ثم فعّل الفوترة وCloud Translation API له. |
| "Daily Limit Exceeded" (403) | السقف اليومي الخاص بك من قسم السلامة أدى دوره. | انتظر حتى اليوم التالي (منتصف الليل بتوقيت المحيط الهادئ)، أو ارفع الحصة. |
تحقق أيضًا من قيد المفتاح: إذا حددت تحت API restrictions خدمة مختلفة، ستَرفض Cloud Translation المفتاح.
أسئلة يطرحها الناس
هل واجهة Google Translate API مجانية؟
أول 500,000 حرف كل شهر مجانية، لكن Google تطلب منك تفعيل الفوترة ببطاقة حتى لو بقيت ضمن الحصة المجانية. وفيما بعدها، السعر هو $20 لكل مليون حرف.
كيف أمنع Google Cloud Translation من تحصيل رسوم مني؟
اضبط حصة يومية على الأحرف في Google Cloud console: هذا هو الحد الذي يوقف الإنفاق فعليًا. الميزانية تكتفي بإرسال رسائل تنبيه بالبريد الإلكتروني؛ ولا توقف شيئًا.
هل واجهة Google Translate API هي نفسها Gemini؟
لا. Google Cloud Translation هي النسخة الاحترافية من Google Translate، بمفاتيح من Google Cloud console. أما Gemini فهو نموذج الذكاء الاصطناعي من Google، بمفاتيح من Google AI Studio.
لماذا تقول Google إن مفتاح API الخاص بي غير صالح أو يحتاج إلى فوترة؟
عادةً يكون أحد ثلاثة أسباب: المشروع الخطأ محدد، أو الفوترة غير مرتبطة بالمشروع، أو Cloud Translation API غير مفعّلة له.
أيهما يجب أن أختار؟
راجع صفحة المقارنة لدينا للاطلاع على مقارنة بسيطة بين الخدمات الخمس، وعلى الخيار المجاني الذي لا يحتاج إلى مفتاح على الإطلاق.
أدلة أخرى: OpenAI · Anthropic (Claude) · Google Gemini · DeepL · أيهما يجب أن أختار؟
