ডিরেক্টরি API: ব্যবহারকারীর উপনাম

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

ব্যবহারকারীর অ্যালিয়াস হলো একটি বিকল্প ইমেল ঠিকানা যা ব্যবহারকারীর প্রাথমিক ইমেল ঠিকানার জন্য ব্যবহৃত একই মেইলবক্স ব্যবহার করে। ব্যবহারকারীর অ্যালিয়াস তার প্রাথমিক ইমেল ঠিকানার ব্যবহৃত ডোমেইন থেকে ভিন্ন কোনো অ্যাকাউন্ট ডোমেইনের সাথে যুক্ত করা যেতে পারে। ২৪ ঘণ্টার মধ্যে (প্রায়শই তার আগেও), ব্যবহারকারী এই ঠিকানায় পাঠানো ইমেল পেতে শুরু করেন। ব্যবহারকারীর অ্যালিয়াস তৈরি করার আগে এপিআই -এর জন্য ডোমেইনের মালিকানা নিশ্চিত করা আবশ্যক। গেস্ট ব্যবহারকারীদের জন্য অ্যালিয়াস সমর্থিত নয়।

একটি ইউজার অ্যালিয়াস তৈরি করতে, নিম্নলিখিত POST অনুরোধটি ব্যবহার করুন এবং 'অনুমোদন অনুরোধ' অংশে বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন। userKey হতে পারে ব্যবহারকারীর প্রাথমিক ইমেল ঠিকানা, ইউজার id , অথবা যেকোনো ইউজার অ্যালিয়াসের ইমেল। অনুরোধ এবং প্রতিক্রিয়ার প্রোপার্টিগুলোর জন্য, এপিআই রেফারেন্স দেখুন।

POST https://admin.googleapis.com/admin/directory/v1/users/userKey/aliases

JSON অনুরোধ

নিম্নলিখিত JSON অনুরোধটি একজন ব্যবহারকারীর অ্যালিয়াস তৈরি করার একটি নমুনা। ব্যবহারকারী হলেন liz@example.com এবং অ্যালিয়াসটি হলো chica@example.com:

POST https://admin.googleapis.com/admin/directory/v1/users/liz@example.com/aliases
অনুরোধের মূল অংশে নতুন উপনামের তথ্য রয়েছে:
{  
 "alias": "chica@example.com"
}

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

একজন ব্যবহারকারীর সমস্ত ছদ্মনাম পুনরুদ্ধার করুন

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

GET https://admin.googleapis.com/admin/directory/v1/users/userKey/aliases
উদাহরণস্বরূপ, এই অনুরোধ URI-টি `liz@example.com` userKey-এর জন্য সমস্ত উপনাম (alias) ফেরত দেয়:
GET https://admin.googleapis.com/admin/directory/v1/users/liz@example.com/aliases

ব্যবহারকারীর সমস্ত উপনাম বর্ণানুক্রমিকভাবে ফেরত দেওয়া হয়। 'সমস্ত উপনাম পুনরুদ্ধার করুন' প্রতিক্রিয়ার জন্য ব্যবহৃত maxResults কোয়েরি স্ট্রিং বা পেজিনেশনের মতো কোনো পৃষ্ঠা আকার নেই।

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

একটি সফল প্রতিক্রিয়া একটি HTTP 200 স্ট্যাটাস কোড ফেরত দেয়। স্ট্যাটাস কোডের পাশাপাশি, প্রতিক্রিয়াটি ব্যবহারকারীর অ্যালিয়াসগুলো বর্ণানুক্রমিকভাবে ফেরত দেয়। এই অ্যালিয়াস ডোমেইনগুলো হলো অ্যাকাউন্টের প্রাথমিক ডোমেইন এবং অন্যান্য একাধিক ডোমেইন:

{
"kind": "directory#user#aliases",
"aliases": [
 {
  "kind": "directory#user#alias",
  "id": "the unique user id",
  "primary_email": "liz@example.com",
  "alias": "chica@example.com"
 },
 {
  "kind": "directory#user#alias",
  "id": "the unique user id",
  "primary_email": "liz@example.com",
  "alias": "support@example.com"
 },
 {
  "kind": "directory#user#alias",
  "id": "the unique user id",
  "primary_email": "liz@example.com",
  "alias": "help@hr.example.com"
 },
 {
  "kind": "directory#user#alias",
  "id": "the unique user id",
  "primary_email": "liz@example.com",
  "alias": "tickets@jumboinc.com"
 }
]
}

একজন ব্যবহারকারীর ছদ্মনাম মুছে ফেলুন

ব্যবহারকারীর অ্যালিয়াস মুছে ফেলার জন্য, নিম্নলিখিত DELETE অনুরোধটি ব্যবহার করুন এবং 'অনুরোধ অনুমোদন করুন' অংশে বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন। অ্যালিয়াসটি মুছে যেতে ২৪ ঘন্টা পর্যন্ত সময় লাগতে পারে। userKey হতে পারে ব্যবহারকারীর প্রাথমিক ইমেল ঠিকানা, ব্যবহারকারী id , অথবা ব্যবহারকারীর যেকোনো অ্যালিয়াসের ইমেল। এবং aliasId হলো সেই অ্যালিয়াসের ইমেল ঠিকানা যা মুছে ফেলা হচ্ছে। অনুরোধ এবং প্রতিক্রিয়ার বৈশিষ্ট্যগুলির জন্য, এপিআই রেফারেন্স দেখুন।

DELETE https://admin.googleapis.com/admin/directory/v1/users/userKey/aliases/aliasId
উদাহরণস্বরূপ, এই DELETE অনুরোধটি userKey, liz@example.com-এর জন্য chica@example.com অ্যালিয়াসটি মুছে দেয়:
DELETE https://admin.googleapis.com/admin/directory/v1/users/liz@example.com/aliases/chica@example.com

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