আপনি ডোমেনে কাস্টম ব্যবহারকারী স্কিমা যোগ করে আপনার ডোমেনের ব্যবহারকারীদের জন্য কাস্টম ক্ষেত্র সংজ্ঞায়িত করতে পারেন। আপনি এই ক্ষেত্রগুলিকে তথ্য সংরক্ষণ করতে ব্যবহার করতে পারেন যেমন আপনার ব্যবহারকারীরা যে প্রকল্পগুলিতে কাজ করে, তাদের শারীরিক অবস্থান, তাদের ভাড়ার তারিখ, বা অন্য যা কিছু আপনার ব্যবসার প্রয়োজনের সাথে খাপ খায়।
শুরু করতে, আপনার ডোমেনের জন্য অর্থপূর্ণ কাস্টম ক্ষেত্রগুলিকে সংজ্ঞায়িত করতে এক বা একাধিক স্কিমা তৈরি করুন ৷ আপনি বেশ কয়েকটি বৈশিষ্ট্য নির্দিষ্ট করতে পারেন, যেমন ক্ষেত্রের নাম, ধরন (স্ট্রিং, বুলিয়ান, পূর্ণসংখ্যা ইত্যাদি), এটি একক- বা বহু-মূল্যবান কিনা এবং এর মানগুলি আপনার ডোমেনের যেকোনো ব্যবহারকারী দ্বারা দেখা যায় কিনা। অথবা শুধুমাত্র প্রশাসক এবং সংশ্লিষ্ট ব্যবহারকারী।
একবার একটি স্কিমা সংজ্ঞায়িত করা হলে, কাস্টম ক্ষেত্রগুলি আদর্শ ক্ষেত্রগুলির মতো আচরণ করে। আপনার ডোমেনে ব্যবহারকারীদের আপডেট করার সময় আপনি তাদের সেট করতে পারেন, users.get এবং users.list এর মাধ্যমে তাদের আনতে পারেন এবং কাস্টম ক্ষেত্রগুলির জন্য অনুসন্ধান করতে পারেন ৷
একটি ব্যবহারকারীর প্রোফাইলে কাস্টম ক্ষেত্র সেট করুন
একটি স্কিমা আপডেট বা তৈরি করতে, একটি customSchemas সম্পত্তি তৈরি করুন এবং এটি ব্যবহারকারীর সংস্থানে যোগ করুন। customSchemas সম্পত্তির ভিতরে, কাস্টম ক্ষেত্রগুলি স্ট্যান্ডার্ড JSON ফর্ম্যাটে স্কিমা দ্বারা গোষ্ঠীভুক্ত করা হয়:
"customSchemas": {
"schema1": {
"field1": "value1",
"field2": [
{ "value": "value2a" },
{ "value": "value2b" },
...
],
...
},
"schema2": {
"field3": "value3",
...
},
...
}
একক-মূল্যবান কাস্টম ক্ষেত্রগুলিকে সাধারণ কী-মানের জোড়া হিসাবে সেট করা হয়, যেমন "field1": "value1" । বহু-মূল্যবান কাস্টম ক্ষেত্রগুলিকে অবজেক্টের অ্যারে হিসাবে সেট করা হয়, যেমন API-এর স্ট্যান্ডার্ড মাল্টি-ভ্যালু ফিল্ড যেমন addresses এবং phones । এই মান বস্তু নিম্নলিখিত কী সমর্থন করে:
| চাবি | |
|---|---|
value | সংরক্ষণ করা মান, প্রয়োজনীয়. |
type | মানের প্রকার, ঐচ্ছিক। সম্ভাব্য মান হল:
|
customType | মান কাস্টম প্রকার, ঐচ্ছিক. type custom সেট করা হলে ব্যবহার করা আবশ্যক। |
যদি একটি স্কিমাতে একটি কাস্টম ক্ষেত্র আপডেটের সময় নির্দিষ্ট করা না থাকে তবে এটি অপরিবর্তিত রাখা হয়। আপডেটের সময় customFields একটি স্কিমা নিজেই নির্দিষ্ট না থাকলে, সেই স্কিমার সমস্ত কাস্টম ক্ষেত্র অপরিবর্তিত থাকে। একটি প্রোফাইল থেকে একটি কাস্টম ক্ষেত্র বা একটি কাস্টম স্কিমা মুছে ফেলতে, আপনাকে এটিকে স্পষ্টভাবে null সেট করতে হবে:
"schema1": {
"field1": null // deletes field1 from this profile.
}
JSON অনুরোধ
নীচের উদাহরণে কলটি একজন ব্যবহারকারীকে আপডেট করে এবং employmentData কাস্টম স্কিমার জন্য মান সেট করে:
PATCH https://admin.googleapis.com/admin/directory/v1/users/[email protected]
{
"customSchemas": {
"employmentData": {
"employeeNumber": "123456789",
"jobFamily": "Engineering"
"location": "Atlanta",
"jobLevel": 8,
"projects": [
{ "value": "GeneGnome" },
{ "value": "Panopticon", "type": "work" },
{ "value": "MegaGene", "type": "custom", "customType": "secret" }
]
}
}
}
একটি ব্যবহারকারী প্রোফাইলে কাস্টম ক্ষেত্র পড়ুন
আপনি একটি users.get এ projection প্যারামিটার সেট করে বা users.list অনুরোধ custom বা full একটি ব্যবহারকারীর প্রোফাইলে কাস্টম ক্ষেত্র আনতে পারেন।
একটি ব্যবহারকারী প্রোফাইলে কাস্টম ক্ষেত্র অনুসন্ধান করুন
আপনি একটি users.list অনুরোধে query প্যারামিটার ব্যবহার করে কাস্টম ক্ষেত্রের মধ্যে অনুসন্ধান করতে পারেন। আপনি একটি schemaName.fieldName সিনট্যাক্স সহ কাস্টম ক্ষেত্রের অনুরোধ করুন৷ যেমন:
employmentData.projects:"GeneGnome"
GeneGnome প্রকল্পে কাজ করে এমন সমস্ত কর্মীদের ফেরত দেয়। প্রশ্ন
employmentData.location="Atlanta" employmentData.jobLevel>=7
আটলান্টায় চাকরির স্তর 7-এর উপরে সমস্ত কর্মচারীকে ফেরত দেয়। আরও তথ্যের জন্য, ব্যবহারকারীদের অনুসন্ধান দেখুন।
একটি কাস্টম ব্যবহারকারী স্কিমা তৈরি করুন
আপনার সমস্ত Google Workspace অ্যাকাউন্টের ডোমেনে একটি কাস্টম ব্যবহারকারী স্কিমা যোগ করা যেতে পারে। আপনার ডোমেনে একটি কাস্টম ব্যবহারকারী স্কিমা তৈরি করতে, নিম্নলিখিত POST অনুরোধটি ব্যবহার করুন এবং অনুমোদনের অনুরোধে বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন। অনুরোধ ক্যোয়ারী স্ট্রিং বৈশিষ্ট্যের জন্য, API রেফারেন্স দেখুন।
POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer or customerId/schemas
সমস্ত ক্রিয়েট রিকোয়েস্টের জন্য আপনাকে অনুরোধ পূরণের জন্য প্রয়োজনীয় তথ্য জমা দিতে হবে। আপনি যদি ক্লায়েন্ট লাইব্রেরি ব্যবহার করেন, তাহলে তারা আপনার নির্বাচিত ভাষা থেকে ডেটা অবজেক্টকে JSON ডেটা ফরম্যাটেড অবজেক্টে রূপান্তর করে।
JSON অনুরোধ
নিম্নলিখিত নমুনা একটি কাস্টম স্কিমা তৈরি করার অনুরোধ দেখায়। অনুরোধ এবং প্রতিক্রিয়া বৈশিষ্ট্যের সম্পূর্ণ তালিকার জন্য, API রেফারেন্স দেখুন।
{
"schemaName": "employmentData",
"fields": [
{
"fieldName": "EmployeeNumber",
"fieldType": "STRING",
"multiValued": "false"
},
{
"fieldName": "JobFamily",
"fieldType": "STRING",
"multiValued": "false"
}
]
}
একটি সফল প্রতিক্রিয়া নতুন কাস্টম স্কিমার বৈশিষ্ট্য সহ একটি HTTP 201 স্ট্যাটাস কোড প্রদান করে।
কাস্টম স্কিমা সীমা
- একটি অ্যাকাউন্টে অনুমোদিত কাস্টম স্কিমার সর্বাধিক সংখ্যা 100।
- একটি অ্যাকাউন্টে অনুমোদিত সর্বাধিক 100টি কাস্টম ক্ষেত্র।
- একটি একক-মূল্যবান কাস্টম ক্ষেত্রের জন্য একটি
stringক্ষেত্রে অনুমোদিত অক্ষরের সর্বাধিক সংখ্যা হল 500৷ বহু-মূল্যবান কাস্টম ক্ষেত্রের জন্য, অনুমোদিত উপাদানগুলির সংখ্যা নির্ধারিত মানগুলির আকারের উপর নির্ভর করে৷ উদাহরণস্বরূপ, আপনি প্রতিটি 100 অক্ষরের 150টি মান বা 500 অক্ষরের 50টি মান যোগ করতে পারেন। - কাস্টম স্কিমা এবং ক্ষেত্রের নামগুলিতে অনুমোদিত অক্ষরগুলি হল আলফানিউমেরিক অক্ষর, আন্ডারস্কোর (
_), এবং হাইফেন (-)। - একটি ক্ষেত্রের ধরন পরিবর্তন করা অনুমোদিত নয়।
- একটি একক-মূল্যবান ক্ষেত্র বহু-মূল্যবান করা যেতে পারে, কিন্তু বিপরীত অপারেশন অনুমোদিত নয়।
- কাস্টম স্কিমা বা ক্ষেত্রগুলির নাম পরিবর্তন করা সম্ভব নয়।
একটি কাস্টম ব্যবহারকারী স্কিমা আপডেট করুন
একটি কাস্টম স্কিমা আপডেট করতে, নিম্নলিখিত PUT অনুরোধটি ব্যবহার করুন এবং অনুমোদনের অনুরোধে বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন। schemaKey স্কিমার নাম বা অনন্য স্কিমা id হতে পারে। অনুরোধ এবং প্রতিক্রিয়া বৈশিষ্ট্যের জন্য, API রেফারেন্স দেখুন।
PUT https://admin.googleapis.com/admin/directory/v1/customer/my_customer or customerId/schemas/schemaKey
JSON অনুরোধ
নীচের উদাহরণে, স্কিমা employmentData একটি JobFamily ফিল্ড ছিল যখন তৈরি করা হয়েছিল। অনুরোধটি শুধুমাত্র একটি EmployeeNumber ক্ষেত্র ধারণ করার জন্য employmentData আপডেট করছে:
PUT https://admin.googleapis.com/admin/directory/v1/customer/my_customer/schemas/employmentData
{
"kind": "admin#directory#schema",
"schemaId": "dKaYmUwmSZy5lreXyh75hQ==",
"etag": "\"St7vIdePbbDsQUvvrssynd-6JLg/PKg63GvWb7bnVSNRomd_O-Vi66w\"",
"schemaName": "employmentData",
"fields": [
{
"kind": "admin#directory#schema#fieldspec",
"fieldId": "21_B4iQIRY-dIFGFgAX-Og==",
"etag": "\"St7vIdePbbDsQUvvrssynd-6JLg/LZxiGaz6_N4R40OpKbDhOcy2qiE\"",
"fieldType": "STRING",
"fieldName": "EmployeeNumber",
"multiValued": "false"
}
]
}
সমস্ত আপডেট অনুরোধের জন্য আপনাকে অনুরোধ পূরণ করার জন্য প্রয়োজনীয় তথ্য জমা দিতে হবে।
একটি সফল প্রতিক্রিয়া আপডেট করা স্কিমা সংস্থান সহ একটি HTTP 200 স্ট্যাটাস কোড প্রদান করে।
একটি কাস্টম ব্যবহারকারী স্কিমা পুনরুদ্ধার করুন
একটি কাস্টম স্কিমা পুনরুদ্ধার করতে, নিম্নলিখিত GET অনুরোধটি ব্যবহার করুন এবং অনুমোদনের অনুরোধে বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন। schemaKey স্কিমার নাম বা অনন্য স্কিমা id হতে পারে। অনুরোধ এবং প্রতিক্রিয়া বৈশিষ্ট্যের জন্য, API রেফারেন্স দেখুন।
GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer or customerId/schemas/schemaKey
একটি সফল প্রতিক্রিয়া কাস্টম স্কিমার বৈশিষ্ট্য সহ একটি HTTP 200 স্ট্যাটাস কোড প্রদান করে।
{
"kind": "admin#directory#schema",
"schemaId": "dKaYmUwmSZy5lreXyh75hQ==",
"etag": "\"KYnPjBPqr8knK6v7rpxly9BhNeY/PKg63GvWb7bnVSNRomd_O-Vi66w\"",
"schemaName": "employmentData",
"fields": [
{
"kind": "admin#directory#schema#fieldspec",
"fieldId": "21_B4iQIRY-dIFGFgAX-Og==",
"etag": "\"KYnPjBPqr8knK6v7rpxly9BhNeY/LZxiGaz6_N4R40OpKbDhOcy2qiE\"",
"fieldType": "STRING",
"fieldName": "EmployeeNumber"
},
{
"kind": "admin#directory#schema#fieldspec",
"fieldId": "ZKy0QtoMRy2QlM-4sAsPtQ==",
"etag": "\"KYnPjBPqr8knK6v7rpxly9BhNeY/jEULI-ZiqywQIHXgc8evEcTE4Cc\"",
"fieldType": "STRING",
"fieldName": "JobFamily"
}
]
}
সমস্ত কাস্টম ব্যবহারকারী স্কিমা পুনরুদ্ধার করুন
একই অ্যাকাউন্টে সমস্ত কাস্টম স্কিমা পুনরুদ্ধার করতে, নিম্নলিখিত GET অনুরোধটি ব্যবহার করুন এবং অনুমোদনের অনুরোধগুলিতে বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন। অনুরোধ এবং প্রতিক্রিয়া বৈশিষ্ট্যের জন্য, API রেফারেন্স দেখুন।
GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer or customerId/schemas
একটি সফল প্রতিক্রিয়া অ্যাকাউন্টের জন্য কাস্টম স্কিমা সহ একটি HTTP 200 স্ট্যাটাস কোড প্রদান করে।
{
"kind": "admin#directory#schemas",
"etag": "\"KYnPjBPqr8knK6v7rpxly9BhNeY/iJ1eWn5AKuR-xTdwH_2IBlvSSKo\"",
"schemas": [
{
"kind": "admin#directory#schema",
"schemaId": "dKaYmUwmSZy5lreXyh75hQ==",
"etag": "\"KYnPjBPqr8knK6v7rpxly9BhNeY/PKg63GvWb7bnVSNRomd_O-Vi66w\"",
"schemaName": "employmentData",
"fields": [
{
"kind": "admin#directory#schema#fieldspec",
"fieldId": "21_B4iQIRY-dIFGFgAX-Og==",
"etag": "\"KYnPjBPqr8knK6v7rpxly9BhNeY/LZxiGaz6_N4R40OpKbDhOcy2qiE\"",
"fieldType": "STRING",
"fieldName": "EmployeeNumber"
},
{
"kind": "admin#directory#schema#fieldspec",
"fieldId": "ZKy0QtoMRy2QlM-4sAsPtQ==",
"etag": "\"KYnPjBPqr8knK6v7rpxly9BhNeY/jEULI-ZiqywQIHXgc8evEcTE4Cc\"",
"fieldType": "STRING",
"fieldName": "JobFamily"
}
]
}
]
}