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
स्कोप ज़रूरी है.
otherContacts.copyOtherContactToMyContactsGroup
का इस्तेमाल करके दूसरे संपर्कों को कॉपी करें.
ग्लोबल अड्रेस लिस्ट एंडपॉइंट
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 को नए स्कोप की ज़रूरत है. ज़रूरी दायरों के बारे में ऊपर जानकारी देखें.
ज़्यादा जानकारी के लिए, अनुरोधों को अनुमति देना देखें.
क्लाइंट लाइब्रेरी
- Apps Script के लिए, लोगों को दी जाने वाली बेहतर सेवा देखें.
- इस्तेमाल की जा सकने वाली अन्य भाषाओं के लिए, क्लाइंट लाइब्रेरी इंस्टॉल करें देखें.