Method: people.get
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Kaynak adı belirterek bir kişi 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/{resourceName=people/*}
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
| Parametreler |
resourceName |
string
Zorunlu. Hakkında bilgi verilecek kişinin kaynak adı.
- 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
|
Sorgu parametreleri
| Parametreler |
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. Kişide döndürülecek alanları kısıtlamak için kullanılan 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_PROFILE ve READ_SOURCE_TYPE_CONTACT olur.
|
İstek içeriği
İstek metni boş olmalıdır.
Yanıt metni
Başarılıysa yanıt metni, Person öğesinin bir örneğini içerir.
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ılavuzu'na 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-08-06 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-08-06 UTC."],[[["Retrieves information about a person, including the authenticated user using `people/me` or by specifying a resource name."],["Requires the `personFields` query parameter to specify which fields to include in the response, otherwise, it returns a 400 error."],["Allows filtering the source of the data using the `sources[]` parameter and supports various authorization scopes for accessing private data."],["Uses a `GET` request to the `https://people.googleapis.com/v1/{resourceName=people/*}` endpoint with optional query parameters."],["Response includes a [Person](/people/api/rest/v1/people#Person) object containing the requested information if successful."]]],["This outlines how to retrieve person information via a `GET` request to `https://people.googleapis.com/v1/{resourceName=people/*}`. The `resourceName` path parameter specifies the person (e.g., `people/me` for the authenticated user). The `personFields` query parameter is mandatory and dictates the data returned. The request body must be empty. A successful request returns a `Person` resource. Authorization is needed for private data. A `400` error is returned if `personFields` is not specified.\n"]]
