REST Resource: people

Kaynak: Kişi

Bir kişi hakkında, kimliği doğrulanan kullanıcının kişileri ve profil verileri gibi çeşitli veri kaynaklarından birleştirilmiş bilgiler.

Çoğu alanda birden fazla öğe olabilir. Bir alandaki öğelerin garantili bir sırası yoktur, ancak boş olmayan her alanda metadata.primary öğesinin doğru değerine ayarlandığı tam olarak bir alan 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 için sunucu tarafından atanan kaynak adı. people/{person_id} biçimindeki 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)

Kişinin yaş grubu.

ageRanges[]

object (AgeRangeType)

Yalnızca çıkış. Kişinin yaş grupları.

biographies[]

object (Biography)

Kişinin biyografileri. Bu alan, kişi kaynakları için bir tekil değerdir.

birthdays[]

object (Birthday)

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

braggingRights[]
(deprecated)

object (BraggingRights)

KULLANIMDAN KALDIRILDI: Kişinin övünme hakları için 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)

Kişinin 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şinin daha fazla e-posta adresi varsa, people.getBatchGet numaralı telefonu arayarak tüm gruba ulaşabilirsiniz.

events[]

object (Event)

Kişinin etkinlikleri.

externalIds[]

object (ExternalId)

Kullanıcının harici kimlikleri.

fileAses[]

object (FileAs)

Kişinin dosya dosyaları.

genders[]

object (Gender)

Kişinin cinsiyetleri. Bu alan, kişi kaynakları için bir tekil değerdir.

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 tekil değerdir.

nicknames[]

object (Nickname)

Kişinin takma adları.

occupations[]

object (Occupation)

Kişinin meslekleri.

organizations[]

object (Organization)

Kişinin geçmişteki veya şu anki 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. Kişinin daha fazla telefon numarası varsa, people.getBatchGet numaralı telefonu arayarak tüm grubu edinebilirsiniz.

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: Kullanıcının ilişki ilgi alanları hiçbir veri döndürülmez.

relationshipStatuses[]
(deprecated)

object (RelationshipStatus)

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

residences[]
(deprecated)

object (Residence)

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

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ülmeyecektir.

urls[]

object (Url)

Kişinin ilişkili URL'leri.

userDefined[]

object (UserDefined)

Kişinin kullanıcı tanımlı 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.

