REST Resource: people

Resource: Person

Informasi tentang seseorang digabungkan dari berbagai sumber data, seperti data kontak dan profil pengguna yang diautentikasi.

Sebagian besar kolom dapat memiliki beberapa item. Item dalam kolom tidak memiliki urutan yang dijamin, tetapi setiap kolom yang tidak kosong dijamin memiliki tepat satu kolom dengan metadata.primary ditetapkan ke benar (true).

Representasi JSON
{
  "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)
    }
  ]
}
Kolom
resourceName

string

Nama resource untuk orang, yang ditetapkan oleh server. String ASCII dalam bentuk people/{person_id}.

etag

string

Tag entity HTTP dari resource. Digunakan untuk validasi cache web.

metadata

object (PersonMetadata)

Hanya output. Metadata tentang orang tersebut.

addresses[]

object (Address)

Alamat orang tersebut.

ageRange
(deprecated)

enum (AgeRange)

Hanya output. TIDAK DIGUNAKAN LAGI (Sebagai gantinya, gunakan person.ageRanges)

Rentang usia orang tersebut.

ageRanges[]

object (AgeRangeType)

Hanya output. Rentang usia orang.

biographies[]

object (Biography)

Biografi orang tersebut. Kolom ini adalah singleton untuk sumber kontak.

birthdays[]

object (Birthday)

Ulang tahun orang tersebut. Kolom ini adalah singleton untuk sumber kontak.

braggingRights[]
(deprecated)

object (BraggingRights)

TIDAK DIGUNAKAN LAGI: Tidak ada data yang akan ditampilkan Hak yang dibanggakan seseorang.

calendarUrls[]

object (CalendarUrl)

URL kalender orang tersebut.

clientData[]

object (ClientData)

Data klien orang tersebut.

coverPhotos[]

object (CoverPhoto)

Hanya output. Foto sampul orang tersebut.

emailAddresses[]

object (EmailAddress)

Alamat email pengguna tersebut. Untuk people.connections.list dan otherContacts.list, jumlah alamat email dibatasi hingga 100. Jika Orang memiliki lebih banyak alamat email, seluruh kumpulan dapat diperoleh dengan memanggil people.getBatchGet.

events[]

object (Event)

Peristiwa seseorang.

externalIds[]

object (ExternalId)

ID eksternal seseorang.

fileAses[]

object (FileAs)

{i>File-ases<i} orang tersebut.

genders[]

object (Gender)

Gender orang tersebut. Kolom ini adalah singleton untuk sumber kontak.

imClients[]

object (ImClient)

Klien pesan instan orang tersebut.

interests[]

object (Interest)

Minat orang tersebut.

locales[]

object (Locale)

Preferensi lokalitas orang tersebut.

locations[]

object (Location)

Lokasi pengguna.

memberships[]

object (Membership)

Keanggotaan grup orang tersebut.

miscKeywords[]

object (MiscKeyword)

Kata kunci lain-lain dari orang tersebut.

names[]

object (Name)

Nama orang. Kolom ini adalah singleton untuk sumber kontak.

nicknames[]

object (Nickname)

Nama panggilan orang tersebut.

occupations[]

object (Occupation)

Pekerjaan orang tersebut.

organizations[]

object (Organization)

Organisasi orang tersebut di masa lalu atau saat ini.

phoneNumbers[]

object (PhoneNumber)

Nomor telepon orang tersebut. Untuk people.connections.list dan otherContacts.list, jumlah nomor telepon dibatasi hingga 100. Jika Orang memiliki lebih banyak nomor telepon, seluruh kumpulan dapat diperoleh dengan memanggil people.getBatchGet.

photos[]

object (Photo)

Hanya output. Foto orang tersebut.

relations[]

object (Relation)

Hubungan orang tersebut.

relationshipInterests[]
(deprecated)

object (RelationshipInterest)

Hanya output. TIDAK DIGUNAKAN LAGI: Tidak ada data yang akan ditampilkan Minat hubungan pengguna tersebut.

relationshipStatuses[]
(deprecated)

object (RelationshipStatus)

Hanya output. TIDAK DIGUNAKAN LAGI: Tidak ada data yang akan ditampilkan Status hubungan pengguna tersebut.

residences[]
(deprecated)

object (Residence)

TIDAK DIGUNAKAN LAGI: (Sebagai gantinya, harap gunakan person.locations) Kediaman orang tersebut.

sipAddresses[]

object (SipAddress)

Alamat SIP orang tersebut.

skills[]

object (Skill)

Keterampilan orang tersebut.

