পরিচিতি API 19 জানুয়ারী, 2022-এ প্রত্যাখ্যান করা হয়েছিল। আপনি People API-এ স্থানান্তরিত করার সাথে সাথে ফিল্ড, এন্ডপয়েন্ট এবং অনুমোদনের সুযোগের পরিবর্তন সম্পর্কে জানতে এই গাইডটি ব্যবহার করুন।
ওভারভিউ
অন্যান্য পরিচিতিগুলির জন্য নিম্নলিখিত ব্যতিক্রমগুলি সহ সমস্ত বৈশিষ্ট্যের জন্য লোক এপিআই-এর লিগ্যাসি পরিচিতি API-এর মতো একই কার্যকারিতা রয়েছে:
- প্রশাসকদের নতুন সুযোগের মাধ্যমে "অন্যান্য পরিচিতিগুলির" জন্য শুধুমাত্র পড়ার অনুমতি রয়েছে৷ যেহেতু "অন্যান্য পরিচিতি"-এ মিউটেট/রাইট সিগন্যাল ফেরত পাঠানো সমর্থিত নয়, আপনার ব্যবহারকারীরা যদি এর ডেটা ক্ষেত্রগুলি আপডেট করতে চান তবে আমার পরিচিতি হিসাবে অন্য পরিচিতিকে যুক্ত করতে হবে৷ 
- "অন্যান্য পরিচিতি" এর জন্য শুধুমাত্র প্রাথমিক যোগাযোগের তথ্য API এর মাধ্যমে পড়া যাবে। উদাহরণস্বরূপ, পুরো নাম, ইমেল ঠিকানা এবং ফোন নম্বর। 
 অতিরিক্তভাবে, পুরানো পরিচিতি স্কোপ ( https://www.google.com/m8/feeds ), যা ব্যক্তিগত পরিচিতি এবং ডিরেক্টরি তথ্য উভয়ের অ্যাক্সেস প্রদান করে, নিম্নলিখিত স্কোপগুলি দ্বারা প্রতিস্থাপিত হয়েছে:
-  ব্যক্তিগত পরিচিতি অ্যাক্সেস করতে: https://www.googleapis.com/auth/contacts
-  ডিরেক্টরির তথ্য অ্যাক্সেস করতে: https://www.googleapis.com/auth/directory.readonly
পরিচিতি
ক্ষেত্র ম্যাপিং
| যোগাযোগ ক্ষেত্র | ব্যক্তি ক্ষেত্র | 
|---|---|
| পরমাণু: সামগ্রী | জীবনী | 
| atom:link rel='http://schemas.google.com/contacts/2008/rel#photo' | ফটো | 
| পরমাণু: শিরোনাম | নাম | 
| gContact:বিলিং তথ্য | মিসকিওয়ার্ড (টাইপ=OUTLOOK_BILLING_INFORMATION) | 
| জি যোগাযোগ: জন্মদিন | জন্মদিন | 
| gContact: calendarLink | ক্যালেন্ডার ইউআরএল | 
| gContact:directoryServer | মিসকিওয়ার্ড (টাইপ=OUTLOOK_DIRECTORY_SERVER) | 
| gContact:ইভেন্ট | ঘটনা | 
| gContact:extendedProperty | ক্লায়েন্ট ডেটা | 
| gContact:externalId | বাহ্যিক আইডি | 
| gContact:fileAs | fileAses | 
| gContact: লিঙ্গ | লিঙ্গ | 
| gContact:groupMembershipInfo | memberships.contactGroupMembership | 
| gContact: শখ | স্বার্থ | 
| gContact: আদ্যক্ষর | অপ্রচলিত ডাকনাম (টাইপ=প্রাথমিক) | 
| gContact: jot type='home' | মিসকিওয়ার্ড (টাইপ=হোম) | 
| gContact: jot type='কীওয়ার্ড' | মিসকিওয়ার্ড (টাইপ=OUTLOOK_KEYWORD) | 
| gContact: jot type='other' | মিসকিওয়ার্ড (টাইপ=OTHER) | 
| gContact: jot type='user' | মিসকিওয়ার্ড (টাইপ=OUTLOOK_USER) | 
| gContact: jot type='work' | মিসকিওয়ার্ড (টাইপ=ওয়ার্ক) | 
| জি যোগাযোগ: ভাষা | ভাষা | 
| gContact:maidenName | বর্জন করা ডাকনাম (টাইপ=MAIDEN_NAME) | 
| gContact:মাইলেজ | মিসকিওয়ার্ড (টাইপ=OUTLOOK_MILEAGE) | 
| gContact:ডাকনাম | ডাকনাম (টাইপ=ডিফল্ট) | 
| gContact:পেশা | পেশা | 
| জি যোগাযোগ: অগ্রাধিকার | মিসকিওয়ার্ড (টাইপ=OUTLOOK_PRIORITY) | 
| gContact:relation | সম্পর্ক | 
| জি যোগাযোগ: সংবেদনশীলতা | মিসকিওয়ার্ড (টাইপ=OUTLOOK_SENSITIVITY) | 
| gContact:shortName | বর্জন করা ডাকনাম (টাইপ=SHORT_NAME) | 
| জি যোগাযোগ: বিষয় | মিসকিওয়ার্ড (টাইপ=OUTLOOK_SUBJECT) | 
| gContact:userDefinedField | ব্যবহারকারী সংজ্ঞায়িত | 
| g যোগাযোগ: ওয়েবসাইট | ইউআরএল | 
| gContact:yomiName | names.phonetic_full_name | 
| gd:মোছা হয়েছে | metadata.deleted | 
| gd: ইমেইল | ইমেইল ঠিকানা | 
| gd:im | ক্লায়েন্ট | 
| gd: সংগঠন | সংগঠন | 
| gd:ফোন নম্বর | ফোন নাম্বারগুলো | 
| gd: ডাক ঠিকানা | addresses.formattedValue | 
| gd: কোথায় | বাসস্থান | 
| gd:structuredPostalAddress | ঠিকানা | 
ব্যক্তিগত যোগাযোগের শেষ পয়েন্ট
পড়ুন
 https://www.googleapis.com/auth/contacts বা https://www.googleapis.com/auth/contacts.readonly সুযোগ প্রয়োজন।
-  একটি একক নির্দিষ্ট যোগাযোগ people.getপড়ুন
-  কিছু নির্দিষ্ট পরিচিতি পড়ুন people.getBatchGet
-  people.connections.listব্যবহার করে পরিচিতি পড়ুন
মিউটে
 https://www.googleapis.com/auth/contacts স্কোপের প্রয়োজন। ছবি ব্যতীত সমস্ত পরিচিতি ক্ষেত্রগুলিকে পরিবর্তন করে৷
-  people.createContactব্যবহার করে একটি পরিচিতি তৈরি করুন
-  people.updateContactব্যবহার করে একটি বিদ্যমান পরিচিতি আপডেট করুন
-  people.deleteContactব্যবহার করে একটি পরিচিতি মুছুন।
ছবির মিউটেটে
 https://www.googleapis.com/auth/contacts স্কোপের প্রয়োজন।
-  people.updateContactPhotoব্যবহার করে একটি পরিচিতির ছবি আপডেট করুন।
-  people.deleteContactPhotoব্যবহার করে একটি পরিচিতির ছবি মুছুন।
অন্যান্য পরিচিতি এন্ডপয়েন্ট
পড়ুন
 অন্যান্য পরিচিতিগুলি শুধুমাত্র পঠনযোগ্য এবং শুধুমাত্র names , emailAddresses এবং phoneNumbers ক্ষেত্রগুলি ফেরত দেওয়া হয়৷
 https://www.googleapis.com/auth/contacts.other.readonly সুযোগ প্রয়োজন।
-  otherContacts.listব্যবহার করে অন্যান্য পরিচিতি পড়ুন।
কপি
 https://www.googleapis.com/auth/contacts.other.readonly এবং https://www.googleapis.com/auth/contacts স্কোপের প্রয়োজন।
-  otherContacts.copyOtherContactToMyContactsGroupব্যবহার করে অন্যান্য পরিচিতি কপি করুন।
গ্লোবাল অ্যাড্রেস লিস্ট এন্ডপয়েন্ট
 https://www.googleapis.com/auth/directory.readonly সুযোগ প্রয়োজন।
-  সমস্ত ডিরেক্টরি পরিচিতি এবং প্রোফাইলের তালিকা করুন people.listDirectoryPeople.
-  ডিরেক্টরির পরিচিতি এবং প্রোফাইলগুলি খুঁজুন people.searchDirectoryPeople.
যোগাযোগ গ্রুপ
ক্ষেত্র ম্যাপিং
| পরিচিতি API যোগাযোগ গোষ্ঠী ক্ষেত্র | পিপল এপিআই কন্টাক্ট গ্রুপ ফিল্ড | 
|---|---|
| পরমাণু: আপডেট করা হয়েছে | metadata.updateTime | 
| পরমাণু: শিরোনাম | নাম | 
| পরমাণু: সামগ্রী | নাম | 
| gd:মোছা হয়েছে | metadata.deleted | 
| সিস্টেম গ্রুপ | groupType=SYSTEM_CONTACT_GROUP | 
শেষবিন্দু
পড়ুন
 https://www.googleapis.com/auth/contacts বা https://www.googleapis.com/auth/contacts.readonly সুযোগ প্রয়োজন।
-  people.contactGroups.getব্যবহার করে একটি নির্দিষ্ট যোগাযোগ গোষ্ঠী পান
-  people.contactGroups.listব্যবহার করে পরিচিতি গোষ্ঠীর তালিকা করুন
মিউটে
 https://www.googleapis.com/auth/contacts স্কোপের প্রয়োজন।
-  people.contactGroups.createব্যবহার করে একটি পরিচিতি গ্রুপ তৈরি করুন
-  people.contactGroups.updateব্যবহার করে একটি পরিচিতি গোষ্ঠী আপডেট করুন
-  people.contactGroups.deleteব্যবহার করে একটি পরিচিতি গোষ্ঠী মুছুন
- people.contactGroups.members.modifyব্যবহার করে পরিচিতি গোষ্ঠী থেকে পরিচিতি যোগ করুন বা সরান
অনুমোদনের সুযোগ
 লিগ্যাসি স্কোপ https://www.google.com/m8/feeds হল https://www.googleapis.com/auth/contacts স্কোপের একটি উপনাম। এর মানে হল যে লিগ্যাসি স্কোপের সাথে বিদ্যমান শপথ অনুদানগুলি People API-এর যেকোনও এন্ডপয়েন্টের জন্য কাজ করবে যার জন্য https://www.googleapis.com/auth/contacts সুযোগ প্রয়োজন। পড়া এবং লেখার পরিচিতি এবং যোগাযোগ গোষ্ঠীগুলি উত্তরাধিকার সুযোগের সাথে কাজ করবে।
People API-এর "অন্যান্য পরিচিতি" বা ডিরেক্টরি ডেটা অ্যাক্সেস করার জন্য নতুন স্কোপের প্রয়োজন। প্রয়োজনীয় স্কোপের জন্য উপরে বিস্তারিত দেখুন।
আরও বিশদ বিবরণের জন্য, অনুমোদনের অনুরোধগুলি দেখুন।
ক্লায়েন্ট লাইব্রেরি
- অ্যাপস স্ক্রিপ্টের জন্য, অ্যাডভান্সড পিপল সার্ভিস দেখুন।
- অন্যান্য সমর্থিত ভাষার জন্য, ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন দেখুন।