ডিরেক্টরি API: সাংগঠনিক ইউনিট

সাংগঠনিক ইউনিট পরিচালনা করুন

একটি Google Workspace অ্যাকাউন্টের সাংগঠনিক ট্রি সাংগঠনিক ইউনিট দিয়ে গঠিত যা আপনাকে আপনার ব্যবহারকারীদের একটি যৌক্তিক এবং শ্রেণিবদ্ধ কাঠামোতে পরিচালনা করতে দেয়। এটি Google অ্যাডমিন কনসোলের 'সংস্থা এবং ব্যবহারকারী' ট্যাবে পাওয়া কার্যকারিতার অনুরূপ। গ্রাহকের সাংগঠনিক ইউনিট শ্রেণিবিন্যাস 35 স্তরের গভীরতার মধ্যে সীমাবদ্ধ। আরও তথ্যের জন্য, অ্যাডমিন সহায়তা কেন্দ্র দেখুন।

• একটি Google Workspace অ্যাকাউন্টে শুধুমাত্র একটি প্রতিষ্ঠান ট্রি থাকে। যখন এই অ্যাকাউন্টটি প্রাথমিকভাবে কনফিগার করা হয়, তখন অ্যাকাউন্ট-স্তরে এর একটি সাংগঠনিক ইউনিট থাকে। এটি প্রাথমিক ডোমেনের সাথে সম্পর্কিত সংস্থা। প্রাথমিক ডোমেন সম্পর্কে আরও তথ্যের জন্য, API সীমা তথ্য দেখুন।
• একটি সাংগঠনিক ইউনিটের পথের নাম অনন্য। সাংগঠনিক ইউনিটের নাম সংগঠনের শ্রেণিবিন্যাসের মধ্যে অনন্য নাও হতে পারে, তবে এর সহোদর সাংগঠনিক ইউনিটগুলির মধ্যে এর নাম অনন্য। এবং একটি সাংগঠনিক ইউনিটের নাম কেস-সংবেদনশীল নয়।
• একটি সাংগঠনিক ইউনিট সাংগঠনিক শ্রেণিবিন্যাস থেকে নীতিমালা উত্তরাধিকার সূত্রে পায়। যেকোনো সাংগঠনিক ইউনিট উত্তরাধিকারসূত্রে প্রাপ্ত নীতিকে অগ্রাহ্য করে পিতামাতার উত্তরাধিকারের এই শৃঙ্খলকে অবরুদ্ধ করতে পারে। একটি নীতির উপর অন্য নীতির অগ্রাধিকার নিকটতম সাংগঠনিক ইউনিট দ্বারা নির্ধারিত হয়। অর্থাৎ, নিম্ন সাংগঠনিক ইউনিটের নীতিগুলি উচ্চতর পিতামাতার ইউনিটের নীতিগুলির উপর অগ্রাধিকার পেতে পারে। একটি প্রতিষ্ঠানের কাঠামোতে উত্তরাধিকার এবং ব্যবহারকারীদের সম্পর্কে আরও তথ্যের জন্য, প্রশাসন সহায়তা কেন্দ্র দেখুন।
• একটি সাংগঠনিক ইউনিটকে একটি হায়ারার্কিকাল ট্রির উপরে বা নীচে সরানো যেতে পারে। এবং, একটি নতুন সংস্থা তৈরি করার সময় বা ব্যবহারকারীদের একটি উপসেটকে এক সাংগঠনিক ইউনিট থেকে অন্যটিতে স্থানান্তর করার সময় সংস্থার সংশ্লিষ্ট ব্যবহারকারীদের পৃথকভাবে বা একটি ব্যাচে স্থানান্তর করা যেতে পারে।
• সাংগঠনিক ইউনিটের বৈশিষ্ট্যে সংরক্ষিত ডেটা ক্রমাগত পরিবর্তিত হতে পারে। অনুরোধ করার সময়, কোনও সত্তার জন্য ফেরত দেওয়া বৈশিষ্ট্যগুলি সত্তাটি পুনরুদ্ধারের সময় সামঞ্জস্যপূর্ণ হওয়ার নিশ্চয়তা দেওয়া হয়। অর্থাৎ, আপনি "আংশিক" আপডেট দেখতে পাবেন না। যদি কোনও পুনরুদ্ধার অপারেশন একাধিক সত্তা ফেরত দেয়, তবে সত্তাগুলির মধ্যে কোনও সামঞ্জস্যের গ্যারান্টি নেই। এটি বিশেষ করে সত্য যখন একটি প্রতিক্রিয়া পৃষ্ঠাঙ্কনে একাধিক পৃষ্ঠা বিস্তৃত করে।

