REST Resource: spaces

সম্পদ: মহাকাশ

গুগল চ্যাটে একটি স্পেস। স্পেস হল দুই বা ততোধিক ব্যবহারকারীর মধ্যে কথোপকথন বা ব্যবহারকারী এবং একটি চ্যাট অ্যাপের মধ্যে 1:1 বার্তা।

JSON প্রতিনিধিত্ব 
{
  "name": string,
  "type": enum (Type),
  "spaceType": enum (SpaceType),
  "singleUserBotDm": boolean,
  "threaded": boolean,
  "displayName": string,
  "externalUserAllowed": boolean,
  "spaceThreadingState": enum (SpaceThreadingState),
  "spaceDetails": {
    object (SpaceDetails)
  },
  "spaceHistoryState": enum (HistoryState),
  "importMode": boolean,
  "createTime": string,
  "lastActiveTime": string,
  "adminInstalled": boolean,
  "membershipCount": {
    object (MembershipCount)
  },
  "accessSettings": {
    object (AccessSettings)
  },
  "spaceUri": string,
  "customer": string,

  // Union field space_permission_settings can be only one of the following:
  "predefinedPermissionSettings": enum (PredefinedPermissionSettings),
  "permissionSettings": {
    object (PermissionSettings)
  }
  // End of list of possible types for union field space_permission_settings.
}
ক্ষেত্র
name

string

স্থানের সম্পদের নাম।

বিন্যাস: spaces/{space}

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

type
(deprecated)

enum ( Type )

শুধুমাত্র আউটপুট। বাতিল করা হয়েছে: পরিবর্তে spaceType ব্যবহার করুন। একটি স্থানের ধরন।

space Type

enum ( SpaceType )

স্থানের ধরন। একটি স্থান তৈরি করার সময় বা একটি স্থানের স্পেস প্রকার আপডেট করার সময় প্রয়োজন। শুধুমাত্র অন্যান্য ব্যবহারের জন্য আউটপুট।

single User Bot Dm

boolean

ঐচ্ছিক। স্পেসটি একটি চ্যাট অ্যাপ এবং একক মানুষের মধ্যে একটি ডিএম কিনা।

threaded
(deprecated)

boolean

শুধুমাত্র আউটপুট। বাতিল করা হয়েছে: পরিবর্তে spaceThreadingState ব্যবহার করুন। এই স্পেসে বার্তাগুলি থ্রেড করা হয়েছে কিনা।

display Name

string

স্থানটির প্রদর্শনের নাম। spaceType SPACE দিয়ে একটি স্পেস তৈরি করার সময় প্রয়োজন। আপনি যদি একটি স্পেস তৈরি করার সময় বা displayName আপডেট করার সময় ALREADY_EXISTS ত্রুটির বার্তা পান তবে একটি ভিন্ন displayName চেষ্টা করুন। Google Workspace সংস্থার মধ্যে আগে থেকেই এই ডিসপ্লে নাম ব্যবহার করা হতে পারে।

সরাসরি বার্তার জন্য, এই ক্ষেত্রটি খালি হতে পারে।

128টি অক্ষর পর্যন্ত সমর্থন করে।

external User Allowed

boolean

অপরিবর্তনীয়। এই স্থানটি কোনও Google চ্যাট ব্যবহারকারীকে সদস্য হিসাবে অনুমতি দেয় কিনা। Google Workspace সংস্থায় স্পেস তৈরি করার সময় ইনপুট করুন। নিম্নলিখিত শর্তে স্পেস তৈরি করার সময় এই ক্ষেত্রটি বাদ দিন:

  • প্রমাণীকৃত ব্যবহারকারী একটি ভোক্তা অ্যাকাউন্ট (অপরিচালিত ব্যবহারকারী অ্যাকাউন্ট) ব্যবহার করে। ডিফল্টরূপে, একটি ভোক্তা অ্যাকাউন্ট দ্বারা তৈরি একটি স্থান যেকোনো Google চ্যাট ব্যবহারকারীকে অনুমতি দেয়।