taglines[]
(deprecated)

object (Tagline)

Hanya output. TIDAK DIGUNAKAN LAGI: Tidak ada data yang akan ditampilkan Tagline orang tersebut.

urls[]

object (Url)

URL terkait orang tersebut.

userDefined[]

object (UserDefined)

Data buatan pengguna milik seseorang.

PersonMetadata

{i>Metadata<i} tentang seseorang.

Representasi JSON
{
  "sources": [
    {
      object (Source)
    }
  ],
  "previousResourceNames": [
    string
  ],
  "linkedPeopleResourceNames": [
    string
  ],
  "deleted": boolean,
  "objectType": enum (ObjectType)
}
Kolom
sources[]

object (Source)

Sumber data untuk orang tersebut.

previousResourceNames[]

string

Hanya output. Nama resource sebelumnya yang dimiliki orang ini. Hanya diisi untuk permintaan people.connections.list yang menyertakan token sinkronisasi.

Nama fasilitas dapat berubah saat menambahkan atau menghapus kolom yang menautkan kontak dan profil seperti email terverifikasi, nomor telepon terverifikasi, atau URL profil.

linkedPeopleResourceNames[]

string

Hanya output. Nama resource orang yang tertaut ke resource ini.

deleted

boolean

Hanya output. True jika resource orang telah dihapus. Hanya diisi untuk permintaan sinkronisasi people.connections.list dan otherContacts.list.

objectType
(deprecated)

enum (ObjectType)

Hanya output. TIDAK DIGUNAKAN LAGI (Sebagai gantinya, gunakan person.metadata.sources.profileMetadata.objectType)

Jenis objek orang.

Sumber

Sumber kolom.

Representasi JSON
{
  "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.
}
Kolom
type

enum (SourceType)

Jenis sumber.

id

string

ID unik dalam jenis sumber yang dihasilkan oleh server.

etag

string

Hanya diisi di person.metadata.sources.

Tag entity HTTP sumber. Digunakan untuk validasi cache web.

updateTime

string (Timestamp format)

Hanya output. Hanya diisi di person.metadata.sources.

Stempel waktu update terakhir sumber ini.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

Kolom union metadata. Hanya diisi di person.metadata.sources.

Metadata tentang sumber. metadata hanya dapat berupa salah satu dari yang berikut:

profileMetadata

object (ProfileMetadata)

Hanya output. Hanya diisi di person.metadata.sources.

Metadata tentang sumber jenis PROFILE.

SourceType

Jenis sumber.

Enum
SOURCE_TYPE_UNSPECIFIED Tidak ditentukan.
ACCOUNT Akun Google.
PROFILE Profil Google. Anda dapat melihat profil di https://profiles.google.com/{id}, dengan {id} adalah ID sumber.
DOMAIN_PROFILE Profil domain Google Workspace.
CONTACT Kontak Google. Anda dapat melihat kontak di https://contact.google.com/{id}, dengan {id} sebagai ID sumber.
OTHER_CONTACT "Kontak lainnya" di Google.
DOMAIN_CONTACT Kontak bersama domain Google Workspace.

ProfileMetadata

Metadata tentang profil.

Representasi JSON
{
  "objectType": enum (ObjectType),
  "userTypes": [
    enum (UserType)
  ]
}
Kolom
objectType

enum (ObjectType)

Hanya output. Jenis objek profil.

userTypes[]

enum (UserType)

Hanya output. Jenis pengguna.

ObjectType

Jenis objek orang.

Enum
OBJECT_TYPE_UNSPECIFIED Tidak ditentukan.
PERSON Pengguna.
PAGE Halaman Currents.

UserType

Jenis pengguna.

Enum
USER_TYPE_UNKNOWN Jenis penggunanya tidak diketahui.
GOOGLE_USER Pengguna adalah pengguna Google.
GPLUS_USER Pengguna adalah pengguna Currents.
GOOGLE_APPS_USER Pengguna adalah pengguna Google Workspace.

Alamat

Alamat fisik seseorang. Dapat berupa P.O. box atau alamat. Semua kolom bersifat opsional.

Representasi JSON
{
  "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
}
Kolom
metadata

object (FieldMetadata)

Metadata tentang alamat.

formattedValue

string

Nilai alamat yang tidak terstruktur. Jika tidak ditetapkan oleh pengguna, atribut ini akan dibuat dari nilai terstruktur secara otomatis.

type

string

Jenis alamat. Jenis dapat berupa kustom atau salah satu dari nilai yang telah ditentukan berikut:

  • home
  • work
  • other
