REST Resource: people

Kaynak: Kişi

Kimliği doğrulanmış kullanıcının kişileri ve profil verileri gibi çeşitli veri kaynaklarından birleştirilen kişi hakkındaki bilgiler.

Çoğu alanda birden fazla öğe olabilir. Bir alandaki öğelerin sırası garanti edilmez, ancak boş olmayan her alanda tam olarak bir alanın metadata.primary doğru değerine ayarlandığı garanti edilir.

JSON gösterimi
{
  "resourceName": string,
  "etag": string,
  "metadata": {
    object (PersonMetadata)
  },
  "addresses": [
    {
      object (Address)
    }
  ],
  "ageRange": enum (AgeRange),
  "ageRanges": [
    {
      object (AgeRangeType)
    }
  ],
  "biographies": [
    {
      object (Biography)
    }
  ],
  "birthdays": [
    {
      object (Birthday)
    }
  ],
  "braggingRights": [
    {
      object (BraggingRights)
    }
  ],
  "calendarUrls": [
    {
      object (CalendarUrl)
    }
  ],
  "clientData": [
    {
      object (ClientData)
    }
  ],
  "coverPhotos": [
    {
      object (CoverPhoto)
    }
  ],
  "emailAddresses": [
    {
      object (EmailAddress)
    }
  ],
  "events": [
    {
      object (Event)
    }
  ],
  "externalIds": [
    {
      object (ExternalId)
    }
  ],
  "fileAses": [
    {
      object (FileAs)
    }
  ],
  "genders": [
    {
      object (Gender)
    }
  ],
  "imClients": [
    {
      object (ImClient)
    }
  ],
  "interests": [
    {
      object (Interest)
    }
  ],
  "locales": [
    {
      object (Locale)
    }
  ],
  "locations": [
    {
      object (Location)
    }
  ],
  "memberships": [
    {
      object (Membership)
    }
  ],
  "miscKeywords": [
    {
      object (MiscKeyword)
    }
  ],
  "names": [
    {
      object (Name)
    }
  ],
  "nicknames": [
    {
      object (Nickname)
    }
  ],
  "occupations": [
    {
      object (Occupation)
    }
  ],
  "organizations": [
    {
      object (Organization)
    }
  ],
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ],
  "photos": [
    {
      object (Photo)
    }
  ],
  "relations": [
    {
      object (Relation)
    }
  ],
  "relationshipInterests": [
    {
      object (RelationshipInterest)
    }
  ],
  "relationshipStatuses": [
    {
      object (RelationshipStatus)
    }
  ],
  "residences": [
    {
      object (Residence)
    }
  ],
  "sipAddresses": [
    {
      object (SipAddress)
    }
  ],
  "skills": [
    {
      object (Skill)
    }
  ],
  "taglines": [
    {
      object (Tagline)
    }
  ],
  "urls": [
    {
      object (Url)
    }
  ],
  "userDefined": [
    {
      object (UserDefined)
    }
  ]
}
Alanlar
resourceName

string

Kişi için sunucu tarafından atanan kaynak adı. people/{person_id} biçiminde bir ASCII dizesi.

etag

string

Kaynağın HTTP varlık etiketi. Web önbelleği doğrulaması için kullanılır.

metadata

object (PersonMetadata)

Yalnızca çıkış. Kişiyle ilgili meta veriler.

addresses[]

object (Address)

Kişinin açık adresleri.

ageRange
(deprecated)

enum (AgeRange)

Yalnızca çıkış. KULLANIMDAN KALDIRILDI (Lütfen bunun yerine person.ageRanges kullanın)

Kullanıcının yaş grubu.

ageRanges[]

object (AgeRangeType)

Yalnızca çıkış. Kullanıcının yaş grupları.

biographies[]

object (Biography)

Kişinin biyografileri. Bu alan, kişi kaynakları için bir tekildir.

birthdays[]

object (Birthday)

Kişinin doğum günleri. Bu alan, kişi kaynakları için bir tekildir.

braggingRights[]
(deprecated)

object (BraggingRights)

KULLANIMDAN KALDIRILDI: Bu kişinin övünme hakları olan hiçbir veri döndürülmez.

calendarUrls[]

object (CalendarUrl)

Kullanıcının takvim URL'leri.

clientData[]

object (ClientData)

Kullanıcının müşteri verileri.

coverPhotos[]

object (CoverPhoto)

Yalnızca çıkış. Kişinin kapak fotoğrafları.

emailAddresses[]

object (EmailAddress)

Kullanıcının e-posta adresleri. people.connections.list ve otherContacts.list için e-posta adresi sayısı 100 ile sınırlıdır. Bir Kişi daha fazla e-posta adresine sahipse, people.getBatchGet numaralı telefon aranarak tüm kümeye ulaşılabilir.

events[]

object (Event)

Kişinin etkinlikleri.

externalIds[]

object (ExternalId)

Kullanıcının harici kimlikleri.

fileAses[]

object (FileAs)

Kullanıcının dosya kaliteleri.

genders[]

object (Gender)

Kişinin cinsiyetleri. Bu alan, kişi kaynakları için bir tekildir.

imClients[]

object (ImClient)

Kişinin anlık mesajlaşma istemcileri.

interests[]

object (Interest)

Kişinin ilgi alanları.

locales[]

object (Locale)

Kullanıcının yerel ayar tercihleri.

locations[]

object (Location)

Kullanıcının konumları.

memberships[]

object (Membership)

Kullanıcının grup üyelikleri.

miscKeywords[]

object (MiscKeyword)

Kullanıcının çeşitli anahtar kelimeleri.

