Method: people.getBatchGet

अनुरोध किए गए संसाधनों के नामों की सूची बताकर, कुछ खास लोगों की सूची के बारे में जानकारी देता है. पुष्टि किए गए उपयोगकर्ता की जानकारी देने के लिए, people/me का इस्तेमाल करें.

अगर 'personFields' को अनुरोध में 400 की गड़बड़ी मिलती है मौजूद नहीं है.

एचटीटीपी अनुरोध

GET https://people.googleapis.com/v1/people:batchGet

यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.

क्वेरी पैरामीटर

पैरामीटर
resourceNames[]

string

ज़रूरी है. उन लोगों के रिसॉर्स के नाम जिनके बारे में जानकारी देनी है. इसे दोहराया जा सकता है. यूआरएल क्वेरी पैरामीटर इस तरह का होना चाहिए

resourceNames=<name1>&resourceNames=<name2>&...

  • पुष्टि किए गए उपयोगकर्ता के बारे में जानकारी पाने के लिए, people/me डालें.
  • किसी Google खाते के बारे में जानकारी पाने के लिए, people/{account_id} तय करें.
  • किसी संपर्क के बारे में जानकारी पाने के लिए, उस संसाधन का नाम बताएं जो people.connections.list से मिले संपर्क की पहचान करता है.

ज़्यादा से ज़्यादा 200 संसाधनों के नाम हो सकते हैं.
requestMask
(deprecated)

object (RequestMask)

बहिष्कृत (कृपया इसके बजाय personFields का उपयोग करें)

नतीजों को व्यक्ति फ़ील्ड के सबसेट तक सीमित करने के लिए मास्क.
personFields

string (FieldMask format)

ज़रूरी है. हर व्यक्ति के लिए कौनसे फ़ील्ड दिखाए जाएं, यह तय करने के लिए फ़ील्ड मास्क. एक से ज़्यादा फ़ील्ड तय करने के लिए, उन्हें कॉमा लगाकर अलग करें. मान्य मान हैं:

  • पते
  • ageRanges
  • जीवनियां
  • जन्मदिन
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • इवेंट
  • externalIds
  • लिंग
  • imClients
  • रुचियां
  • स्थान-भाषाएं
  • जगहें
  • की पैसे चुकाकर ली जाने वाली सदस्यताएं
  • मेटाडेटा
  • miscKeywords
  • नाम
  • निकनेम
  • व्यवसाय
  • संगठन
  • phoneNumbers
  • फ़ोटोज
  • संबंध
  • sipAddresses
  • कौशल
  • यूआरएल
  • userDefined
sources[]

enum (ReadSourceType)

ज़रूरी नहीं. किस तरह के सोर्स टाइप को दिखाना है. अगर यह नीति सेट नहीं है, तो डिफ़ॉल्ट तौर पर READ_SOURCE_TYPE_CONTACT और READ_SOURCE_TYPE_PROFILE होती है.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

संसाधन के नाम के हिसाब से लोगों की सूची पाने के अनुरोध का जवाब.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON के काेड में दिखाना 
{
  "responses": [
    {
      object (PersonResponse)
    }
  ]
}
फ़ील्ड
responses[]

object (PersonResponse)

अनुरोध किए गए हर संसाधन के नाम के लिए रिस्पॉन्स.

अनुमति के दायरे

सार्वजनिक डेटा को ऐक्सेस करने के लिए, अनुमति की ज़रूरत नहीं होती. निजी डेटा के लिए, OAuth के इनमें से किसी एक स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/contacts
  • https://www.googleapis.com/auth/contacts.readonly
  • https://www.googleapis.com/auth/contacts.other.readonly
  • https://www.googleapis.com/auth/directory.readonly
  • https://www.googleapis.com/auth/profile.agerange.read
  • https://www.googleapis.com/auth/profile.emails.read
  • https://www.googleapis.com/auth/profile.language.read
  • https://www.googleapis.com/auth/user.addresses.read
  • https://www.googleapis.com/auth/user.birthday.read
  • https://www.googleapis.com/auth/user.emails.read
  • https://www.googleapis.com/auth/user.gender.read
  • https://www.googleapis.com/auth/user.organization.read
  • https://www.googleapis.com/auth/user.phonenumbers.read
  • https://www.googleapis.com/auth/userinfo.email
  • https://www.googleapis.com/auth/userinfo.profile
  • https://www.googleapis.com/auth/profile.language.read

ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.