গ্রুপ পরিচালনা করুন

এই পৃষ্ঠাটি ডাইরেক্টরি API-এর সাহায্যে Google গোষ্ঠীগুলিকে কীভাবে পরিচালনা করবেন সে সম্পর্কে:

  • একটি গ্রুপ তৈরি করুন
  • একটি গ্রুপ আপডেট করুন
  • একটি গ্রুপ উপনাম যোগ করুন
  • একটি গ্রুপ পুনরুদ্ধার করুন
  • একটি ডোমেন বা অ্যাকাউন্টের জন্য সমস্ত গ্রুপ পুনরুদ্ধার করুন
  • একটি সদস্যের জন্য সমস্ত গ্রুপ পুনরুদ্ধার করুন
  • সমস্ত গ্রুপ উপনাম পুনরুদ্ধার করুন
  • একটি গ্রুপ উপনাম মুছুন
  • একটি গ্রুপ মুছুন

একটি গ্রুপ তৈরি করুন

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

POST https://admin.googleapis.com/admin/directory/v1/groups

নিম্নলিখিত JSON অনুরোধটি একটি নমুনা অনুরোধের বডি দেখায় যা একটি গ্রুপ তৈরি করে। গ্রুপের ইমেল ঠিকানা হল [email protected]:

{
   "email": "[email protected]",
   "name": "Sales Group",
   "description": "This is the Sales group."
}

একটি সফল প্রতিক্রিয়া একটি HTTP 201 স্ট্যাটাস কোড এবং নতুন গ্রুপের বৈশিষ্ট্য প্রদান করে।

একটি গ্রুপ আপডেট করুন

একটি গোষ্ঠীর সেটিংস আপডেট করতে, নিম্নলিখিত PUT অনুরোধটি ব্যবহার করুন এবং অনুমোদনের অনুরোধে বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন। groupKey হল গোষ্ঠীর ইমেল ঠিকানা, গ্রুপের যে কোনো উপনামের ইমেল ঠিকানা বা গ্রুপের অনন্য id । ক্যোয়ারী স্ট্রিং, অনুরোধ এবং প্রতিক্রিয়া বৈশিষ্ট্যের জন্য, groups.update পদ্ধতি দেখুন।

PUT https://admin.googleapis.com/admin/directory/v1/groups/groupKey

সাধারণভাবে, গুগল সুপারিশ করে যে গ্রুপের ইমেল ঠিকানাটিকে স্থায়ী ডেটার জন্য একটি কী হিসাবে ব্যবহার না করার কারণ ইমেল ঠিকানা পরিবর্তন সাপেক্ষে।

নিম্নলিখিত উদাহরণে, অনন্য groupKey হল nnn এবং গ্রুপের নাম হল APAC বিক্রয় গ্রুপ: 

PUT https://admin.googleapis.com/admin/directory/v1/groups/nnn

{
    "email": "[email protected]",
    "name": "APAC Sales Group"
}

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

একটি সফল প্রতিক্রিয়া একটি HTTP 201 স্ট্যাটাস কোড এবং নতুন গোষ্ঠীর বৈশিষ্ট্য প্রদান করে: 

{
    "kind": "directory#groups",
    "id": "group's unique ID",
    "etag": "group's unique ETag",
    "email": "[email protected]",
    "name": "APAC Sales Group",
    "directMembersCount": "5",
    "description": "This is the APAC sales group.",
    "adminCreated": true,
    "aliases": [
     {
        "alias": "[email protected]"
     }
    ],
    "nonEditableAliases: [
     {
        "alias": "[email protected]"
     }
    ]
}

একটি গ্রুপ উপনাম যোগ করুন

একটি গ্রুপ উপনাম যোগ করতে, নিম্নলিখিত POST অনুরোধটি ব্যবহার করুন এবং অনুমোদনের অনুরোধে বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন। groupKey হল গোষ্ঠীর ইমেল ঠিকানা, গ্রুপের যে কোনো উপনামের ইমেল ঠিকানা, বা গ্রুপের অনন্য id । ক্যোয়ারী স্ট্রিং, অনুরোধ এবং প্রতিক্রিয়া বৈশিষ্ট্যের জন্য, groups রিসোর্স দেখুন।

