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

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

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

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

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

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

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

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

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

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",
    "blockInheritance": false
}

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

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

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

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

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

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

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

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

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

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",
    "blockInheritance": false
}

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

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

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

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

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

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

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",
    "blockInheritance": false
}

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

একটি সাংগঠনিক ইউনিটের অধীনে সমস্ত উপ-সাংগঠনিক ইউনিট পুনরুদ্ধার করতে, একটি সাংগঠনিক ইউনিটের অধীনে অবিলম্বে শিশুদের, বা সমস্ত উপ-সাংগঠনিক ইউনিট এবং নির্দিষ্ট সাংগঠনিক ইউনিটের অধীনে, নিম্নলিখিত GET অনুরোধটি ব্যবহার করুন এবং অনুমোদনের অনুরোধগুলিতে বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন। অনুরোধ এবং প্রতিক্রিয়া বৈশিষ্ট্যের জন্য, 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 পেতে ব্যবহারকারীর অপারেশন পুনরুদ্ধার করুন:

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",
    "blockInheritance": false
     },
     {
    "kind": "directory#orgUnit",
    "name": "frontline sales",
    "description": "The frontline sales team",
    "orgUnitPath": "/corp/sales/frontline sales",
    "parentOrgUnitPath": "/corp/sales",
    "blockInheritance": false
     },
     {
    "kind": "directory#orgUnit",
    "name": "support",
    "description": "The corporate support team",
    "orgUnitPath": "/corp/support",
    "parentOrgUnitPath": "/corp",
    "blockInheritance": false
     },
     {
    "kind": "directory#orgUnit",
    "name": "sales_support",
    "description": "The BEST support team",
    "orgUnitPath": "/corp/support/sales_support",
    "parentOrgUnitPath": "/corp/support",
    "blockInheritance": false
     }
  ]
  }

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

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

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

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

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

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 স্ট্যাটাস কোড প্রদান করে।

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