formattedType

string

Hanya output. Jenis alamat yang diterjemahkan dan diformat dalam lokalitas akun pelihat atau lokalitas header HTTP Accept-Language.

poBox

string

P.O. box alamat.

streetAddress

string

Alamat.

extendedAddress

string

Alamat lengkap dari alamat tersebut; misalnya, nomor apartemen.

city

string

Kota alamat.

region

string

Wilayah alamat; misalnya, negara bagian atau provinsi.

postalCode

string

Kode pos alamat.

country

string

Negara alamat.

countryCode

string

Kode negara ISO 3166-1 alpha-2 untuk alamat.

FieldMetadata

Metadata tentang kolom.

Representasi JSON
{
  "primary": boolean,
  "sourcePrimary": boolean,
  "verified": boolean,
  "source": {
    object (Source)
  }
}
Kolom
primary

boolean

Hanya output. True jika kolom adalah kolom utama untuk semua sumber dalam orang tersebut. Setiap orang akan memiliki maksimal satu kolom dengan primary ditetapkan ke benar (true).

sourcePrimary

boolean

Benar jika kolom adalah kolom utama untuk source. Setiap sumber harus memiliki maksimal satu kolom dengan sourcePrimary ditetapkan ke true.

verified

boolean

Hanya output. Benar jika kolom diverifikasi; salah jika kolom belum diverifikasi. Kolom terverifikasi biasanya berupa nama, alamat email, nomor telepon, atau situs yang telah dikonfirmasi sebagai milik orang tersebut.

source

object (Source)

Sumber kolom.

AgeRange

TIDAK DIGUNAKAN LAGI (Sebagai gantinya, gunakan person.ageRanges)

Rentang usia seseorang.

Enum
AGE_RANGE_UNSPECIFIED Tidak ditentukan.
LESS_THAN_EIGHTEEN Lebih muda dari delapan belas tahun.
EIGHTEEN_TO_TWENTY Antara delapan belas sampai dua puluh.
TWENTY_ONE_OR_OLDER Dua puluh satu tahun ke atas.

AgeRangeType

Rentang usia seseorang.

Representasi JSON
{
  "metadata": {
    object (FieldMetadata)
  },
  "ageRange": enum (AgeRange)
}
Kolom
metadata

object (FieldMetadata)

Metadata tentang rentang usia.

ageRange

enum (AgeRange)

Rentang usia.

Biografi

Biografi singkat seseorang.

Representasi JSON
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "contentType": enum (ContentType)
}
Kolom
metadata

object (FieldMetadata)

Metadata tentang biografi.

value

string

Biografi singkat.

contentType

enum (ContentType)

Jenis konten biografi.

ContentType

Jenis konten.

Enum
CONTENT_TYPE_UNSPECIFIED Tidak ditentukan.
TEXT_PLAIN Teks biasa.
TEXT_HTML Teks HTML.

Ulang Tahun

Ulang tahun seseorang. Setidaknya salah satu kolom date dan text ditentukan. Kolom date dan text biasanya merepresentasikan tanggal yang sama, tetapi tidak dijamin. Klien harus selalu menetapkan kolom date saat mengubah tanggal lahir.

Representasi JSON
{
  "metadata": {
    object (FieldMetadata)
  },
  "date": {
    object (Date)
  },
  "text": string
}
Kolom
metadata

object (FieldMetadata)

Metadata tentang ulang tahun.

date

object (Date)

Tanggal terstruktur ulang tahun.

text
(deprecated)

string

Pilih untuk menggunakan kolom date jika ditetapkan.

String bentuk bebas yang mewakili tanggal lahir pengguna. Nilai ini tidak divalidasi.

Tanggal

Mewakili seluruh atau sebagian tanggal kalender, seperti ulang tahun. Waktu dan zona waktu ditentukan di tempat lain atau tidak signifikan. Tanggal tersebut relatif terhadap Kalender Gregorian. Ini dapat mewakili salah satu dari hal berikut:

  • Tanggal lengkap, dengan nilai tahun, bulan, dan hari bukan nol.
  • Bulan dan hari, dengan nol tahun (misalnya, hari jadi).
  • Setahun dengan sendirinya, dengan bulan nol dan hari nol.
  • Tahun dan bulan, dengan nol hari (misalnya, tanggal habis masa berlaku kartu kredit).

Jenis terkait:

Representasi JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
Kolom
year

integer

Tahun dalam tanggal. Harus dari 1 hingga 9999, atau 0 untuk menentukan tanggal tanpa tahun.

month

integer