POST https://admin.googleapis.com/admin/directory/v1/groups/groupKey/aliases

সাধারণভাবে, গুগল সুপারিশ করে যে গ্রুপের ইমেল ঠিকানাটিকে স্থায়ী ডেটার জন্য একটি কী হিসাবে ব্যবহার না করার কারণ ইমেল ঠিকানা পরিবর্তন সাপেক্ষে।

নিম্নলিখিত JSON অনুরোধটি একটি গ্রুপের উপনাম তৈরি করার জন্য একটি নমুনা অনুরোধ দেখায়। groupKey হল গ্রুপের অনন্য id যা NNNN দ্বারা উপস্থাপিত হয় 

POST https://admin.googleapis.com/admin/directory/v1/groups/NNNN/aliases

{
    "alias": "[email protected]"
}

একটি সফল প্রতিক্রিয়া একটি HTTP 201 স্ট্যাটাস কোড এবং নতুন গ্রুপ উপনামের বৈশিষ্ট্য প্রদান করে।

একটি গ্রুপ পুনরুদ্ধার করুন

একটি গোষ্ঠী পুনরুদ্ধার করতে, নিম্নলিখিত GET অনুরোধটি ব্যবহার করুন এবং অনুমোদনের অনুরোধে বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন। groupKey হল গোষ্ঠীর ইমেল ঠিকানা, গ্রুপের যে কোনো উপনামের ইমেল ঠিকানা, বা গ্রুপের অনন্য id । ক্যোয়ারী স্ট্রিং, অনুরোধ এবং প্রতিক্রিয়া বৈশিষ্ট্যের জন্য, groups.get পদ্ধতি দেখুন।
GET https://admin.googleapis.com/admin/directory/v1/groups/groupKey

সাধারণভাবে, গুগল সুপারিশ করে যে গ্রুপের ইমেল ঠিকানাটিকে স্থায়ী ডেটার জন্য একটি কী হিসাবে ব্যবহার না করার কারণ ইমেল ঠিকানা পরিবর্তন সাপেক্ষে।

নিম্নলিখিত উদাহরণে, অনন্য groupKey আইডি হল nnnn :

GET https://admin.googleapis.com/admin/directory/v1/groups/nnnn

একটি সফল প্রতিক্রিয়া একটি HTTP 200 স্ট্যাটাস কোড এবং গ্রুপের সেটিংস প্রদান করে:

{
    "kind": "directory#groups",
    "id": "group's unique ID",
    "etag": "group's unique ETag",
    "email": "[email protected]",
    "name": "APAC Sales Group",
    "directMembersCount": "5",
    "description": "This is the APAC sales group.",
    "adminCreated": true,
    "aliases": [
     {
        "alias": "[email protected]"
     }
    ],
    "nonEditableAliases: [
     {
        "alias": "[email protected]"
     }
    ]
}

একটি ডোমেন বা অ্যাকাউন্টের জন্য সমস্ত গ্রুপ পুনরুদ্ধার করুন

একটি নির্দিষ্ট ডোমেন বা অ্যাকাউন্টের জন্য সমস্ত গ্রুপ পুনরুদ্ধার করতে, নিম্নলিখিত GET অনুরোধটি ব্যবহার করুন এবং অনুমোদনের অনুরোধে বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন। ক্যোয়ারী স্ট্রিং, অনুরোধ এবং প্রতিক্রিয়া বৈশিষ্ট্যের জন্য, groups.list পদ্ধতিটি দেখুন। পঠনযোগ্যতার জন্য, এই উদাহরণ লাইন রিটার্ন ব্যবহার করে:

GET https://admin.googleapis.com/admin/directory/v1/groups?domain=domain name
&customer=my_customer or customerId&pageToken=pagination token
&maxResults=max results

