REST Resource: people

Resource: Orang

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

Sebagian besar kolom dapat berisi lebih dari satu item. Item dalam kolom tidak memiliki urutan yang pasti, tetapi setiap kolom yang tidak kosong dijamin memiliki satu kolom dengan metadata.primary yang ditetapkan ke 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 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 tersebut.

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 dikembalikan. Hak-hak yang membanggakan orang tersebut.

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. Untuk people.connections.list dan otherContacts.list, jumlah alamat email dibatasi hingga 100. Jika Seseorang memiliki lebih banyak alamat email, seluruh kumpulan dapat diperoleh dengan memanggil people.getBatchGet.

events[]

object (Event)

Peristiwa yang dialami orang tersebut.

externalIds[]

object (ExternalId)

ID eksternal orang tersebut.

fileAses[]

object (FileAs)

Analisis file orang tersebut.

genders[]

object (Gender)

Jenis kelamin 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 lokal orang tersebut.

locations[]

object (Location)

Lokasi orang tersebut.

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 maksimal 100. Jika Seseorang 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 orang 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, gunakan person.locations) Tempat tinggal orang tersebut.

sipAddresses[]

object (SipAddress)

Alamat SIP pengguna tersebut.

skills[]

object (Skill)

Keterampilan orang tersebut.

taglines[]
(deprecated)

object (Tagline)

Hanya output. TIDAK DIGUNAKAN LAGI: Tagline orang tersebut tidak akan ditampilkan.

urls[]

object (Url)

URL yang terkait dengan orang tersebut.

userDefined[]

object (UserDefined)

Data yang ditetapkan pengguna milik orang tersebut.

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 pernah 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-orang yang ditautkan ke resource ini.

deleted

boolean

Hanya output. True jika sumber daya 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 dari sumber. Digunakan untuk validasi cache web.

updateTime

string (Timestamp format)

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

Stempel waktu pembaruan terakhir sumber ini.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. 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 tersebut di https://profiles.google.com/{id}, dengan {id} adalah ID sumbernya.
DOMAIN_PROFILE Profil domain Google Workspace Anda.
CONTACT Kontak Google. Anda dapat melihat kontak di https://contact.google.com/{id}, dengan {id} adalah ID sumbernya.
OTHER_CONTACT "Kontak lainnya" dari 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 pengguna tidak diketahui.
GOOGLE_USER Pengguna adalah pengguna Google.
GPLUS_USER Pengguna tersebut adalah pengguna Currents.
GOOGLE_APPS_USER Pengguna adalah pengguna Google Workspace.

Alamat

Alamat fisik seseorang. Mungkin berupa P.O. kotak 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, nilai ini akan otomatis dibuat dari nilai terstruktur.

type

string

Jenis alamat. Jenisnya dapat berupa kustom atau salah satu dari nilai standar 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

PO. kotak alamat.

streetAddress

string

Alamat.

extendedAddress

string

Alamat yang diperluas; misalnya, nomor apartemen.

city

string

Kota alamat.

region

string

Region 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. Benar jika kolom adalah kolom utama untuk semua sumber dalam seseorang. Setiap orang akan memiliki maksimal satu kolom dengan primary ditetapkan ke benar (true).

sourcePrimary

boolean

True jika kolomnya adalah kolom utama untuk source. Setiap sumber harus memiliki maksimal satu kolom dengan sourcePrimary ditetapkan ke benar (true).

verified

boolean

Hanya output. True jika kolom telah diverifikasi; false jika kolom tidak diverifikasi. Kolom terverifikasi biasanya adalah nama, alamat email, nomor telepon, atau situs yang telah dikonfirmasi sebagai milik orang tersebut.

source

object (Source)

Sumber kolom.

RentangUsia

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 dan dua puluh tahun.
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 satu kolom date dan text ditentukan. Kolom date dan text biasanya mewakili tanggal yang sama, tetapi tidak dijamin. Klien harus selalu menyetel kolom date saat mengubah tanggal lahir.

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

