People API আপনাকে অনুমতি দেয়:
- প্রমাণীকৃত ব্যবহারকারীর পরিচিতি পড়ুন এবং পরিচালনা করুন
- যাচাইকৃত ব্যবহারকারীর "অন্যান্য পরিচিতি" পড়ুন এবং অনুলিপি করুন
- প্রমাণীকৃত ব্যবহারকারী এবং তাদের পরিচিতিদের জন্য প্রোফাইল তথ্য পড়ুন
- ডোমেন প্রোফাইল এবং পরিচিতি পড়ুন
উদাহরণস্বরূপ, ধরুন যে প্রমাণীকৃত ব্যবহারকারী, জেন, তার ব্যক্তিগত পরিচিতিতে ফ্যাবিয়ান এবং রঞ্জিত রয়েছে৷ যখন আপনার অ্যাপ people.connections.list কল করে তার সংযোগগুলির একটি তালিকা পড়তে, জেনকে একটি সম্মতি স্ক্রীন উপস্থাপন করা হয় যাতে অ্যাপটিকে তালিকায় অ্যাক্সেস দিতে বলা হয়। জেন সম্মতি দিলে, অ্যাপটি ফ্যাবিয়ান এবং রঞ্জিতের জন্য person resources সম্বলিত একটি তালিকা পড়ে।
অ্যাপটির যদি কোনো নির্দিষ্ট ব্যক্তির জন্য তথ্যের প্রয়োজন হয়, তাহলে এটি সেই ব্যক্তির জন্য person resource পেতে, একটি সম্পদের নামে পাস করে people.get কল করতে পারে।
অ্যাপটি people.createContact ব্যবহার করে নতুন পরিচিতি তৈরি করে পরিচিতিগুলি পরিচালনা করতে পারে, people.updateContact ব্যবহার করে people.connections.list থেকে পড়া বিদ্যমান পরিচিতিগুলি আপডেট করতে পারে এবং people.deleteContact ব্যবহার করে পরিচিতিগুলি মুছে দিতে পারে।
Google Workspace ব্যবহারকারীরা people.listDirectoryPeople ব্যবহার করে তাদের ডিরেক্টরির ডোমেন প্রোফাইল এবং ডোমেন পরিচিতিগুলি তালিকাভুক্ত করতে পারেন বা people.searchDirectoryPeople ব্যবহার করে সার্চ করতে পারেন।
মানুষের তথ্য একটি একত্রিত দৃশ্য
পিপল এপিআই যে জনগণের তথ্য পড়ে তা নিম্নলিখিত শর্তগুলির উপর নির্ভর করে বিভিন্ন উত্স থেকে একত্রিত করা হয়:
| উৎস | অবস্থা |
|---|---|
| সর্বজনীন Google প্রোফাইল ডেটা | সর্বদা. |
| Google Workspace ডোমেন প্রোফাইল ডেটা | ডোমেন প্রশাসক ডোমেন-স্কোপড ডেটার বাহ্যিক যোগাযোগ এবং প্রোফাইল শেয়ারিং সক্ষম করেছে এবং directory.readonly স্কোপ মঞ্জুর করা হয়েছে |
| প্রমাণীকৃত ব্যবহারকারীর ব্যক্তিগত প্রোফাইল তথ্য | profile স্কোপের একটি মঞ্জুর করা হয়েছে। |
| প্রমাণীকৃত ব্যবহারকারীর পরিচিতি | contacts সুযোগ মঞ্জুর করা হয়েছে. |
একত্রিত ব্যক্তি ডেটা বোঝা
একজন ব্যক্তির জন্য তথ্য একটি প্রধান উৎস প্রকার থেকে প্রাপ্ত করা হয়. অন্যান্য উত্স থেকে ডেটা এই ডেটার সাথে মার্জ করা হয় যদি উত্সগুলি যাচাই করা ইমেল ঠিকানা, ফোন নম্বর বা প্রোফাইল URL এর মাধ্যমে সংযুক্ত থাকে৷ এই উপায়ে একজন ব্যক্তি রচনা করা যেতে পারে:
| প্রধান উৎস | পরিচিতি | প্রোফাইল | Google Workspace ডোমেন প্রোফাইল | Google Workspace ডোমেনের পরিচিতি | ব্যবহার |
|---|---|---|---|---|---|
| যোগাযোগ | 1 | 0+ | 0+ | 0+ | বেশিরভাগ এন্ডপয়েন্টের জন্য ফিরে এসেছে |
| প্রোফাইল | 0+ | 1 | 0 বা 1 | 0 | people.get এ ফিরে এসেছে যখন এটি সাইন-ইন করা ব্যবহারকারীর জন্য ব্যক্তি পেতে বা অন্য ব্যবহারকারীর Google অ্যাকাউন্টের জন্য একজন ব্যক্তিকে পেতে ব্যবহার করা হয়। |
| ডোমেন যোগাযোগ | 0+ | 0 | 0 | 1 | people.listDirectoryPeople বা people.searchDirectoryPeople এ ফিরে এসেছে। |
মিউটেশন এন্ডপয়েন্ট দ্বারা শুধুমাত্র যোগাযোগ ভিত্তিক ব্যক্তিদের পরিবর্তন করা যেতে পারে। প্রোফাইল এবং ডোমেন যোগাযোগের মিউটেশন সমর্থিত নয়।