Contacts API माइग्रेशन गाइड

Contacts API 19 जनवरी, 2022 को बंद कर दिया गया था. लोगों एपीआई पर माइग्रेट करते समय, फ़ील्ड, एंडपॉइंट, और ऑथराइज़ेशन के दायरे में होने वाले बदलावों के बारे में जानने के लिए, इस गाइड का इस्तेमाल करें.

खास जानकारी

सभी सुविधाओं के लिए, पीपल एपीआई वही काम करता है जो लेगसी Contacts API में होता है. हालांकि, अन्य संपर्क के मामले में यहां दिए गए अपवाद लागू होते हैं:

  • एडमिन के पास नए स्कोप के तहत, "अन्य संपर्कों" के लिए रीड ओनली ऐक्सेस है. क्योंकि "अन्य संपर्कों" में बदलाव करने/लिखने के सिग्नल वापस भेजने की सुविधा नहीं है, इसलिए अगर आपके उपयोगकर्ता अपने डेटा फ़ील्ड अपडेट करना चाहते हैं, तो उन्हें अन्य संपर्क को मेरे संपर्क के रूप में जोड़ना होगा.

  • एपीआई का इस्तेमाल करके, "अन्य संपर्कों" की सिर्फ़ बुनियादी संपर्क जानकारी पढ़ी जा सकती है. उदाहरण के लिए, पूरा नाम, ईमेल पता, और फ़ोन नंबर.

इसके अलावा, निजी संपर्क और डायरेक्ट्री की जानकारी, दोनों का ऐक्सेस देने वाले पुराने संपर्क दायरे (https://www.google.com/m8/feeds) को इन दायरों से बदल दिया गया है:

  • निजी संपर्कों को ऐक्सेस करने के लिए: https://www.googleapis.com/auth/contacts
  • डायरेक्ट्री की जानकारी ऐक्सेस करने के लिए: https://www.googleapis.com/auth/directory.readonly

संपर्क

फ़ील्ड मैपिंग

संपर्क फ़ील्ड व्यक्ति वाला फ़ील्ड
atom:content जीवनी
Atom:link rel='http://schemas.google.com/contacts/2008/rel#photo' फ़ोटो
atom:title names
gContact:बिलिंग जानकारी गलत कीवर्ड (टाइप=OUTLOOK_BILLING_INFORMATION)
gContact:जन्मदिन जन्मदिन
gContact:calendarLink calendarUrls
gContact:directoryServer गलत कीवर्ड (type=OUTLOOK_DIRECTORY_SERVER)
gContact:इवेंट इवेंट
gContact:extendedप्रॉपर्टी clientData
gContact:externalId externalIds
gContact:fileAs fileAses
gContact:लिंग लिंग
gContact:groupMembershipInfo memberships.contactGroupMembership
gContact:शौक दिलचस्पी
gContact:नाम के पहले अक्षर रोक दिया गया निकनेम (type=INITIALS)
gContact:jot type='home' गलत कीवर्ड (type=HOME)
gContact:jot type='keyword' गलत कीवर्ड (type=OUTLOOK_KEYWORD)
gContact:jot type='other' गलत कीवर्ड (type=OTHER)
gContacts:jot type='user' गलत कीवर्ड (टाइप=OUTLOOK_USER)
gContact:jot type='work' गलत कीवर्ड (टाइप=वर्क)
gContact:भाषा भाषाएं
gContact:maidenName रोक दिया गया निकनेम (type=MAIDEN_NAME)
gContact:माइलेज गलत कीवर्ड (टाइप=OUTLOOK_MILEAGE)
gcontact:दूसरा नाम निकनेम (टाइप=डिफ़ॉल्ट)
gContact:रोज़गार पेशे
gContact:प्राथमिकता गलत कीवर्ड (टाइप=OUTLOOK_PRIORITY)
gContact:रिलेशन रिलेशन
gContact:संवेदनशीलता गलत कीवर्ड (टाइप=OUTLOOK_SENSITIVITY)
gContact:shortName रोक दिया गया निकनेम (टाइप=SHORT_NAME)
gContact:विषय गलत कीवर्ड (टाइप=OUTLOOK_SUBJECT)
gContact:user कैफ़िक्शन फ़ील्ड userDefined
gContact:वेबसाइट urls
gContact:yomiName names.phonetic_full_name
gd:मिटाया गया metadata.deleted
gd:email emailAddresses
gd:im imClients
gd:संगठन organizations
gd:phoneNumber phoneNumbers
gd:postalAddress 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 स्कोप ज़रूरी है.

ग्लोबल अड्रेस लिस्ट एंडपॉइंट

https://www.googleapis.com/auth/directory.readonly का दायरा ज़रूरी है.

  • डायरेक्ट्री में मौजूद सभी संपर्कों और प्रोफ़ाइलों की सूची बनाएं people.listDirectoryPeople.
  • डायरेक्ट्री के संपर्क और प्रोफ़ाइल खोजें people.searchDirectoryPeople.

संपर्क समूह

फ़ील्ड मैपिंग

Contacts API संपर्क ग्रुप का फ़ील्ड लोगों के एपीआई संपर्क ग्रुप का फ़ील्ड
ऐटम:अपडेट किया गया metadata.updateTime
atom:title name
atom:content name
gd:मिटाया गया metadata.deleted
systemGroup 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 स्कोप के लिए उपनाम है. इसका मतलब है कि लेगसी स्कोप के साथ मौजूदा oauth अनुदान, People API में ऐसे किसी भी एंडपॉइंट के लिए काम करेंगे जिसे https://www.googleapis.com/auth/contacts स्कोप की ज़रूरत होती है. संपर्कों और संपर्क ग्रुप को पढ़ने और लिखने की सुविधा, लेगसी स्कोप के साथ काम करेगी.

"अन्य संपर्क" या डायरेक्ट्री डेटा को ऐक्सेस करने के लिए, People API को नए स्कोप की ज़रूरत है. ज़रूरी दायरों के बारे में ऊपर जानकारी देखें.

ज़्यादा जानकारी के लिए, अनुरोधों को अनुमति देना देखें.

क्लाइंट लाइब्रेरी