কাস্টম ব্যবহারকারী ক্ষেত্রগুলি পরিচালনা করুন৷

আপনি আপনার ডোমেনের ব্যবহারকারীদের জন্য কাস্টম ক্ষেত্রগুলি সংজ্ঞায়িত করতে পারেন ডোমেনে কাস্টম ব্যবহারকারী স্কিমা যোগ করে। আপনি এই ক্ষেত্রগুলি ব্যবহার করে আপনার ব্যবহারকারীরা যে প্রকল্পগুলিতে কাজ করেন, তাদের ভৌত অবস্থান, তাদের ভাড়ার তারিখ, অথবা আপনার ব্যবসার প্রয়োজন অনুসারে অন্য যা কিছু তথ্য সংরক্ষণ করতে পারেন।

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

একবার স্কিমা সংজ্ঞায়িত হয়ে গেলে, কাস্টম ফিল্ডগুলি স্ট্যান্ডার্ড ফিল্ডের মতোই আচরণ করে। আপনার ডোমেনে ব্যবহারকারীদের আপডেট করার সময় আপনি এগুলি সেট করতে পারেন, 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 মানের ধরণ, ঐচ্ছিক। সম্ভাব্য মানগুলি হল:
  • custom
  • home
  • other
  • work
customType মানের কাস্টম টাইপ, ঐচ্ছিক। type custom এ সেট করা থাকলে অবশ্যই ব্যবহার করা উচিত।

যদি আপডেটের সময় স্কিমার একটি কাস্টম ফিল্ড নির্দিষ্ট না করা থাকে, তাহলে এটি অপরিবর্তিত থাকে। যদি আপডেটের সময় customFields একটি স্কিমা নিজেই নির্দিষ্ট না করা থাকে, তাহলে সেই স্কিমার সমস্ত কাস্টম ফিল্ড অপরিবর্তিত থাকে। একটি প্রোফাইল থেকে একটি কাস্টম ফিল্ড বা একটি কাস্টম স্কিমা মুছে ফেলার জন্য, আপনাকে এটিকে স্পষ্টভাবে null এ সেট করতে হবে:

"schema1": {
  "field1": null // deletes field1 from this profile.
}

JSON অনুরোধ

নিচের উদাহরণে দেওয়া কলটি একজন ব্যবহারকারীকে আপডেট করে এবং employmentData কাস্টম স্কিমার জন্য মান সেট করে:

PATCH https://admin.googleapis.com/admin/directory/v1/users/liz@example.com

{
  "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 অথবা users.list অনুরোধে projection প্যারামিটারটি custom অথবা full সেট করে একটি ব্যবহারকারী প্রোফাইলে কাস্টম ক্ষেত্র আনতে পারেন।

ব্যবহারকারীর প্রোফাইলে কাস্টম ক্ষেত্রগুলি অনুসন্ধান করুন

আপনি users.list অনুরোধে query প্যারামিটার ব্যবহার করে কাস্টম ফিল্ডের মধ্যে অনুসন্ধান করতে পারেন। আপনি schemaName.fieldName সিনট্যাক্স ব্যবহার করে কাস্টম ফিল্ডের জন্য অনুরোধ করতে পারেন। উদাহরণস্বরূপ:

employmentData.projects:"GeneGnome"

GeneGnome প্রকল্পে কাজ করা সকল কর্মচারীকে ফেরত পাঠায়। কোয়েরিটি

employmentData.location="Atlanta" employmentData.jobLevel>=7

আটলান্টার সকল কর্মচারীকে চাকরির স্তর ৭ এর উপরে ফিরিয়ে দেয়। আরও তথ্যের জন্য, ব্যবহারকারীদের অনুসন্ধান করুন দেখুন।

একটি কাস্টম ব্যবহারকারী স্কিমা তৈরি করুন

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

কাস্টম স্কিমা সীমা

  • একটি অ্যাকাউন্টে অনুমোদিত কাস্টম স্কিমার সর্বাধিক সংখ্যা ১০০টি।
  • একটি অ্যাকাউন্টে অনুমোদিত কাস্টম ফিল্ডের সর্বোচ্চ সংখ্যা ১০০টি।
  • একটি একক-মূল্যবান কাস্টম ক্ষেত্রের জন্য একটি string ক্ষেত্রে অনুমোদিত অক্ষরের সর্বাধিক সংখ্যা 500। বহু-মূল্যবান কাস্টম ক্ষেত্রের জন্য, অনুমোদিত উপাদানের সংখ্যা নির্ধারিত মানের আকারের উপর নির্ভর করে। উদাহরণস্বরূপ, আপনি 100 অক্ষরের প্রতিটির 150টি মান বা 500 অক্ষরের প্রতিটির 50টি মান যোগ করতে পারেন।
  • কাস্টম স্কিমা এবং ফিল্ডের নামগুলিতে অনুমোদিত অক্ষরগুলি হল আলফানিউমেরিক অক্ষর, আন্ডারস্কোর ( _ ), এবং হাইফেন ( - )।
  • ক্ষেত্রের ধরণ পরিবর্তন করা অনুমোদিত নয়।
  • একটি একক-মূল্যবান ক্ষেত্রকে বহু-মূল্যবান করা যেতে পারে, কিন্তু বিপরীত ক্রিয়া অনুমোদিত নয়।
  • কাস্টম স্কিমা বা ক্ষেত্রগুলির নাম পরিবর্তন করা সম্ভব নয়।

একটি কাস্টম ব্যবহারকারী স্কিমা আপডেট করুন

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

PUT https://admin.googleapis.com/admin/directory/v1/customer/my_customer or customerId/schemas/schemaKey

JSON অনুরোধ

নিচের উদাহরণে, স্কিমা employmentData তৈরির সময় একটি JobFamily ক্ষেত্র ছিল। অনুরোধটি employmentData আপডেট করে শুধুমাত্র একটি EmployeeNumber ক্ষেত্র ধারণ করছে:

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 অনুরোধটি ব্যবহার করুন এবং Authorize requests এ বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন। 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 অনুরোধটি ব্যবহার করুন এবং Authorize requests এ বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন। অনুরোধ এবং প্রতিক্রিয়া বৈশিষ্ট্যের জন্য, 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"
        }
      ]
    }
  ]
}