object (FieldMetadata)

Metadata tentang tanggal lahir.

date

object (Date)

Tanggal ulang tahun yang terstruktur.

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 ini relatif terhadap Kalender Gregorian. ID ini dapat mewakili salah satu dari hal berikut:

  • Tanggal lengkap, dengan nilai tahun, bulan, dan hari bukan nol.
  • Bulan dan hari, dengan tahun nol (misalnya, hari jadi).
  • Tahun saja, dengan bulan nol dan hari nol.
  • Tahun dan bulan, dengan hari nol (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 dikembalikan. Hak membanggakan seseorang.

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

object (FieldMetadata)

Metadata tentang hak yang dibanggakan.

value

string

Hak yang membanggakan; 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. Jenisnya dapat berupa kustom atau salah satu dari nilai standar berikut:

  • home
  • freeBusy
  • work
formattedType

string

Hanya output. Jenis URL kalender yang diterjemahkan dan diformat dalam lokal akun penonton atau lokal 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 data klien yang ditentukan klien.

value

string

Nilai data klien yang ditentukan klien.

CoverPhoto

Foto sampul seseorang. Gambar besar yang ditampilkan di halaman profil seseorang yang mewakili siapa dia atau apa yang dia 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

True jika foto sampul adalah foto sampul default; false jika foto sampul adalah foto sampul yang diberikan pengguna.

EmailAddress

Alamat email seseorang.

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. Jenisnya dapat berupa kustom atau salah satu dari nilai standar 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.

Acara

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. Jenisnya dapat berupa kustom atau salah satu dari nilai standar berikut:

  • anniversary
  • other
formattedType

string

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

IdEksternal

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. Jenisnya dapat berupa kustom atau salah satu dari nilai standar berikut:

  • account
  • customer
  • loginId
  • network
  • organization
formattedType

string

Hanya output. Jenis peristiwa 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 file-as

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 salah satu dari nilai khusus atau salah satu nilai yang telah ditentukan berikut:

  • male
  • female
  • unspecified
formattedValue

string

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

addressMeAs

string

Kolom teks bentuk bebas untuk sebutan yang harus digunakan untuk menyapa 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. Jenisnya dapat berupa kustom atau salah satu dari nilai standar 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 dapat berupa nilai kustom atau salah satu dari nilai yang telah ditetapkan 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.

Lokal

Preferensi lokal seseorang.

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

object (FieldMetadata)

Metadata tentang lokalitas.

value

string

Tag bahasa IETF BCP 47 yang diformat dengan baik yang 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 lokasi dalam bentuk bebas.

type

string

Jenis lokasi. Jenisnya dapat berupa kustom atau salah satu dari nilai standar berikut:

  • desk
  • grewUp
current

boolean

Apakah lokasi tersebut adalah lokasi saat ini.

buildingId

string

ID gedung.

floor

string

Nama atau nomor lantai.

floorSection

string

Bagian lantai di floor_name.

deskCode

string

Lokasi meja kerja individu.

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 dapat berupa salah satu dari 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 "myContacts" atau "berbintang" keanggotaan grup sistem dapat ditambahkan. Kontak harus selalu memiliki setidaknya satu keanggotaan grup kontak.

DomainMembership

Langganan Domain Google Workspace.

Representasi JSON
{
  "inViewerDomain": boolean
}
Kolom
inViewerDomain

boolean

Benar 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 penonton atau lokal 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 Kolom Outlook untuk server direktori.
OUTLOOK_KEYWORD Kolom Outlook untuk kata kunci.
OUTLOOK_MILEAGE bidang 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 Beranda.
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 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 yang diberikan.

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 dieja seperti kedengarannya.

phoneticGivenName

string

Nama yang diberikan dieja seperti kedengarannya.

phoneticMiddleName

string

Nama tengah dieja seperti bunyinya.

phoneticHonorificPrefix

string

Awalan kehormatan yang dieja seperti terdengar.

phoneticHonorificSuffix

string

Akhiran kehormatan yang dieja seperti bunyinya.

Nama panggilan

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 gadis atau nama keluarga kelahiran. Digunakan jika nama keluarga orang telah berubah karena pernikahan.

INITIALS

Inisial.

GPLUS

Nama panggilan profil Google+.

OTHER_NAME

Nama afiliasi profesional atau nama lainnya; misalnya Dr. Smith.

ALTERNATE_NAME Nama alternatif orang dikenal.
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 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. Jenisnya dapat berupa kustom atau salah satu dari nilai standar 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 dengan organisasi.

endDate

object (Date)

Tanggal akhir saat pengguna keluar dari organisasi.

current

boolean

True jika organisasi tersebut adalah organisasi milik orang tersebut saat ini; false jika organisasi tersebut adalah organisasi lama.

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 di organisasi tersebut.

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

Milipercent setara penuh waktu orang tersebut dalam organisasi (100000 = 100%).

NomorTelepon

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 nomor telepon ITU-T E.164 yang dikanonikalisasi.

type

string

Jenis nomor telepon. Jenisnya dapat berupa kustom atau salah satu dari nilai standar 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 lokal akun penonton atau lokal header HTTP Accept-Language.

Foto

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

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

True jika foto adalah foto default; false jika foto adalah foto yang disediakan 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 lain yang dirujuk hubungan ini.

type

string

Hubungan orang tersebut dengan orang lain. Jenisnya dapat berupa kustom atau salah satu dari nilai standar 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 penonton atau lokal yang ditentukan di header HTTP Accept-Language.

RelationshipInterest

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

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

object (FieldMetadata)

Metadata tentang ketertarikan hubungan.

value

string

Hubungan yang diharapkan orang tersebut. Nilai dapat berupa kustom atau salah satu dari nilai standar berikut:

  • friend
  • date
  • relationship
  • networking
formattedValue

string

Hanya output. Nilai ketertarikan hubungan yang diterjemahkan dan diformat dalam lokalitas akun pemirsa atau lokal yang ditentukan di 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. Nilai dapat berupa kustom atau salah satu dari nilai standar berikut:

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

string

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

Kediaman

TIDAK DIGUNAKAN LAGI: Sebagai gantinya, gunakan person.locations. Tempat tinggal seseorang di masa lalu 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 tersebut adalah tempat tinggal orang tersebut saat ini; false jika tempat tinggal tersebut adalah tempat tinggal sebelumnya.

SipAddress

Alamat SIP seseorang. Alamat Protokol Awal Sesi digunakan pada 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. Jenisnya dapat berupa kustom atau salah satu dari nilai standar 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 yang dikaitkan 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. Jenisnya dapat berupa kustom atau salah satu dari nilai standar 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 penonton 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 buatan pengguna.

key

string

Kunci yang ditentukan pengguna akhir dari data yang ditentukan pengguna.

value

string

Nilai yang ditentukan pengguna akhir dari data yang ditentukan pengguna.

Metode

batchCreateContacts

Buat batch kontak baru dan tampilkan PersonResponses untuk

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

batchDeleteContacts

Menghapus sekumpulan kontak.

batchUpdateContacts

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

createContact

Buat kontak baru dan kembalikan sumber daya orang untuk kontak tersebut.

deleteContact

Hapus kontak seseorang.

deleteContactPhoto

Menghapus foto kontak.

get

Memberikan informasi tentang seseorang dengan menentukan nama resource.

getBatchGet

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

listDirectoryPeople

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

searchContacts

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

searchDirectoryPeople

Memberikan daftar profil domain dan kontak domain di direktori domain pengguna terautentikasi yang cocok dengan kueri penelusuran.

updateContact

Perbarui data kontak untuk kontak yang ada.

updateContactPhoto

Memperbarui foto kontak.