Bulan dalam setahun. Harus dari 1 hingga 12, atau 0 untuk menentukan tahun tanpa bulan dan hari.

day

integer

Hari dalam sebulan. Harus dari 1 hingga 31 dan berlaku untuk tahun dan bulan, atau 0 untuk menentukan tahun saja atau tahun dan bulan jika hari dianggap tidak signifikan.

BraggingRights

TIDAK DIGUNAKAN LAGI: Tidak ada data yang akan ditampilkan sebagai hak yang dibanggakan seseorang.

Representasi JSON
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}
Kolom
metadata

object (FieldMetadata)

Metadata tentang hal-hal yang dibanggakan.

value

string

Hal-hal yang dibanggakan; misalnya, climbed mount everest.

CalendarUrl

URL kalender seseorang.

Representasi JSON
{
  "metadata": {
    object (FieldMetadata)
  },
  "url": string,
  "type": string,
  "formattedType": string
}
Kolom
metadata

object (FieldMetadata)

Metadata tentang URL kalender.

url

string

URL kalender.

type

string

Jenis URL kalender. Jenis dapat berupa kustom atau salah satu dari nilai yang telah ditentukan berikut:

  • home
  • freeBusy
  • work
formattedType

string

Hanya output. Jenis URL kalender yang diterjemahkan dan diformat dalam lokalitas akun pelihat atau lokalitas header HTTP Accept-Language.

ClientData

Data klien arbitrer yang diisi oleh klien. Kunci dan nilai duplikat diizinkan.

Representasi JSON
{
  "metadata": {
    object (FieldMetadata)
  },
  "key": string,
  "value": string
}
Kolom
metadata

object (FieldMetadata)

Metadata tentang data klien.

key

string

Kunci yang ditentukan klien dari data klien.

value

string

Klien menentukan nilai data klien.

CoverPhoto

Foto sampul seseorang. Gambar besar yang ditampilkan di halaman profil seseorang yang mewakili siapa mereka atau apa yang mereka pedulikan.

Representasi JSON
{
  "metadata": {
    object (FieldMetadata)
  },
  "url": string,
  "default": boolean
}
Kolom
metadata

object (FieldMetadata)

Metadata tentang foto sampul.

url

string

URL foto sampul.

default

boolean

Benar jika foto sampul adalah foto sampul default; salah jika foto sampul adalah foto sampul yang diberikan pengguna.

EmailAddress

Alamat email pengguna.

Representasi JSON
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": string,
  "formattedType": string,
  "displayName": string
}
Kolom
metadata

object (FieldMetadata)

Metadata tentang alamat email.

value

string

Alamat email.

type

string

Jenis alamat email. Jenis dapat berupa kustom atau salah satu dari nilai yang telah ditentukan berikut:

  • home
  • work
  • other
formattedType

string

Hanya output. Jenis alamat email yang diterjemahkan dan diformat dalam lokalitas akun pelihat atau lokalitas header HTTP Accept-Language.

displayName

string

Nama tampilan email.

Event

Peristiwa yang terkait dengan orang tersebut.

Representasi JSON
{
  "metadata": {
    object (FieldMetadata)
  },
  "date": {
    object (Date)
  },
  "type": string,
  "formattedType": string
}
Kolom
metadata

object (FieldMetadata)

Metadata tentang peristiwa.

date

object (Date)

Tanggal peristiwa.

type

string

Jenis peristiwa. Jenis dapat berupa kustom atau salah satu dari nilai yang telah ditentukan berikut:

  • anniversary
  • other
formattedType

string

Hanya output. Jenis acara yang diterjemahkan dan diformat dalam lokalitas akun penonton atau lokalitas header HTTP Accept-Language.

ExternalId

ID dari entitas eksternal yang terkait dengan orang tersebut.

Representasi JSON
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": string,
  "formattedType": string
}
Kolom
metadata

object (FieldMetadata)

Metadata tentang ID eksternal.

value

string

Nilai ID eksternal.

type

string

Jenis ID eksternal. Jenis dapat berupa kustom atau salah satu dari nilai yang telah ditentukan berikut:

  • account
  • customer
  • loginId
  • network
  • organization
formattedType

string

Hanya output. Jenis acara yang diterjemahkan dan diformat dalam lokalitas akun penonton atau lokalitas header HTTP Accept-Language.

FileAs

Nama yang harus digunakan untuk mengurutkan orang dalam daftar.

Representasi JSON
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}
Kolom
metadata

object (FieldMetadata)

Metadata tentang file-as.

value

string

Nilai {i>file-as<i}