একটি ডোমেন বা অ্যাকাউন্টের জন্য সমস্ত গ্রুপ পুনরুদ্ধার করার সময়, নিম্নলিখিতগুলি বিবেচনা করুন:

  • একটি সাব-ডোমেনের জন্য সমস্ত গ্রুপ: ডোমেনের নামের সাথে domain আর্গুমেন্ট ব্যবহার করুন।
  • অ্যাকাউন্টের জন্য সমস্ত গ্রুপ: my_customer বা অ্যাকাউন্টের customerId মান দিয়ে customer যুক্তি ব্যবহার করুন। একটি অ্যাকাউন্ট প্রশাসক হিসাবে, আপনার অ্যাকাউন্টের customerId প্রতিনিধিত্ব করতে my_customer স্ট্রিংটি ব্যবহার করুন। আপনি যদি একজন রিসেলার হয়ে থাকেন তাহলে পুনরায় বিক্রীত গ্রাহকের অ্যাকাউন্ট অ্যাক্সেস করেন, তাহলে পুনরায় বিক্রীত অ্যাকাউন্টের customerId ব্যবহার করুন। customerId মানের জন্য অ্যাকাউন্টের প্রাথমিক ডোমেন নামটি ব্যবহার করুন একটি ডোমেন অপারেশনের অনুরোধে সমস্ত ব্যবহারকারী পুনরুদ্ধার করুন ৷ ফলস্বরূপ প্রতিক্রিয়ার customerId মান রয়েছে।
  • domain এবং customer উভয় আর্গুমেন্ট ব্যবহার করে: ডিরেক্টরি API domain জন্য সমস্ত গ্রুপ ফেরত দেয়।
  • domain এবং customer আর্গুমেন্ট ব্যবহার না করা: ডিরেক্টরি API my_customer এর সাথে যুক্ত অ্যাকাউন্টের জন্য সমস্ত গ্রুপ ফেরত দেয়। এটি হল অ্যাডমিনিস্ট্রেটরের অ্যাকাউন্ট customerId যা অনুরোধ করছে।
  • customer এবং userKey উভয় আর্গুমেন্ট ব্যবহার করে: ডিরেক্টরি API একটি ত্রুটি প্রদান করে। আপনি এই আর্গুমেন্ট সঙ্গে দুটি পৃথক অনুরোধ করতে হবে.

নিম্নলিখিত উদাহরণে, একজন অ্যাকাউন্ট অ্যাডমিনিস্ট্রেটর my_customer ব্যবহার করে একটি অ্যাকাউন্টের সমস্ত গ্রুপের তালিকার অনুরোধ করেন:

GET https://admin.googleapis.com/admin/directory/v1/groups?domain=sales.com&customer=my_customer&maxResults=2

নিম্নলিখিত উদাহরণে, একজন রিসেলার অ্যাডমিনিস্ট্রেটরের অনুরোধ customerId C03az79cb এর সাথে পুনঃবিক্রীত অ্যাকাউন্টের জন্য সমস্ত গ্রুপ ফেরত দেয়। প্রতি প্রতিক্রিয়া পৃষ্ঠায় সর্বাধিক ফলাফল পাওয়া যায় 2। এই প্রতিক্রিয়ায় ব্যবহারকারীদের ফলো-অন তালিকার জন্য একটি nextPageToken আছে:

GET https://admin.googleapis.com/admin/directory/v1/groups?domain=sales.com&customer=C03az79cb&maxResults=2

একটি সফল প্রতিক্রিয়া একটি HTTP 200 স্ট্যাটাস কোড এবং গ্রুপ ইমেলের বর্ণানুক্রমিক ক্রম অনুসারে গ্রুপগুলি ফেরত দেয়: 