names[]

object (Name)

Kişinin adları. Bu alan, kişi kaynakları için bir tekildir.

nicknames[]

object (Nickname)

Kişinin takma adları.

occupations[]

object (Occupation)

Kişinin meslekleri.

organizations[]

object (Organization)

Kişinin geçmiş veya mevcut kuruluşları.

phoneNumbers[]

object (PhoneNumber)

Kişinin telefon numaraları. people.connections.list ve otherContacts.list için telefon numarası sayısı 100 ile sınırlıdır. Bir Kişi daha fazla telefon numarasına sahipse tüm gruba people.getBatchGet aranarak ulaşılabilir.

photos[]

object (Photo)

Yalnızca çıkış. Kişinin fotoğrafları.

relations[]

object (Relation)

Kişinin ilişkileri.

relationshipInterests[]
(deprecated)

object (RelationshipInterest)

Yalnızca çıkış. KULLANIMDAN KALDIRILDI: Hiçbir veri döndürülmez. Kişinin ilişkisine dair menfaatler.

relationshipStatuses[]
(deprecated)

object (RelationshipStatus)

Yalnızca çıkış. KULLANIMDAN KALDIRILDI: Kişinin ilişki durumları hiçbir veri döndürülmez.

residences[]
(deprecated)

object (Residence)

KULLANIMDAN KALDIRILDI: (Lütfen bunun yerine person.locations kullanın) Kişinin ikamet ettiği yerler.

sipAddresses[]

object (SipAddress)

Kişinin SIP adresleri.

skills[]

object (Skill)

Kişinin becerileri.

taglines[]
(deprecated)

object (Tagline)

Yalnızca çıkış. KULLANIMDAN KALDIRILDI: Kullanıcının kısa açıklamaları hiçbir veri döndürülmez.

urls[]

object (Url)

Kullanıcının ilişkili URL'leri.

userDefined[]

object (UserDefined)

Kişinin kullanıcı tarafından tanımlanan verileri.

PersonMetadata

Bir kişi hakkındaki meta veriler.

JSON gösterimi
{
  "sources": [
    {
      object (Source)
    }
  ],
  "previousResourceNames": [
    string
  ],
  "linkedPeopleResourceNames": [
    string
  ],
  "deleted": boolean,
  "objectType": enum (ObjectType)
}
Alanlar
sources[]

object (Source)

Kişiyle ilgili veri kaynakları.

previousResourceNames[]

string

Yalnızca çıkış. Bu kişinin sahip olduğu eski kaynak adları. Yalnızca senkronizasyon jetonu içeren people.connections.list istekleri için doldurulur.

Kaynak adı; doğrulanmış e-posta, doğrulanmış telefon numarası veya profil URL'si gibi bir kişi ile profili birbirine bağlayan alanlar eklenirken veya kaldırılırken değişebilir.

linkedPeopleResourceNames[]

string

Yalnızca çıkış. Bu kaynağa bağlı kişilerin kaynak adları.

deleted

boolean

Yalnızca çıkış. Kişi kaynağı silindiyse doğru değerini döndürür. Yalnızca people.connections.list ve otherContacts.list senkronizasyon isteği için doldurulur.

objectType
(deprecated)

enum (ObjectType)

Yalnızca çıkış. KULLANIMDAN KALDIRILDI (Lütfen bunun yerine person.metadata.sources.profileMetadata.objectType kullanın)

Kişi nesnesinin türü.

Kaynak

Bir alanın kaynağı.

JSON gösterimi
{
  "type": enum (SourceType),
  "id": string,
  "etag": string,
  "updateTime": string,

  // Union field metadata can be only one of the following:
  "profileMetadata": {
    object (ProfileMetadata)
  }
  // End of list of possible types for union field metadata.
}
Alanlar
type

enum (SourceType)

Kaynak türü.

id

string

Sunucu tarafından oluşturulan kaynak türü içindeki benzersiz tanımlayıcı.

etag

string

Yalnızca person.metadata.sources dilinde doldurulur.

Kaynağın HTTP varlık etiketi. Web önbelleği doğrulaması için kullanılır.

updateTime

string (Timestamp format)

Yalnızca çıkış. Yalnızca person.metadata.sources dilinde doldurulur.

Bu kaynağın son güncelleme zaman damgası.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

Birleştirme alanı metadata. Yalnızca person.metadata.sources dilinde doldurulur.

Kaynakla ilgili meta veriler. metadata şunlardan yalnızca biri olabilir:

profileMetadata

object (ProfileMetadata)

Yalnızca çıkış. Yalnızca person.metadata.sources dilinde doldurulur.

PROFILE türündeki bir kaynakla ilgili meta veriler.

SourceType

Kaynağın türü.

Sıralamalar
SOURCE_TYPE_UNSPECIFIED Belirtilmedi.
ACCOUNT Google Hesabı.
PROFILE Google profili. Profili https://profiles.google.com/{id} adresinde görüntüleyebilirsiniz. Burada {id}, kaynak kimliğidir.
DOMAIN_PROFILE Google Workspace alan profili.
CONTACT Google kişisi. Kişiyi https://contact.google.com/{id} adresinde görüntüleyebilirsiniz. Burada {id}, kaynak kimliğidir.
OTHER_CONTACT Google "Diğer kişi".
DOMAIN_CONTACT Google Workspace alanında paylaşılan kişi.

ProfileMetadata

Bir profil hakkındaki meta veriler.

JSON gösterimi
{
  "objectType": enum (ObjectType),
  "userTypes": [
    enum (UserType)
  ]
}
Alanlar
objectType