Gender

Jenis kelamin seseorang.

Representasi JSON
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "formattedValue": string,
  "addressMeAs": string
}
Kolom
metadata

object (FieldMetadata)

Metadata tentang gender.

value

string

Gender untuk orang tersebut. Gender dapat berupa gender khusus atau salah satu dari nilai yang telah ditentukan berikut:

  • male
  • female
  • unspecified
formattedValue

string

Hanya output. Nilai gender yang diterjemahkan dan diformat dalam lokalitas akun pelihat atau lokalitas header HTTP Accept-Language. Nilai kustom atau tidak ditentukan tidak dilokalkan.

addressMeAs

string

Kolom teks bentuk bebas untuk sebutan yang harus digunakan untuk memanggil orang tersebut. Nilai umumnya adalah:

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

ImClient

Klien pesan instan seseorang.

Representasi JSON
{
  "metadata": {
    object (FieldMetadata)
  },
  "username": string,
  "type": string,
  "formattedType": string,
  "protocol": string,
  "formattedProtocol": string
}
Kolom
metadata

object (FieldMetadata)

Metadata tentang klien IM.

username

string

Nama pengguna yang digunakan di klien IM.

type

string

Jenis klien IM. Jenis dapat berupa kustom atau salah satu dari nilai yang telah ditentukan berikut:

  • home
  • work
  • other
formattedType

string

Hanya output. Jenis klien IM yang diterjemahkan dan diformat dalam lokalitas akun pelihat atau lokalitas header HTTP Accept-Language.

protocol

string

Protokol klien IM. Protokol tersebut dapat berupa protokol khusus atau salah satu dari nilai yang telah ditentukan berikut:

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

string

Hanya output. Protokol klien IM yang diformat dalam lokalitas akun pelihat atau lokalitas header HTTP Accept-Language.

Minat

Salah satu minat orang tersebut.

Representasi JSON
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}
Kolom
metadata

object (FieldMetadata)

Metadata tentang minat.

value

string

Minat; misalnya, stargazing.

Lokalitas

Preferensi lokalitas seseorang.

Representasi JSON
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}
Kolom
metadata

object (FieldMetadata)

Metadata tentang lokalitas.

value

string

Tag bahasa IETF BCP 47 yang disusun dengan baik mewakili lokalitas.

Lokasi

Lokasi seseorang.

Representasi JSON
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": string,
  "current": boolean,
  "buildingId": string,
  "floor": string,
  "floorSection": string,
  "deskCode": string
}
Kolom
metadata

object (FieldMetadata)

Metadata tentang lokasi.

value

string

Nilai bentuk bebas lokasi.

type

string

Jenis lokasi. Jenis dapat berupa kustom atau salah satu dari nilai yang telah ditentukan berikut:

  • desk
  • grewUp
current

boolean

Apakah lokasi adalah lokasi saat ini.

buildingId

string

ID gedung.

floor

string

Nama atau nomor lantai.

floorSection

string

Bagian lantai di floor_name.

deskCode

string

Lokasi masing-masing meja.

Langganan

Keanggotaan seseorang dalam grup. Hanya keanggotaan grup kontak yang dapat diubah.

Representasi JSON
{
  "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.
}
Kolom
metadata

object (FieldMetadata)

Metadata tentang keanggotaan.

Kolom union membership. Keanggotaan. membership hanya ada berupa salah satu diantara berikut:
contactGroupMembership

object (ContactGroupMembership)

Keanggotaan grup kontak.

domainMembership

object (DomainMembership)

Hanya output. Keanggotaan domain.

ContactGroupMembership

Keanggotaan grup kontak Google.

Representasi JSON
{
  "contactGroupId": string,
  "contactGroupResourceName": string
}
Kolom
contactGroupId
(deprecated)

string

Hanya output. ID grup kontak untuk keanggotaan grup kontak.

contactGroupResourceName

string

Nama resource untuk grup kontak, yang ditetapkan oleh server. String ASCII, dalam bentuk contactGroups/{contactGroupId}. Hanya contactGroupResourceName yang dapat digunakan untuk mengubah keanggotaan. Semua keanggotaan grup kontak dapat dihapus, tetapi hanya grup pengguna atau keanggotaan grup sistem "myContacts" atau "berbintang" yang dapat ditambahkan. Kontak harus selalu memiliki setidaknya satu keanggotaan grup kontak.

DomainMembership

Keanggotaan Domain Google Workspace.

Representasi JSON
{
  "inViewerDomain": boolean
}
Kolom
inViewerDomain

boolean