বিদ্যমান স্থানগুলির জন্য, এই ক্ষেত্রটি শুধুমাত্র আউটপুট।

space Threading State

enum ( SpaceThreadingState )

শুধুমাত্র আউটপুট। চ্যাট স্পেসে থ্রেডিং অবস্থা।

space Details

object ( SpaceDetails )

বর্ণনা এবং নিয়ম সহ স্থান সম্পর্কে বিশদ বিবরণ।

space History State

enum ( HistoryState )

এই স্থানের বার্তা এবং থ্রেডগুলির জন্য বার্তা ইতিহাসের অবস্থা।

import Mode

boolean

ঐচ্ছিক। Google Workspace-এ ডেটা মাইগ্রেশনের অংশ হিসেবে Import Mode এই স্পেস তৈরি করা হয়েছে কিনা। যখন স্পেস আমদানি করা হচ্ছে, আমদানি সম্পূর্ণ না হওয়া পর্যন্ত সেগুলি ব্যবহারকারীদের কাছে দৃশ্যমান নয়৷

Import Mode একটি স্থান তৈরি করার জন্য ব্যবহারকারীর প্রমাণীকরণ প্রয়োজন।

create Time

string ( Timestamp format)

ঐচ্ছিক। অপরিবর্তনীয়। চ্যাটে তৈরি স্পেসগুলির জন্য, স্পেস তৈরি করার সময়। এই ক্ষেত্রটি শুধুমাত্র আউটপুট, যখন আমদানি মোড স্পেসগুলিতে ব্যবহৃত হয়।

ইম্পোর্ট মোড স্পেসগুলির জন্য, এই ক্ষেত্রটিকে ঐতিহাসিক টাইমস্ট্যাম্পে সেট করুন যেখানে মূল সৃষ্টির সময় সংরক্ষণ করার জন্য উৎসে স্থানটি তৈরি করা হয়েছিল।

spaceType GROUP_CHAT বা SPACE হলে শুধুমাত্র আউটপুটে পপুলেট করা হয়।

last Active Time

string ( Timestamp format)

শুধুমাত্র আউটপুট। স্পেসে শেষ বার্তার টাইমস্ট্যাম্প।

admin Installed

boolean

শুধুমাত্র আউটপুট। Chat অ্যাপের মাধ্যমে সরাসরি মেসেজ (DM) স্পেসের জন্য, Google Workspace অ্যাডমিনিস্ট্রেটর স্পেস তৈরি করেছেন কিনা। অ্যাডমিনিস্ট্রেটররা তাদের প্রতিষ্ঠানের ব্যবহারকারীদের পক্ষে একটি চ্যাট অ্যাপের মাধ্যমে একটি সরাসরি বার্তা ইনস্টল এবং সেট-আপ করতে পারেন।

অ্যাডমিন ইনস্টল সমর্থন করতে, আপনার চ্যাট অ্যাপে অবশ্যই সরাসরি মেসেজিং বৈশিষ্ট্য থাকতে হবে।

membership Count

object ( MembershipCount )

শুধুমাত্র আউটপুট। সদস্যের ধরন অনুসারে গোষ্ঠীভুক্ত সদস্যপদে যোগদানের সংখ্যা। spaceType যখন SPACE , DIRECT_MESSAGE বা GROUP_CHAT হয় তখন পপুলেট হয়।

access Settings

object ( AccessSettings )

ঐচ্ছিক। স্থানের অ্যাক্সেস সেটিং নির্দিষ্ট করে। শুধুমাত্র spaceType SPACE হলেই পপুলেট হয়।

space Uri

string

শুধুমাত্র আউটপুট। স্পেস অ্যাক্সেস করার জন্য ব্যবহারকারীর জন্য URI।

customer

string

