إضافة Google Cloud Pub/Sub

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

الإصدار: 1.2.0

نشر الرسائل إلى موضوع في خدمة Google Cloud Pub/Sub

يوفّر هذا المحتوى مرجعًا لإعداد هذه الإضافة واستخدامها.

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

قبل استخدام هذه الإضافة من خادم وكيل لواجهة برمجة التطبيقات، عليك إجراء ما يلي:

1. أنشئ موضوعًا في Cloud Pub/Sub، كما هو موضّح في البدء السريع: استخدام وحدة التحكّم.

2. بعد الحصول على الموضوع، امنح الإذن بالنشر في موضوع Cloud Pub/Sub. على سبيل المثال، يمكنك استخدام دور roles/pubsub.publisher للنشر في المواضيع. لمزيد من المعلومات عن أدوار Cloud Pub/Sub، يُرجى الاطّلاع على التحكّم في الوصول.

3. استخدام "وحدة تحكّم Google Cloud Platform" لإنشاء مفتاح لحساب الخدمة

4. استخدِم محتوى ملف مفتاح JSON الناتج عند إضافة الإضافة وإعدادها باستخدام مرجع الإعداد.

لمحة عن Cloud Pub/Sub

توفّر خدمة Cloud Pub/Sub مراسلة غير متزامنة بين عدة مرسلين وعدة مستلمين، ما يؤدي إلى فصل المرسِلين عن المستلمين. توفّر خدمة Cloud Pub/Sub إمكانية تبادل الرسائل بشكل سريع وموثوق، ما يساعد المطوّرين على دمج الأنظمة المستضافة على Google Cloud Platform والأنظمة الخارجية بسرعة.

إذا كنت في مرحلة بدء استخدام Cloud Pub/Sub، يمكنك الاطّلاع على البدايات السريعة في مستندات Cloud Pub/Sub.

نماذج

توضّح الأمثلة التالية كيفية إعداد دعم إجراءات إضافة Cloud Pub/Sub باستخدام سياسة ExtensionCallout.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Publish-Message">
    <DisplayName>Publish Message</DisplayName>
    <Connector>cloud-pub-sub-extension-example</Connector>
    <Action>publish</Action>
    <Input><![CDATA[
      {
          "message" : "My test message."
      }
    ]]></Input>
    <Output>topic.message.id</Output>
</ConnectorCallout>

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

{"messageId":"165918654986954"}

الإجراءات

نشر

تنشر هذه الإضافة رسالة في الموضوع المحدّد في إعداداتها.

<Action>publish</Action>
<Input><![CDATA[{
  "message" : "message-to-publish"
}]]></Input>

<Action>publish</Action>
<Input><![CDATA[
  {
      "message" : "My test message."
  }
]]></Input>

مَعلمات الطلب

الردّ

ملف JSON يحتوي على معرّف الرسالة كما تم نشره في الموضوع. على سبيل المثال:

{"messageId":"165918654986954"}

مرجع الإعدادات

استخدِم ما يلي عند ضبط هذه الإضافة ونشرها لاستخدامها في خوادم API الوكيلة.

خصائص الإضافة الشائعة

السمات التالية متاحة لكل إضافة.

سمات حزمة الإضافة هذه