True jika orang tersebut berada di domain Google Workspace pelihat.

MiscKeyword

Kata kunci lain-lain dari seseorang.

Representasi JSON
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": enum (KeywordType),
  "formattedType": string
}
Kolom
metadata

object (FieldMetadata)

Metadata tentang kata kunci lain-lain.

value

string

Nilai kata kunci lain-lain.

type

enum (KeywordType)

Jenis kata kunci lain-lain.

formattedType

string

Hanya output. Jenis kata kunci lain-lain yang diterjemahkan dan diformat dalam lokalitas akun audiens atau lokalitas header HTTP Accept-Language.

KeywordType

Jenis kata kunci lain-lain.

Enum
TYPE_UNSPECIFIED Tidak ditentukan.
OUTLOOK_BILLING_INFORMATION Kolom Outlook untuk informasi penagihan.
OUTLOOK_DIRECTORY_SERVER Bidang Outlook untuk server direktori.
OUTLOOK_KEYWORD Kolom Outlook untuk kata kunci.
OUTLOOK_MILEAGE Kolom Outlook untuk jarak tempuh.
OUTLOOK_PRIORITY Kolom Outlook untuk prioritas.
OUTLOOK_SENSITIVITY Kolom Outlook untuk sensitivitas.
OUTLOOK_SUBJECT Kolom Outlook untuk subjek.
OUTLOOK_USER Kolom Outlook untuk pengguna.
HOME Layar utama.
WORK Kantor.
OTHER Lainnya.

Nama

Nama seseorang. Jika nama adalah mononim, nama keluarga kosong.

Representasi JSON
{
  "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
}
Kolom
metadata

object (FieldMetadata)

Metadata tentang nama.

displayName

string

Hanya output. Nama tampilan diformat sesuai dengan lokalitas yang ditentukan oleh akun pelihat atau header HTTP Accept-Language.

displayNameLastFirst

string

Hanya output. Nama tampilan dengan nama belakang yang terlebih dahulu diformat sesuai dengan lokalitas yang ditentukan oleh akun penonton atau header HTTP Accept-Language.

unstructuredName

string

Nilai nama bentuk bebas.

familyName

string

Nama keluarga.

givenName

string

Nama depan.

middleName

string

Nama tengah.

honorificPrefix

string

Awalan kehormatan, seperti Mrs. atau Dr.

honorificSuffix

string

Akhiran kehormatan, seperti Jr.

phoneticFullName

string

Nama lengkap dieja seperti kedengarannya.

phoneticFamilyName

string

Nama keluarga yang dieja sesuai kedengarannya.

phoneticGivenName

string

Nama yang diberikan dieja sesuai kedengarannya.

phoneticMiddleName

string

Nama tengah dieja sesuai bunyinya.

phoneticHonorificPrefix

string

Awalan kehormatan yang dieja sesuai bunyinya.

phoneticHonorificSuffix

string

Akhiran kehormatan yang dieja sesuai dengan bunyinya.

Nama

Nama panggilan seseorang.

Representasi JSON
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": enum (NicknameType)
}
Kolom
metadata

object (FieldMetadata)

Metadata tentang nama panggilan.

value

string

Nama panggilan.

type

enum (NicknameType)

Jenis nama panggilan.

NicknameType

Jenis nama panggilan.

Enum
DEFAULT Nama panggilan umum.
MAIDEN_NAME

Nama sebelum menikah atau nama belakang. Digunakan ketika nama keluarga seseorang telah berubah sebagai akibat dari pernikahan.

INITIALS

Inisial.

GPLUS

Nama panggilan profil Google+.

OTHER_NAME

Afiliasi profesional atau nama lain; misalnya, Dr. Smith.

ALTERNATE_NAME Nama alternatif orang dikenali.
SHORT_NAME

Versi yang lebih pendek dari nama orang.

Pekerjaan

Pekerjaan seseorang.

Representasi JSON
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}
Kolom
metadata

object (FieldMetadata)

Metadata tentang pekerjaan.

value

string

Pekerjaan; misalnya, carpenter.

Organisasi

Organisasi seseorang di masa lalu atau saat ini. Rentang tanggal yang tumpang-tindih diizinkan.

Representasi JSON
{
  "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
}
Kolom
metadata

object (FieldMetadata)

Metadata tentang organisasi.

type

string

Jenis organisasi. Jenis dapat berupa kustom atau salah satu dari nilai yang telah ditentukan berikut:

  • work
  • school
formattedType

string