enum (ObjectType)

Yalnızca çıkış. Profil nesnesinin türü.

userTypes[]

enum (UserType)

Yalnızca çıkış. Kullanıcı yazar.

ObjectType

Kişi nesnesinin türü.

Sıralamalar
OBJECT_TYPE_UNSPECIFIED Belirtilmedi.
PERSON Kişi.
PAGE Currents Sayfası.

UserType

Kullanıcının türü.

Sıralamalar
USER_TYPE_UNKNOWN Kullanıcı türü bilinmiyor.
GOOGLE_USER Kullanıcı, bir Google kullanıcısıdır.
GPLUS_USER Kullanıcı bir Currents kullanıcısı.
GOOGLE_APPS_USER Kullanıcı, Google Workspace kullanıcısıdır.

Adres

Bir kişinin fiziksel adresi. Posta kutusu olabilir bir kutu veya açık adres görürsünüz. Tüm alanlar isteğe bağlıdır.

JSON gösterimi
{
  "metadata": {
    object (FieldMetadata)
  },
  "formattedValue": string,
  "type": string,
  "formattedType": string,
  "poBox": string,
  "streetAddress": string,
  "extendedAddress": string,
  "city": string,
  "region": string,
  "postalCode": string,
  "country": string,
  "countryCode": string
}
Alanlar
metadata

object (FieldMetadata)

Adresle ilgili meta veriler.

formattedValue

string

Adresin yapılandırılmamış değeri. Bu özellik kullanıcı tarafından ayarlanmazsa otomatik olarak yapılandırılmış değerlerden oluşturulur.

type

string

Adresin türü. Tür, özel veya önceden tanımlanmış şu değerlerden biri olabilir:

  • home
  • work
  • other
formattedType

string

Yalnızca çıkış. Görüntüleyenin hesap yerel ayarında veya Accept-Language HTTP üstbilgisi yerel ayarında çevrilen ve biçimlendirilen adresin türü.

poBox

string

Posta kutusuna ekleyebilirsiniz.

streetAddress

string

Açık adres.

extendedAddress

string

Adresin genişletilmiş adresi; Örneğin, apartman numarası.

city

string

Adresin bulunduğu şehir.

region

string

Adresin bölgesi; Örneğin eyalet veya il.

postalCode

string

Adresin posta kodu.

country

string

Adresin bulunduğu ülke.

countryCode

string

Adresin ISO 3166-1 alpha-2 ülke kodu.

FieldMetadata

Bir alanla ilgili meta veriler.

JSON gösterimi
{
  "primary": boolean,
  "sourcePrimary": boolean,
  "verified": boolean,
  "source": {
    object (Source)
  }
}
Alanlar
primary

boolean

Yalnızca çıkış. Alan, ilgili kişinin tüm kaynakları için birincil alansa doğru değerini döndürür. Her kullanıcı, primary doğru değerine ayarlanmış en fazla bir alana sahip olur.

sourcePrimary

boolean

Bu alan source için birincil alansa doğru değerini döndürür. Her kaynakta, sourcePrimary doğru değerine ayarlanmış en fazla bir alan olmalıdır.

verified

boolean

Yalnızca çıkış. Alan doğrulanmışsa True (doğru) değerini alır; Alan doğrulanmamışsa false (yanlış) değerini alır. Doğrulanmış alan genellikle kullanıcının sahibi olduğu onaylanan bir ad, e-posta adresi, telefon numarası veya web sitesidir.

source

object (Source)

Alanın kaynağı.

Yaş Aralığı

KULLANIMDAN KALDIRILDI (Lütfen bunun yerine person.ageRanges kullanın)

Bir kişinin yaş grubu.

Sıralamalar
AGE_RANGE_UNSPECIFIED Belirtilmedi.
LESS_THAN_EIGHTEEN On sekiz yaşından küçük olanlar.
EIGHTEEN_TO_TWENTY On sekiz ile yirmi arasında.
TWENTY_ONE_OR_OLDER Yirmi bir ve üzeri yaşta.

AgeRangeType

Bir kişinin yaş grubu.

JSON gösterimi
{
  "metadata": {
    object (FieldMetadata)
  },
  "ageRange": enum (AgeRange)
}
Alanlar
metadata

object (FieldMetadata)

Yaş aralığıyla ilgili meta veriler.

ageRange

enum (AgeRange)

Yaş grubu.

Biyografi

Bir kişinin kısa biyografisi.

JSON gösterimi
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "contentType": enum (ContentType)
}
Alanlar
metadata

object (FieldMetadata)

Biyografiyle ilgili meta veriler.

value

string

Kısa biyografi.

contentType

enum (ContentType)

Biyografinin içerik türü.

ContentType

İçeriğin türü.

Sıralamalar
CONTENT_TYPE_UNSPECIFIED Belirtilmedi.
TEXT_PLAIN Düz metin.
TEXT_HTML HTML metni.

Doğum Günü

Bir kişinin doğum günü. date ve text alanlarından en az biri belirtilmiş. date ve text alanları genellikle aynı tarihi temsil eder ancak garanti edilmez. Müşteriler, doğum günlerini değiştirirken her zaman date alanını ayarlamalıdır.

JSON gösterimi
{
  "metadata": {
    object (FieldMetadata)
  },
  "date": {
    object (Date)
  },
  "text": string
}
Alanlar
metadata

object (FieldMetadata)

Doğum günüyle ilgili meta veriler.

date

object (Date)

Yapılandırılmış doğum tarihi.

text
(deprecated)

string

