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ştirilmiş bir kişi hakkında bilgiler.

Çoğu alanda birden çok öğe olabilir. Bir alandaki öğelerin garanti edilen bir sırası yoktur, ancak boş olmayan her bir alanın metadata.primary değeri true olarak ayarlanmış tam olarak bir alana sahip olması 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 tarafından 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)

Kullanıcının 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, iletişim kaynakları için kullanılan bir tekil alandır.

birthdays[]

object (Birthday)

Kişinin doğum günleri. Bu alan, iletişim kaynakları için kullanılan bir tekil alandır.

braggingRights[]
(deprecated)

object (BraggingRights)

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

calendarUrls[]

object (CalendarUrl)

Kişinin takvim URL'leri.

clientData[]

object (ClientData)

Kişinin 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 adreslerinin sayısı 100 ile sınırlıdır. Bir kullanıcının daha fazla e-posta adresi varsa people.getBatchGet numaralı telefonu arayarak tüm kümeyi edinebilirsiniz.

events[]

object (Event)

Kişinin etkinlikleri.

externalIds[]

object (ExternalId)

Kişinin harici kimlikleri.

fileAses[]

object (FileAs)

Kişinin dosya kayıtları.

genders[]

object (Gender)

Kullanıcının cinsiyetleri. Bu alan, iletişim kaynakları için kullanılan bir tekil alandır.

imClients[]

object (ImClient)

Kullanıcının anlık mesajlaşma istemcileri.

interests[]

object (Interest)

Kullanıcının ilgi alanları.

locales[]

object (Locale)

Kullanıcının yerel tercihleri.

locations[]

object (Location)

Kullanıcının bulunduğu yerler.

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, iletişim kaynakları için kullanılan bir tekil alandır.

nicknames[]

object (Nickname)

Kişinin takma adları.

occupations[]

object (Occupation)

Kullanıcının mesleği.

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şinin daha fazla telefon numarası varsa people.getBatchGet numaralı telefonu arayarak tüm seti edinebilirsiniz.

photos[]

object (Photo)

Yalnızca çıkış. Kullanıcının 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. Kullanıcının ilişkisi ilgi alanları.

relationshipStatuses[]
(deprecated)

object (RelationshipStatus)

Yalnızca çıkış. KULLANIMDAN KALDIRILDI: Hiçbir veri döndürülmez. Kullanıcının ilişki durumları

residences[]
(deprecated)

object (Residence)

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

sipAddresses[]

object (SipAddress)

Kullanıcının SIP adresleri.

skills[]

object (Skill)

Kullanıcının becerileri.

taglines[]
(deprecated)

object (Tagline)

Yalnızca çıkış. KULLANIMDAN KALDIRILDI: Hiçbir veri döndürülmeyecektir. Kişinin kısa açıklamaları.

urls[]

object (Url)

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

userDefined[]

object (UserDefined)

Kullanıcının kullanıcı tanımlı verileri.

Kişi Meta Verileri

Bir kişiyle ilgili 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 kullanıcının eski tüm kaynak adları. Yalnızca senkronizasyon jetonu içeren people.connections.list istek için doldurulur.

Doğrulanmış e-posta, doğrulanmış telefon numarası veya profil URL'si gibi bir kişi ve profil ile bağlantı oluşturan alanlar eklenirken veya kaldırılırken kaynak adı 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 alır. Yalnızca people.connections.list ve otherContacts.list senkronizasyon istekleri 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,
  "profileMetadata": {
    object (ProfileMetadata)
  }
}
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 içinde 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 içinde doldurulur.

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

Nanosaniye çözünürlükte ve dokuz adede kadar kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

profileMetadata

object (ProfileMetadata)

Yalnızca çıkış. Yalnızca person.metadata.sources içinde doldurulur.

PROFILE türü bir kaynakla ilgili meta veriler.

Kaynak Türü

Kaynağın türü.

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

ProfilMeta Verileri

Bir profille ilgili meta veriler.

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

enum (ObjectType)

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

userTypes[]

enum (UserType)

Yalnızca çıkış. Kullanıcı türleri.

Nesne Türü

Kişi nesnesinin türü.

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

KullanıcıTürü

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ı bir Google Workspace kullanıcısı olmalıdır.

Adres

Bir kişinin fiziksel adresi. Posta kutusu veya açık adres olabilir. 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 parametre kullanıcı tarafından ayarlanmadıysa yapılandırılmış değerlerden otomatik olarak 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ış. İzleyicinin hesap yerel ayarda veya Accept-Language HTTP başlığı yerel ayarında çevrilen ve biçimlendirilen adresin türü.