Hanya output. Jenis organisasi yang diterjemahkan dan diformat dalam lokalitas akun pelihat atau lokalitas header HTTP Accept-Language.

startDate

object (Date)

Tanggal mulai saat orang tersebut bergabung ke organisasi.

endDate

object (Date)

Tanggal akhir saat pengguna tersebut keluar dari organisasi.

current

boolean

Benar jika organisasi adalah organisasi saat ini milik orang tersebut; salah jika organisasi tersebut adalah organisasi sebelumnya.

name

string

Nama organisasi.

phoneticName

string

Nama fonetik organisasi.

department

string

Departemen orang di organisasi.

title

string

Jabatan orang tersebut di organisasi.

jobDescription

string

Deskripsi pekerjaan orang tersebut di organisasi.

symbol

string

Simbol yang terkait dengan organisasi; misalnya, simbol saham, singkatan, atau akronim.

domain

string

Nama domain yang terkait dengan organisasi; misalnya, google.com.

location

string

Lokasi kantor organisasi tempat orang bekerja.

costCenter

string

Pusat biaya seseorang di organisasi.

fullTimeEquivalentMillipercent

integer

Milipersen setara penuh waktu seseorang dalam organisasi (100000 = 100%).

PhoneNumber

Nomor telepon seseorang.

Representasi JSON
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "canonicalForm": string,
  "type": string,
  "formattedType": string
}
Kolom
metadata

object (FieldMetadata)

Metadata tentang nomor telepon.

value

string

Nomor telepon.

canonicalForm

string

Hanya output. Bentuk ITU-T E.164 yang dikanonikalisasi dari nomor telepon.

type

string

Jenis nomor telepon. Jenis dapat berupa kustom atau salah satu dari nilai yang telah ditentukan berikut:

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

string

Hanya output. Jenis nomor telepon yang diterjemahkan dan diformat dalam lokalitas akun pelihat atau lokalitas header HTTP Accept-Language.

Foto

Foto seseorang. Gambar yang ditampilkan di samping nama orang untuk membantu orang lain mengenali orang tersebut.

Representasi JSON
{
  "metadata": {
    object (FieldMetadata)
  },
  "url": string,
  "default": boolean
}
Kolom
metadata

object (FieldMetadata)

Metadata tentang foto.

url

string

URL foto. Anda dapat mengubah ukuran yang diinginkan dengan menambahkan parameter kueri sz={size} di akhir URL, dengan {size} adalah ukuran dalam piksel. Contoh: https://lh3.googleusercontent.com/-T_wVWLlmg7w/AAAAAAAAAAI/AAAAAAAABa8/00gzXvDBYqw/s100/photo.jpg?sz=50

default

boolean

Benar jika foto adalah foto default; salah jika foto adalah foto yang diberikan pengguna.

Hubungan

Hubungan seseorang dengan orang lain.

Representasi JSON
{
  "metadata": {
    object (FieldMetadata)
  },
  "person": string,
  "type": string,
  "formattedType": string
}
Kolom
metadata

object (FieldMetadata)

Metadata tentang relasi.

person

string

Nama orang yang dirujuk oleh relasi ini.

type

string

Hubungan seseorang dengan orang lain. Jenis dapat berupa kustom atau salah satu dari nilai yang telah ditentukan berikut:

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

string

Hanya output. Jenis relasi yang diterjemahkan dan diformat dalam lokalitas akun pelihat atau lokal yang ditentukan dalam header HTTP Accept-Language.

RelationshipInterest

TIDAK DIGUNAKAN LAGI: Tidak ada data yang akan ditampilkan Ketertarikan hubungan seseorang .

Representasi JSON
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "formattedValue": string
}
Kolom
metadata

object (FieldMetadata)

Metadata tentang minat hubungan.

value

string

Jenis hubungan yang dicari oleh orang tersebut. Nilainya dapat berupa nilai khusus atau salah satu dari nilai yang telah ditentukan berikut:

  • friend
  • date
  • relationship
  • networking
formattedValue

string

Hanya output. Nilai minat hubungan yang diterjemahkan dan diformat dalam lokalitas akun pelihat atau lokal yang ditentukan dalam header HTTP Accept-Language.

RelationshipStatus

TIDAK DIGUNAKAN LAGI: Tidak ada data yang akan ditampilkan Status hubungan seseorang.

Representasi JSON
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "formattedValue": string
}
Kolom
metadata

object (FieldMetadata)

Metadata tentang status hubungan.

value

string

Status hubungan. Nilainya dapat berupa nilai khusus atau salah satu dari nilai yang telah ditentukan berikut:

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

string