{
"kind": "directory#groups",
    "groups": [
     {
      "kind": "directory#groups",
      "id": "group's unique ID",
      "etag": "group's unique ETag",
      "email": "[email protected]",
      "name": "Sales support",
      "directMembersCount": "6",
      "description": "The sales support group",
      "adminCreated": true
     },
     {
      "kind": "directory#groups",
      "id": "group's unique ID",
      "etag": "group's unique ETag",
      "email": "[email protected]",
      "name": "Sales travel",
      "directMembersCount": "2",
      "description": "The travel group supporting sales",
      "adminCreated": false,
      "aliases": [
       {
         "alias": "[email protected]"
       }
      ],
      "nonEditableAliases: [
       {
         "alias": "[email protected]"
       }
      ]
     },
  "nextPageToken": "NNNN"
  }

একটি সদস্যের জন্য সমস্ত গ্রুপ পুনরুদ্ধার করুন

একটি সদস্যের সদস্যতা আছে এমন সমস্ত গোষ্ঠী পুনরুদ্ধার করতে, নিম্নলিখিত GET অনুরোধটি ব্যবহার করুন এবং অনুমোদনের অনুরোধে বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন। পঠনযোগ্যতার জন্য, এই উদাহরণ লাইন রিটার্ন ব্যবহার করে:

GET https://admin.googleapis.com/admin/directory/v1/groups?userKey=user key
?pageToken=pagination token
&maxResults=maximum results per response page
  • একজন সদস্য হয় একটি ব্যবহারকারী বা একটি গ্রুপ হতে পারে.
  • userKey ব্যবহারকারীর প্রাথমিক ইমেল ঠিকানা, ব্যবহারকারীর উপনাম ইমেল ঠিকানা, একটি গোষ্ঠীর প্রাথমিক ইমেল ঠিকানা, একটি গোষ্ঠীর ইমেল উপনাম, বা ব্যবহারকারীর অনন্য id হতে পারে যা ব্যবহারকারীর অপারেশন পুনরুদ্ধার করে পাওয়া যেতে পারে।
  • userKey এ নির্দিষ্ট করা ব্যবহারকারী বা গোষ্ঠী অবশ্যই আপনার ডোমেনের অন্তর্গত।
  • বৃহৎ সংখ্যক গোষ্ঠী সহ প্রতিক্রিয়াগুলির জন্য pageToken ক্যোয়ারী স্ট্রিং ব্যবহার করুন। পেজিনেশনের ক্ষেত্রে, প্রতিক্রিয়া nextPageToken প্রপার্টি প্রদান করে যা প্রতিক্রিয়া ফলাফলের পরবর্তী পৃষ্ঠার জন্য একটি টোকেন দেয়। আপনার পরবর্তী অনুরোধ এই টোকেনটিকে pageToken কোয়েরি স্ট্রিং মান হিসাবে ব্যবহার করে।
  • customer এবং userKey উভয় আর্গুমেন্ট ব্যবহার করে: ডিরেক্টরি API একটি ত্রুটি প্রদান করে। আপনি এই আর্গুমেন্ট সঙ্গে দুটি পৃথক অনুরোধ করতে হবে.

অনুরোধ এবং প্রতিক্রিয়া বৈশিষ্ট্যের জন্য, groups.list পদ্ধতি দেখুন।

একটি সফল প্রতিক্রিয়া একটি HTTP 200 স্ট্যাটাস কোড এবং সদস্য তথ্যের তালিকা প্রদান করে:

  • ব্যবহারকারীর ডোমেনের বাইরের গোষ্ঠীগুলি সহ একজন সদস্যের সদস্যতা রয়েছে এমন সমস্ত গ্রুপগুলি ফেরত দেওয়া হয়।
  • গ্রুপগুলি প্রতিটি গ্রুপের ইমেল ঠিকানার বর্ণানুক্রমিক ক্রমে ফেরত দেওয়া হয়।
  • প্রতিক্রিয়ার মূল অংশে, id গ্রুপের অনন্য আইডি।
  • প্রতিক্রিয়ায়, ব্যবহারকারীর ডোমেনের বাইরে থেকে একটি গোষ্ঠীর তালিকায় বাইরের গোষ্ঠীর উপনাম অন্তর্ভুক্ত করা হয় না। 
{
    "kind": "directory#groups",
    "groups": [
     {
      "kind": "directory#group",
      "id": "group's unique ID",
      "etag": "group's unique ETag",
      "email": "[email protected]",
      "name": "sale group",
      "directMembersCount": "5",
      "description": "Sales group"
     },
     {
      "kind": "directory#group",
      "id": "group's unique ID",
      "etag": "group's unique ETag",
      "email": "support_group.com",
      "name": "support group",
      "directMembersCount": "5",
      "description": "Support group"
     }
  ],
   "nextPakeToken": "NNNNN"
}