Ayarlanmışsa date alanını kullanmayı tercih edin.

Kullanıcının doğum gününü temsil eden serbest biçimli bir dize. Bu değer doğrulanmadı.

Tarih

Takvimin tamamını veya bir kısmını temsil eder (ör. doğum günü). Günün saati ve saat dilimi başka bir yerde belirtilmiş veya önemsiz. Tarih, Miladi Takvim'e göredir. Bu, aşağıdakilerden birini temsil edebilir:

  • Sıfır olmayan yıl, ay ve gün değerleriyle tam tarih.
  • Bir ay ve gün ile sıfır yıl (örneğin, bir yıl dönümü).
  • Tek başına bir yıl, sıfır ay ve sıfır gün.
  • Sıfır gün içeren bir yıl ve ay (örneğin, kredi kartı son kullanma tarihi).

İlgili türler:

JSON gösterimi
{
  "year": integer,
  "month": integer,
  "day": integer
}
Alanlar
year

integer

Tarihin yılı. 1 ile 9999 arasında veya yıl içermeyen bir tarihi belirtmek için 0 arasında olmalıdır.

month

integer

Bir yılın ayı. 1 ile 12 arasında veya ay ve gün içermeyen bir yılı belirtmek için 0 arasında olmalıdır.

day

integer

Ayın günü. 1 ile 31 arasında bir değer olmalı ve yıl ve ay için geçerlidir. Yalnızca yılı belirtmek için 0 değerini veya günün önemli olmadığı bir yılı ve ayı belirtmek için 0 değerini girin.

BraggingRights

KULLANIMDAN KALDIRILDI: Hiçbir veri kişinin övünme hakları döndürülmez.

JSON gösterimi
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}
Alanlar
metadata

object (FieldMetadata)

Övünme haklarıyla ilgili meta veriler.

value

string

Övünme hakları; örneğin, climbed mount everest.

CalendarUrl

Kullanıcının takvim URL'si.

JSON gösterimi
{
  "metadata": {
    object (FieldMetadata)
  },
  "url": string,
  "type": string,
  "formattedType": string
}
Alanlar
metadata

object (FieldMetadata)

Takvim URL'siyle ilgili meta veriler.

url

string

Takvim URL'si.

type

string

Takvim URL'sinin türü. Tür, özel veya önceden tanımlanmış şu değerlerden biri olabilir:

  • home
  • freeBusy
  • work
formattedType

string

Yalnızca çıkış. Görüntüleyenin hesap yerel ayarında veya Accept-Language HTTP üstbilgisi yerel ayarında çevrilen ve biçimlendirilen takvim URL'sinin türü.

ClientData

İstemciler tarafından doldurulan rastgele istemci verileri. Yinelenen anahtarlara ve değerlere izin verilir.

JSON gösterimi
{
  "metadata": {
    object (FieldMetadata)
  },
  "key": string,
  "value": string
}
Alanlar
metadata

object (FieldMetadata)

İstemci verileriyle ilgili meta veriler.

key

string

İstemci tarafından belirtilen istemci verilerinin anahtarı.

value

string

İstemci, müşteri verilerinin değerini belirtti.

CoverPhoto

Bir kişinin kapak fotoğrafı. Kullanıcının profil sayfasında gösterilen ve onun kim olduğunu veya neye önem verdiğini temsil eden büyük bir resim.

JSON gösterimi
{
  "metadata": {
    object (FieldMetadata)
  },
  "url": string,
  "default": boolean
}
Alanlar
metadata

object (FieldMetadata)

Kapak fotoğrafıyla ilgili meta veriler.

url

string

Kapak fotoğrafının URL'si.

default

boolean

Kapak fotoğrafı varsayılan kapak fotoğrafıysa doğru değerini döndürür; Kapak fotoğrafı kullanıcı tarafından sağlanan bir kapak fotoğrafıysa false (yanlış) değerini alır.

EmailAddress

Kullanıcının e-posta adresi.

JSON gösterimi
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": string,
  "formattedType": string,
  "displayName": string
}
Alanlar
metadata

object (FieldMetadata)

E-posta adresiyle ilgili meta veriler.

value

string

E-posta adresi.

type

string

E-posta adresinin türü. Tür, özel veya önceden tanımlanmış şu değerlerden biri olabilir:

  • home
  • work
  • other
formattedType

string

Yalnızca çıkış. Görüntüleyenin hesap yerel ayarında veya Accept-Language HTTP üstbilgisi yerel ayarında çevrilen ve biçimlendirilen e-posta adresinin türü.

displayName

string

E-postanın görünen adı.

Etkinlik

Kişiyle ilgili bir etkinlik.

JSON gösterimi
{
  "metadata": {
    object (FieldMetadata)
  },
  "date": {
    object (Date)
  },
  "type": string,
  "formattedType": string
}
Alanlar
metadata

object (FieldMetadata)

Etkinlikle ilgili meta veriler.

date

object (Date)

Etkinliğin tarihi.

type

string

Etkinliğin türü. Tür, özel veya önceden tanımlanmış şu değerlerden biri olabilir:

  • anniversary
  • other
formattedType

string

Yalnızca çıkış. İzleyicinin hesap yerel ayarında veya Accept-Language HTTP üstbilgisi yerel ayarında çevrilen ve biçimlendirilen etkinliğin türü.

Dış Kimlik

Kişiyle ilgili harici bir varlıktaki tanımlayıcı.

JSON gösterimi
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": string,
  "formattedType": string
}
Alanlar
metadata

object (FieldMetadata)

Harici kimlikle ilgili meta veriler.

value

string

