- Tài nguyên: Người
- Biểu diễn dưới dạng JSON
- PersonMetadata (Siêu dữ liệu)
- Nguồn
- SourceType
- ProfileMetadata
- ObjectType
- UserType
- Địa chỉ
- FieldMetadata
- AgeRange
- AgeRangeType
- Tiểu sử
- ContentType
- Ngày sinh
- Ngày
- BraggingRights
- CalendarUrl
- ClientData
- CoverPhoto
- EmailAddress
- Sự kiện
- ExternalId
- FileAs
- Giới tính
- ImClient
- Mối quan tâm
- Ngôn ngữ
- Vị trí
- Gói thành viên
- ContactGroupMembership
- DomainMembership
- MiscKeyword
- KeywordType
- Tên
- Biệt hiệu
- NicknameType
- Nghề nghiệp
- Tổ chức
- PhoneNumber
- Ảnh
- Relation (Quan hệ)
- RelationshipInterest
- RelationshipStatus
- Nơi cư trú
- SipAddress
- Kỹ năng
- Dòng giới thiệu
- URL
- UserDefined
- Phương thức
Tài nguyên: Person
Thông tin về một người được hợp nhất từ nhiều nguồn dữ liệu, chẳng hạn như danh bạ và dữ liệu hồ sơ của người dùng đã xác thực.
Hầu hết các trường có thể chứa nhiều mục. Các mục trong một trường không có thứ tự được đảm bảo, nhưng mỗi trường không trống được đảm bảo có đúng một trường với metadata.primary
được đặt thành đúng.
Biểu diễn dưới dạng JSON |
---|
{ "resourceName": string, "etag": string, "metadata": { object ( |
Trường | |
---|---|
resourceName |
Tên tài nguyên cho người đó, được máy chủ chỉ định. Một chuỗi ASCII dưới dạng |
etag |
Thẻ thực thể HTTP của tài nguyên. Dùng để xác thực bộ nhớ đệm của web. |
metadata |
Chỉ có đầu ra. Siêu dữ liệu về người đó. |
addresses[] |
Địa chỉ đường phố của người đó. |
ageRange |
Chỉ có đầu ra. KHÔNG DÙNG NỮA (Vui lòng sử dụng Độ tuổi của người đó. |
ageRanges[] |
Chỉ có đầu ra. Độ tuổi của người đó. |
biographies[] |
Tiểu sử của người đó. Trường này là một singleton cho nguồn liên hệ. |
birthdays[] |
Ngày sinh nhật của người đó. Trường này là một singleton cho nguồn liên hệ. |
braggingRights[] |
KHÔNG DÙNG NỮA: Sẽ không có dữ liệu nào được trả lại thành tích của người đó. |
calendarUrls[] |
URL lịch của người đó. |
clientData[] |
Dữ liệu khách hàng của người đó. |
coverPhotos[] |
Chỉ có đầu ra. Ảnh bìa của người đó. |
emailAddresses[] |
Địa chỉ email của người đó. Đối với |
events[] |
Sự kiện của người đó. |
externalIds[] |
Mã nhận dạng bên ngoài của người đó. |
fileAses[] |
Tệp của người này. |
genders[] |
Giới tính của người đó. Trường này là một singleton cho nguồn liên hệ. |
imClients[] |
Ứng dụng nhắn tin nhanh của người này. |
interests[] |
Mối quan tâm của người đó. |
locales[] |
Lựa chọn ưu tiên về ngôn ngữ của người đó. |
locations[] |
Vị trí của người đó. |
memberships[] |
Tư cách thành viên trong nhóm của người đó. |
miscKeywords[] |
Các từ khoá khác của người này. |
names[] |
Tên của người đó. Trường này là một singleton cho nguồn liên hệ. |
nicknames[] |
Biệt hiệu của người đó. |
occupations[] |
Nghề nghiệp của người đó. |
organizations[] |
Tổ chức trong quá khứ hoặc hiện tại của người đó. |
phoneNumbers[] |
Số điện thoại của người đó. Đối với |
photos[] |
Chỉ có đầu ra. Ảnh của người đó. |
relations[] |
Mối quan hệ của người đó. |
relationshipInterests[] |
Chỉ có đầu ra. KHÔNG DÙNG NỮA: Hệ thống sẽ không trả về dữ liệu nào về mối quan tâm của người đó. |
relationshipStatuses[] |
Chỉ có đầu ra. KHÔNG DÙNG NỮA: Hệ thống sẽ không trả về dữ liệu |
residences[] |
KHÔNG DÙNG NỮA: (Vui lòng sử dụng |
sipAddresses[] |
Địa chỉ SIP của người đó. |
skills[] |
Kỹ năng của người đó. |
taglines[] |
Chỉ có đầu ra. KHÔNG DÙNG NỮA: Dòng giới thiệu của người đó sẽ không được trả về dữ liệu nào. |
urls[] |
URL liên kết của người đó. |
userDefined[] |
Dữ liệu do người dùng xác định của người đó. |
PersonMetadata
Siêu dữ liệu về một người.
Biểu diễn dưới dạng JSON |
---|
{ "sources": [ { object ( |
Trường | |
---|---|
sources[] |
Nguồn dữ liệu về người đó. |
previousResourceNames[] |
Chỉ có đầu ra. Mọi tên tài nguyên cũ mà người này có. Chỉ được điền sẵn cho các yêu cầu Tên tài nguyên có thể thay đổi khi thêm hoặc xoá các trường liên kết một người liên hệ và hồ sơ, chẳng hạn như email đã xác minh, số điện thoại đã xác minh hoặc URL hồ sơ. |
linkedPeopleResourceNames[] |
Chỉ có đầu ra. Tên tài nguyên của những người được liên kết với tài nguyên này. |
deleted |
Chỉ có đầu ra. Đúng nếu tài nguyên của người đó đã bị xoá. Chỉ được điền sẵn cho các yêu cầu đồng bộ hoá |
objectType |
Chỉ có đầu ra. KHÔNG DÙNG NỮA (Vui lòng sử dụng Loại đối tượng người. |
Nguồn
Nguồn của một trường.
Biểu diễn dưới dạng JSON |
---|
{ "type": enum ( |
Trường | |
---|---|
type |
Loại nguồn. |
id |
Giá trị nhận dạng duy nhất trong loại nguồn do máy chủ tạo. |
etag |
Chỉ được điền bằng Thẻ thực thể HTTP của nguồn. Dùng để xác thực bộ nhớ đệm của web. |
updateTime |
Chỉ có đầu ra. Chỉ được điền bằng Dấu thời gian của lần cập nhật gần đây nhất của nguồn này. Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: |
Trường hợp Siêu dữ liệu về nguồn. |
|
profileMetadata |
Chỉ có đầu ra. Chỉ được điền bằng Siêu dữ liệu về nguồn thuộc loại PROFILE. |
SourceType
Loại của nguồn.
Enum | |
---|---|
SOURCE_TYPE_UNSPECIFIED |
Không xác định. |
ACCOUNT |
Tài khoản Google. |
PROFILE |
Hồ sơ trên Google. Bạn có thể xem hồ sơ tại https://profiles.google.com/{id}, trong đó {id} là mã nguồn. |
DOMAIN_PROFILE |
Hồ sơ miền Google Workspace. |
CONTACT |
Thông tin liên hệ của Google. Bạn có thể xem người liên hệ tại https://contact.google.com/{id}, trong đó {id} là mã nguồn. |
OTHER_CONTACT |
Google "Liên hệ khác". |
DOMAIN_CONTACT |
Thông tin liên hệ được chia sẻ của miền Google Workspace. |
ProfileMetadata
Siêu dữ liệu về một hồ sơ.
Biểu diễn dưới dạng JSON |
---|
{ "objectType": enum ( |
Trường | |
---|---|
objectType |
Chỉ có đầu ra. Loại đối tượng hồ sơ. |
userTypes[] |
Chỉ có đầu ra. Người dùng nhập dữ liệu. |
ObjectType
Loại đối tượng người.
Enum | |
---|---|
OBJECT_TYPE_UNSPECIFIED |
Không xác định. |
PERSON |
Người. |
PAGE |
Trang Currents. |
UserType
Loại người dùng.
Enum | |
---|---|
USER_TYPE_UNKNOWN |
Loại người dùng không xác định. |
GOOGLE_USER |
Người dùng là người dùng Google. |
GPLUS_USER |
Người dùng là người dùng Currents. |
GOOGLE_APPS_USER |
Người dùng là một người dùng Google Workspace. |
Address (Địa chỉ)
Địa chỉ thực tế của một người. Có thể là hộp thư bưu điện hoặc địa chỉ đường phố. Tất cả các trường đều không bắt buộc.
Biểu diễn dưới dạng JSON |
---|
{
"metadata": {
object ( |
Trường | |
---|---|
metadata |
Siêu dữ liệu về địa chỉ. |
formattedValue |
Giá trị không có cấu trúc của địa chỉ. Nếu người dùng không đặt thuộc tính này, giá trị sẽ được tạo tự động từ các giá trị có cấu trúc. |
type |
Loại địa chỉ. Loại này có thể là tuỳ chỉnh hoặc một trong các giá trị được xác định trước sau:
|
formattedType |
Chỉ có đầu ra. Loại địa chỉ được dịch và định dạng bằng ngôn ngữ trong tài khoản của người xem hoặc ngôn ngữ tiêu đề HTTP |
poBox |
Hộp thư bưu điện của địa chỉ. |
streetAddress |
Địa chỉ đường phố. |
extendedAddress |
Địa chỉ mở rộng của địa chỉ (ví dụ: số căn hộ). |
city |
Thành phố của địa chỉ. |
region |
Khu vực của địa chỉ; ví dụ: tiểu bang hoặc tỉnh. |
postalCode |
Mã bưu điện của địa chỉ. |
country |
Quốc gia của địa chỉ. |
countryCode |
Mã quốc gia theo ISO 3166-1 alpha-2 của địa chỉ. |
FieldMetadata
Siêu dữ liệu về một trường.
Biểu diễn dưới dạng JSON |
---|
{
"primary": boolean,
"sourcePrimary": boolean,
"verified": boolean,
"source": {
object ( |
Trường | |
---|---|
primary |
Chỉ có đầu ra. Đúng nếu trường này là trường chính cho tất cả các nguồn trong người đó. Mỗi người sẽ có tối đa một trường có |
sourcePrimary |
Đúng nếu trường này là trường chính của |
verified |
Chỉ có đầu ra. "True" nếu trường được xác minh; "false" nếu trường chưa được xác minh. Trường đã xác minh thường là tên, địa chỉ email, số điện thoại hoặc trang web đã được xác nhận là do người đó sở hữu. |
source |
Nguồn của trường. |
AgeRange
KHÔNG DÙNG NỮA (Vui lòng sử dụng person.ageRanges
để thay thế)
Độ tuổi của một người.
Enum | |
---|---|
AGE_RANGE_UNSPECIFIED |
Không xác định. |
LESS_THAN_EIGHTEEN |
Nhỏ hơn 18 tuổi. |
EIGHTEEN_TO_TWENTY |
Từ 18 đến 20. |
TWENTY_ONE_OR_OLDER |
21 tuổi trở lên. |
AgeRangeType
Độ tuổi của một người.
Biểu diễn dưới dạng JSON |
---|
{ "metadata": { object ( |
Trường | |
---|---|
metadata |
Siêu dữ liệu về độ tuổi. |
ageRange |
Độ tuổi. |
Tiểu sử
Tiểu sử ngắn của một người.
Biểu diễn dưới dạng JSON |
---|
{ "metadata": { object ( |
Trường | |
---|---|
metadata |
Siêu dữ liệu về tiểu sử. |
value |
Tiểu sử ngắn. |
contentType |
Loại nội dung của tiểu sử. |
ContentType
Loại nội dung.
Enum | |
---|---|
CONTENT_TYPE_UNSPECIFIED |
Không xác định. |
TEXT_PLAIN |
Văn bản thuần tuý. |
TEXT_HTML |
Văn bản HTML. |
Sinh nhật
Sinh nhật của một người. Bạn đã chỉ định ít nhất một trong các trường date
và text
. Các trường date
và text
thường đại diện cho cùng một ngày nhưng chúng tôi không đảm bảo sẽ đại diện cho cùng một ngày. Ứng dụng phải luôn đặt trường date
khi thay đổi ngày sinh nhật.
Biểu diễn dưới dạng JSON |
---|
{ "metadata": { object ( |
Trường | |
---|---|
metadata |
Siêu dữ liệu về ngày sinh nhật. |
date |
Ngày sinh nhật theo cấu trúc. |
text |
Ưu tiên sử dụng trường Một chuỗi dạng tự do đại diện cho ngày sinh của người dùng. Giá trị này không được xác thực. |
Ngày
Đại diện cho toàn bộ hoặc một phần ngày theo lịch, chẳng hạn như sinh nhật. Thời gian trong ngày và múi giờ được chỉ định ở nơi khác hoặc không đáng kể. Ngày này có liên quan đến Dương lịch. Điều này có thể đại diện cho một trong những điều sau:
- Một ngày đầy đủ, với các giá trị năm, tháng và ngày khác 0.
- Tháng và ngày, có năm bằng 0 (ví dụ: ngày kỷ niệm).
- Chỉ có năm, có tháng 0 và ngày không.
- Năm và tháng, không có ngày (ví dụ: ngày hết hạn thẻ tín dụng).
Các loại liên quan:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
Biểu diễn dưới dạng JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
Trường | |
---|---|
year |
Năm của ngày tháng. Giá trị phải từ 1 đến 9999 hoặc từ 0 để chỉ định ngày không có năm. |
month |
Tháng trong năm. Giá trị phải từ 1 đến 12 hoặc từ 0 để chỉ định năm không có tháng và ngày. |
day |
Ngày trong tháng. Giá trị phải từ 1 đến 31 và có giá trị cho năm và tháng, hoặc 0 để chỉ định riêng một năm hoặc một năm và tháng mà ngày đó không quan trọng. |
BraggingRights
KHÔNG DÙNG NỮA: Sẽ không có dữ liệu nào được trả lại quyền khoe khoang của một người.
Biểu diễn dưới dạng JSON |
---|
{
"metadata": {
object ( |
Trường | |
---|---|
metadata |
Siêu dữ liệu về thành tích. |
value |
Thành tích; ví dụ: |
CalendarUrl
URL lịch của một người.
Biểu diễn dưới dạng JSON |
---|
{
"metadata": {
object ( |
Trường | |
---|---|
metadata |
Siêu dữ liệu về URL của lịch. |
url |
URL lịch. |
type |
Loại URL của lịch. Loại này có thể là tuỳ chỉnh hoặc một trong các giá trị được xác định trước sau:
|
formattedType |
Chỉ có đầu ra. Loại URL của lịch được dịch và định dạng bằng ngôn ngữ tài khoản của người xem hoặc ngôn ngữ tiêu đề HTTP |
ClientData
Dữ liệu khách hàng tuỳ ý do khách hàng điền sẵn. Cho phép khóa và giá trị trùng lặp.
Biểu diễn dưới dạng JSON |
---|
{
"metadata": {
object ( |
Trường | |
---|---|
metadata |
Siêu dữ liệu về dữ liệu ứng dụng. |
key |
Khoá của dữ liệu ứng dụng do ứng dụng chỉ định. |
value |
Giá trị ứng dụng được chỉ định của dữ liệu ứng dụng. |
CoverPhoto
Ảnh bìa của một người. Hình ảnh lớn hiển thị trên trang hồ sơ của người đó thể hiện họ là ai hoặc họ quan tâm đến điều gì.
Biểu diễn dưới dạng JSON |
---|
{
"metadata": {
object ( |
Trường | |
---|---|
metadata |
Siêu dữ liệu về ảnh bìa. |
url |
URL của ảnh bìa. |
default |
True nếu ảnh bìa là ảnh bìa mặc định; false nếu ảnh bìa là ảnh bìa do người dùng cung cấp. |
EmailAddress
Địa chỉ email của một người.
Biểu diễn dưới dạng JSON |
---|
{
"metadata": {
object ( |
Trường | |
---|---|
metadata |
Siêu dữ liệu về địa chỉ email. |
value |
Địa chỉ email. |
type |
Loại địa chỉ email. Loại này có thể là tuỳ chỉnh hoặc một trong các giá trị được xác định trước sau:
|
formattedType |
Chỉ có đầu ra. Loại địa chỉ email được dịch và định dạng bằng ngôn ngữ tài khoản của người xem hoặc ngôn ngữ tiêu đề HTTP |
displayName |
Tên hiển thị của email. |
Sự kiện
Một sự kiện liên quan đến người đó.
Biểu diễn dưới dạng JSON |
---|
{ "metadata": { object ( |
Trường | |
---|---|
metadata |
Siêu dữ liệu về sự kiện. |
date |
Ngày diễn ra sự kiện. |
type |
Loại sự kiện. Loại này có thể là tuỳ chỉnh hoặc một trong các giá trị được xác định trước sau:
|
formattedType |
Chỉ có đầu ra. Loại sự kiện được dịch và định dạng bằng ngôn ngữ trong tài khoản của người xem hoặc ngôn ngữ tiêu đề HTTP |
ExternalId
Giá trị nhận dạng của một thực thể bên ngoài liên quan đến người đó.
Biểu diễn dưới dạng JSON |
---|
{
"metadata": {
object ( |
Trường | |
---|---|
metadata |
Siêu dữ liệu về mã nhận dạng bên ngoài. |
value |
Giá trị của mã nhận dạng bên ngoài. |
type |
Loại mã nhận dạng bên ngoài. Loại này có thể là tuỳ chỉnh hoặc một trong các giá trị được xác định trước sau:
|
formattedType |
Chỉ có đầu ra. Loại sự kiện được dịch và định dạng bằng ngôn ngữ trong tài khoản của người xem hoặc ngôn ngữ tiêu đề HTTP |
FileAs
Tên nên được sử dụng để sắp xếp người dùng trong danh sách.
Biểu diễn dưới dạng JSON |
---|
{
"metadata": {
object ( |
Trường | |
---|---|
metadata |
Siêu dữ liệu về tệp dưới dạng. |
value |
Tệp dưới dạng giá trị |
Giới tính
Giới tính của một người.
Biểu diễn dưới dạng JSON |
---|
{
"metadata": {
object ( |
Trường | |
---|---|
metadata |
Siêu dữ liệu về giới tính. |
value |
Giới tính của người đó. Giới tính có thể là giới tính tuỳ chỉnh hoặc một trong các giá trị được xác định trước sau:
|
formattedValue |
Chỉ có đầu ra. Giá trị của giới tính được dịch và định dạng bằng ngôn ngữ trong tài khoản của người xem hoặc ngôn ngữ tiêu đề HTTP |
addressMeAs |
Trường văn bản dạng tự do cho đại từ nhân xưng nên dùng để xưng hô với người đó. Các giá trị phổ biến là:
|
ImClient
Ứng dụng nhắn tin nhanh của một người.
Biểu diễn dưới dạng JSON |
---|
{
"metadata": {
object ( |
Trường | |
---|---|
metadata |
Siêu dữ liệu về ứng dụng nhắn tin nhanh. |
username |
Tên người dùng được sử dụng trong ứng dụng nhắn tin nhanh. |
type |
Loại ứng dụng nhắn tin nhanh. Loại này có thể là tuỳ chỉnh hoặc một trong các giá trị được xác định trước sau:
|
formattedType |
Chỉ có đầu ra. Loại ứng dụng nhắn tin nhanh được dịch và định dạng bằng ngôn ngữ tài khoản của người xem hoặc ngôn ngữ tiêu đề HTTP |
protocol |
Giao thức của ứng dụng nhắn tin nhanh. Giao thức có thể là giao thức tuỳ chỉnh hoặc là một trong các giá trị được xác định trước sau:
|
formattedProtocol |
Chỉ có đầu ra. Giao thức của ứng dụng nhắn tin nhanh được định dạng theo ngôn ngữ tài khoản của người xem hoặc ngôn ngữ tiêu đề HTTP |
Quan tâm
Một trong những mối quan tâm của người đó.
Biểu diễn dưới dạng JSON |
---|
{
"metadata": {
object ( |
Trường | |
---|---|
metadata |
Siêu dữ liệu về mối quan tâm. |
value |
Mối quan tâm; ví dụ: |
Ngôn ngữ
Lựa chọn ưu tiên về ngôn ngữ của người dùng.
Biểu diễn dưới dạng JSON |
---|
{
"metadata": {
object ( |
Trường | |
---|---|
metadata |
Siêu dữ liệu về ngôn ngữ. |
value |
Thẻ ngôn ngữ IETF BCP 47 được định dạng đúng cách, đại diện cho ngôn ngữ. |
Vị trí
Vị trí của một người.
Biểu diễn dưới dạng JSON |
---|
{
"metadata": {
object ( |
Trường | |
---|---|
metadata |
Siêu dữ liệu về vị trí đó. |
value |
Giá trị dạng tự do của vị trí. |
type |
Loại vị trí. Loại này có thể là tuỳ chỉnh hoặc một trong các giá trị được xác định trước sau:
|
current |
Liệu vị trí có phải là vị trí hiện tại hay không. |
buildingId |
Mã nhận dạng toà nhà. |
floor |
Tên hoặc số tầng. |
floorSection |
Phần sàn trong |
deskCode |
Vị trí không gian làm việc riêng. |
Gói thành viên
Tư cách thành viên của một người trong nhóm. Chỉ có thể sửa đổi tư cách thành viên của nhóm liên hệ.
Biểu diễn dưới dạng JSON |
---|
{ "metadata": { object ( |
Trường | |
---|---|
metadata |
Siêu dữ liệu về gói thành viên. |
Trường hợp membership . Gói thành viên. membership chỉ có thể là một trong những trạng thái sau: |
|
contactGroupMembership |
Thành viên trong nhóm người liên hệ. |
domainMembership |
Chỉ có đầu ra. Thành viên miền. |
ContactGroupMembership
Một thành viên trong nhóm liên hệ Google.
Biểu diễn dưới dạng JSON |
---|
{ "contactGroupId": string, "contactGroupResourceName": string } |
Trường | |
---|---|
contactGroupId |
Chỉ có đầu ra. Mã nhóm người liên hệ để thành viên trong nhóm liên hệ. |
contactGroupResourceName |
Tên tài nguyên cho nhóm người liên hệ do máy chủ chỉ định. Một chuỗi ASCII, dưới dạng |
DomainMembership
Một gói thành viên của miền Google Workspace.
Biểu diễn dưới dạng JSON |
---|
{ "inViewerDomain": boolean } |
Trường | |
---|---|
inViewerDomain |
Đúng nếu người đó thuộc miền Google Workspace của người xem. |
MiscKeyword
Từ khóa khác của một người.
Biểu diễn dưới dạng JSON |
---|
{ "metadata": { object ( |
Trường | |
---|---|
metadata |
Siêu dữ liệu về từ khoá khác. |
value |
Giá trị của từ khoá khác. |
type |
Loại từ khóa khác. |
formattedType |
Chỉ có đầu ra. Loại từ khoá khác được dịch và định dạng bằng ngôn ngữ trong tài khoản của người xem hoặc ngôn ngữ tiêu đề HTTP |
KeywordType
Loại từ khóa khác.
Enum | |
---|---|
TYPE_UNSPECIFIED |
Không xác định. |
OUTLOOK_BILLING_INFORMATION |
Trường Outlook dành cho thông tin thanh toán. |
OUTLOOK_DIRECTORY_SERVER |
Trường Outlook cho máy chủ thư mục. |
OUTLOOK_KEYWORD |
Trường Outlook cho từ khoá. |
OUTLOOK_MILEAGE |
Trường Outlook cho quãng đường đã đi. |
OUTLOOK_PRIORITY |
Trường Outlook để ưu tiên. |
OUTLOOK_SENSITIVITY |
Trường Outlook về tính nhạy cảm. |
OUTLOOK_SUBJECT |
Trường Outlook cho tiêu đề. |
OUTLOOK_USER |
Trường Outlook cho người dùng. |
HOME |
Trang chủ. |
WORK |
Nơi làm việc. |
OTHER |
Khác. |
Tên
Tên của một người. Nếu tên là tên duy nhất thì họ sẽ trống.
Biểu diễn dưới dạng JSON |
---|
{
"metadata": {
object ( |
Trường | |
---|---|
metadata |
Siêu dữ liệu về tên. |
displayName |
Chỉ có đầu ra. Tên hiển thị được định dạng theo ngôn ngữ do tài khoản của người xem hoặc tiêu đề HTTP |
displayNameLastFirst |
Chỉ có đầu ra. Tên hiển thị có họ được định dạng đầu theo ngôn ngữ do tài khoản của người xem hoặc tiêu đề HTTP |
unstructuredName |
Giá trị tên biểu mẫu tuỳ ý. |
familyName |
Họ. |
givenName |
Tên đặt. |
middleName |
Tên đệm. |
honorificPrefix |
Tiền tố kính ngữ, chẳng hạn như |
honorificSuffix |
Hậu tố kính ngữ, chẳng hạn như |
phoneticFullName |
Tên đầy đủ được đánh vần như tên. |
phoneticFamilyName |
Tên gia đình đánh vần như đúng. |
phoneticGivenName |
Tên đã đặt đánh vần đúng như tên gọi. |
phoneticMiddleName |
(Các) tên đệm đánh vần như cách đọc. |
phoneticHonorificPrefix |
Tiền tố kính ngữ được đánh vần theo đúng cách phát âm. |
phoneticHonorificSuffix |
Hậu tố kính ngữ được đánh vần đúng như cách đọc. |
Biệt hiệu
Biệt hiệu của một người.
Biểu diễn dưới dạng JSON |
---|
{ "metadata": { object ( |
Trường | |
---|---|
metadata |
Siêu dữ liệu về biệt hiệu. |
value |
Biệt hiệu. |
type |
Loại biệt hiệu. |
NicknameType
Loại biệt hiệu.
Enum | |
---|---|
DEFAULT |
Biệt hiệu chung chung. |
MAIDEN_NAME |
Tên thời con gái hoặc họ khai sinh. Được dùng khi họ của người đó thay đổi do kết quả hôn nhân. |
INITIALS |
Tên họ viết tắt. |
GPLUS |
Biệt hiệu của hồ sơ trên Google+. |
OTHER_NAME |
Mối liên kết nghề nghiệp hoặc tên khác; ví dụ: |
ALTERNATE_NAME |
Tên thay thế của người. |
SHORT_NAME |
Tên ngắn hơn của người đó. |
Nghề nghiệp
Nghề nghiệp của người dùng.
Biểu diễn dưới dạng JSON |
---|
{
"metadata": {
object ( |
Trường | |
---|---|
metadata |
Siêu dữ liệu về nghề nghiệp. |
value |
Nghề nghiệp; ví dụ: |
Tổ chức
Tổ chức trước đây hoặc hiện tại của một người. Phạm vi ngày trùng lặp được phép.
Biểu diễn dưới dạng JSON |
---|
{ "metadata": { object ( |
Trường | |
---|---|
metadata |
Siêu dữ liệu về tổ chức. |
type |
Loại tổ chức. Loại này có thể là tuỳ chỉnh hoặc một trong các giá trị được xác định trước sau:
|
formattedType |
Chỉ có đầu ra. Loại tổ chức được dịch và định dạng theo ngôn ngữ tài khoản của người xem hoặc ngôn ngữ tiêu đề HTTP |
startDate |
Ngày bắt đầu khi người đó tham gia tổ chức. |
endDate |
Ngày kết thúc khi người đó rời khỏi tổ chức. |
current |
Đúng nếu tổ chức là tổ chức hiện tại của người đó; sai nếu tổ chức là tổ chức cũ. |
name |
Tên của tổ chức. |
phoneticName |
Tên theo phiên âm của tổ chức. |
department |
Bộ phận của người đó trong tổ chức. |
title |
Chức danh của người này trong tổ chức. |
jobDescription |
Nội dung mô tả công việc của người này tại tổ chức. |
symbol |
Ký hiệu liên quan đến tổ chức; ví dụ: mã chứng khoán, chữ viết tắt hoặc từ viết tắt. |
domain |
Tên miền liên kết với tổ chức; ví dụ: |
location |
Địa điểm của văn phòng của tổ chức mà người đó làm việc. |
costCenter |
Là trung tâm chi phí của người đó trong tổ chức. |
fullTimeEquivalentMillipercent |
Tỷ lệ phần trăm toàn thời gian tương đương của người đó trong tổ chức (100.000 = 100%). |
PhoneNumber
Số điện thoại của một người.
Biểu diễn dưới dạng JSON |
---|
{
"metadata": {
object ( |
Trường | |
---|---|
metadata |
Siêu dữ liệu về số điện thoại. |
value |
Số điện thoại. |
canonicalForm |
Chỉ có đầu ra. Dạng chuẩn hoá ITU-T E.164 của số điện thoại. |
type |
Loại số điện thoại. Loại này có thể là tuỳ chỉnh hoặc một trong các giá trị được xác định trước sau:
|
formattedType |
Chỉ có đầu ra. Loại số điện thoại được dịch và định dạng theo ngôn ngữ trong tài khoản của người xem hoặc ngôn ngữ tiêu đề HTTP |
Ảnh
Ảnh của một người. Hình ảnh hiển thị bên cạnh tên của người đó để giúp người khác nhận ra người đó.
Biểu diễn dưới dạng JSON |
---|
{
"metadata": {
object ( |
Trường | |
---|---|
metadata |
Siêu dữ liệu về ảnh. |
url |
URL của ảnh. Bạn có thể thay đổi kích thước mong muốn bằng cách thêm tham số truy vấn |
default |
"True" nếu ảnh này là ảnh mặc định; "false" nếu ảnh là ảnh do người dùng cung cấp. |
Mối quan hệ
Mối quan hệ của một người với một người khác.
Biểu diễn dưới dạng JSON |
---|
{
"metadata": {
object ( |
Trường | |
---|---|
metadata |
Siêu dữ liệu về mối quan hệ. |
person |
Tên của người khác mà mối liên hệ này đề cập. |
type |
Mối quan hệ của người này với người kia. Loại này có thể là tuỳ chỉnh hoặc một trong các giá trị được xác định trước sau:
|
formattedType |
Chỉ có đầu ra. Loại mối quan hệ được dịch và định dạng bằng ngôn ngữ tài khoản của người xem hoặc ngôn ngữ được chỉ định trong tiêu đề HTTP Accept-Language. |
RelationshipInterest
KHÔNG DÙNG NỮA: Hệ thống sẽ không trả về dữ liệu nào Mối quan hệ của một người .
Biểu diễn dưới dạng JSON |
---|
{
"metadata": {
object ( |
Trường | |
---|---|
metadata |
Siêu dữ liệu về mối quan hệ. |
value |
Loại mối quan hệ mà người đó đang tìm kiếm. Giá trị này có thể là giá trị tuỳ chỉnh hoặc là một trong các giá trị được xác định trước sau:
|
formattedValue |
Chỉ có đầu ra. Giá trị của mối quan tâm được dịch và định dạng bằng ngôn ngữ tài khoản của người xem hoặc ngôn ngữ được chỉ định trong tiêu đề HTTP Accept-Language. |
RelationshipStatus
KHÔNG DÙNG NỮA: Hệ thống sẽ không trả về dữ liệu nào về tình trạng quan hệ của một người.
Biểu diễn dưới dạng JSON |
---|
{
"metadata": {
object ( |
Trường | |
---|---|
metadata |
Siêu dữ liệu về tình trạng quan hệ. |
value |
Tình trạng của mối quan hệ. Giá trị này có thể là giá trị tuỳ chỉnh hoặc là một trong các giá trị được xác định trước sau:
|
formattedValue |
Chỉ có đầu ra. Giá trị của trạng thái mối quan hệ được dịch và định dạng bằng ngôn ngữ tài khoản của người xem hoặc ngôn ngữ tiêu đề HTTP |
Nhà riêng
KHÔNG DÙNG NỮA: Vui lòng sử dụng person.locations
. Nơi ở trong quá khứ hoặc hiện tại của người nào đó.
Biểu diễn dưới dạng JSON |
---|
{
"metadata": {
object ( |
Trường | |
---|---|
metadata |
Siêu dữ liệu về nơi cư trú. |
value |
Địa chỉ của nơi cư trú. |
current |
"True" nếu nơi cư trú này là nơi ở hiện tại của người đó; "false" nếu đây là nơi cư trú trước đây. |
SipAddress
Địa chỉ SIP của một người. Địa chỉ Giao thức ban đầu của phiên được dùng cho hoạt động giao tiếp VoIP để thực hiện cuộc gọi thoại hoặc cuộc gọi video qua Internet.
Biểu diễn dưới dạng JSON |
---|
{
"metadata": {
object ( |
Trường | |
---|---|
metadata |
Siêu dữ liệu về địa chỉ SIP. |
value |
Địa chỉ SIP ở định dạng URI SIP RFC 3261 19.1. |
type |
Loại địa chỉ SIP. Loại này có thể là giá trị tuỳ chỉnh hoặc có thể là một trong các giá trị được xác định trước sau:
|
formattedType |
Chỉ có đầu ra. Loại địa chỉ SIP được dịch và định dạng bằng ngôn ngữ tài khoản của người xem hoặc ngôn ngữ tiêu đề HTTP |
Kỹ năng
Một kỹ năng mà người đó có.
Biểu diễn dưới dạng JSON |
---|
{
"metadata": {
object ( |
Trường | |
---|---|
metadata |
Siêu dữ liệu về kỹ năng. |
value |
Kỹ năng; ví dụ: |
Dòng giới thiệu
KHÔNG DÙNG NỮA: Hệ thống sẽ không trả về dữ liệu nào. Thông tin mô tả ngắn gọn một dòng về người đó sẽ không được trả về.
Biểu diễn dưới dạng JSON |
---|
{
"metadata": {
object ( |
Trường | |
---|---|
metadata |
Siêu dữ liệu về dòng giới thiệu. |
value |
Dòng giới thiệu. |
URL
URL được liên kết của một người.
Biểu diễn dưới dạng JSON |
---|
{
"metadata": {
object ( |
Trường | |
---|---|
metadata |
Siêu dữ liệu về URL. |
value |
URL. |
type |
Loại URL. Loại này có thể là tuỳ chỉnh hoặc một trong các giá trị được xác định trước sau:
|
formattedType |
Chỉ có đầu ra. Loại URL được dịch và định dạng bằng ngôn ngữ trong tài khoản của người xem hoặc ngôn ngữ tiêu đề HTTP |
UserDefined
Dữ liệu người dùng tuỳ ý do người dùng cuối điền.
Biểu diễn dưới dạng JSON |
---|
{
"metadata": {
object ( |
Trường | |
---|---|
metadata |
Siêu dữ liệu về dữ liệu do người dùng xác định. |
key |
Khoá do người dùng cuối chỉ định trong dữ liệu do người dùng xác định. |
value |
Giá trị do người dùng cuối chỉ định của dữ liệu do người dùng xác định. |
Phương thức |
|
---|---|
|
Tạo một loạt địa chỉ liên hệ mới và trả về PersonResponse cho Bạn phải gửi yêu cầu thay đổi cho cùng một người dùng theo tuần tự để tránh tăng độ trễ và lỗi. |
|
Xoá một loạt địa chỉ liên hệ. |
|
Cập nhật một loạt mục liên hệ và trả về bản đồ tên tài nguyên cho PersonResponse cho các mục liên hệ đã cập nhật. |
|
Tạo một liên hệ mới và trả về tài nguyên người cho liên hệ đó. |
|
Xoá người liên hệ. |
|
Xoá ảnh của một người liên hệ. |
|
Cung cấp thông tin về một người bằng cách chỉ định tên tài nguyên. |
|
Cung cấp thông tin về danh sách những người cụ thể bằng cách chỉ định danh sách tên tài nguyên được yêu cầu. |
|
Cung cấp danh sách các hồ sơ trên miền và danh bạ miền trong thư mục miền của người dùng đã xác thực. |
|
Cung cấp danh sách địa chỉ liên hệ trong danh bạ được nhóm của người dùng đã xác thực phù hợp với truy vấn tìm kiếm. |
|
Cung cấp danh sách các hồ sơ trên miền và địa chỉ liên hệ trên miền trong thư mục miền của người dùng đã xác thực khớp với truy vấn tìm kiếm. |
|
Cập nhật dữ liệu liên hệ cho một người liên hệ hiện có. |
|
Cập nhật ảnh của một người liên hệ. |