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

এই পৃষ্ঠাটি ডিরেক্টরি API ব্যবহার করে গুগল গ্রুপগুলি কীভাবে পরিচালনা করবেন তা বর্ণনা করে:

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

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

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

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

নিম্নলিখিত JSON অনুরোধটি একটি নমুনা অনুরোধের অংশ দেখায় যা একটি গ্রুপ তৈরি করে। গ্রুপটির ইমেল ঠিকানা হল sales_group@example.com:

{
   "email": "sales_group@example.com",
   "name": "Sales Group",
   "description": "This is the Sales group."
}

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

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

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

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

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

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

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

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

{
    "email": "sales_group@example.com",
    "name": "APAC Sales Group"
}

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

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

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

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

একটি গ্রুপ উপনাম যোগ করতে, নিম্নলিখিত POST অনুরোধটি ব্যবহার করুন এবং Authorize requests এ বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন। 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": "best_sales_group@example.com"
}

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

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

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

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

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

নিম্নলিখিত উদাহরণে, অনন্য groupKey ID হল 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": "sales_group@example.com",
    "name": "APAC Sales Group",
    "directMembersCount": "5",
    "description": "This is the APAC sales group.",
    "adminCreated": true,
    "aliases": [
     {
        "alias": "best_sales_group@example.com"
     }
    ],
    "nonEditableAliases": [
     {
        "alias": "liz@test.com"
     }
    ]
}

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

একটি নির্দিষ্ট ডোমেন বা অ্যাকাউন্টের জন্য সমস্ত গ্রুপ পুনরুদ্ধার করতে, নিম্নলিখিত GET অনুরোধটি ব্যবহার করুন এবং Authorize requests এ বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন। কোয়েরি স্ট্রিং, অনুরোধ এবং প্রতিক্রিয়া বৈশিষ্ট্যের জন্য, 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 মানের জন্য, Retrieve all users in a domain operation's request-এ অ্যাকাউন্টের প্রাথমিক ডোমেইন নাম ব্যবহার করুন। ফলস্বরূপ প্রতিক্রিয়ায় customerId মান থাকবে।
  • domain এবং customer উভয় আর্গুমেন্ট ব্যবহার করে: ডিরেক্টরি API domain জন্য সমস্ত গ্রুপ ফেরত দেয়।
  • domain এবং customer আর্গুমেন্ট ব্যবহার না করা: ডিরেক্টরি API my_customer এর সাথে সম্পর্কিত অ্যাকাউন্টের জন্য সমস্ত গ্রুপ ফেরত দেয়। এটি অনুরোধকারী প্রশাসকের অ্যাকাউন্ট customerId ।
  • customer এবং userKey উভয় আর্গুমেন্ট ব্যবহার করে: Directory 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": "support@sales.com",
      "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": "travel@sales.com",
      "name": "Sales travel",
      "directMembersCount": "2",
      "description": "The travel group supporting sales",
      "adminCreated": false,
      "aliases": [
       {
         "alias": "best_sales_group@example.com"
       }
      ],
      "nonEditableAliases": [
       {
         "alias": "liz@test.com"
       }
      ]
     },
  "nextPageToken": "NNNN"
  }

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

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

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

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

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

  • ব্যবহারকারীর ডোমেনের বাইরের গ্রুপগুলি সহ, সদস্যদের সাবস্ক্রিপশন থাকা সমস্ত গ্রুপ ফেরত পাঠানো হয়।
  • প্রতিটি গ্রুপের ইমেল ঠিকানার বর্ণানুক্রমিক ক্রমানুসারে গ্রুপগুলি ফেরত পাঠানো হয়।
  • প্রতিক্রিয়ার মূল অংশে, id হল গ্রুপের অনন্য আইডি।
  • প্রতিক্রিয়ায়, ব্যবহারকারীর ডোমেনের বাইরের কোনও গোষ্ঠীর তালিকায় বাইরের গোষ্ঠীর উপনাম অন্তর্ভুক্ত নেই। 
{
    "kind": "directory#groups",
    "groups": [
     {
      "kind": "directory#group",
      "id": "group's unique ID",
      "etag": "group's unique ETag",
      "email": "sales_group@example.com",
      "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"
     }
  ],
   "nextPageToken": "NNNNN"
}

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

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

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

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

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

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

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

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

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

একটি গ্রুপ মুছে ফেলার জন্য, নিম্নলিখিত DELETE অনুরোধটি ব্যবহার করুন এবং Authorize requests এ বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন। 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 স্ট্যাটাস কোড প্রদান করে।

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

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