Hanya output. Nilai status hubungan yang diterjemahkan dan diformat dalam lokalitas akun pelihat atau lokalitas header HTTP Accept-Language.

Kediaman

TIDAK DIGUNAKAN LAGI: Sebagai gantinya, gunakan person.locations. Tempat tinggal seseorang sebelumnya atau saat ini.

Representasi JSON
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "current": boolean
}
Kolom
metadata

object (FieldMetadata)

Metadata tentang tempat tinggal.

value

string

Alamat tempat tinggal.

current

boolean

Benar jika tempat tinggal adalah tempat tinggal pengguna saat ini; salah jika tempat tinggal tersebut adalah tempat tinggal sebelumnya.

SipAddress

Alamat SIP seseorang. Alamat Protokol Awal Sesi digunakan untuk komunikasi VoIP untuk melakukan panggilan suara atau video melalui internet.

Representasi JSON
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": string,
  "formattedType": string
}
Kolom
metadata

object (FieldMetadata)

Metadata tentang alamat SIP.

value

string

Alamat SIP dalam format SIP URI RFC 3261 19.1.

type

string

Jenis alamat SIP. Jenis dapat berupa kustom atau salah satu dari nilai yang telah ditentukan berikut:

  • home
  • work
  • mobile
  • other
formattedType

string

Hanya output. Jenis alamat SIP yang diterjemahkan dan diformat dalam lokalitas akun pelihat atau lokalitas header HTTP Accept-Language.

Keterampilan

Keterampilan yang dimiliki orang tersebut.

Representasi JSON
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}
Kolom
metadata

object (FieldMetadata)

Metadata tentang keterampilan.

value

string

Keterampilan; misalnya, underwater basket weaving.

Tagline

TIDAK DIGUNAKAN LAGI: Tidak ada data yang akan ditampilkan. Deskripsi singkat satu baris tentang orang tersebut.

Representasi JSON
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}
Kolom
metadata

object (FieldMetadata)

Metadata tentang tagline.

value

string

Tagline.

URL

URL terkait seseorang.

Representasi JSON
{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": string,
  "formattedType": string
}
Kolom
metadata

object (FieldMetadata)

Metadata tentang URL.

value

string

URL.

type

string

Jenis URL. Jenis dapat berupa kustom atau salah satu dari nilai yang telah ditentukan berikut:

  • home
  • work
  • blog
  • profile
  • homePage
  • ftp
  • reservations
  • appInstallPage: situs untuk aplikasi Currents.
  • other
formattedType

string

Hanya output. Jenis URL yang diterjemahkan dan diformat dalam lokalitas akun pelihat atau lokalitas header HTTP Accept-Language.

UserDefined

Data pengguna arbitrer yang diisi oleh pengguna akhir.

Representasi JSON
{
  "metadata": {
    object (FieldMetadata)
  },
  "key": string,
  "value": string
}
Kolom
metadata

object (FieldMetadata)

Metadata tentang data yang ditentukan pengguna.

key

string

Kunci yang ditentukan pengguna akhir dari data buatan pengguna.

value

string

Nilai yang ditentukan pengguna akhir dari data yang ditetapkan pengguna.

Metode

batchCreateContacts

Buat batch kontak baru dan tampilkan PersonResponses untuk kontak baru

Permintaan yang berubah untuk pengguna yang sama harus dikirim secara berurutan untuk menghindari peningkatan latensi dan kegagalan.

batchDeleteContacts

Menghapus banyak kontak.

batchUpdateContacts

Perbarui batch kontak dan tampilkan peta nama resource ke PersonResponses untuk kontak yang diperbarui.

createContact

Buat kontak baru dan tampilkan referensi orang untuk kontak tersebut.

deleteContact

Menghapus kontak.

deleteContactPhoto

Menghapus foto kontak.

get

Memberikan informasi tentang seseorang dengan menentukan nama sumber daya.

getBatchGet

Memberikan informasi tentang daftar orang tertentu dengan menentukan daftar nama fasilitas yang diminta.

listDirectoryPeople

Menyediakan daftar profil domain dan kontak domain di direktori domain pengguna yang diautentikasi.

searchContacts

Menyediakan daftar kontak dalam grup kontak pengguna terautentikasi yang cocok dengan kueri penelusuran.

searchDirectoryPeople

Menyediakan daftar profil domain dan kontak domain di direktori domain pengguna yang diautentikasi yang cocok dengan kueri penelusuran.

updateContact

Perbarui data kontak untuk kontak yang ada.

updateContactPhoto

Perbarui foto kontak.