ঐচ্ছিক। অপরিবর্তনীয়। স্পেসের ডোমেনের গ্রাহক আইডি। শুধুমাত্র অ্যাপ প্রমাণীকরণের সাথে একটি স্পেস তৈরি করার সময় প্রয়োজন এবং SpaceType হল SPACE , অন্যথায় সেট করা উচিত নয়।

customers/{customer} ফর্ম্যাটে, যেখানে customer হল [অ্যাডমিন SDK গ্রাহক সম্পদ]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers) থেকে id । ব্যক্তিগত অ্যাপগুলিও customers/my_customer alias ব্যবহার করে অ্যাপের মতো Google Workspace সংস্থায় জায়গা তৈরি করতে পারে।

DM-এর জন্য, এই ক্ষেত্রটি জনবহুল নয়।

ইউনিয়ন ক্ষেত্র space_permission_settings । একটি স্থানের অনুমতি সেটিংস প্রতিনিধিত্ব করে। শুধুমাত্র space_type SPACE হলেই পপুলেট হয়।

ব্যবহারকারীর প্রমাণীকরণ প্রয়োজন। space_permission_settings নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:

predefined Permission Settings

enum ( PredefinedPermissionSettings )

ঐচ্ছিক। শুধুমাত্র ইনপুট। পূর্বনির্ধারিত স্থান অনুমতি সেটিংস, শুধুমাত্র একটি স্থান তৈরি করার সময় ইনপুট। ক্ষেত্র সেট না থাকলে, একটি সহযোগিতা স্থান তৈরি করা হয়। আপনি স্থান তৈরি করার পরে, PermissionSettings ক্ষেত্রে সেটিংস পপুলেট করা হয়।

permission Settings

object ( PermissionSettings )

ঐচ্ছিক। বিদ্যমান স্থানগুলির জন্য স্থান অনুমতি সেটিংস। সঠিক স্থান অনুমতি সেটিংস আপডেট করার জন্য ইনপুট, যেখানে বিদ্যমান অনুমতি সেটিংস প্রতিস্থাপিত হয়। আউটপুট বর্তমান অনুমতি সেটিংস তালিকা.

টাইপ

বাতিল করা হয়েছে: পরিবর্তে SpaceType ব্যবহার করুন।

Enums
TYPE_UNSPECIFIED সংরক্ষিত
ROOM দুই বা ততোধিক মানুষের মধ্যে কথোপকথন।
DM 1:1 একটি মানুষ এবং একটি চ্যাট অ্যাপের মধ্যে সরাসরি বার্তা, যেখানে সমস্ত বার্তা সমতল। মনে রাখবেন যে এটি দুটি মানুষের মধ্যে সরাসরি বার্তা অন্তর্ভুক্ত করে না।

স্পেস টাইপ

স্থানের ধরন। একটি স্থান তৈরি বা আপডেট করার সময় প্রয়োজন। শুধুমাত্র অন্যান্য ব্যবহারের জন্য আউটপুট।

Enums
SPACE_TYPE_UNSPECIFIED সংরক্ষিত
SPACE এমন একটি জায়গা যেখানে লোকেরা বার্তা পাঠায়, ফাইল শেয়ার করে এবং সহযোগিতা করে। একটি SPACE চ্যাট অ্যাপসকে অন্তর্ভুক্ত করতে পারে।
GROUP_CHAT 3 বা তার বেশি লোকের মধ্যে গ্রুপ কথোপকথন। একটি GROUP_CHAT চ্যাট অ্যাপ অন্তর্ভুক্ত করতে পারে।
DIRECT_MESSAGE 1:1 দুই মানুষ বা একজন মানুষ এবং একটি চ্যাট অ্যাপের মধ্যে বার্তা।

স্পেস থ্রেডিং স্টেট

চ্যাট স্পেসে থ্রেডিং অবস্থার ধরন নির্দিষ্ট করে।

