إضافة دوال Google Cloud

استدعاء دالة Node.js

يعرض المثال التالي سياسة ExtensionCallout لاستدعاء إضافة دوال Google Cloud. تستدعي الإضافة الاسم التلقائي "hello world" عند تفعيل Cloud Functions API.

تم نشر محتوى JavaScript التالي في Node.js في Cloud Functions في حساب Google Cloud Platform. إذا كان الطلب يتضمّن خاصية رسالة، يعرض الرمز ذلك. وإلا، فسيتم عرض "Hello World!" كاستجابة له.

/**
 * Responds to any HTTP request.
 *
 * @param {!express:Request} req HTTP request context.
 * @param {!express:Response} res HTTP response context.
 */
exports.helloWorld = (req, res) => {
  let message = req.query.message || req.body.message || 'Hello World!';
  res.status(200).send(message);
};

يتضمن هذا المثال إضافة Google Cloud Functions التي تم ضبطها مع بيانات الاعتماد اللازمة للمصادقة والحصول على إذن لاستدعاء الرمز في Cloud Functions.

يتم حفظ رمز الدالة السابق في دوال Cloud باسم helloWorld ببساطة. يستخدم رمز ضبط سياسة ExtensionCallout هذا الاسم، بالإضافة إلى قيم رقم تعريف المنطقة والمشروع التي تتطابق مع تفاصيل بيئة Cloud Functions التي تم فيها تفعيل الدالة.

<Action>invoke</Action>
<Input><![CDATA[
  {
    "region" : "us-central1",
    "projectId" : "my-project",
    "functionName" : "hello-world",
    "method" : "POST",
    "payload" : { "message" : "Hello yourself!" }
  }
]]></Input>
<Output parsed="false">function.response</Output>

تسجِّل سياسة assignMessage التالية قيمة الردّ لأغراض تصحيح الأخطاء.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage async="false" continueOnError="false" enabled="true" name="Get-Function-Response">
    <DisplayName>Get Function Response</DisplayName>
    <AssignTo type="response" createNew="false"/>
    <Set>
        <Payload contentType="application/json">{function.response}</Payload>
    </Set>
</AssignMessage>

سيكون الرد على الطلب أعلاه على النحو التالي:

Hello yourself!

القيمة التلقائية للسمة parsed هي true. يحدّد هذا المثال العلامة parsed="false" في العلامة <Output> للسياسة. ما يمنع السياسة من تحليل استجابة JSON. في معظم الحالات عند استخدام إضافة "دوال السحابة الإلكترونية"، يمكنك إعداد parsed="false". راجع <الإخراج> العنصر للمزيد.

إذا أرجعت دالة السحابة الإلكترونية استجابة JSON وضبطت parsed="true"، ستكون الاستجابة من الإضافة مرجع كائن. لاستخراج الردّ من المرجع، استخدِم البنية التالية: {objectName}.{jsonKey}. مثلاً:

function.response.message

البنية

<Action>invoke</Action>
<Input><![CDATA[
  {
    "region" : "deployment-region",
    "projectId" : "project-id",
    "functionName" : "function-name",
    "method" : "http-method",
    "payload" : { json-payload }
  }
]]></Input>
<Output>function.response</Output>

مثال

<Action>invoke</Action>
<Input><![CDATA[
  {
    "region" : "us-central1",
    "projectId" : "my-project",
    "functionName" : "hello-world",
    "method" : "POST",
    "payload" : { "message" : "Hello yourself!" }
  }
]]></Input>
<Output>function.response</Output>