Method: spaces.patch

• HTTP অনুরোধ
• পথের পরামিতি
• কোয়েরি প্যারামিটার
• অনুরোধকারী শরীর
• প্রতিক্রিয়া সংস্থা
• অনুমোদনের পরিধি
• চেষ্টা করে দেখুন!

একটি স্পেস আপডেট করে। উদাহরণের জন্য, ‘একটি স্পেস আপডেট করুন’ দেখুন।

আপনি যদি displayName ফিল্ডটি আপডেট করার সময় ALREADY_EXISTS ত্রুটি বার্তাটি পান, তাহলে একটি ভিন্ন ডিসপ্লে নেম ব্যবহার করে দেখুন। Google Workspace অর্গানাইজেশনের মধ্যে থাকা কোনো বিদ্যমান স্পেস হয়তো ইতিমধ্যেই এই ডিসপ্লে নেমটি ব্যবহার করছে।

নিম্নলিখিত ধরণের প্রমাণীকরণ সমর্থন করে:

• প্রশাসকের অনুমোদন এবং নিম্নলিখিত অনুমোদন পরিধিগুলির মধ্যে একটির মাধ্যমে অ্যাপের প্রমাণীকরণ :

  • https://www.googleapis.com/auth/chat.app.spaces

• নিম্নলিখিত অনুমোদন পরিধিগুলির মধ্যে একটি ব্যবহার করে ব্যবহারকারীর প্রমাণীকরণ :

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.import (ইম্পোর্ট মোডে শুধুমাত্র স্পেস)
  • ব্যবহারকারী প্রমাণীকরণ অ্যাডমিনিস্ট্রেটর বিশেষাধিকার প্রদান করে যখন একটি অ্যাডমিনিস্ট্রেটর অ্যাকাউন্ট প্রমাণীকরণ করে, useAdminAccess true হয়, এবং নিম্নলিখিত অনুমোদন স্কোপগুলি ব্যবহৃত হয়:
    • https://www.googleapis.com/auth/chat.admin.spaces

অ্যাপ প্রমাণীকরণের নিম্নলিখিত সীমাবদ্ধতাগুলো রয়েছে:

• space.predefined_permission_settings অথবা space.permission_settings আপডেট করতে হলে, অ্যাপটিকে অবশ্যই স্পেসটির নির্মাতা হতে হবে।
• অ্যাপ প্রমাণীকরণের জন্য space.access_settings.audience আপডেট করা সমর্থিত নয়।

HTTP অনুরোধ

PATCH https://chat.googleapis.com/v1/{space.name=spaces/*}

URL-টিতে gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়েছে।

পথের পরামিতি

প্যারামিটার
space.name	string শনাক্তকারী। স্থানটির রিসোর্স নাম। ফর্ম্যাট: spaces/{space} এখানে {space} হলো স্পেসটির জন্য সিস্টেম-নির্ধারিত আইডি। আপনি spaces.list() মেথডটি কল করে অথবা স্পেস ইউআরএল থেকে স্পেস আইডিটি পেতে পারেন। উদাহরণস্বরূপ, যদি স্পেস ইউআরএলটি হয় https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA , তাহলে স্পেস আইডিটি হবে AAAAAAAAA ।

কোয়েরি প্যারামিটার