Enums
SPACE_THREADING_STATE_UNSPECIFIED সংরক্ষিত
THREADED_MESSAGES নামযুক্ত স্থান যা বার্তা থ্রেড সমর্থন করে। যখন ব্যবহারকারীরা একটি বার্তার প্রতিক্রিয়া জানায়, তখন তারা থ্রেডের মধ্যে উত্তর দিতে পারে, যা তাদের প্রতিক্রিয়া মূল বার্তার প্রসঙ্গে রাখে।
GROUPED_MESSAGES কথোপকথন বিষয় অনুযায়ী সংগঠিত হয় যেখানে নাম দেওয়া স্থান. বিষয় এবং তাদের উত্তর একসাথে গ্রুপ করা হয়.
UNTHREADED_MESSAGES দুই ব্যক্তির মধ্যে সরাসরি বার্তা (DMs) এবং 3 বা তার বেশি লোকের মধ্যে গোষ্ঠী কথোপকথন।

মহাকাশের বিবরণ

বর্ণনা এবং নিয়ম সহ স্থান সম্পর্কে বিশদ বিবরণ।

JSON প্রতিনিধিত্ব 
{
  "description": string,
  "guidelines": string
}
ক্ষেত্র
description

string

ঐচ্ছিক। স্থানের বর্ণনা। উদাহরণস্বরূপ, স্থানের আলোচনার বিষয়, কার্যকরী উদ্দেশ্য বা অংশগ্রহণকারীদের বর্ণনা করুন।

150টি অক্ষর পর্যন্ত সমর্থন করে।

guidelines

string

ঐচ্ছিক। স্থানের নিয়ম, প্রত্যাশা এবং শিষ্টাচার।

5,000 অক্ষর পর্যন্ত সমর্থন করে।

ইতিহাস রাজ্য

বার্তা এবং স্থানগুলির জন্য ইতিহাসের অবস্থা৷ বার্তা এবং কথোপকথন থ্রেড তৈরি করার পরে কতক্ষণ রাখা হয় তা নির্দিষ্ট করে।

Enums
HISTORY_STATE_UNSPECIFIED ডিফল্ট মান। ব্যবহার করবেন না।
HISTORY_OFF ইতিহাস বন্ধ. বার্তা এবং থ্রেড 24 ঘন্টা রাখা হয় .
HISTORY_ON ইতিহাস চালু সংস্থার ভল্ট ধরে রাখার নিয়মগুলি কতক্ষণ বার্তা এবং থ্রেড রাখা হবে তা নির্দিষ্ট করে৷

সদস্য সংখ্যা

বিভাগগুলিতে গোষ্ঠীবদ্ধ একটি স্থানের সদস্যতার গণনাকে প্রতিনিধিত্ব করে।

JSON প্রতিনিধিত্ব 
{
  "joinedDirectHumanUserCount": integer,
  "joinedGroupCount": integer
}
ক্ষেত্র
joined Direct Human User Count

integer

স্পেসটিতে সরাসরি যোগদানকারী মানব ব্যবহারকারীর সংখ্যা, যোগদান করা গোষ্ঠীতে সদস্যপদ নিয়ে যোগদানকারী ব্যবহারকারীদের গণনা নয়।

joined Group Count

integer

স্থানটিতে সরাসরি যোগদানকারী সমস্ত গোষ্ঠীর সংখ্যা।

অ্যাক্সেস সেটিংস

স্থানের অ্যাক্সেস সেটিং প্রতিনিধিত্ব করে।

JSON প্রতিনিধিত্ব 
{
  "accessState": enum (AccessState),
  "audience": string
}
ক্ষেত্র
access State

enum ( AccessState )

শুধুমাত্র আউটপুট। স্থানের অ্যাক্সেসের অবস্থা নির্দেশ করে।

audience

string