একটি সাংগঠনিক ইউনিট তৈরি করুন

একটি সাংগঠনিক ইউনিট তৈরি করতে, নিম্নলিখিত POST অনুরোধটি ব্যবহার করুন এবং Authorize requests এ বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন।

আপনি যদি একজন প্রশাসক হন যিনি একটি সাংগঠনিক ইউনিট তৈরি করেন, তাহলে my_customer ব্যবহার করুন।

POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/orgunits

যদি আপনি একজন পুনঃবিক্রীত গ্রাহকের জন্য একটি সাংগঠনিক ইউনিট তৈরি করে রিসেলার হন, তাহলে customerId ব্যবহার করুন। customerId পুনরুদ্ধার করতে, Retrieve a user অপারেশনটি ব্যবহার করুন।

POST https://admin.googleapis.com/admin/directory/v1/customer/customerId/orgunits

আপনার অ্যাকাউন্টের সাংগঠনিক কাঠামো বুঝতে, অ্যাডমিন সহায়তা কেন্দ্র দেখুন। অনুরোধ এবং প্রতিক্রিয়া বৈশিষ্ট্যের জন্য, API রেফারেন্স দেখুন।

JSON অনুরোধ

নিম্নলিখিত JSON রিসেলার উদাহরণে একটি নমুনা অনুরোধের বডি দেখানো হয়েছে যা sales_support সাংগঠনিক ইউনিট তৈরি করে। name এবং parentOrgUnitPath প্রয়োজন:

POST https://admin.googleapis.com/admin/directory/v1/customer/C03az79cb/orgunits

{
    "name": "sales_support",
    "description": "The sales support team",
    "parentOrgUnitPath": "/corp/support",
}

JSON প্রতিক্রিয়া

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

{
    "kind": "directory#orgUnit",
    "name": "sales_support",
    "description": "The sales support team",
    "orgUnitPath": "/corp/support/sales_support",
    "parentOrgUnitPath": "/corp/support"
  }

একটি সাংগঠনিক ইউনিট আপডেট করুন

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

আপনি যদি কোনও সাংগঠনিক ইউনিট আপডেট করার জন্য প্রশাসক হন, তাহলে my_customer ব্যবহার করুন।

 PUT https://admin.googleapis.com/admin/directory/v1/customer/my_customer/orgunits/orgUnitPath

আপনি যদি একজন পুনঃবিক্রয়কারী গ্রাহকের জন্য একটি সাংগঠনিক ইউনিট আপডেট করার জন্য একজন পুনঃবিক্রেতা হন, তাহলে customerId ব্যবহার করুন। customerId পেতে, Retrieve a user অপারেশনটি ব্যবহার করুন।

PUT https://admin.googleapis.com/admin/directory/v1/customer/customerId/orgunits/orgUnitPath

দ্রষ্টব্য: API প্যাচ সেমান্টিক্সও সমর্থন করে।

JSON অনুরোধ

নিচের উদাহরণে, সাংগঠনিক ইউনিটের বিবরণ আপডেট করা হয়েছে:

PUT https://admin.googleapis.com/admin/directory/v1/customer/my_customer/orgunits/corp/support/sales_support

{
    "description": "The BEST sales support team"
}

আপডেট অনুরোধের জন্য নোট:

• আপনার অনুরোধে শুধুমাত্র আপডেট করা তথ্য জমা দিতে হবে। অনুরোধে গ্রুপের সমস্ত বৈশিষ্ট্য প্রবেশ করার প্রয়োজন নেই।
• যদি ব্যবহারকারীর অ্যাকাউন্ট তৈরির সময় কোনও ব্যবহারকারীকে কোনও নির্দিষ্ট সাংগঠনিক ইউনিটে নিয়োগ করা না হয়, তাহলে অ্যাকাউন্টটি শীর্ষ-স্তরের সাংগঠনিক ইউনিটে থাকে।
• আপনি অনুরোধে parentOrgUnitPath বৈশিষ্ট্যটি সেট করে আপনার অ্যাকাউন্টের সংগঠন কাঠামোর অন্য অংশে একটি সাংগঠনিক ইউনিট স্থানান্তর করতে পারেন। এটি মনে রাখা গুরুত্বপূর্ণ যে, একটি সাংগঠনিক ইউনিট স্থানান্তরিত করলে স্থানান্তরিত সাংগঠনিক ইউনিটের ব্যবহারকারীদের জন্য পরিষেবা এবং সেটিংস পরিবর্তন হতে পারে।