poBox

string

Adresin posta kutusu.

streetAddress

string

Açık adres.

extendedAddress

string

Adresin genişletilmiş adresi; örneğin, daire numarası.

city

string

Adresin bulunduğu şehir.

region

string

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

postalCode

string

Adresin posta kodu.

country

string

Adresteki ülke.

countryCode

string

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

Alan Meta Verisi

Bir alanla ilgili meta veriler.

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

boolean

Yalnızca çıkış. Bu alandaki tüm kaynaklar için birincil alan alan ise doğru. Her kullanıcı için primary doğru değerine ayarlanmış en fazla bir alan bulunur.

sourcePrimary

boolean

Bu alan, source için birincil alansa doğru değerini alır. Her bir kaynak, sourcePrimary doğru değerine ayarlanmış en fazla bir alana sahip olmalıdır.

verified

boolean

Yalnızca çıkış. Alan doğrulandıysa true (doğru), alan doğrulanmamışsa false (yanlış). Doğrulanmış alan genellikle kişinin sahibi olduğu onaylanmış 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.
EIGHTEEN_TO_TWENTY On sekiz ile yirmi arasında.
TWENTY_ONE_OR_OLDER Yirmi bir ve üzeri.

YaşAralığı Türü

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 bunların olacağı 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)

Doğum gününün yapılandırılmış 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 dize. Bu değer doğrulanmamış.

Tarih

Tam veya kısmi bir takvim tarihini temsil eder (ör. doğum günü). Günün saati veya saat dilimi başka bir yerde belirtilmiş veya önemli değil. Tarih, Takvim Takvimine göre değişir. Bu, aşağıdakilerden birini temsil edebilir:

  • Sıfır olmayan yıl, ay ve gün değerleriyle tam tarih.
  • Sıfır yıl içeren bir ay ve gün (örneğin, bir yıl dönümü).
  • Sıfır ay, sıfır gün olmak üzere kendi başına bir yıl.
  • Sıfır gün içeren 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ı. Yıl içermeyen bir tarih belirtmek için 1 ile 9999 arasında veya 0 olmalıdır.

month

integer

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

day

integer

Ayın günü. 1 ile 31 arasında, yıl ve ay için geçerli olmalıdır. 0 değeri ise tek başına bir yılı veya günün önemli olmadığı bir yıl ve ayı belirtir.

Övünme Hakkı

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

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

object (FieldMetadata)

Övünme hakkıyla ilgili meta veriler.

value

string

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

Takvim URL'si

Bir 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ı veya Accept-Language HTTP üst bilgisi yerel ayarında çevrilen ve biçimlendirilen takvim URL'sinin türü.

İstemci Verileri

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

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

object (FieldMetadata)

Müşteri verileriyle ilgili meta veriler.

key

string

İstemci tarafından tanımlanan müşteri verileri.

value

string

İstemci verilerinde istemci tarafından belirtilen değer.

KapakFotoğrafı

Bir kişinin kapak fotoğrafı. Kişinin profil sayfasında kim olduğunu veya nelere önem verdiğini gösteren 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 true (doğru), kapak fotoğrafı ise kullanıcı tarafından sağlanan bir kapak fotoğrafıysa false (yanlış) değerine sahiptir.

EmailAddress

Bir kişinin 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ış. İzleyicinin hesap yerel ayarı veya Accept-Language HTTP üst bilgisi yerel ayarında çevrilen ve biçimlendirilen e-posta adresi 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ı veya Accept-Language HTTP üst bilgisi yerel ayarında çevrilen ve biçimlendirilen etkinliğin türü.

Dış Kimlik

Kişiyle ilgili harici bir tüzel kişinin tanımlayıcısı.

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ı veya Accept-Language HTTP üst bilgisi yerel ayarında çevrilen ve biçimlendirilen etkinliğin türü.

Dosyalar

Bir kişiyi listede sıralamak için kullanılması gereken ad.

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

object (FieldMetadata)

Farklı dosyalama meta verileri.

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 olabilir veya şu önceden tanımlanmış değerlerden biri olabilir:

  • male
  • female
  • unspecified
formattedValue

string

Yalnızca çıkış. Görüntüleyenin hesap yerel ayarında veya Accept-Language HTTP üst bilgisi yerel ayarında çevrilen ve biçimlendirilen cinsiyet değeri. Belirtilmeyen veya özel değer yerelleştirilmez.

addressMeAs

string

Hitap şekli için, kişiye yönelik olarak kullanılması gereken serbest biçimli metin alanı. Yaygın değerler şunlardır:

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

