Method: people.getBatchGet

İstenen kaynak adlarının bir listesini belirterek belirli kişilerin bir listesi hakkında bilgi sağlar. Kimliği doğrulanmış kullanıcıyı belirtmek için people/me değerini kullanın.

"personFields" belirtilmezse istek 400 hatası döndürür.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Sorgu parametreleri

Parametreler
resourceNames[]

string

Zorunlu. Hakkında bilgi verilecek kişilerin kaynak adları. Tekrarlanabilir. URL sorgu parametresi

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

  • Kimliği doğrulanmış kullanıcı hakkında bilgi almak için people/me değerini belirtin.
  • Bir Google Hesabı hakkında bilgi almak için people/{account_id} değerini belirtin.
  • Bir kişi hakkında bilgi almak için, people.connections.list tarafından döndürülen kişiyi tanımlayan kaynak adını belirtin.

En fazla 200 kaynak adı olabilir.
requestMask
(deprecated)

object (RequestMask)

KULLANIMDAN KALDIRILDI (Lütfen bunun yerine personFields değerini kullanın)

Sonuçları, kişi alanlarının bir alt kümesiyle sınırlayan maske.
personFields

string (FieldMask format)

Zorunlu. Her bir kişide döndürülecek alanları kısıtlayan bir alan maskesi. Virgülle ayırarak birden çok alan belirtilebilir. Geçerli değerler şunlardır:

  • adresler
  • ageRanges
  • biyografiler
  • doğum günleri
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • etkinlikler
  • externalIds
  • cinsiyetler
  • imClients
  • ilgi alanları
  • locales
  • konumlar
  • memberships
  • meta veri
  • miscKeywords
  • isimler
  • takma adlar
  • meslekler
  • kuruluşlar
  • phoneNumbers
  • fotoğraflar
  • ilişkiler
  • sipAddresses
  • beceriler
  • urller
  • userDefined
sources[]

enum (ReadSourceType)

İsteğe bağlı. Döndürülecek kaynak türlerinin maskesi. Ayarlanmamışsa varsayılan olarak READ_SOURCE_TYPE_CONTACT ve READ_SOURCE_TYPE_PROFILE değerlerine ayarlanır.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Kaynak adına göre kullanıcı listesi için get isteğinin yanıtı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "responses": [
    {
      object (PersonResponse)
    }
  ]
}
Alanlar
responses[]

object (PersonResponse)

İstenen her kaynak adı için yanıt.

Yetkilendirme kapsamları

Herkese açık verilere erişmek için yetkilendirme gerekmez. Gizli veriler için aşağıdaki OAuth kapsamlarından biri gereklidir:

  • 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

Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.