JSON প্রতিক্রিয়া

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

{
    "kind": "directory#orgUnit",
    "name": "sales_support",
    "description": "The BEST sales support team",
    "orgUnitPath": "/corp/support/sales_support",
    "parentOrgUnitPath": "/corp/support"
}

ব্যবহারকারীর অ্যাকাউন্ট তৈরি করার সময় যদি কোনও ব্যবহারকারীকে কোনও নির্দিষ্ট সাংগঠনিক ইউনিটে নিয়োগ করা না হয়, তাহলে অ্যাকাউন্টটি শীর্ষ-স্তরের সাংগঠনিক ইউনিটে থাকে। ব্যবহারকারীর কোন Google Workspace পরিষেবাগুলিতে অ্যাক্সেস আছে তা ব্যবহারকারীর সাংগঠনিক ইউনিট নির্ধারণ করে। ব্যবহারকারীকে একটি নতুন সংস্থায় স্থানান্তরিত করা হলে, ব্যবহারকারীর অ্যাক্সেস পরিবর্তিত হয়। প্রতিষ্ঠানের কাঠামো সম্পর্কে আরও তথ্যের জন্য, প্রশাসন সহায়তা কেন্দ্র দেখুন। ব্যবহারকারীকে অন্য সংস্থায় স্থানান্তরিত করার বিষয়ে আরও তথ্যের জন্য, ব্যবহারকারীকে আপডেট করুন দেখুন।

একটি সাংগঠনিক ইউনিট পুনরুদ্ধার করুন

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

আপনি যদি একজন প্রশাসক হন যিনি একটি সাংগঠনিক ইউনিট পুনরুদ্ধার করছেন, তাহলে my_customer ব্যবহার করুন।

GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/orgunits/orgUnitPath

আপনি যদি একজন রিসেলার হন যিনি পুনঃবিক্রীত গ্রাহকের জন্য একটি সাংগঠনিক ইউনিট পুনরুদ্ধার করছেন, তাহলে customerId ব্যবহার করুন। customerId পেতে Retrieve a user অপারেশন ব্যবহার করুন।

GET https://admin.googleapis.com/admin/directory/v1/customer/customerId/orgunits/orgUnitPath

JSON প্রতিক্রিয়া

নিচের উদাহরণে, 'ফ্রন্টলাইন বিক্রয়' সাংগঠনিক ইউনিটটি পুনরুদ্ধার করা হয়েছে। অনুরোধের URI-তে 'ফ্রন্টলাইন+বিক্রয়' HTTP এনকোডিংটি লক্ষ্য করুন:

GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/orgunits/corp/sales/frontline+sales

একটি সফল প্রতিক্রিয়া একটি HTTP 200 স্ট্যাটাস কোড ফেরত পাঠায়। স্ট্যাটাস কোডের সাথে, প্রতিক্রিয়াটি সাংগঠনিক ইউনিটের সেটিংস ফেরত দেয়:

{
    "kind": "directory#orgUnit",
    "name": "frontline sales",
    "description": "The frontline sales team",
    "orgUnitPath": "/corp/sales/frontline sales",
    "parentOrgUnitPath": "/corp/sales"
}

সাংগঠনিক ইউনিটগুলি পুনরুদ্ধার করুন

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

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

GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer
/orgunits?orgUnitPath=full org unit path&type=all or children or all_including_parent

যদি আপনি একজন রিসেলার হন যিনি পুনঃবিক্রীত গ্রাহকের জন্য সাংগঠনিক ইউনিট পুনরুদ্ধার করেন, তাহলে customerId ব্যবহার করুন। customerId পেতে Retrieve a user অপারেশন ব্যবহার করুন:

GET https://admin.googleapis.com/admin/directory/v1/customer/customerId
/orgunits?orgUnitPath=full org unit path&type=all or children or all_including_parent

