إضافة دوال Google Cloud

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

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

تم نشر رمز JavaScript التالي في Node.js في دوال السحابة لحساب 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. في معظم الحالات عند استخدام إضافة دوال Cloud، يمكنك إعداد parsed="false". راجع عنصر<الإخراج> للاطّلاع على مزيد من المعلومات.

إذا كانت دالة Cloud تعرض استجابة 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>