ঐচ্ছিক। টার্গেট অডিয়েন্সের রিসোর্স নাম যারা স্পেস আবিষ্কার করতে পারে, স্পেসে যোগ দিতে পারে এবং স্পেসে বার্তাগুলির পূর্বরূপ দেখতে পারে। যদি সেট করা না থাকে, শুধুমাত্র ব্যবহারকারী বা Google গ্রুপ যারা স্বতন্ত্রভাবে আমন্ত্রিত বা স্পেসে যোগ করা হয়েছে তারা এটি অ্যাক্সেস করতে পারবেন। বিশদ বিবরণের জন্য, লক্ষ্য দর্শকদের জন্য একটি স্থান আবিষ্কারযোগ্য করুন দেখুন।

বিন্যাস: audiences/{audience}

Google Workspace সংস্থার জন্য ডিফল্ট টার্গেট অডিয়েন্স ব্যবহার করতে, audiences/default সেট করুন।

লক্ষ্য দর্শকদের পড়া সমর্থন করে:

অ্যাপ প্রমাণীকরণের সাথে chat.bot স্কোপ ব্যবহার করার সময় এই ক্ষেত্রটি জনবহুল হয় না।

লক্ষ্য শ্রোতা সেট করার জন্য ব্যবহারকারীর প্রমাণীকরণ প্রয়োজন।

অ্যাক্সেস স্টেট

স্থানের অ্যাক্সেসের অবস্থার প্রতিনিধিত্ব করে।

Enums
ACCESS_STATE_UNSPECIFIED অ্যাক্সেস স্থিতি অজানা বা এই API তে সমর্থিত নয়৷
PRIVATE অন্য ব্যবহারকারী বা Google Workspace অ্যাডমিনিস্ট্রেটরদের দ্বারা পৃথকভাবে যোগ করা বা আমন্ত্রণ করা ব্যবহারকারী বা Google Groups শুধুমাত্র স্পেসটি আবিষ্কার করতে এবং অ্যাক্সেস করতে পারবে।
DISCOVERABLE

একজন স্পেস ম্যানেজার একটি টার্গেট শ্রোতাকে স্থানটিতে অ্যাক্সেসের অনুমতি দিয়েছেন। যে ব্যবহারকারী বা Google গ্রুপগুলিকে পৃথকভাবে যোগ করা হয়েছে বা স্পেসে আমন্ত্রণ জানানো হয়েছে তারাও স্থানটি আবিষ্কার করতে এবং অ্যাক্সেস করতে পারে৷ আরও জানতে, নির্দিষ্ট ব্যবহারকারীদের জন্য একটি স্থান আবিষ্কারযোগ্য করুন দেখুন।

আবিষ্কারযোগ্য স্থান তৈরি করার জন্য ব্যবহারকারীর প্রমাণীকরণ প্রয়োজন।

পূর্বনির্ধারিত পারমিশন সেটিংস

পূর্বনির্ধারিত অনুমতি সেটিংস যা আপনি শুধুমাত্র একটি নামযুক্ত স্থান তৈরি করার সময় নির্দিষ্ট করতে পারেন। ভবিষ্যতে আরো সেটিংস যোগ করা হতে পারে. নামযুক্ত স্থানগুলির জন্য অনুমতি সেটিংস সম্পর্কে বিশদ বিবরণের জন্য, স্পেস সম্পর্কে জানুন দেখুন।

Enums
PREDEFINED_PERMISSION_SETTINGS_UNSPECIFIED অনির্দিষ্ট। ব্যবহার করবেন না।
COLLABORATION_SPACE স্পেসটিকে একটি সহযোগিতার স্থান হিসাবে সেট করা হচ্ছে যেখানে সমস্ত সদস্য বার্তা পোস্ট করতে পারে৷
ANNOUNCEMENT_SPACE স্থানটিকে একটি ঘোষণার স্থান হিসাবে সেট করা হচ্ছে যেখানে শুধুমাত্র স্পেস ম্যানেজাররা বার্তা পোস্ট করতে পারে।