get কোয়েরি স্ট্রিং হয় orgUnitPath অধীনে থাকা all উপ-সাংগঠনিক ইউনিট, orgUnitPath এর অন্তিম children , অথবা সমস্ত উপ-সাংগঠনিক ইউনিট এবং all_including_parent এর জন্য নির্দিষ্ট orgUnitPath ফেরত পাঠায়। ডিফল্ট হল type=children ।

JSON প্রতিক্রিয়া

উদাহরণস্বরূপ, এই অনুরোধটি /corp সাংগঠনিক ইউনিট থেকে শুরু করে সমস্ত সাংগঠনিক ইউনিট ফেরত পাঠায়:

GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/orgunits?orgUnitPath=/corp&type=all

একটি সফল প্রতিক্রিয়া একটি HTTP 200 স্ট্যাটাস কোড ফেরত পাঠায়। স্ট্যাটাস কোডের সাথে, প্রতিক্রিয়াটি অ্যাকাউন্টের সাংগঠনিক ইউনিটগুলি ফেরত দেয়:

{
"kind": "directory#orgUnits",
    "organizationUnits": [
     {
    "kind": "directory#orgUnit",
    "name": "sales",
    "description": "The corporate sales team",
    "orgUnitPath": "/corp/sales",
    "parentOrgUnitPath": "/corp"
     },
     {
    "kind": "directory#orgUnit",
    "name": "frontline sales",
    "description": "The frontline sales team",
    "orgUnitPath": "/corp/sales/frontline sales",
    "parentOrgUnitPath": "/corp/sales"
     },
     {
    "kind": "directory#orgUnit",
    "name": "support",
    "description": "The corporate support team",
    "orgUnitPath": "/corp/support",
    "parentOrgUnitPath": "/corp"
     },
     {
    "kind": "directory#orgUnit",
    "name": "sales_support",
    "description": "The BEST support team",
    "orgUnitPath": "/corp/support/sales_support",
    "parentOrgUnitPath": "/corp/support"
     }
  ]
  }

একটি সাংগঠনিক ইউনিট মুছুন

একটি সাংগঠনিক ইউনিট মুছে ফেলার জন্য, নিম্নলিখিত DELETE অনুরোধটি ব্যবহার করুন এবং Authorize requests এ বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন। customerId পুনরুদ্ধার করতে, Retrieve a user অপারেশনটি ব্যবহার করুন। অনুরোধ এবং প্রতিক্রিয়া বৈশিষ্ট্যগুলির জন্য, API রেফারেন্স দেখুন:

আপনি যদি একজন অ্যাকাউন্ট প্রশাসক হন যিনি একটি সাংগঠনিক ইউনিট মুছে ফেলেন, তাহলে my_customer ব্যবহার করুন।

DELETE https://admin.googleapis.com/admin/directory/v1/customer/my_customer/orgunits/orgUnitPath

যদি আপনি একজন রিসেলার হন যিনি পুনঃবিক্রীত গ্রাহকের জন্য একটি সাংগঠনিক ইউনিট মুছে ফেলেন, তাহলে customerId ব্যবহার করুন। customerId পেতে Retrieve a user অপারেশন ব্যবহার করুন।

DELETE https://admin.googleapis.com/admin/directory/v1/customer/customerId/orgunits/orgUnitPath

উদাহরণস্বরূপ, এই রিসেলার অ্যাডমিনিস্ট্রেটরের DELETE অনুরোধ 'backend_tests' সাংগঠনিক ইউনিটটি মুছে ফেলে:

DELETE https://admin.googleapis.com/admin/directory/v1/customer/C03az79cb/orgunits/corp/sales/backend_tests

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

আপনি কেবল সেইসব সাংগঠনিক ইউনিট মুছে ফেলতে পারবেন যাদের কোনও চাইল্ড সাংগঠনিক ইউনিট নেই অথবা তাদের জন্য কোনও ব্যবহারকারী নির্ধারিত নেই। মুছে ফেলার আগে আপনাকে ব্যবহারকারীদের অন্য সাংগঠনিক ইউনিটে পুনরায় বরাদ্দ করতে হবে এবং যেকোনো চাইল্ড সাংগঠনিক ইউনিট সরিয়ে ফেলতে হবে।