İstemci İstemcisi

Bir kullanıcının 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ış. İzleyicinin hesap yerel ayarında veya Accept-Language HTTP üst bilgisi yerel ayarında çevrilen ve biçimlendirilen IM istemcisinin türü.

protocol

string

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

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

string

Yalnızca çıkış. İzleyicinin hesap yerel ayarında veya Accept-Language HTTP üst bilgisi yerel ayarında IM istemcisinin protokolü.

İlgi alanı

Kullanıcının ilgi alanlarından biridir.

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

object (FieldMetadata)

İlgi alanıyla ilgili meta veriler.

value

string

İlgi alanı; örneğin, stargazing.

Yerel ayar

Bir kullanıcının yerel ayar tercihi.

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

object (FieldMetadata)

Yerel ayar hakkındaki meta veriler.

value

string

Yerel ayarı gösteren iyi biçimlendirilmiş IETF BCP 47 dil etiketi.

Konum

Bir kişinin 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 adlı katın kat bölümü.

deskCode

string

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

Birlik alanı membership. Üyelik. membership aşağıdakilerden yalnızca biri olabilir:
contactGroupMembership

object (ContactGroupMembership)

Kişi grubu üyeliği.

domainMembership

object (DomainMembership)

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

KişiGrubu Üyeliği

Google kişi grubu üyeliği.

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

string

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

contactGroupResourceName

string

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

AlanÜyeliği

Google Workspace alan üyeliği.

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

boolean

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

ÇeşitliAnahtarKelime

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

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

object (FieldMetadata)

Çeşitli anahtar kelimeyle 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 üst bilgisi yerel ayarında çevrilen ve biçimlendirilen çeşitli anahtar kelimenin türü.

Anahtar Kelime Türü

Çeşitli anahtar kelime türü.

Sıralamalar
TYPE_UNSPECIFIED Belirtilmedi.
OUTLOOK_BILLING_INFORMATION Fatura bilgisi 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ının Outlook alanı.
HOME Ev'e dokunun
WORK İş'e gidin.
OTHER Diğer.

Ad

Kullanıcının adı. Ad yalnızca bir ad ise aile adı boş olur.

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 başlığı tarafından belirtilen yerel ayara göre biçimlendirilmiş görünen ad.

displayNameLastFirst

string

Yalnızca çıkış. İzleyicinin hesabı veya Accept-Language HTTP başlığı tarafından belirtilen yerel ayara göre ilk olarak biçimlendirilen soyadı olan ad.

unstructuredName

string

Serbest biçim adı değeri.

familyName

string

Soyadı.

givenName

string

Belirtilen ad.

middleName

string

İkinci adlar.

honorificPrefix

string

Mrs. veya Dr. gibi onur ön ekleri

honorificSuffix

string

Jr. gibi onurlu son ekler

phoneticFullName

string

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

phoneticFamilyName

string

Ad, telaffuz edildiği şekilde yazılıyor.

phoneticGivenName

string

Ad, telaffuz edildiği şekilde yazılıyor.

phoneticMiddleName

string

Sesi görünen ikinci adlar.

phoneticHonorificPrefix

string

Seslere benzetilen saygın önekler.

phoneticHonorificSuffix

string

Seslere benzer şekilde yazılan son ekler.

Takma ad

Kullanıcının 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ü.

Takma Ad Türü

Takma ad türü.

Sıralamalar
DEFAULT Genel takma ad.
MAIDEN_NAME

Kızlık soyadı veya doğum soyadı. Kullanıcının aile adı evlilik nedeniyle değiştiğinde.

INITIALS

Baş harfler

GPLUS

Google+ profili takma adı.

OTHER_NAME

Meslek ilişkisi veya başka bir ad; örneğin, Dr. Smith.

ALTERNATE_NAME Alternatif kişinin adı.
SHORT_NAME

Kişinin adının daha kısa bir sürümü.

Meslek

Bir kişinin mesleği.

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

object (FieldMetadata)

Mesleğe dair meta veriler.

value

string

Meslek. Örneğin, carpenter.

Kuruluş

Bir kullanıcının 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ış. İzleyicinin hesap yerel ayarı veya Accept-Language HTTP üst bilgisi 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ş, kullanıcının mevcut kuruluşuysa doğru, kuruluş eski bir kuruluş ise false (yanlış) değerini alır.

name

string

Kurumun adı.

phoneticName

string

Kuruluşun fonetik adı.

department

string

Kuruluştaki ilgili kişi bölümü.

title

string

Kuruluştaki kişinin iş unvanı.

jobDescription

