كيفية التحقق من مفاتيح API لـ Gemini AI وOpenAI باستخدام Google Apps Script

تعرف على كيفية التحقق من مفاتيح واجهة برمجة التطبيقات لـ Google Gemini AI وOpenAI باستخدام Google Apps Script.

هل تعمل على تطوير وظائف جداول بيانات Google أو إضافات Google Workspace التي تستفيد من قوة Google Gemini AI أو OpenAI؟ يشرح هذا البرنامج التعليمي كيف يمكنك استخدام Google Apps Script للتحقق من أن مفاتيح API التي يقدمها المستخدم صالحة وتعمل.

تقدم البرامج النصية طلب HTTP إلى خدمة AI وتتحقق مما إذا كانت الاستجابة تحتوي على قائمة بالنماذج أو المحركات المتاحة. لا توجد تكلفة مرتبطة بعملية التحقق هذه حيث يتم استخدام مفاتيح واجهة برمجة التطبيقات (API) فقط لجلب قائمة النماذج المتاحة وليس لتنفيذ أي مهام فعلية للذكاء الاصطناعي.

تحقق من مفتاح Google Gemini API

يقدم المقتطف طلب GET إلى Google Gemini API لجلب قائمة النماذج المتاحة. إذا كان مفتاح API صالحًا، فستحتوي الاستجابة على قائمة النماذج. إذا كان مفتاح API غير صالح، فسوف تحتوي الاستجابة على رسالة خطأ.

const verifyGeminiApiKey = (apiKey) => {
  const API_VERSION = 'v1';
  const apiUrl = `https://generativelanguage.googleapis.com/${API_VERSION}/models?key=${apiKey}`;
  const response = UrlFetchApp.fetch(apiUrl, {
    method: 'GET',
    headers: { 'Content-Type': 'application/json' },
    muteHttpExceptions: true,
  });
  const { error } = JSON.parse(response.getContentText());
  if (error) {
    throw new Error(error.message);
  }
  return true;
};

يعمل هذا المقتطف مع Gemini API v1. إذا كنت تستخدم Gemini 1.5، فأنت بحاجة إلى تحديث API_VERSION متغير في البرنامج النصي.

تحقق من مفتاح OpenAI API

يقدم مقتطف Apps Script طلب GET إلى OpenAI API لجلب قائمة المحركات المتاحة. على عكس Gemini API حيث يتم تمرير المفتاح كمعلمة استعلام في عنوان URL، يتطلب OpenAI تمرير مفتاح API في Authorization header.

إذا كان مفتاح API صالحًا، فستحتوي الاستجابة على قائمة بالمحركات. إذا كان مفتاح API غير صالح، فسوف تحتوي الاستجابة على رسالة خطأ.

const verifyOpenaiApiKey = (apiKey) => {
  const apiUrl = `https://api.openai.com/v1/engines`;
  const response = UrlFetchApp.fetch(apiUrl, {
    method: 'GET',
    headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${apiKey}` },
    muteHttpExceptions: true,
  });
  const { error } = JSON.parse(response.getContentText());
  if (error) {
    throw new Error(error.message);
  }
  return true;
};