Harici kimliğin değeri.

type

string

Harici kimliğin türü. Tür, özel veya önceden tanımlanmış şu değerlerden biri olabilir:

  • account
  • customer
  • loginId
  • network
  • organization
formattedType

string

Yalnızca çıkış. İzleyicinin hesap yerel ayarında veya Accept-Language HTTP üstbilgisi yerel ayarında çevrilen ve biçimlendirilen etkinliğin türü.

FileAs

Kişiyi bir listede sıralamak için kullanılması gereken ad.

JSON gösterimi
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}
Alanlar
metadata

object (FieldMetadata)

Farklı dosya ile ilgili meta veriler.

value

string

Farklı dosya değeri

Cinsiyet

Bir kişinin cinsiyeti.

JSON gösterimi
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "formattedValue": string,
  "addressMeAs": string
}
Alanlar
metadata

object (FieldMetadata)

Cinsiyetle ilgili meta veriler.

value

string

Kişinin cinsiyeti. Cinsiyet, özel veya önceden tanımlanmış şu değerlerden biri olabilir:

  • male
  • female
  • unspecified
formattedValue

string

Yalnızca çıkış. İzleyicinin hesap yerel ayarında veya Accept-Language HTTP başlığı yerel ayarında çevrilen ve biçimlendirilen cinsiyet değeri. Belirtilmemiş veya özel değer yerelleştirilmez.

addressMeAs

string

Kişiye hitap etmek için kullanılması gereken hitap tercihi için serbest biçimli metin alanı. Ortak değerler şunlardır:

  • he/him
  • she/her
  • they/them

ImClient

Bir kişinin anlık mesajlaşma istemcisi.

JSON gösterimi
{
  "metadata": {
    object (FieldMetadata)
  },
  "username": string,
  "type": string,
  "formattedType": string,
  "protocol": string,
  "formattedProtocol": string
}
Alanlar
metadata

object (FieldMetadata)

IM istemcisiyle ilgili meta veriler.

username

string

IM istemcisinde kullanılan kullanıcı adı.

type

string

IM istemcisinin türü. Tür, özel veya önceden tanımlanmış şu değerlerden biri olabilir:

  • home
  • work
  • other
formattedType

string

Yalnızca çıkış. Görüntüleyen kişinin hesap yerel ayarında veya Accept-Language HTTP üstbilgisi yerel ayarında çevrilen ve biçimlendirilen IM istemcisi türü.

protocol

string

IM istemcisinin protokolü. Protokol, özel veya önceden tanımlanmış şu değerlerden biri olabilir:

  • aim
  • msn
  • yahoo
  • skype
  • qq
  • googleTalk
  • icq
  • jabber
  • netMeeting
formattedProtocol

string

Yalnızca çıkış. Görüntüleyenin hesap yerel ayarında veya Accept-Language HTTP üstbilgisi yerel ayarında biçimlendirilmiş IM istemcisi protokolü.

İlgi

Kişinin ilgi alanlarından biri.

JSON gösterimi
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}
Alanlar
metadata

object (FieldMetadata)

İlgi alanı hakkındaki meta veriler.

value

string

Fayda/menfaat; örneğin, stargazing.

Yerel ayar

Kullanıcının yerel ayar tercihi.

JSON gösterimi
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}
Alanlar
metadata

object (FieldMetadata)

Yerel ayarla ilgili meta veriler.

value

string

Yerel ayarı temsil eden, iyi biçimlendirilmiş IETF BCP 47 dil etiketi.

Konum

Bir kullanıcının konumu.

JSON gösterimi
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": string,
  "current": boolean,
  "buildingId": string,
  "floor": string,
  "floorSection": string,
  "deskCode": string
}
Alanlar
metadata

object (FieldMetadata)

Konumla ilgili meta veriler.

value

string

Konumun serbest biçimli değeri.

type

string

Konumun türü. Tür, özel veya önceden tanımlanmış şu değerlerden biri olabilir:

  • desk
  • grewUp
current

boolean

Konumun geçerli konum olup olmadığı.

buildingId

string

Bina tanımlayıcısı.

floor

string

Kat adı veya numarası.

floorSection

string

floor_name bölgesindeki zemin bölümü.

deskCode

string

Bağımsız masa konumu.

Üyelik

Bir kullanıcının bir gruptaki üyeliği. Yalnızca kişi grubu üyelikleri değiştirilebilir.

JSON gösterimi
{
  "metadata": {
    object (FieldMetadata)
  },

  // Union field membership can be only one of the following:
  "contactGroupMembership": {
    object (ContactGroupMembership)
  },
  "domainMembership": {
    object (DomainMembership)
  }
  // End of list of possible types for union field membership.
}
Alanlar
metadata

object (FieldMetadata)

Üyelikle ilgili meta veriler.

Birleştirme alanı membership. Üyelik. membership şunlardan yalnızca biri olabilir:
contactGroupMembership

object (ContactGroupMembership)

Kişi grubu üyeliği.

domainMembership

object (DomainMembership)

Yalnızca çıkış. Alan üyeliği.

ContactGroupMembership

Google kişi grubu üyeliği.

JSON gösterimi
{
  "contactGroupId": string,
  "contactGroupResourceName": string
}
Alanlar
contactGroupId
(deprecated)

string

Yalnızca çıkış. Kişi grubu üyeliği için kişi grubu kimliği.

contactGroupResourceName

string