string

Kuruluştaki iş açıklaması.

symbol

string

Kuruluşla ilişkili simge; örneğin, bir hisse senedi kısaltması, 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 ofisinin konumu.

costCenter

string

Kuruluştaki maliyet merkezi.

fullTimeEquivalentMillipercent

integer

Kullanıcının kuruluş içindeki tam zamanlı eşdeğeri (100.000 = %100).

PhoneNumber

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 başlığı yerel ayarında çevrilen ve biçimlendirilen telefon numarasının türü.

Fotoğraf

Bir kişinin fotoğrafı. Diğer kullanıcıların kişiyi tanımasına yardımcı olmak için kişi adının yanında gösterilen 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. İstenen boyutu, URL'nin sonuna sz={size} sorgu parametresi ekleyerek değiştirebilirsiniz. Burada {size}, piksel cinsinden boyut olarak belirtilmiştir. Örnek: https://lh3.googleusercontent.com/-T_wVWLlmg7w/AAAAAAAAAAI/AAAAAAAABa8/00gzXvDBYqw/s100/photo.jpg?sz=50

default

boolean

Fotoğraf varsayılan bir fotoğrafsa "true", 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 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 başvuruda bulunduğu 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ış. İzleyicinin hesap yerel ayarında veya Kabul Et-HTTP HTTP başlığında belirtilen yerel ayarda çevrilen ve biçimlendirilen ilişkinin türü.

İlişki İlgisi

KULLANIMDAN KALDIRILDI: Hiçbir veri iadesi kullanıcının ilişki ilgisi olmayacak .

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

object (FieldMetadata)

İlişki ilgi alanıyla ilgili meta veriler.

value

string

Kullanıcının 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 hesap yerel ayarında veya Kabul Et-HTTP HTTP başlığında belirtilen yerel ayarda çevrilmiş ve biçimlendirilmiş ilişki ilgisi.

İlişki Durumu

KULLANIMDAN KALDIRILDI: Hiçbir veri döndürülmez. Kullanıcının 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ış. İzleyicinin hesap yerel ayarına veya Accept-Language HTTP üst bilgisi yerel ayarına göre çevrilmiş ve biçimlendirilmiş ilişki durumunun değeri.

Konut

KULLANIMDAN KALDIRILDI: Lütfen bunun yerine person.locations kullanın. Bir kişinin geçmiş veya mevcut konutu.

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

object (FieldMetadata)

Konutla ilgili meta veriler.

value

string

İkamet adresi.

current

boolean

İkamet, o anda ikamet eden kişi ise True (Doğru) değerine, konut, geçmişte ikamet ettiği takdirde "false" (yanlış) değerine sahiptir.

Adres

Kullanıcının SIP adresi. Oturum Başlangıç Protokolü adresleri, internet üzerinden sesli veya görüntülü görüşmeler yapmak için VoIP iletişimleri için 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ış. İzleyicinin hesap yerel ayarı veya Accept-Language HTTP üst bilgisi yerel ayarında çevrilen ve biçimlendirilen SIP adresinin türü.

Skill

Kişinin sahip olduğu bir beceri.

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

object (FieldMetadata)

Yetenekle ilgili meta veriler.

value

string

Yetenek; örneğin, underwater basket weaving.

Kısa açıklama

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

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ı için web sitesi.
  • other
formattedType

string

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

Kullanıcı Tanımlı

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ını tanımladı.

value

string

Son kullanıcı, kullanıcı tanımlı verilerin belirttiği değeri.

Yöntemler

batchCreateContacts

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

Artan gecikme ve hatalardan kaçınmak için aynı kullanıcıya ait istek istekleri sırayla gönderilmelidir.

batchDeleteContacts

Bir kişi grubunu silin.

batchUpdateContacts

Bir grup kişiyi güncelleyin ve güncellenen kişiler için kaynak adlarının bir listesini PersonResponses'a döndürün.

createContact

Yeni bir kişi oluşturun ve söz konusu kişinin kişi kaynağını döndürün.

deleteContact

Bir kişiyi silin.

deleteContactPhoto

Kişinin fotoğrafını silme.

get

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

getBatchGet

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

listDirectoryPeople

Kimliği doğrulanmış kullanıcının alan dizininde, alan 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 listesini sağlar.

searchDirectoryPeople

Kimliği doğrulanmış kullanıcının alan dizininde, arama sorgusuyla eşleşen alan profillerinin ve alan kişilerinin listesini sağlar.

updateContact

Mevcut bir kişi kişisinin iletişim verilerini güncelleyin.

updateContactPhoto

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