اختیاری. حداکثر تعداد اشتراک برای بازگشت. ممکن است این سرویس کمتر از این مقدار را برگرداند.
اگر مشخص نشده باشد یا روی 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 رد می کند.