সমস্ত গ্রুপ উপনাম পুনরুদ্ধার করুন

একটি গোষ্ঠীর সমস্ত উপনাম পুনরুদ্ধার করতে, নিম্নলিখিত GET অনুরোধটি ব্যবহার করুন এবং অনুমোদনের অনুরোধে বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন। groupKey হতে পারে গোষ্ঠীর প্রাথমিক ইমেল ঠিকানা, গোষ্ঠীর অনন্য id , বা গ্রুপ উপনামের যেকোনো ইমেল। অনুরোধ এবং প্রতিক্রিয়া বৈশিষ্ট্যের জন্য, groups রিসোর্স দেখুন।

GET https://admin.googleapis.com/admin/directory/v1/groups/groupKey/aliases

একটি সফল প্রতিক্রিয়া একটি HTTP 201 স্ট্যাটাস কোড এবং গ্রুপের উপনামের একটি তালিকা প্রদান করে।

একটি গ্রুপ উপনাম মুছুন

একটি গোষ্ঠীর উপনাম মুছে ফেলতে, নিম্নলিখিত DELETE অনুরোধটি ব্যবহার করুন এবং অনুমোদনের অনুরোধে বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন। groupKey হতে পারে গোষ্ঠীর প্রাথমিক ইমেল ঠিকানা, গোষ্ঠীর অনন্য id , বা গ্রুপ উপনামের যেকোনো ইমেল। aliasId হল উপনাম মুছে ফেলা হচ্ছে। অনুরোধ এবং প্রতিক্রিয়া বৈশিষ্ট্যের জন্য, groups সংস্থান দেখুন:

DELETE https://admin.googleapis.com/admin/directory/v1/groups/groupKey/aliases/aliasId

একটি সফল প্রতিক্রিয়া একটি HTTP 201 স্ট্যাটাস কোড প্রদান করে।

একটি গ্রুপ মুছুন

একটি গ্রুপ মুছে ফেলার জন্য, নিম্নলিখিত DELETE অনুরোধটি ব্যবহার করুন এবং অনুমোদনের অনুরোধে বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন। groupKey হল গ্রুপের অনন্য id :

DELETE https://admin.googleapis.com/admin/directory/v1/groups/groupKey
উদাহরণস্বরূপ, এই DELETE অনুরোধটি সেই গোষ্ঠীটিকে মুছে দেয় যার nnnn গ্রুপ id রয়েছে:
DELETE https://admin.googleapis.com/admin/directory/v1/group/nnnn

একটি সফল প্রতিক্রিয়া একটি HTTP 200 স্ট্যাটাস কোড প্রদান করে।

যখন একটি গ্রুপ মুছে ফেলা হয়, নিম্নলিখিতগুলি ঘটে:

  • গ্রুপের সকল সদস্যদের মুছে ফেলা হয়েছে। সদস্যের ব্যবহারকারী অ্যাকাউন্ট মুছে ফেলা হয় না.
  • গ্রুপ সংরক্ষণাগার মুছে ফেলা হয়েছে.
  • মুছে ফেলা গোষ্ঠীর ঠিকানায় পাঠানো বার্তা বিতরণ করা হয় না। পরিবর্তে, প্রেরক একটি বাউন্স বার্তা পায়।