Bir kişi ile profili bağlayan alanlar (ör. doğrulanmış e-posta, doğrulanmış telefon numarası veya profil URL'si) 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ğı silinmişse doğru değerini alı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 itirazının türü.

Kaynak

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ünde 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ük ve en fazla dokuz kesir basamağı olan, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

Birleştirme alanı metadata. Yalnızca person.metadata.sources içinde doldurulur.

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

profileMetadata

object (ProfileMetadata)

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

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

SourceType

Kaynağın türü.

Sıralamalar
SOURCE_TYPE_UNSPECIFIED Belirtilmedi.
ACCOUNT Google Hesabı.
PROFILE Google profili. Profili, https://profiles.google.com/{id} adresinden 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. Buradaki {id}, kaynak kimliğidir.
OTHER_CONTACT Google "Diğer kişi".
DOMAIN_CONTACT Google Workspace alanında paylaşılan kişi.

ProfileMetadata

Bir profille ilgili meta veriler.

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

enum (ObjectType)

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

userTypes[]

enum (UserType)

Yalnızca çıkış. Kullanıcı bir şeyler 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ı bir Google Workspace kullanıcısı.

Adres

Bir kişinin fiziksel adresi. Bir 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, kullanıcı tarafından ayarlanmazsa otomatik olarak yapılandırılmış değerlerden oluşturulur.

type

string

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

  • home
  • work
  • other
formattedType

string

Yalnızca çıkış. Görüntüleyenin hesap yerel ayarında veya Accept-Language HTTP üst bilgisi yerel ayarında çevrilmiş ve biçimlendirilmiş adresin türü.

poBox

string

Adresin posta kutusu.

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, kişideki tüm kaynaklar için birincil alansa doğru değerini alır. Her kullanıcının, primary değeri true olarak ayarlanmış en fazla bir alanı olur.

sourcePrimary

boolean

Alan, source için birincil alansa doğru değerini alır. Her kaynakta, sourcePrimary değeri true olarak ayarlanmış en fazla bir alan olmalıdır.

verified

boolean

Yalnızca çıkış. Alan doğrulanırsa doğru, alan doğrulanmamışsa false (yanlış) değerini alır. Doğrulanmış alan genellikle bir kişinin sahibi olduğu onaylanmış bir ad, e-posta adresi, telefon numarası veya web sitesidir.

source

object (Source)

Alanın kaynağı.

AgeRange

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 üstü.

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 üst 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 tarih 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

Ayarlanırsa 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

Doğum günü gibi tam veya kısmi bir takvim tarihini temsil eder. Günün saati ve saat dilimi başka bir yerde belirtilmiş veya önemsiz. Tarih, Miladi Takvim ile görelidir. 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ı olan bir ay ve gün (örneğin, yıl dönümü).
  • Sıfır ay ve sıfır gün olmak üzere tek başına bir yıl.
  • 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 tarih belirtmek için 0 olmalıdır.

month

integer

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

day

integer

Ayın günü. 1 ile 31 arasında olup yıl ve ay için geçerli olmalıdır. Yılın tek başına olduğu yıl ya da günün önemli olmadığı yıl ve ay belirtilmelidir.

BraggingRights

KULLANIMDAN KALDIRILDI: Kişilerin hayatta övünme haklarıyla ilgili hiçbir veri döndürülmeyecek.

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

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 aşağıdaki önceden tanımlanmış 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'si türü.

ClientData

Müşteriler tarafından doldurulan rastgele müşteri 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 verilerinin istemci tarafından belirtilen anahtarı.

value

string

İstemci tarafından belirtilen müşteri verileri değeri.

CoverPhoto

Bir kişinin kapak fotoğrafı. Kişinin profil sayfasında gösterilen, 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 True (doğru), 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 aşağıdaki önceden tanımlanmış değerlerden biri olabilir:

  • home
  • work
  • other
formattedType

string

Yalnızca çıkış. Görüntüleyenin hesap yerel ayarında veya Accept-Language HTTP üst bilgisi yerel ayarında çevrilmiş ve biçimlendirilmiş 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 aşağıdaki önceden tanımlanmış değerlerden biri olabilir:

  • anniversary
  • other
formattedType

string

Yalnızca çıkış. Görüntüleyenin hesap yerel ayarında veya Accept-Language HTTP üst bilgisi yerel ayarında çevrilmiş ve biçimlendirilen etkinliğin türü.

ExternalId

Kişiyle ilgili olan 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 aşağıdaki önceden tanımlanmış değerlerden biri olabilir:

  • account
  • customer
  • loginId
  • network
  • organization
formattedType

string

Yalnızca çıkış. Görüntüleyenin hesap yerel ayarında veya Accept-Language HTTP üst bilgisi yerel ayarında çevrilmiş ve biçimlendirilen etkinliğin türü.

FileAs

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

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

object (FieldMetadata)

Dosya adıyla ilgili meta veriler.

value

string

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 üst bilgisi yerel ayarında çevrilen ve biçimlendirilen cinsiyet değeri. Belirtilmemiş veya özel değer yerelleştirilmemiş.

addressMeAs

string

Kişiye hitap etmek için kullanılması gereken, hitap şekillerine yönelik serbest biçimli metin alanı. Genel 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 aşağıdaki önceden tanımlanmış değerlerden biri olabilir:

  • home
  • work
  • other
formattedType

string

Yalnızca çıkış. Görüntüleyenin hesap yerel ayarında veya Accept-Language HTTP üst bilgisi yerel ayarında çevrilmiş ve biçimlendirilmiş IM istemcisinin 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ış. İzleyicinin hesap yerel ayarında veya Accept-Language HTTP üst bilgisi yerel ayarında biçimlendirilmiş IM istemcisinin protokolü.

İlgi

Kişinin ilgi alanlarından biri.

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 ayarla ilgili meta veriler.

value

string

Yerel ayarı temsil eden, 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 aşağıdaki önceden tanımlanmış değerlerden biri olabilir:

  • desk
  • grewUp
current

boolean

Konumun mevcut konum olup olmadığı.

buildingId

string

Bina tanımlayıcısı.

floor

string

Kat adı veya numarası.

floorSection

string

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

deskCode

string

Ayrı 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

Bir Google Kişileri 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 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. Herhangi bir kişi grubu üyeliği kaldırılabilir, ancak yalnızca kullanıcı grubu veya "Kişilerim" ya da "yıldızlı" sistem grupları ü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 True (doğru) değerini alır.

MiscKeyword

Bir 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 üst bilgisi yerel ayarında çevrilmiş ve biçimlendirilmiş çeşitli anahtar kelimelerin türü.

KeywordType

Çeşitli anahtar kelime türü.

Sıralamalar
TYPE_UNSPECIFIED Belirtilmedi.
OUTLOOK_BILLING_INFORMATION Outlook'ta fatura bilgileri alanı görünür.
OUTLOOK_DIRECTORY_SERVER Dizin sunucusu için Outlook alanı.
OUTLOOK_KEYWORD Anahtar kelime için Outlook alanı.
OUTLOOK_MILEAGE Outlook alanı için de aynı durum geçerlidir.
OUTLOOK_PRIORITY Outlook alanı.
OUTLOOK_SENSITIVITY Outlook alanı görüntülenir.
OUTLOOK_SUBJECT Konu için Outlook alanı.
OUTLOOK_USER Outlook alanı.
HOME Ev'e dokunun
WORK İş'e gidin.
OTHER Diğer.

Ad

Bir kişinin adı. Ad tek ad ise soyadı 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çimlendirilen ve soyadına sahip 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

Mrs. veya Dr. gibi onursal önekler

honorificSuffix

string

Jr. gibi saygın sonekler

phoneticFullName

string

Tam ad, anlaşıldığı gibi yazılmış.

phoneticFamilyName

string

Soyadının yazıldığı şekilde.

phoneticGivenName

string

Verilen ad, göründüğü gibi yazılmış.

phoneticMiddleName

string

İkinci adlar telaffuzu gibi okunur.

phoneticHonorificPrefix

string

Okundukları gibi okunan saygın önekler.

phoneticHonorificSuffix

string

Okundukları gibi okunan onursal sonekler.

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 aile adı 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 Diğer ad, kişi tarafından tanınıyor.
SHORT_NAME

Kullanıcı adının daha kısa bir hali.

Meslek

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

  • work
  • school
formattedType

string

Yalnızca çıkış. Görüntüleyenin hesap yerel ayarında veya Accept-Language HTTP üst bilgisi yerel ayarında çevrilmiş ve biçimlendirilmiş kuruluş 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 True (doğru), kuruluş geçmişteki 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 iş unvanı.

jobDescription

string

Kişinin kurumdaki iş tanımı.

symbol

string

Kuruluşla ilişkilendirilen sembol; örneğin, hisse senedi sembolü, kısaltma veya ad.

domain

string

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

location

string

Kişinin çalıştığı kuruluş ofisinin yeri.

costCenter

string

Kişinin kurumdaki maliyet merkezi.

fullTimeEquivalentMillipercent

integer

Kişinin kuruluş içindeki tam zamanlı eş değeri (100.000 = %100).

PhoneNumber

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 aşağıdaki önceden tanımlanmış 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 üst bilgisi 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şinin adının yanında gösterilen 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 sz={size} sorgu parametresi ekleyerek istediğiniz boyutu değiştirebilirsiniz. Burada {size}, piksel cinsinden boyuttur. Ö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 (doğru), 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 üst veriler.

person

string

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

type

string

Kişinin diğer kişiyle olan ilişkisi. Tür, özel veya aşağıdaki önceden tanımlanmış 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 hesap yerel ayarında veya Accept-Language HTTP başlığında belirtilen yerel ayarda çevrilen ve biçimlendirilen ilişkinin türü.

RelationshipInterest

KULLANIMDAN KALDIRILDI: Kullanıcının ilişki ilişkisine dair hiçbir veri döndürülmez .

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

  • friend
  • date
  • relationship
  • networking
formattedValue

string

Yalnızca çıkış. Görüntüleyenin hesap yerel ayarında veya Accept-Language HTTP başlığında belirtilen yerel ayarda çevrilen ve biçimlendirilmiş ilişki ilgisinin değeri.

RelationshipStatus

KULLANIMDAN KALDIRILDI: Kullanıcının ilişki durumu hiçbir veri döndürülmez.

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 aşağıdaki önceden tanımlanmış 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 üst bilgisi yerel ayarında çevrilen ve biçimlendirilmiş ilişki durumunun değeri.

Konut

KULLANIMDAN KALDIRILDI: Lütfen bunun yerine person.locations kullanın. Kişinin geçmişte veya şu anda yaşadığı yer.

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

object (FieldMetadata)

Konutla ilgili meta veriler.

value

string

İkametgah adresi.

current

boolean

İkamet, kişinin mevcut ikametgahıysa doğru; konut eski 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ş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 aşağıdaki önceden tanımlanmış 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 üst bilgisi yerel ayarında çevrilmiş ve biçimlendirilmiş SIP adresinin türü.

Skill

Kişinin sahip olduğu bir beceridir.

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

object (FieldMetadata)

Beceriyle ilgili üst veriler.

value

string

Beceri; örneğin, underwater basket weaving.

Kısa açıklama

KULLANIMDAN KALDIRILDI: Hiçbir veri döndürülmeyecek Kullanıcıyla ilgili kısa bir tek satırlık 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

Bir kişinin 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 aşağıdaki önceden tanımlanmış değerlerden biri olabilir:

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

string

Yalnızca çıkış. Görüntüleyenin hesap yerel ayarında veya Accept-Language HTTP üst bilgisi yerel ayarında çevrilmiş ve biçimlendirilmiş 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

Kullanıcı tanımlı verilerin son kullanıcı tarafından belirtilen anahtarı.

value

string

Kullanıcı tanımlı veriler için son kullanıcı tarafından belirtilen değer.

Yöntemler

batchCreateContacts

Bir grup yeni kişi oluşturun ve yeni kişiler için PersonResponses bilgilerini

Aynı kullanıcıya yönelik değişiklik istekleri, gecikme ve hata sayısında artış olmaması için sırayla gönderilmelidir.

batchDeleteContacts

Kişileri toplu olarak silebilirsiniz.

batchUpdateContacts

Bir kişi grubunu güncelleyin ve güncellenmiş kişiler için PersonResponses'a kaynak adları haritasını döndürün.

createContact

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

deleteContact

Kişiyi silme

deleteContactPhoto

Kişinin fotoğrafını silme.

get

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

getBatchGet

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

listDirectoryPeople

Kimliği doğrulanmış kullanıcının alan dizinindeki 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 dizinindeki, arama sorgusuyla eşleşen alan adı profillerinin ve alan kişilerinin bir listesini sağlar.

updateContact

Mevcut bir ilgili kişinin iletişim verilerini güncelleme.

updateContactPhoto

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