- درخواست HTTP
- پارامترهای مسیر
- درخواست بدنه
- بدنه پاسخ
- دامنههای مجوز
- درخواست بهروزرسانی اعضا
- امتحانش کن!
اعضای یک فضا را در یک دسته بهروزرسانی میکند.
درخواست HTTP
POST https://meet.googleapis.com/v2/{parent=spaces/*}/members:batchUpdate
این URL از سینتکس Transcoding در gRPC استفاده میکند.
پارامترهای مسیر
| پارامترها | |
|---|---|
parent | الزامی. منبع والد که توسط همه اعضا به اشتراک گذاشته شده و بهروزرسانی میشود. قالب: space/{space} |
درخواست بدنه
بدنه درخواست شامل دادههایی با ساختار زیر است:
| نمایش JSON |
|---|
{
"requests": [
{
object ( |
| فیلدها | |
|---|---|
requests[] | الزامی. پیام درخواستی که منابع مورد نیاز برای بهروزرسانی را مشخص میکند. حداکثر ۵۰۰ عضو را میتوان به صورت دستهای تغییر داد. |
updateMask | اختیاری. ماسک فیلد سطح بالا برای مشخص کردن فیلدهایی که باید در عضو برای همه UpdateMemberRequests بهروزرسانی شوند، استفاده میشود. 4 سناریوی ممکن برای ماسک فیلد سطح بالا و فیلد فرزند وجود دارد: 1. ماسک فیلد سطح بالا و فیلد فرزند وجود ندارد: تمام فیلدهای ارائه شده در درخواستها بهروزرسانی میشوند، از جمله فیلدهایی که در درخواستها تنظیم نشدهاند. 2. ماسک فیلد سطح بالا وجود دارد اما ماسک فیلد فرزند وجود ندارد: فیلدهای مشخص شده در ماسک فیلد سطح بالا بهروزرسانی میشوند. 3. ماسک فیلد سطح بالا و فیلد فرزند وجود دارد: ماسک فیلد فرزند باید با ماسک فیلد سطح بالا یکسان باشد. 4. ماسک فیلد سطح بالا وجود ندارد اما ماسک فیلد فرزند وجود دارد: پشتیبانی نمیشود و خطا برمیگرداند. |
بدنه پاسخ
پاسخ اعضای بهروزرسانی دستهای.
در صورت موفقیت، بدنه پاسخ شامل دادههایی با ساختار زیر است:
| نمایش JSON |
|---|
{
"members": [
{
object ( |
| فیلدها | |
|---|---|
members[] | اعضا بهروزرسانی شدند. |
دامنههای مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/meetings.space.created
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.
درخواست بهروزرسانی اعضا
درخواست بهروزرسانی یک عضو.
| نمایش JSON |
|---|
{
"member": {
object ( |
| فیلدها | |
|---|---|
member | الزامی. عضوی که باید بهروزرسانی شود. قالب: space/{space}/members/{member} |
updateMask | اختیاری. ماسک فیلد برای مشخص کردن فیلدهایی که باید در عضو بهروزرسانی شوند، استفاده میشود. اگر updateMask ارائه نشده باشد (تنظیم نشده باشد، با مسیرهای خالی تنظیم شده باشد، یا فقط "" به عنوان مسیر داشته باشد)، به طور پیشفرض تمام فیلدهای ارائه شده با مقادیر در درخواست را بهروزرسانی میکند. استفاده از "*" به عنوان updateMask تمام فیلدها، از جمله فیلدهایی که در درخواست تنظیم نشدهاند را بهروزرسانی میکند. در مورد BatchUpdate، باید وجود نداشته باشد یا مانند updateMask در BatchUpdateMembersRequest باشد، زمانی که UpdateMemberRequest به عنوان یک درخواست فرزند از BatchUpdateMembersRequest ساخته میشود. |