Kişi grubu için sunucu tarafından atanan kaynak adı. contactGroups/{contactGroupId} biçiminde bir ASCII dizesi. Üyelikleri değiştirmek için yalnızca contactGroupResourceName kullanılabilir. Tüm kişi grubu üyelikleri kaldırılabilir ancak yalnızca kullanıcı grubu veya "myContacts" (Kişilerim) grubu kullanılabilir. veya "yıldızlı" sistem grup üyelikleri eklenebilir. Bir kişinin her zaman en az bir kişi grubu üyeliği olmalıdır.

DomainMembership

Google Workspace alanı üyeliği

JSON gösterimi
{
  "inViewerDomain": boolean
}
Alanlar
inViewerDomain

boolean

Kullanıcı, görüntüleyenin Google Workspace alanındaysa doğru değerini döndürür.

MiscKeyword

Kullanıcının çeşitli anahtar kelimeleri.

JSON gösterimi
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": enum (KeywordType),
  "formattedType": string
}
Alanlar
metadata

object (FieldMetadata)

Çeşitli anahtar kelimelerle ilgili meta veriler.

value

string

Çeşitli anahtar kelimenin değeri.

type

enum (KeywordType)

Çeşitli anahtar kelime türü.

formattedType

string

Yalnızca çıkış. İzleyicinin hesap yerel ayarında veya Accept-Language HTTP başlığı yerel ayarında çevrilen ve biçimlendirilen çeşitli anahtar kelimenin türü.

KeywordType

Çeşitli anahtar kelime türü.

Sıralamalar
TYPE_UNSPECIFIED Belirtilmedi.
OUTLOOK_BILLING_INFORMATION Fatura bilgileri için Outlook alanı.
OUTLOOK_DIRECTORY_SERVER Dizin sunucusu için Outlook alanı.
OUTLOOK_KEYWORD Anahtar kelime için Outlook alanı.
OUTLOOK_MILEAGE Kilometre için Outlook alanı.
OUTLOOK_PRIORITY Öncelik için Outlook alanı.
OUTLOOK_SENSITIVITY Hassasiyet için Outlook alanı.
OUTLOOK_SUBJECT Konu için Outlook alanı.
OUTLOOK_USER Kullanıcı için Outlook alanı.
HOME Ana Sayfa.
WORK İş'e gidin.
OTHER Diğer.

Ad

Bir kişinin adı. Ad yalnızca takma ad ise aile adı boş bırakılır.

JSON gösterimi
{
  "metadata": {
    object (FieldMetadata)
  },
  "displayName": string,
  "displayNameLastFirst": string,
  "unstructuredName": string,
  "familyName": string,
  "givenName": string,
  "middleName": string,
  "honorificPrefix": string,
  "honorificSuffix": string,
  "phoneticFullName": string,
  "phoneticFamilyName": string,
  "phoneticGivenName": string,
  "phoneticMiddleName": string,
  "phoneticHonorificPrefix": string,
  "phoneticHonorificSuffix": string
}
Alanlar
metadata

object (FieldMetadata)

Adla ilgili meta veriler.

displayName

string

Yalnızca çıkış. İzleyicinin hesabı veya Accept-Language HTTP üst bilgisi tarafından belirtilen yerel ayara göre biçimlendirilmiş görünen ad.

displayNameLastFirst

string

Yalnızca çıkış. İzleyicinin hesabı veya Accept-Language HTTP üst bilgisi tarafından belirtilen yerel ayara göre biçimlendirilmiş, önce soyadının yer aldığı görünen ad.

unstructuredName

string

Serbest biçimli ad değeri.

familyName

string

Soyadı.

givenName

string

Verilen ad.

middleName

string

İkinci adlar.

honorificPrefix

string

Onurlu ön ekler, örneğin Mrs. veya Dr.

honorificSuffix

string

Jr. gibi saygın son ekler

phoneticFullName

string

Adından da anlaşılacağı gibi tam ad.

phoneticFamilyName

string

Adından da anlaşılacağı gibi yazılan aile adı.

phoneticGivenName

string

Adın yazıldığı şekilde okunduğu ad.

phoneticMiddleName

string

İkinci adlar okunduğu şekilde hecelenir.

phoneticHonorificPrefix

string

Okunduğu gibi yazılan saygın ön ekler.

phoneticHonorificSuffix

string

Okunduğu gibi yazılan saygın son ekler.

Takma ad

Bir kişinin takma adı.

JSON gösterimi
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": enum (NicknameType)
}
Alanlar
metadata

object (FieldMetadata)

Takma adla ilgili meta veriler.

value

string

Takma ad.

type

enum (NicknameType)

Takma adın türü.

NicknameType

Takma adın türü.

Sıralamalar
DEFAULT Genel takma ad.
MAIDEN_NAME

Kızlık soyadı veya doğum soyadı. Kişinin soyadı evlilik nedeniyle değiştiğinde kullanılır.

INITIALS

Baş harfler.

GPLUS

Google+ profili takma adı.

OTHER_NAME

Mesleki üyelik veya başka bir ad; örneğin, Dr. Smith.

ALTERNATE_NAME Alternatif kişinin adı
SHORT_NAME

Kişinin adının kısa bir hali.

Meslek

Bir kişinin mesleği.

JSON gösterimi
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}
Alanlar
metadata

object (FieldMetadata)

Meslekle ilgili meta veriler.

value

string

Meslek; örneğin, carpenter.

Kuruluş

Bir kişinin geçmiş veya mevcut kuruluşu. Çakışan tarih aralıklarına izin verilir.

