Method: subscriptions.list

يسرد اشتراكات Google Workspace. للتعرّف على كيفية استخدام هذه الطريقة، يُرجى الاطّلاع على إدراج اشتراكات Google Workspace.

طلب HTTP

GET https://workspaceevents.googleapis.com/v1beta/subscriptions

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

معامِلات طلب البحث

المعلمات
pageSize

integer

اختياريّ. الحد الأقصى لعدد الاشتراكات المطلوب عرضها قد تعرض الخدمة أقل من هذه القيمة.

إذا لم يتم تحديد قيمة أو تم ضبط السياسة على 0، سيتم عرض ما يصل إلى 50 اشتراكًا.

الحد الأقصى للقيمة هو 100. إذا حدّدت قيمة أكثر من 100، سيعرض النظام 100 اشتراك فقط.

pageToken

string

اختياريّ. رمز مميّز للصفحة، تم تلقّيه من مكالمة سابقة للاشتراكات في قائمة قدِّم هذه المَعلمة لاسترداد الصفحة التالية.

عند التقسيم على صفحات، يجب أن تتطابق قيمة الفلتر مع الاستدعاء الذي قدّم الرمز المميز للصفحة. وقد يؤدي تمرير قيمة مختلفة إلى نتائج غير متوقّعة.

filter

string

مطلوب. فلتر طلب بحث

يمكنك فلترة الاشتراكات حسب نوع الحدث (event_types) والمورد المستهدف (target_resource).

عليك تحديد نوع حدث واحد على الأقل في طلب البحث. لفلترة أنواع الأحداث المتعدّدة، استخدِم عامل التشغيل OR.

للفلترة حسب نوع الحدث والمورد المستهدف، استخدِم عامل التشغيل AND وحدِّد اسم المورد الكامل، مثل //chat.googleapis.com/spaces/{space}.

على سبيل المثال، طلبات البحث التالية صالحة:

event_types:"google.workspace.chat.membership.v1.updated" OR
  event_types:"google.workspace.chat.message.v1.created"

event_types:"google.workspace.chat.message.v1.created" AND
  target_resource="//chat.googleapis.com/spaces/{space}"

( event_types:"google.workspace.chat.membership.v1.updated" OR
  event_types:"google.workspace.chat.message.v1.created" ) AND
  target_resource="//chat.googleapis.com/spaces/{space}"

يرفض الخادم طلبات البحث غير الصالحة التي تعرض خطأ INVALID_ARGUMENT.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

رسالة الردّ على SubscriptionsService.ListSubscriptions.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON
{
  "subscriptions": [
    {
      object (Subscription)
    }
  ],
  "nextPageToken": string
}
الحقول
subscriptions[]

object (Subscription)

قائمة الاشتراكات

nextPageToken

string

رمز مميز يمكن إرساله على شكل pageToken لاسترداد الصفحة التالية. في حال إسقاط هذا الحقل، لن تظهر أي صفحات لاحقة.

نطاقات الأذونات

يتطلب هذا الإعداد أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.reactions.readonly
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly
  • https://www.googleapis.com/auth/meetings.space.created
  • https://www.googleapis.com/auth/meetings.space.readonly

لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.