প্যারামিটার
updateMask	string ( FieldMask format) আবশ্যক। হালনাগাদ করা ফিল্ড পাথগুলো, একাধিক থাকলে কমা দিয়ে আলাদা করুন। একটি স্পেসের জন্য আপনি নিম্নলিখিত ফিল্ডগুলি আপডেট করতে পারেন: spaceDetails : স্পেসের বিবরণ এবং নির্দেশিকা আপডেট করে। আপডেট অনুরোধে আপনাকে অবশ্যই বিবরণ এবং নির্দেশিকা উভয়ই SpaceDetails হিসেবে পাস করতে হবে। আপনি যদি শুধুমাত্র একটি ফিল্ড আপডেট করতে চান, তাহলে অন্য ফিল্ডটির বিদ্যমান মান পাস করুন। displayName : শুধুমাত্র সেইসব স্পেসের ডিসপ্লে নেম আপডেট করা সমর্থন করে, যেখানে spaceType ফিল্ডের মান SPACE । যদি আপনি ALREADY_EXISTS এরর মেসেজটি পান, তাহলে অন্য একটি মান ব্যবহার করে দেখুন। Google Workspace অর্গানাইজেশনের মধ্যে থাকা কোনো বিদ্যমান স্পেস হয়তো ইতিমধ্যেই এই ডিসপ্লে নেমটি ব্যবহার করছে। spaceType : শুধুমাত্র একটি GROUP_CHAT স্পেস টাইপকে SPACE এ পরিবর্তন করা সমর্থন করে। আপডেট মাস্কে spaceType সাথে displayName অন্তর্ভুক্ত করুন এবং নিশ্চিত করুন যে নির্দিষ্ট স্পেসটির একটি খালি নয় এমন ডিসপ্লে নেম এবং SPACE স্পেস টাইপ রয়েছে। যদি বিদ্যমান স্পেসটিতে ইতিমধ্যেই SPACE টাইপ থাকে, তাহলে ডিসপ্লে নেম আপডেট করার সময় নির্দিষ্ট স্পেসে spaceType মাস্ক এবং SPACE টাইপ অন্তর্ভুক্ত করা ঐচ্ছিক। অন্য কোনো উপায়ে স্পেস টাইপ আপডেট করার চেষ্টা করলে একটি অবৈধ আর্গুমেন্ট ত্রুটি দেখা দেয়। useAdminAccess এর সাথে spaceType সমর্থিত নয়। spaceHistoryState : স্পেসের জন্য হিস্ট্রি চালু বা বন্ধ করে স্পেস হিস্ট্রি সেটিংস আপডেট করে। এটি শুধুমাত্র তখনই সমর্থিত হয়, যদি Google Workspace অর্গানাইজেশনের জন্য হিস্ট্রি সেটিংস সক্রিয় করা থাকে। স্পেস হিস্ট্রি স্টেট আপডেট করতে, আপনাকে আপনার অনুরোধে অন্য সব ফিল্ড মাস্ক বাদ দিতে হবে। useAdminAccess এর সাথে spaceHistoryState সমর্থিত নয়। accessSettings.audience : যে স্পেসের spaceType ফিল্ডটি SPACE , সেই স্পেসে কারা স্পেসটি খুঁজে পাবে, স্পেসে যোগ দেবে এবং মেসেজ প্রিভিউ করতে পারবে, তার অ্যাক্সেস সেটিং আপডেট করে। যদি বিদ্যমান স্পেসটির কোনো টার্গেট অডিয়েন্স থাকে, তবে আপনি এই ফিল্ড মাস্কের ভ্যালুটি বাদ দিয়ে অডিয়েন্সটি সরিয়ে ফেলতে এবং স্পেসের অ্যাক্সেস সীমাবদ্ধ করতে পারেন। কোনো স্পেসের অ্যাক্সেস সেটিং আপডেট করার জন্য, প্রমাণীকরণকারী ব্যবহারকারীকে অবশ্যই একজন স্পেস ম্যানেজার হতে হবে এবং আপনার অনুরোধে অন্য সব ফিল্ড মাস্ক বাদ দিতে হবে। স্পেসটি যদি ইম্পোর্ট মোডে থাকে, তবে আপনি এই ফিল্ডটি আপডেট করতে পারবেন না। আরও জানতে, “নির্দিষ্ট ব্যবহারকারীদের জন্য একটি স্পেসকে আবিষ্কারযোগ্য করে তোলা ” দেখুন। useAdminAccess এর সাথে ` accessSettings.audience সমর্থিত নয়। accessSettings.access_permission_settings : যে স্পেসের spaceType ফিল্ডটি ` SPACE , সেই স্পেসটি কারা ডিসকভার এবং জয়েন করতে পারবে, তার অ্যাক্সেস পারমিশন সেটিংস আপডেট করে। যে প্রিন্সিপালদের স্পেসে জয়েন করার অনুমতি আছে, তাদের অবশ্যই এটি ডিসকভার করারও অনুমতি থাকতে হবে। একটি স্পেসের অ্যাক্সেস পারমিশন সেটিংস আপডেট করতে, অথেন্টিকেটকারী ব্যবহারকারীকে অবশ্যই একজন স্পেস ম্যানেজার বা অ্যাসিস্ট্যান্ট ম্যানেজার হতে হবে এবং অনুরোধে অন্য সব ফিল্ড মাস্ক বাদ দিতে হবে। স্পেসটি যদি ইম্পোর্ট মোডে থাকে, তবে আপনি এই ফিল্ডটি আপডেট করতে পারবেন না। আরও জানতে, “Make a space discoverable to specific users” দেখুন। useAdminAccess এর সাথে accessSettings.access_permission_settings সমর্থিত নয়। সমর্থিত ফিল্ড মাস্কগুলো হলো: accessSettings.access_permission_settings.discoverSpaceSetting accessSettings.access_permission_settings.joinSpaceSetting permissionSettings : একটি স্পেসের অনুমতি সেটিংস পরিবর্তন করা সমর্থন করে। অনুমতি সেটিংস আপডেট করার সময়, আপনি শুধুমাত্র permissionSettings ফিল্ড মাস্ক নির্দিষ্ট করতে পারবেন; একই সময়ে অন্য ফিল্ড মাস্ক আপডেট করা যাবে না। সমর্থিত ফিল্ড মাস্কগুলো হলো: permissionSettings.manageMembersAndGroups permissionSettings.modifySpaceDetails permissionSettings.toggleHistory permissionSettings.useAtMentionAll permissionSettings.manageApps permissionSettings.manageWebhooks permissionSettings.replyMessages
useAdminAccess	boolean ঐচ্ছিক। ' true হলে, মেথডটি ব্যবহারকারীর গুগল ওয়ার্কস্পেস অ্যাডমিনিস্ট্রেটর প্রিভিলেজ ব্যবহার করে রান করে। কলকারী ব্যবহারকারীকে অবশ্যই একজন গুগল ওয়ার্কস্পেস অ্যাডমিনিস্ট্রেটর হতে হবে, যার চ্যাট এবং স্পেস কথোপকথন পরিচালনা করার বিশেষাধিকার রয়েছে । এর জন্য chat.admin.spaces OAuth 2.0 স্কোপটি প্রয়োজন। অ্যাডমিন অ্যাক্সেস ব্যবহার করে কিছু FieldMask ভ্যালু সমর্থিত নয়। বিস্তারিত জানতে, updateMask এর বিবরণ দেখুন।

অনুরোধকারী শরীর

অনুরোধের বডিতে Space এর একটি ইনস্ট্যান্স রয়েছে।

প্রতিক্রিয়া সংস্থা

সফল হলে, রেসপন্স বডিতে Space এর একটি ইনস্ট্যান্স থাকে।

অনুমোদনের পরিধি

নিম্নলিখিত OAuth স্কোপগুলির মধ্যে একটি প্রয়োজন:

• https://www.googleapis.com/auth/chat.app.spaces
• https://www.googleapis.com/auth/chat.admin.spaces
• https://www.googleapis.com/auth/chat.import
• https://www.googleapis.com/auth/chat.spaces

আরও তথ্যের জন্য, অনুমোদন নির্দেশিকা দেখুন।