JSON gösterimi
{
  "metadata": {
    object (FieldMetadata)
  },
  "type": string,
  "formattedType": string,
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  },
  "current": boolean,
  "name": string,
  "phoneticName": string,
  "department": string,
  "title": string,
  "jobDescription": string,
  "symbol": string,
  "domain": string,
  "location": string,
  "costCenter": string,
  "fullTimeEquivalentMillipercent": integer
}
Alanlar
metadata

object (FieldMetadata)

Kuruluşla ilgili meta veriler.

type

string

Kuruluşun türü. Tür, özel veya önceden tanımlanmış şu değerlerden biri olabilir:

  • work
  • school
formattedType

string

Yalnızca çıkış. Görüntüleyen kişinin hesap yerel ayarında veya Accept-Language HTTP üstbilgisi yerel ayarında çevrilen ve biçimlendirilen kuruluşun türü.

startDate

object (Date)

Kullanıcının kuruluşa katıldığı başlangıç tarihi.

endDate

object (Date)

Kullanıcının kuruluştan ayrıldığı bitiş tarihi.

current

boolean

Kuruluş, kişinin mevcut kuruluşuysa doğru değerini döndürür; Kuruluş eski bir kuruluşsa false (yanlış) değerini alır.

name

string

Kurumun adı.

phoneticName

string

Kuruluşun fonetik adı.

department

string

Kişinin kurumdaki departmanı.

title

string

Kişinin kurumdaki mesleki unvanı.

jobDescription

string

Kişinin kurumdaki iş tanımı.

symbol

string

Kuruluşla ilişkili simge; Örneğin, borsa kodu simgesi, kısaltma veya kısaltma.

domain

string

Kuruluşla ilişkili alan adı; örneğin, google.com.

location

string

Kişinin çalıştığı kuruluşun ofisi.

costCenter

string

Kişinin kurumdaki maliyet merkezi.

fullTimeEquivalentMillipercent

integer

Kişinin kuruluştaki tam zamanlı eşdeğeri milisaniye (100.000 = %100).

Telefon Numarası

Bir kişinin telefon numarası.

JSON gösterimi
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "canonicalForm": string,
  "type": string,
  "formattedType": string
}
Alanlar
metadata

object (FieldMetadata)

Telefon numarasıyla ilgili meta veriler.

value

string

Telefon numarası.

canonicalForm

string

Yalnızca çıkış. Telefon numarasının standartlaştırılmış ITU-T E.164 biçimi.

type

string

Telefon numarasının türü. Tür, özel veya önceden tanımlanmış şu değerlerden biri olabilir:

  • home
  • work
  • mobile
  • homeFax
  • workFax
  • otherFax
  • pager
  • workMobile
  • workPager
  • main
  • googleVoice
  • other
formattedType

string

Yalnızca çıkış. İzleyicinin hesap yerel ayarında veya Accept-Language HTTP üstbilgisi yerel ayarında çevrilen ve biçimlendirilen telefon numarasının türü.

Fotoğraf

Bir kullanıcının fotoğrafı. Kişinin adının yanında, diğer kullanıcıların kişiyi tanımasına yardımcı olacak bir resim.

JSON gösterimi
{
  "metadata": {
    object (FieldMetadata)
  },
  "url": string,
  "default": boolean
}
Alanlar
metadata

object (FieldMetadata)

Fotoğrafla ilgili meta veriler.

url

string

Fotoğrafın URL'si. URL'nin sonuna bir sorgu parametresi sz={size} ekleyerek istediğiniz boyutu değiştirebilirsiniz. Buradaki {size}, piksel cinsinden boyuttur. Örnek: https://lh3.googleusercontent.com/-T_wVWLlmg7w/AAAAAAAAAAI/AAAAAAAABa8/00gzXvDBYqw/s100/photo.jpg?sz=50

default

boolean

Fotoğraf bir varsayılan fotoğrafsa doğru değerini döndürür; Fotoğraf kullanıcı tarafından sağlanan bir fotoğrafsa false (yanlış) değerini alır.

İlişki

Bir kişinin başka bir kişiyle olan ilişkisi.

JSON gösterimi
{
  "metadata": {
    object (FieldMetadata)
  },
  "person": string,
  "type": string,
  "formattedType": string
}
Alanlar
metadata

object (FieldMetadata)

İlişkiyle ilgili meta veriler.

person

string

Bu ilişkinin belirttiği diğer kişinin adı.

type

string

Kişinin diğer kişiyle olan ilişkisi. Tür, özel veya önceden tanımlanmış şu değerlerden biri olabilir:

  • spouse
  • child
  • mother
  • father
  • parent
  • brother
  • sister
  • friend
  • relative
  • domesticPartner
  • manager
  • assistant
  • referredBy
  • partner
formattedType

string

Yalnızca çıkış. Görüntüleyenin hesabının yerel ayarında veya Accept-Language HTTP başlığında belirtilen yerel ayarda çevrilen ve biçimlendirilen ilişkinin türü.

RelationshipInterest

KULLANIMDAN KALDIRILDI: Hiçbir veri döndürülmez Kişinin ilişkisine dair ilgi .

JSON gösterimi
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "formattedValue": string
}
Alanlar
metadata

object (FieldMetadata)

İlişkinin menfaatine dair meta veriler.

value

string

Kişinin aradığı ilişki türü. Değer, özel veya önceden tanımlanmış şu değerlerden biri olabilir:

  • friend
  • date
  • relationship
  • networking
formattedValue

string

Yalnızca çıkış. İzleyicinin hesabının yerel ayarında veya Accept-Language HTTP başlığında belirtilen yerel ayarda çevrilen ve biçimlendirilen, ilgi alanının değeri.

RelationshipStatus