অনুমতি সেটিংস

অনুমতি সেটিংস যা আপনি একটি বিদ্যমান নামযুক্ত স্থান আপডেট করার সময় নির্দিষ্ট করতে পারেন৷

একটি স্থান তৈরি করার সময় অনুমতি সেটিংস সেট করতে, আপনার অনুরোধে PredefinedPermissionSettings ক্ষেত্রটি নির্দিষ্ট করুন।

JSON প্রতিনিধিত্ব 
{
  "manageMembersAndGroups": {
    object (PermissionSetting)
  },
  "modifySpaceDetails": {
    object (PermissionSetting)
  },
  "toggleHistory": {
    object (PermissionSetting)
  },
  "useAtMentionAll": {
    object (PermissionSetting)
  },
  "manageApps": {
    object (PermissionSetting)
  },
  "manageWebhooks": {
    object (PermissionSetting)
  },
  "postMessages": {
    object (PermissionSetting)
  },
  "replyMessages": {
    object (PermissionSetting)
  }
}
ক্ষেত্র
manage Members And Groups

object ( PermissionSetting )

একটি স্পেসে সদস্য এবং গোষ্ঠী পরিচালনার জন্য সেটিং।

modify Space Details

object ( PermissionSetting )

স্থানের নাম, অবতার, বিবরণ এবং নির্দেশিকা আপডেট করার জন্য সেটিং।

toggle History

object ( PermissionSetting )

স্থান ইতিহাস চালু এবং বন্ধ টগল করার জন্য সেটিং।

use At Mention All

object ( PermissionSetting )

একটি স্পেসে @all ব্যবহার করার জন্য সেট করা হচ্ছে।

manage Apps

object ( PermissionSetting )

একটি স্পেসে অ্যাপ পরিচালনার জন্য সেটিং।

manage Webhooks

object ( PermissionSetting )

একটি স্পেসে ওয়েবহুক পরিচালনার জন্য সেটিং।

post Messages

object ( PermissionSetting )

শুধুমাত্র আউটপুট। একটি স্পেসে বার্তা পোস্ট করার জন্য সেটিং।

reply Messages

object ( PermissionSetting )

একটি স্পেসে বার্তার উত্তর দেওয়ার জন্য সেটিং।

অনুমতি সেটিং

একটি স্থান অনুমতি সেটিং প্রতিনিধিত্ব করে।

JSON প্রতিনিধিত্ব 
{
  "managersAllowed": boolean,
  "membersAllowed": boolean
}
ক্ষেত্র
managers Allowed

boolean

স্পেস পরিচালকদের এই অনুমতি আছে কিনা।

members Allowed

boolean

নন-ম্যানেজার সদস্যদের এই অনুমতি আছে কিনা।

পদ্ধতি

complete Import

 নির্দিষ্ট স্থানের জন্য আমদানি প্রক্রিয়া সম্পূর্ণ করে এবং এটি ব্যবহারকারীদের কাছে দৃশ্যমান করে তোলে।

create

 কোনো সদস্য ছাড়া একটি স্থান তৈরি করে।

delete

 একটি নামযুক্ত স্থান মুছে দেয়।

find Direct Message

 নির্দিষ্ট ব্যবহারকারীর সাথে বিদ্যমান সরাসরি বার্তা ফেরত দেয়।

get

 একটি স্থান সম্পর্কে বিশদ বিবরণ প্রদান করে।

list

 কলার যে স্থানের সদস্য তা তালিকাভুক্ত করে।

patch

 একটি স্থান আপডেট করে।
অ্যাডমিনিস্ট্রেটরের সার্চের উপর ভিত্তি করে Google Workspace সংস্থার স্পেসগুলির একটি তালিকা দেখায়।

setup

 একটি স্থান তৈরি করে এবং এতে নির্দিষ্ট ব্যবহারকারী যোগ করে।