Method: people.getBatchGet
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
İ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
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:
| 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/contactshttps://www.googleapis.com/auth/contacts.readonlyhttps://www.googleapis.com/auth/contacts.other.readonlyhttps://www.googleapis.com/auth/directory.readonlyhttps://www.googleapis.com/auth/profile.agerange.readhttps://www.googleapis.com/auth/profile.emails.readhttps://www.googleapis.com/auth/profile.language.readhttps://www.googleapis.com/auth/user.addresses.readhttps://www.googleapis.com/auth/user.birthday.readhttps://www.googleapis.com/auth/user.emails.readhttps://www.googleapis.com/auth/user.gender.readhttps://www.googleapis.com/auth/user.organization.readhttps://www.googleapis.com/auth/user.phonenumbers.readhttps://www.googleapis.com/auth/userinfo.emailhttps://www.googleapis.com/auth/userinfo.profilehttps://www.googleapis.com/auth/profile.language.read
Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2024-11-08 UTC.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2024-11-08 UTC."],[[["Retrieves information about a list of specific people, including the authenticated user, by specifying resource names."],["Requires the `personFields` query parameter to specify desired data fields and returns a 400 error if it's missing."],["Supports various authorization scopes for accessing private data, although public data requires no authorization."],["Returns a JSON response containing an array of `PersonResponse` objects, each corresponding to a requested resource name."],["Uses the `GET` HTTP method and the `https://people.googleapis.com/v1/people:batchGet` endpoint with gRPC Transcoding syntax."]]],["This outlines how to retrieve information about specific people using the `people:batchGet` endpoint via a `GET` HTTP request. You must provide `resourceNames` (up to 200) in the query, identifying each person (e.g., `people/me` or `people/{account_id}`). The `personFields` parameter is required to specify which person attributes to include. The request body is empty. The response returns an array of `PersonResponse` objects, one for each requested resource name, and requires authorization scopes for private data. A 400 error is returned if 'personFields' are not provided.\n"]]
