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
  • रुचियां
  • locales
  • जगहें
  • की पैसे चुकाकर ली जाने वाली सदस्यताएं
  • मेटाडेटा
  • 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

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