Method: people.getBatchGet

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

"personFields" belirtilmemişse 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ı. Tekrar 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, kişiyi people.connections.list tarafından döndürüldüğü şekliyle tanımlayan kaynak adını belirtin.

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

object (RequestMask)

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

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

string (FieldMask format)

Zorunlu. Her kişide hangi alanların döndürüleceğini sınırlayan bir alan maskesi. Virgülle ayırarak birden çok alan belirtilebilir. Valid values are:

  • addresses
  • ageRanges
  • biyografiler
  • doğum günleri
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • etkinlikler
  • externalIds
  • cinsiyetler
  • imClients
  • ilgi alanları
  • locales
  • konumlar
  • memberships
  • metadata
  • miscKeywords
  • names
  • takma adlar
  • meslekler
  • organizations
  • phoneNumbers
  • fotoğraflar
  • ilişkiler
  • sipAddresses
  • beceriler
  • urls
  • 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 olur.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Kaynak adına göre kişi listesi alma isteğine verilen 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ının 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ılavuzu'na bakın.