Method: people.get

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 tarafından döndürüldüğü şekliyle tanımlayan kaynak adını belirtin.

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/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.