KULLANIMDAN KALDIRILDI: Hiçbir veri döndürülmez. Kişinin ilişki durumu.

JSON gösterimi
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "formattedValue": string
}
Alanlar
metadata

object (FieldMetadata)

İlişki durumuyla ilgili meta veriler.

value

string

İlişki durumu. Değer, özel veya önceden tanımlanmış şu değerlerden biri olabilir:

  • single
  • inARelationship
  • engaged
  • married
  • itsComplicated
  • openRelationship
  • widowed
  • inDomesticPartnership
  • inCivilUnion
formattedValue

string

Yalnızca çıkış. Görüntüleyenin hesap yerel ayarında veya Accept-Language HTTP üstbilgisi yerel ayarında çevrilen ve biçimlendirilen ilişki durumunun değeri.

Konut

KULLANIMDAN KALDIRILDI: Lütfen bunun yerine person.locations kullanın. Bir kişinin geçmiş veya şu anda ikamet ettiği yer.

JSON gösterimi
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "current": boolean
}
Alanlar
metadata

object (FieldMetadata)

İkamet yeriyle ilgili meta veriler.

value

string

İkamet edilen adres.

current

boolean

İkamet, kişinin mevcut ikametiyse doğru değerini döndürür; konut geçmişte bir konutsa false (yanlış) değerini alır.

SipAddress

Bir kişinin SIP adresi. Oturum İlk Protokol adresleri, internet üzerinden sesli veya görüntülü görüşme yapmak üzere VoIP iletişimlerinde kullanılır.

JSON gösterimi
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": string,
  "formattedType": string
}
Alanlar
metadata

object (FieldMetadata)

SIP adresiyle ilgili meta veriler.

value

string

RFC 3261 19.1 SIP URI biçimindeki SIP adresi.

type

string

SIP adresinin türü. Tür, özel veya önceden tanımlanmış şu değerlerden biri olabilir:

  • home
  • work
  • mobile
  • other
formattedType

string

Yalnızca çıkış. Görüntüleyenin hesap yerel ayarında veya Accept-Language HTTP üstbilgisi yerel ayarında çevrilen ve biçimlendirilen SIP adresinin türü.

Beceri

Kişinin sahip olduğu bir beceri.

JSON gösterimi
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}
Alanlar
metadata

object (FieldMetadata)

Beceriyle ilgili meta veriler.

value

string

Beceri; örneğin, underwater basket weaving.

Kısa açıklama

KULLANIMDAN KALDIRILDI: Hiçbir veri döndürülmez. Kişiyle ilgili tek satırlık kısa bir açıklama.

JSON gösterimi
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}
Alanlar
metadata

object (FieldMetadata)

Kısa açıklamayla ilgili meta veriler.

value

string

Kısa açıklama.

Url

Kullanıcının ilişkili URL'leri.

JSON gösterimi
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": string,
  "formattedType": string
}
Alanlar
metadata

object (FieldMetadata)

URL ile ilgili meta veriler.

value

string

URL.

type

string

URL'nin türü. Tür, özel veya önceden tanımlanmış şu değerlerden biri olabilir:

  • home
  • work
  • blog
  • profile
  • homePage
  • ftp
  • reservations
  • appInstallPage: Currents uygulamasına ait web sitesi.
  • other
formattedType

string

Yalnızca çıkış. İzleyicinin hesap yerel ayarında veya Accept-Language HTTP üstbilgisi yerel ayarında çevrilen ve biçimlendirilen URL'nin türü.

UserDefined

Son kullanıcılar tarafından doldurulan rastgele kullanıcı verileri.

JSON gösterimi
{
  "metadata": {
    object (FieldMetadata)
  },
  "key": string,
  "value": string
}
Alanlar
metadata

object (FieldMetadata)

Kullanıcı tanımlı verilerle ilgili meta veriler.

key

string

Son kullanıcı, kullanıcı tanımlı verilerin anahtarı.

value

string

Son kullanıcı, kullanıcı tarafından tanımlanan verilerin değeri.

Yöntemler

batchCreateContacts

Bir grup yeni kişi oluşturun ve yeni kişi için PersonResponses'u döndürün

Gecikmenin ve hataların artmasını önlemek için aynı kullanıcıya yönelik değişiklik istekleri sırayla gönderilmelidir.

batchDeleteContacts

Bir kişi grubunu silme

batchUpdateContacts

Bir kişi grubunu güncelleme ve güncellenen kişiler için PersonResponses'a kaynak adları haritasını döndürme.

createContact

Yeni bir kişi oluşturun ve söz konusu kişinin kişi kaynağını geri verin.

deleteContact

Bir kişiyi silme

deleteContactPhoto

Bir kişinin fotoğrafını silin.

get

Bir kaynak adı belirterek bir kişi hakkında bilgi sağlar.

getBatchGet

İstenen kaynak adlarının bir listesini belirterek belirli kişilerin bir listesi hakkında bilgi sağlar.

listDirectoryPeople

Kimliği doğrulanan kullanıcının alan dizinindeki alan adı profillerinin ve alan kişilerinin listesini sağlar.

searchContacts

Kimliği doğrulanmış kullanıcının gruplandırılmış kişilerindeki, arama sorgusuyla eşleşen kişilerin bir listesini sağlar.

searchDirectoryPeople

Kimliği doğrulanan kullanıcının alan dizinindeki ve arama sorgusuyla eşleşen alan adı profillerinin ve alan kişilerinin listesini sağlar.

updateContact

Mevcut bir ilgili kişinin kişi verilerini güncelleme.

updateContactPhoto

Bir kişinin fotoğrafını güncelleyin.